saad-z

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

from saad_z import ZstdDecompressor, ZstdCompressionDict, DICT_TYPE_AUTO

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

التثبيت

python -m pip install saad-z

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

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

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))

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

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، وتظل شروطه سارية على الاعتماد المثبت.