uel-toolcraft 0.1.2

A Unified Essential Library toolcraft (uel-toolcraft) for personal usage.

uel-toolcraft

A Unified Essential Library toolcraft for personal usage.

Installation

pip install uel-toolcraft

Install with optional dependencies:

# Core only (explicit — same as pip install uel-toolcraft)
pip install uel-toolcraft[core]

# All optional dependencies (excludes PyQt6 — install [pyqt] separately if needed)
pip install uel-toolcraft[all]

# Specific extras
pip install uel-toolcraft[pyqt,ffmpeg,git]

# Everything including PyQt6
pip install uel-toolcraft[all,pyqt]

Local development install:

git clone https://github.com/iShengren/uel-toolcraft.git
cd uel-toolcraft
uv pip install -e ".[all]"

---

Usage

Models

from uel_toolcraft.models import AESCipher, SQLiteHelper, BarkClient

cipher = AESCipher("my-secret-key")
db = SQLiteHelper("mydb.sqlite")
bark = BarkClient("https://bark.example.com", "device_key")

Tools

from uel_toolcraft.tools import read_json_file, write_json_file, md5sum

data = read_json_file("config.json")
checksum = md5sum("large_file.bin")
write_json_file({"key": "value"}, "output.json")

CLI

uel-toolcraft --version
python -m uel_toolcraft --version

---

Logging

LogConfig 提供彩色控制台日志 + 可选文件日志，并自动屏蔽吵杂的第三方库日志。

from uel_toolcraft.models import LogConfig

LogConfig(level=logging.INFO, log_file="app.log", block_loggers=["noisy_lib_1", "noisy_lib_2"])

屏蔽第三方库日志 — 在项目的 pyproject.toml 中配置：

[tool.uel-toolcraft.logging]
block_loggers = ["boto3", "azure.core", "googleapiclient"]

也可以通过参数显式传入：

LogConfig(level=logging.INFO, log_file="app.log", block_loggers=["noisy_lib_1", "noisy_lib_2"])

合并规则：内置默认 (httpx, urllib3) + pyproject.toml 中的 + 参数传入的 → 三源并集自动去重。

get_logger 在配置 LogConfig 的同时返回 logging.Logger 对象

---

Optional Dependencies

Extra	Packages	Used by
core	(none)	Explicit core-only install
pyqt	PyQt6	PyQtAsyncHelper, ui_tools
ffmpeg	ffmpeg-python	ffmpeg_tools
rclone	rclone-python	rclone_tools
supabase	supabase	supabase_tools
git	GitPython	git_tools
redis	upstash-redis	redis_upstash

---

License

MIT