Metadata-Version: 2.4
Name: zDataBase
Version: 0.1
Summary: This project is designed to simplify working with the sqlite3 database, offers extensive features, and supports all types in Python.
Home-page: https://github.com/OandONE/zdb
Author: seyyed mohamad hosein moosavi raja(01)
Author-email: mohamadhosein159159@gmail.com
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: aiosqlite
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# ZDB - پایگاه داده Key-Value سبک بر پایه SQLite

ZDB یک دیتابیس **Key-Value ساده و سبک** با استفاده از SQLite است.  
این کتابخانه امکاناتی مثل **ذخیره‌سازی خودکار، صف تغییرات (queue)، کش داخلی، عملیات اتمیک و پشتیبانی از مدل‌ها** را فراهم می‌کند تا ذخیره‌سازی محلی سریع و راحت باشد، بدون نیاز به دیتابیس کامل.

![icon](https://zdb.parssource.ir/icon.ico)

---

## ویژگی‌ها / Features

- رابط کاربری ساده Key-Value (`db[key] = value`)  
- پشتیبانی از انواع داده‌ها: `int`, `str`, `float`, `list`, `dict` و ساختارهای تو در تو  
- **Proxy types**: `ZValue`, `ZList`, `ZDict` برای track خودکار تغییرات و ذخیره‌سازی  
- ذخیره خودکار و **صف تغییرات** برای عملکرد بهتر  
- **کش داخلی** برای افزایش سرعت خواندن داده‌ها  
- پشتیبانی از **backup** دستی یا دوره‌ای  
- عملیات اتمیک (`increment`, `append_if_not_exists`)  
- مدیریت تراکنش‌ها (`with db.transaction():`)  
- پشتیبانی اختیاری از **Model** با type hints و multi-table  
- پشتیبانی از namespace برای چند جدول در یک دیتابیس  
- رمزگذاری اختیاری با SQLCipher  
- نسخه سینک (sync) کامل، نسخه async جداگانه

---

## نصب / Installation

نسخه سینک ZDB با کتابخانه‌های داخلی پایتون کار می‌کند:  
`sqlite3`, `json`, `threading`, `os`, `shutil` و غیره.  

```bash
pip install zdb
```
