Metadata-Version: 2.4
Name: liwancai-PyLog
Version: 1.0.1
Summary: 一个基于 logbook 的彩色日志库，支持多种日志级别和日志文件自动分割
Author-email: liwancai <248411282@qq.com>
Maintainer-email: liwancai <248411282@qq.com>
License: MIT
Keywords: log,logging,logbook,color,日志
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Logging
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: logbook>=1.5.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"

# PyLog

一个基于 logbook 的彩色日志库，支持多种日志级别和日志文件自动分割。

## 安装

```bash
pip install liwancai-PyLog
```

## 快速使用

```python
from LOG import log

log.Info("This is an info message")
log.Debug("This is a debug message")
log.Error("This is an error message")
log.Warn("This is a warning message")
log.Critical("This is a critical message")
```

## 日志级别

| 方法 | 级别 | 颜色 |
|------|------|------|
| `Info()` | INFO | 绿色 |
| `Debug()` | DEBUG | 青色 |
| `Error()` | ERROR | 红色 |
| `Warn()` | WARNING | 黄色 |
| `Critical()` | CRITICAL | 紫色 |
| `Notice()` | NOTICE | 橙色 |
| `Trace()` | TRACE | 默认 |

## 设置终端日志级别

终端日志级别只影响控制台输出，不影响文件保存（文件始终记录所有级别）。

```python
from LOG import log

# 设置终端只显示 INFO 及以上级别
log.set_console_level('INFO')

# 设置终端只显示 WARNING 及以上级别
log.set_console_level('WARNING')

# 设置终端只显示 ERROR 及以上级别
log.set_console_level('ERROR')

# 获取当前终端日志级别
print(log.get_console_level_name())  # 输出: INFO
```

### 日志级别优先级（从低到高）

```
CRITICAL = 15
ERROR = 14
WARNING = 13
NOTICE = 12
INFO = 11
DEBUG = 10
TRACE = 9
NOTSET = 0
```

设置某个级别后，只会显示该级别及更高级别的日志。

## 特性

- 控制台彩色输出
- 日志文件按日期自动分割
- 支持多种日志级别
- 自动创建日志目录
- 支持动态设置终端日志级别（不影响文件保存）

## 依赖

- logbook >= 1.5.0

## License

MIT
