Metadata-Version: 2.5
Name: xiaoyi-utils
Version: 0.1.3
Summary: 一个用于学习 Python 公共库构建和发布的示例工程
Requires-Python: >=3.14
Requires-Dist: markdown>=3.5
Requires-Dist: python-dateutil>=2.8
Description-Content-Type: text/markdown

# xiaoyi-utils

一个用于学习 Python 公共库构建和发布的示例工程，提供常用工具函数。

## 安装

```bash
pip install -e .
```

## 模块说明

### date — 日期时间

```python
from xiaoyi_utils.date import parse_date, format_datetime, add_days, diff_days

dt = parse_date("2026-09-03")
print(format_datetime(dt, "%Y年%m月%d日"))
print(add_days(dt, 7))
print(diff_days("2026-01-01", "2026-09-03"))
```

### markdown — Markdown 处理

```python
from xiaoyi_utils.markdown import md_to_html, md_to_plain

html = md_to_html("# Hello **world**")
plain = md_to_plain("# Hello **world**")
```

### text — 文本处理

```python
from xiaoyi_utils.text import truncate, slugify, camel_to_snake

print(truncate("这是一段很长的文本", 6))
print(slugify("Hello World 你好"))
print(camel_to_snake("UserProfile"))
```

### hash — 哈希摘要

```python
from xiaoyi_utils.hash import md5, sha256, file_hash

print(sha256("hello"))
print(file_hash("README.md"))
```

### json_util — JSON 工具

```python
from xiaoyi_utils.json_util import safe_loads, pretty_dumps, read_json, write_json

data = safe_loads('{"name": "xiaoyi"}', default={})
print(pretty_dumps(data))
```
