Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

log78-2.1.3.tar.gz (16.0 kB view details)

Uploaded Source

Built Distribution

log78-2.1.3-py3-none-any.whl (18.6 kB view details)

Uploaded Python 3

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

Hashes for log78-2.1.3.tar.gz
Algorithm Hash digest
SHA256 622dc2cb4f34ba803a572956eb554e04895d8aa48b8d9a3f5a7f69605e40b5bc
MD5 8ca46bb1667a18043fc21865fb815665
BLAKE2b-256 4d525d5a32a989c325151034acdc5d8d8c0888d9ab22813901e65603482e74f1

See more details on using hashes here.

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

Hashes for log78-2.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 eaf88ddd4f1c676dee2682a0d646086c26ea2fcebb691988bd7126bbee3ebbd8
MD5 2db3432899275326fcbd943bffe2282f
BLAKE2b-256 7324ac23aa8b55d70ab45c04fa30017bfe05287d274ed3d5ec62211a05151bf6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page