Skip to main content

UsefulLog

Yet another logging library - made by BravestCheetah, Used by BravestCheetah

The main class

Everything in this library builds upon the Logger class: from usefullog.logger import Logger

The Logger Class

To use the tool you first gotta initialize an instance of the Logger class, you can do it just like this, including the name of the project:

logger = Logger("My Awesome Project")

When logging simple data like this: logger.log("cool logs") youll get some output like this:

2025-08-16 12:51:00 ( Test ) | [LOG] cool logs

There are other log formats too! Here they are:

.info("This is some info") - 2025-08-16 12:51:00 ( Test ) | [INFO] This is some info

.warn("You have been warned!") - 2025-08-16 12:51:00 ( Test ) | [WARN] You have been warned!

.error("Something went wrong :(") - 2025-08-16 12:51:00 ( Test ) | [ERROR] Something went wrong :(

.critical("CRITICAL ERROR") - 2025-08-16 12:51:00 ( Test ) | [CRITICAL] CRITICAL ERROR

.raw("only contents :O") - only contents :O

.space() - Newline (\n)

All logs are colored using the termcolor library which should be compatible with your terminal - Not visible in the documentation, but its there :D

Customization

But the logger does have multiple optional arguments to customize your logs. Lets list them:

1. Subname - Logger("My Awesome Project", sub_name="cool subsystem")

Result: 2025-08-16 12:55:19 ( Test/cool subsystem ) | [LOG] This is a test log

Useful for separating different systems or parts of your codebase for easier debugging.

2. Disable Timestamps - logger = Logger("Test", do_timestamps=False)

Result: ( Test ) | [LOG] This is a test log

Useful to declutter logs if timestamps arent necessary, makes the logs look more clean

3. Save Logs - logger = Logger("Test", do_log_saving=True)

Saves Logs Into .log files by default in the /logs folder. Each new instance of the Logger class creates a new log file.

Useful for saving and sharing logs

4. Disable Log Printing - logger = Logger("Test", print_logs=False)

Disables printing for logs, when paired with log saving you can safely store logs without filling the terminal.

5. Color Saved Logs - logger = Logger("Test", do_saved_log_decolouring=False)

When False the argument will keep the coloruing characters in the save folder, though most text editors may display these as normal characters and not colour them colours can be viewed when using a tool like cat to print the contents to the terminal directly.

6. Change Log Folder - logger = Logger("Test", log_save_folder="other folder")

When used logs will be saved in that path instead of the default /logs

Metadata

Release files for usefullog 0.8.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for usefullog 0.8.7
File Size Uploaded Provenance Actions
usefullog-0.8.7.tar.gz 3.1 kB Without provenance Details for usefullog-0.8.7.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for usefullog 0.8.7
File Interpreter ABI Platform Actions
usefullog-0.8.7-py3-none-any.whl Python 3 none any Details for usefullog-0.8.7-py3-none-any.whl

Total release size: 6.3 kB

Release files / usefullog-0.8.7.tar.gz

Download URL usefullog-0.8.7.tar.gz
Size 3.1 kB
Tags Source
SHA-256 checksum
How to use checksums
c20bbd595028b8740bbf1bc5d95cce606f0989a2bf4a8695b309604f0d40f44b
BLAKE2b-256 checksum
How to use checksums
44fc32f8afc7498b3486c45a52aaad1e0ad542e263d73ed6a014f06ab7173c97
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.8.11

Release files / usefullog-0.8.7-py3-none-any.whl

Download URL usefullog-0.8.7-py3-none-any.whl
Size 3.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
23fdf4a22384f3f05be4bef14e80a55c8092a58d4b9713b4f0ba0d8c908e276d
BLAKE2b-256 checksum
How to use checksums
be0b2ac598904c1692f55772a684fd5f6aa52120588ad260153efdad3e25bafb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.8.11

Security for usefullog 0.8.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page