Metadata-Version: 2.1
Name: eazylogger
Version: 24.9
Summary: A simple module to add color to Python log messages.
Author: Aric Kraft
Project-URL: Homepage, https://github.com/aeazy/eazylogger
Project-URL: Issues, https://github.com/aeazy/eazylogger/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# EazyLogger

A simple module to add color to Python log messages.

## Table of Contents

- [Installation](#installation)
- [Logger](#logger)
- [Examples:](#examples)
  - [Basic Example](#basic-example)
  - [Using Parameters](#using-parameters)

## Installation

Binary installer is available at the [Python Package Index (PyPi)](#).

```bash
pip install eazylogger
```

## Logger

> Parameters
> <strong id='Logger'>Logger</strong>(<b>name</b>, <b>msg_fmt</b><i>="[%(levelname)s] - %(message)s (%(name)s)"</i>, <b>info_fmt</b><i>="%(message)s"</i>)

Logger class with color-coded log messages.

> Parameters

<ul style='list-style: none'>
	<li id='Logger-name'>
		<b>name : <i>str</i></b>
		<ul style='list-style: none'>
			<li id='Logger-name-description'>String expression representing the name of the logger class.</li>
		</ul>
	</li>
</ul>
<ul style='list-style: none'>
	<li id='Logger-msg_fmt'>
		<b>msg_fmt : <i>str, default [%(levelname)s] - %(message)s (%(name)s)</i></b>
		<ul style='list-style: none'>
			<li id='Logger-msg_fmt-description'>String expression representing how the debug, warning, error, and critical log messages are formatted. Defaults to "[%(levelname)s] - %(message)s (%(name)s)".</li>
		</ul>
	</li>
</ul>
<ul style='list-style: none'>
	<li id='Logger-info_fmt'>
		<b>info_fmt : <i>str, default %(message)s</i></b>
		<ul style='list-style: none'>
			<li id='Logger-info_fmt-description'>String expression representing how the info and success messages are formatted. Defaults to "%(message)s".</li>
		</ul>
	</li>
</ul>

<hr>

## Examples

- [Basic Example](#basic-example)
- [Using parameters](#customization):
  - [`name`](#name-parameter)

### Basic Example

1. Import and instantiate `Logger` class:

   ```python
   # main.py
   from eazylogger import Logger
   logger = Logger(__name__)
   ```

2. Logging methods:

   ```python
   # main.py
   logger.debug("Example debug message")
   logger.info("Example info message")
   logger.warn("Example warning message")
   logger.error("Example error message")
   logger.critical("Example critical message")
   logger.success("Example success message")
   ```

<p align='center'>
<img src="/assets/images/exampleOutput.png" />
</p>

### Using Parameters

- #### `name`:

  ```python
  logger = Logger("customName")
  logger.debug("Example debug message with customName")
  ```

  ```bash
  [DEBUG] - Example debug message with customName (customName)
  ```

- #### `msg_fmt`:

  - Sets the message format for `logger.debug`, `logger.warn`, `logger.error`, and `logger.critical`.

  - For full list of keyword arguments see [the docs](https://docs.python.org/3/library/logging.html#logrecord-attributes)

  ```python
  logger = Logger(
    __name__,
    msg_fmt="%(asctime)s %(message)s [%(pathname)s]",
  )
  logger.debug("Example debug message with custom msg_fmt")
  ```

  ```bash
  2000-01-01 12:00:00,000 Example debug message with custom msg_fmt [~\main.py]
  ```

- #### `info_fmt`
  - Sets the message format for `logger.info` and `logger.success`.
  ```python
  logger = Logger(
    __name__,
    info_fmt="[%(levelname)s] - %(message)s (%(name)s)",
  )
  logger.info("Example info message with custom info_fmt")
  ```
  ```bash
  [INFO] - Example info message with custom info_fmt (__main__)
  ```
