Metadata-Version: 2.1
Name: cprintf
Version: 0.0.7
Summary: Printing and debugging with color
Home-page: https://github.com/wang-zhibo/cprintf
Author: gm.zhibo.wang
Author-email: gm.zhibo.wang@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown


## cprintf

## 安装

`pip install cprintf`

## 使用方法

```python
import cprintf
from time import sleep

# 设置日志级别
cprintf.set_log_level('DEBUG')  # 可选: DEBUG, INFO, WARNING, ERROR, FATAL

# 基本打印功能
cprintf.info("普通字符串")
cprintf.info('{"hello": "world", "list": [1, 2, 3]}')
cprintf.info({"hello": "world", "list": [1, 2, 3]})
cprintf.warn({"warn_key": True})
cprintf.err("这是一条错误信息", format_mode='pprint')
cprintf.fatal("This is a fatal error.")
cprintf.ok('强制使用 pprint 模式', format_mode='pprint')
cprintf.debug('强制使用 raw 模式', format_mode='raw')

# 带时间戳的日志
cprintf.info("这是一条带时间戳的信息", timestamp=True)

# 分割线
cprintf.line()
cprintf.line(char='=', length=60, color='OK')

# 自定义颜色
cprintf.custom("This is a custom color message in cyan!", "\033[96m")

# 进度条
for i in range(100):
    sleep(0.1)
    cprintf.progress_bar(i + 1, 100, prefix='进度:', suffix='完成', length=50)

# 打印表格
data = [
    [1, "Alice", 25],
    [2, "Bob", 30],
    [3, "Charlie", 35]
]
cprintf.print_table(data, headers=["ID", "Name", "Age"], color='INFO')

# 获取带颜色的字符串（不打印）
colored_str = cprintf.get_colored_string("这是一个带颜色的字符串", color='WARNING')
print(colored_str)
```

## 功能说明

- **日志级别控制**：通过 `set_log_level()` 设置日志级别，低于该级别的日志将不会显示
- **时间戳**：在日志信息前添加时间戳，使用 `timestamp=True` 参数
- **进度条**：使用 `progress_bar()` 方法显示进度条
- **表格打印**：使用 `print_table()` 方法打印整齐的表格
- **自定义颜色**：使用 `custom()` 方法自定义颜色，或使用 `get_colored_string()` 获取带颜色的字符串
- **格式化模式**：支持 `raw`、`json`、`pprint` 和 `auto` 四种格式化模式
```

