Skip to main content

A simple and customizable logging library for Python.

Project description

LogAssist

A simple and customizable logging library for Python.

Installation

pip install LogAssist

Features

  • Easy to use and configure
  • Supports multiple log levels (debug, info, warning, error)
  • Outputs log messages to both console and file
  • Allows for log file removal on initialization
  • Provides datetime formatting for log messages

Usage

  1. Import the Logger class:
import LogAssist.log as Logger
  1. Initialize the logger with your desired settings:
Logger.logger_init(config=my_config_dictionary)
# or
Logger.logger_init()
  1. Use the logger in your code:
Logger.verbose('MyTag', 'This is a verbose message')
Logger.debug('MyTag', 'This is a debug message')
Logger.info('MyTag', 'This is an info message')
Logger.warn('MyTag', 'This is a warning message')
Logger.error('MyTag', 'This is an error message')
Logger.exception('MyTag', 'This is a exception message')

Configuration

You can configure the logger using a JSON configuration. Below is an example of a configuration and explanations for each field.

Example Usage:

{
    "base": {
        "name": "MyLogger",
        "level": "debug",
        "trace_output": "true"
    },
    "console": {
        "level": "debug",
        "format": "%(asctime)s[%(levelname)s]%(message)s"
    },
    "file_timed": {
        "level": "info",
        "format": "%(asctime)s[%(levelname)s]%(message)s",
        "file_name": "default.log",
        "when": "midnight",
        "interval": 1,
        "backup_count": 30
    }
}

Configuration Fields

base

  • name: The identifier for the logger. Default is 'MyLogger'.
  • level: The minimum log level to set (debug, info, warn, error, exception). Default is 'debug'.

console

  • level: The minimum log level for console output (debug, info, warn, error, exception). Default is 'debug'.
  • format: Defines the log message format for console output. Default is %(asctime)s[%(levelname)s]%(message)s.

file_timed

  • level: The minimum log level for file output (debug, info, warn, error, exception). Default is 'info'.
  • format: Defines the log message format for file output. Default is %(asctime)s[%(levelname)s]%(message)s.
  • file_name: The file name to use for logging. Default is 'default.log'.
  • when: The time interval for rotating the log file (e.g., 'midnight'). Default is 'midnight'.
  • interval: Defines how often the log file is rotated. Default is 1.
  • backup_count: Specifies the number of backup files to keep. Default is 30.

Use this JSON configuration to initialize your logger with the desired settings.

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

logassist-1.1.5.tar.gz (4.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

logassist-1.1.5-py3-none-any.whl (4.6 kB view details)

Uploaded Python 3

File details

Details for the file logassist-1.1.5.tar.gz.

File metadata

  • Download URL: logassist-1.1.5.tar.gz
  • Upload date:
  • Size: 4.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for logassist-1.1.5.tar.gz
Algorithm Hash digest
SHA256 e1bf6c0933d871fd6db0cdc40bb2e22d0356526ea7c6c647faaf89f06ae58968
MD5 c022cd998261e036da3c2dbc1de47290
BLAKE2b-256 5b02083f2ecc4d7d7277d18c359dc5e9106b319c685029939b36894491eb414a

See more details on using hashes here.

File details

Details for the file logassist-1.1.5-py3-none-any.whl.

File metadata

  • Download URL: logassist-1.1.5-py3-none-any.whl
  • Upload date:
  • Size: 4.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for logassist-1.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 b4124d65de0c51ab558e0ea394c080f140e68307639dff8a8d652f6fd5a0fcb2
MD5 7826b2c4c5705dc081b6c9fbd56974d0
BLAKE2b-256 0bc1016d11610948cbc10ebcef22a7c449d050d8e074f218612a72de312b8bff

See more details on using hashes here.

Supported by

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