log-symbols

library0.0.14pypypi✓ verified 23d ago

Log Symbols provides colored symbols (like ✓, ✖, ℹ, ⚠) for various log levels in Python, enhancing terminal output readability. The current version is 0.0.14, with the last release in August 2019, indicating a stable but not actively developed library. It includes fallbacks for Windows CMD, which has a limited character set.

observability serialization

pip install log-symbols

github ↗package ↗

INSTALL

IMPORT

SIG · LOG-SYMBOLS

log-symbols

observabilitypythonv0.0.14

Install

1.7s avg

Import

30ms

Disk

16MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.0.14 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.024s · 18MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.7s · import 0.036s · 19MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Log Symbols

✓ from log_symbols import LogSymbols

Direct Symbols (e.g., success)

✓ from log_symbols import success, info, warning, error

Import `LogSymbols` to access symbols as attributes (e.g., `LogSymbols.success`), or import individual symbols directly for concise usage. The library automatically handles appropriate symbol rendering for different terminals, including fallbacks for Windows CMD.

from log_symbols import LogSymbols print(LogSymbols.success + ' Finished successfully!') print(LogSymbols.info + ' This is an informational message.') print(LogSymbols.warning + ' A potential issue occurred.') print(LogSymbols.error + ' Something went wrong!') # Or directly import symbols from log_symbols import success, info, warning, error print(success + ' Direct import example.')

Debug

Known issues

gotchaThe `log-symbols` library is not directly integrated with Python's standard `logging` module. You need to explicitly print the symbols alongside your log messages if you want to use `logging` functionality (e.g., `logger.info(LogSymbols.info + ' Message')`). It merely provides the symbols as strings.

fix

Manually prepend the desired symbol to your log message string when using Python's `logging` module or other logging frameworks.

affects: 0.0.14

gotchaThe library's last release was in August 2019, meaning it's not actively maintained. While it's stable for its intended purpose, there will be no new features or updates for compatibility with very recent Python versions or terminal advancements.

fix

Consider if the existing functionality meets your needs. For advanced terminal output or active development, explore more recently maintained alternatives if available.

affects: 0.0.14

gotchaDirect concatenation of symbols with non-string types can lead to `TypeError`. Ensure that any message combined with a log symbol is first converted to a string.

fix

Always convert messages to strings before concatenating with `log_symbols`. For example: `LogSymbols.info + str(your_variable)`.

affects: 0.0.14

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'log_symbols'

The `log-symbols` package is not installed in your Python environment, or there is a typo in the import statement or package name.

fix

Install the package using pip: `pip install log_symbols`

AttributeError: module 'log_symbols' has no attribute 'LogSymbols'

You likely imported the module as `import log_symbols` but then tried to access `log_symbols.LogSymbols` without `LogSymbols` being directly available at the top-level module when imported this way.

fix

Use `from log_symbols import LogSymbols` to directly import the `LogSymbols` enum, or if you keep `import log_symbols`, access the enum as `log_symbols.LogSymbols` (e.g., `log_symbols.LogSymbols.SUCCESS.value`).

AttributeError: 'LogSymbols' object has no attribute 'success'

The symbols within the `LogSymbols` Enum (e.g., `SUCCESS`, `INFO`, `WARNING`, `ERROR`) are defined in uppercase, and Python is case-sensitive.

fix

Use the correct uppercase casing for the symbol names: `LogSymbols.SUCCESS.value`.

log-symbols characters not displaying correctly on Windows

The default Windows Command Prompt (CMD) and some other terminals may have limited support for displaying Unicode characters (like ✓, ✖, ℹ, ⚠) that `log-symbols` uses.

fix

Use a Unicode-compatible terminal like Windows Terminal, PowerShell, or Git Bash. If using CMD, ensure the font is set to a Unicode-aware font (e.g., Consolas) and try setting the console's codepage to UTF-8 by running `chcp 65001` before executing your Python script.

Upgrade

Version history

0.0.14latest on PyPI · released Aug 8, 2019

Audit

Dependencies

No dependency data recorded yet.

Agent activity

13 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/manrajgrover/py-log-symbols ↗

packagehttps://pypi.org/project/log-symbols/ ↗