Metadata-Version: 2.1
Name: dou-utils
Version: 0.1.1
Summary: The utility package of Dou Co., Ltd.
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: loguru>=0.7.2
Requires-Dist: pydantic>=2.10.2

# DouLogger

A simple and flexible Python logging utility with enhanced features for structured logging.

## Features

- **Easy-to-use logging methods**: `info`, `debug`, `warning`, `error`.
- **Structured logging support**: Pass additional metadata with your log messages.
- **Configurable logging levels**: Control the verbosity of your logs.

## Installation

Install DouLogger directly from the GitHub repository:

```bash
pip install git+https://github.com/douinc/dou-python-utils.git@v0.1.0
```

### Quick Start

Import the logger from the dou package:

```python
from dou import logger
```

### Basic Logging

Log messages at different severity levels:

```python
logger.info("This is an info message")
logger.debug("This is a debug message")
logger.warning("This is a warning message")
logger.error("This is an error message")
```

### Structured Logging

Include additional metadata in your logs for better traceability:

```python
logger.info(
    message={
        "event": "user_signup",
        "user_id": 12345,
    },
    search_id="abcde12345",
)
```

### License

This project is licensed under the MIT License - see the LICENSE file for details.

### Contact

For questions or suggestions, please open an issue or contact us at team@dou.so
