ddata 0.2.4

A Python data package

ddata

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

功能特性

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

安装

pip install ddata

快速开始

日期工具

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

日志工具

from ddata import log

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

Pandas 配置

from ddata import pd

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

密码生成

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           # 测试模块

开发

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

# 运行测试
pytest

作者

flyphant - [e-mail]

许可证

MIT License