Metadata-Version: 2.1
Name: ddata
Version: 0.2.3
Summary: A Python data package
Home-page: https://github.com/flyphant/ddata
Author: flyphant
Author-email: 576938286@qq.com
Keywords: python,package,sample
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6, <4
Description-Content-Type: text/markdown
Requires-Dist: numpy
Provides-Extra: dev
Requires-Dist: pytest >=3.7 ; extra == 'dev'

# ddata

一个简单实用的 Python 工具包，提供了日期处理、日志记录、pandas 配置和密码生成等常用功能。

## 功能特性

- **日期工具 (date)**: 提供常用的日期处理功能，如获取今天/昨天、日期格式化、日期加减等
- **日志工具 (loggor)**: 简单易用的日志记录封装
- **Pandas 配置 (pandas)**: 预配置的 pandas 实例，自动设置显示选项
- **密码生成 (password)**: 安全的随机密码生成器

## 安装

```bash
pip install ddata
```

## 快速开始

### 日期工具

```python
from ddata import date

# 获取今天日期
print(date.get_today())  # 例如: 20260605

# 获取昨天日期
print(date.yesterday())  # 例如: 20260604

# 获取当前时间
print(date.now())  # 例如: 2026-06-05 14:30:45.123

# 计算 n 天前/后的日期
print(date.n_day_ago("20260605", 7))  # 20260529
print(date.n_day_later("20260605", 7))  # 20260612

# 日期格式化
print(date.today("%Y-%m-%d"))  # 2026-06-05
print(date.date_2_hyphen_date("20260605"))  # 2026-06-05

# 计时器装饰器
@date.timer
def my_function():
    # 你的代码
    pass
```

### 日志工具

```python
from ddata import log

log.info("这是一条信息日志")
log.warn("这是一条警告日志")
log.error("这是一条错误日志")
```

### Pandas 配置

```python
from ddata import pd

# pd 是已经配置好的 pandas 实例，会自动显示所有行列
df = pd.DataFrame(...)  # 直接使用即可
print(df)
```

### 密码生成

```python
from ddata.password import generate_random_password

# 生成默认 12 位包含特殊字符的密码
password = generate_random_password()
print(password)

# 生成 16 位不包含特殊字符的密码
password = generate_random_password(16, include_special_chars=False)
print(password)
```

## 项目结构

```
ddata/
├── __init__.py       # 包初始化，导出主要功能
├── date.py           # 日期工具
├── loggor.py         # 日志工具
├── pandas.py         # Pandas 配置
├── password.py       # 密码生成
└── test.py           # 测试模块
```

## 开发

```bash
# 安装开发依赖
pip install -e ".[dev]"

# 运行测试
pytest
```

## 作者

flyphant - 576938286@qq.com

## 许可证

MIT License
