A flexible Python logging library supporting console, file, and server logging.
Project description
Log78
Log78 is a flexible Python logging library that supports console, file, and server logging.
Installation
Install Log78 using pip:
pip install log78
Quick Start
Log78 provides two ways to log messages: a simple method for quick logging and a more detailed method using LogEntry
objects. Here's how to get started with the simple method:
from log78 import Log78
# Get the Log78 instance - no setup required!
log = Logger78.instance()
# Log a simple message
await log.INFO("Hello, Log78!")
# Log with a summary and custom level
await log.WARN("This is a warning", "Warning Summary", 60)
For more detailed logging, you can use the LogEntry
object:
from log78 import LogEntry, BasicInfo
log_entry = LogEntry(basic=BasicInfo(message="Detailed log message", summary="Log Summary"))
await log.INFO(log_entry)
Both methods are ready to use out of the box with default console and file logging.
Advanced Configuration (Optional)
If you need custom logging behavior, you can use the setup
method:
from log78 import Logger78. ServerLog78, FileLog78, ConsoleLog78
# Create custom logger instances if needed
server_logger = ServerLog78()
file_logger = FileLog78("custom_logfile")
console_logger = ConsoleLog78()
# Setup custom loggers
log = Logger78.instance()
log.setup(server_logger, file_logger, console_logger)
Properties
debug_kind
: A set of log debugging keywords used to control which types of logs are recorded.level_file
,level_console
,level_api
: Respectively represent the threshold levels for file logs, console logs, and API logs.debug_entry
: Used to set more fine-grained debugging conditions.
Suggested Log Levels
- DEBUG (10): Detailed debug information, typically used only in development environments
- INFO (30): General information, can be used to track normal application operations
- WARN (50): Warning information, indicating potential issues but not affecting main functionality
- ERROR (60): Errors and serious problems that require immediate attention
Example: Adjusting Log Levels
from log78 import Logger78. LogEntry, BasicInfo
log = Logger78.instance()
# Adjust console log level to 0 to print all logs (for debugging)
log.level_console = 0
# Adjust file log level to 60 to only record more severe warnings and errors
log.level_file = 60
# Using different levels to record logs
log_entry = LogEntry(basic=BasicInfo(message="Debug information"))
await log.DEBUG(log_entry) # Will only output to console
log_entry.basic.message = "General information"
await log.INFO(log_entry) # Will output to console, not recorded in file
log_entry.basic.message = "Warning"
await log.WARN(log_entry) # Will be recorded in both console and file
log_entry.basic.message = "Error"
await log.ERROR(log_entry) # Will be recorded in console, file, and API
Methods
DEBUG
,INFO
,WARN
,ERROR
: Record logs of different levels.ERROR(Exception, LogEntry)
: Records exception error logs.
Using the LogEntry Class
The LogEntry
class provides structured information for detailed logging:
from log78 import Logger78. LogEntry, BasicInfo, EventInfo, HttpInfo
log_entry = LogEntry()
log_entry.basic = BasicInfo(
summary="User login successful",
log_level_number=30,
log_level="INFO",
message="User johndoe successfully logged into the system",
service_name="AuthService",
user_id="user123",
user_name="johndoe"
)
log_entry.event = EventInfo(
event_category="authentication",
event_action="login",
event_outcome="success"
)
log_entry.http = HttpInfo(
http_request_method="POST",
http_request_body_content="{\"username\":\"johndoe\",\"password\":\"*****\"}",
http_response_status_code=200,
url_original="https://api.example.com/login"
)
# Add custom properties
log_entry.add_property("customField", "customValue")
await log.INFO(log_entry)
Other
For more detailed information, please refer to the project's GitHub repository or the API documentation.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file log78-2.1.3.tar.gz
.
File metadata
- Download URL: log78-2.1.3.tar.gz
- Upload date:
- Size: 16.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 622dc2cb4f34ba803a572956eb554e04895d8aa48b8d9a3f5a7f69605e40b5bc |
|
MD5 | 8ca46bb1667a18043fc21865fb815665 |
|
BLAKE2b-256 | 4d525d5a32a989c325151034acdc5d8d8c0888d9ab22813901e65603482e74f1 |
File details
Details for the file log78-2.1.3-py3-none-any.whl
.
File metadata
- Download URL: log78-2.1.3-py3-none-any.whl
- Upload date:
- Size: 18.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | eaf88ddd4f1c676dee2682a0d646086c26ea2fcebb691988bd7126bbee3ebbd8 |
|
MD5 | 2db3432899275326fcbd943bffe2282f |
|
BLAKE2b-256 | 7324ac23aa8b55d70ab45c04fa30017bfe05287d274ed3d5ec62211a05151bf6 |