Metadata-Version: 2.4
Name: saad-z
Version: 0.1.0
Summary: A SAAD-branded compatibility facade for the zstandard Python API
Author: SAAD
License: BSD-3-Clause
Project-URL: Homepage, https://pypi.org/project/saad-z/
Project-URL: Upstream, https://github.com/indygreg/python-zstandard
Keywords: saad,zstandard,zstd,compression
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: System :: Archiving :: Compression
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: zstandard>=0.25.0

# saad-z

حزمة Python باسم **saad_z** تعيد تصدير واجهة `zstandard` تحت اسم جديد:

```python
from saad_z import ZstdDecompressor, ZstdCompressionDict, DICT_TYPE_AUTO
```

الحزمة نفسها غلاف خفيف، بينما تنفيذ الضغط وفك الضغط يأتي من مشروع `zstandard` الأصلي. لذلك تحافظ على الأداء والتوافق بدل إعادة تنفيذ محرك Zstandard.

## التثبيت

```bash
python -m pip install saad-z
```

يتطلب التثبيت محرك `zstandard` الثنائي المتوافق مع إصدار Python ونظام التشغيل. على Pydroid 3 أو Android قد لا يتوفر wheel جاهز، وعندها قد يفشل التثبيت ما لم تتوفر أداة بناء مناسبة للامتداد الأصلي.

## ضغط وفك ضغط بسيط

```python
from saad_z import ZstdCompressor, ZstdDecompressor

source = b"SAAD compression example " * 100
compressed = ZstdCompressor(level=3).compress(source)
restored = ZstdDecompressor().decompress(compressed)
assert restored == source
print(len(source), len(compressed))
```

## استخدام الأسماء المطلوبة

```python
from saad_z import ZstdDecompressor, ZstdCompressionDict, DICT_TYPE_AUTO

raw_dictionary = b"SAAD dictionary data " * 20
dictionary = ZstdCompressionDict(raw_dictionary, dict_type=DICT_TYPE_AUTO)
print(dictionary.dict_id())
print(len(dictionary.as_bytes()))
```

## ملاحظات التوافق

تتوفر بقية الأسماء العامة في `zstandard` تلقائيًا عبر `saad_z`، بما فيها `ZstdCompressor` و`ZstdCompressionParameters` و`train_dictionary` عند توفرها في الإصدار المثبت.

هذه الحزمة لا تنسخ كود `zstandard` الأصلي؛ بل تعتمد عليه كاعتماد خارجي. راجع ترخيص zstandard upstream من الرابط التالي:

<https://github.com/indygreg/python-zstandard>

## الترخيص

كود واجهة saad_z مرخص MIT. أما محرك zstandard فهو مشروع مستقل بترخيص BSD-3-Clause، وتظل شروطه سارية على الاعتماد المثبت.
