Metadata-Version: 2.4
Name: uel-toolcraft
Version: 0.1.0
Summary: A Unified Essential Library toolcraft (uel-toolcraft) for personal usage.
Author: Samuel
License: MIT
License-File: LICENSE
Keywords: models,tools,utilities
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Requires-Dist: json5>=0.9.0
Requires-Dist: pycryptodome>=3.15.0
Requires-Dist: requests>=2.28.0
Provides-Extra: all
Requires-Dist: ffmpeg-python>=0.2.0; extra == 'all'
Requires-Dist: gitpython>=3.1.0; extra == 'all'
Requires-Dist: pyqt6>=6.5.0; extra == 'all'
Requires-Dist: rclone-python>=0.1.0; extra == 'all'
Requires-Dist: supabase>=2.0.0; extra == 'all'
Requires-Dist: upstash-redis>=0.1.0; extra == 'all'
Provides-Extra: ffmpeg
Requires-Dist: ffmpeg-python>=0.2.0; extra == 'ffmpeg'
Provides-Extra: git
Requires-Dist: gitpython>=3.1.0; extra == 'git'
Provides-Extra: pyqt
Requires-Dist: pyqt6>=6.5.0; extra == 'pyqt'
Provides-Extra: rclone
Requires-Dist: rclone-python>=0.1.0; extra == 'rclone'
Provides-Extra: redis
Requires-Dist: upstash-redis>=0.1.0; extra == 'redis'
Provides-Extra: supabase
Requires-Dist: supabase>=2.0.0; extra == 'supabase'
Description-Content-Type: text/markdown

# uel-toolcraft

A Unified Essential Library toolcraft for personal usage.

## Installation

```bash
pip install uel-toolcraft
```

Install with optional dependencies:

```bash
# All optional dependencies
pip install uel-toolcraft[all]

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

Local development install:

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

## Usage

### Models

```python
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

```python
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

```bash
uel-toolcraft --version
python -m uel_toolcraft --version
```

## Optional Dependencies

| Extra | Packages | Used by |
|---|---|---|
| `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
