Metadata-Version: 2.1
Name: multikiwilogger
Version: 1.0.8
Summary: This is a multilogger for LogTail, File and terminal print
Author: OZRay
Author-email: d@404.kiwi
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.0
Description-Content-Type: text/markdown
License-File: LICENSE

KiwiLogger
A simple Python logger class that logs messages to Logtail, a local file, and/or the terminal. Easily configurable and customizable.

Features
Log messages to Logtail (an online logging service)
Log messages to a local file
Log messages to the terminal (stdout)
Specify the logging level (e.g., INFO, ERROR, CRITICAL)
Add structured logging (extra data) to log messages

Installation
Before using KiwiLogger, you need to install the multikiwilogger library:

bash
Copy code
pip install multikiwilogger

Usage
python

Copy code
from multikiwilogger import KiwiLogger

# Initialize the logger
mlog = KiwiLogger(log_online=True, log_local=True, log_terminal=True)

# Log a simple message
mlog('This is an INFO message.')  # Defaults to INFO level

# Log a message with a specific level
mlog('Something bad happened.', level='ERROR')

# Log a message with structured logging (extra data)
mlog('Log message with structured logging.', level='INFO', extra={
    'item': "Orange Soda",
    'price': 100.00
})

Configuration
Initialize the KiwiLogger with the following optional parameters:

name (default: __name__): The name of the logger.
level (default: logging.INFO): The minimum log level for messages.
log_online (default: True): Log messages to Logtail.
log_local (default: False): Log messages to a local file.
log_terminal (default: True): Log messages to the terminal (stdout).

Environment Variables
KiwiLogger relies on the LOGTAIL_SOURCE_TOKEN environment variable to send logs to Logtail. Set this variable in your environment or add it to a .env file:

makefile
Copy code
LOGTAIL_SOURCE_TOKEN=your_logtail_source_token_here
Replace your_logtail_source_token_here with the actual source token provided by Logtail.

License
This project is licensed under the MIT License.
