tasalsul 0.2.0__tar.gz

tasalsul-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tasalsul Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tasalsul-0.2.0/PKG-INFO

@@ -0,0 +1,244 @@
+Metadata-Version: 2.4
+Name: tasalsul
+Version: 0.2.0
+Summary: تسلسل: أرشيف مضغوط ومشفّر للمسلسلات (.tslsl v2)
+Author: Tasalsul Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/syrian-vcg/tasalsul
+Project-URL: Repository, https://github.com/syrian-vcg/tasalsul
+Project-URL: Issues, https://github.com/syrian-vcg/tasalsul/issues
+Project-URL: Changelog, https://github.com/syrian-vcg/tasalsul/blob/main/CHANGELOG.md
+Keywords: archive,encryption,video,series,tslsl
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography>=42.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs-material; extra == "docs"
+Dynamic: license-file
+
+# تسلسل (Tasalsul) 📦🔐
+
+<p align="center">
+  <img src="assets/tslsl-icon.svg" width="80" alt="تسلسل أيقونة"/>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/tasalsul/"><img src="https://img.shields.io/pypi/v/tasalsul?label=PyPI&color=6C63FF" alt="PyPI"/></a>
+  <a href="https://www.npmjs.com/package/tasalsul"><img src="https://img.shields.io/npm/v/tasalsul?label=npm&color=FF6584" alt="npm"/></a>
+  <img src="https://img.shields.io/pypi/pyversions/tasalsul?color=4ADE80" alt="Python"/>
+  <img src="https://img.shields.io/github/license/YOUR_USERNAME/tasalsul" alt="License"/>
+  <img src="https://img.shields.io/github/actions/workflow/status/YOUR_USERNAME/tasalsul/ci.yml?label=CI" alt="CI"/>
+</p>
+
+**تسلسل** هي صيغة أرشيف مفتوحة المصدر (`.tslsl`) لضغط وتشفير فيديوهات المسلسلات بشكل آمن، مع ميتاداتا قابلة للقراءة بلا كلمة سر.
+
+---
+
+## ✨ الميزات
+
+| الميزة | التفاصيل |
+|--------|----------|
+| 🔐 تشفير قوي | AES-256-GCM مع PBKDF2 (390,000 تكرار) |
+| 📦 ضغط | zlib — تقليص ملحوظ للحجم |
+| 📋 ميتاداتا غنية | اسم، موسم، حلقة، وصف، لغة، ترجمات، صورة مصغّرة |
+| 🌐 دعم الويب | JavaScript SDK للمتصفح و Node.js |
+| 🔄 بث (streaming) | يعمل مع ملفات ضخمة بكفاءة |
+| ✅ سلامة البيانات | SHA-256 للتحقق من الملف الأصلي |
+| 🔁 ترقية v1→v2 | أمر `migrate` مدمج |
+
+---
+
+## 📥 التثبيت
+
+### Python
+```bash
+pip install tasalsul
+```
+
+### JavaScript / Node.js
+```bash
+npm install tasalsul
+```
+
+### من المصدر
+```bash
+git clone https://github.com/YOUR_USERNAME/tasalsul
+cd tasalsul
+pip install -e ".[dev]"
+```
+
+---
+
+## 🚀 الاستخدام
+
+### Python API
+
+```python
+from tasalsul import create_archive, extract_archive, read_metadata, ThumbnailMeta
+
+# إنشاء أرشيف
+result = create_archive(
+    source      = "episode01.mp4",
+    dest        = "episode01.tslsl",
+    password    = "كلمة_سرية",
+    series_name = "Breaking Bad",
+    season      = 1,
+    episode     = 1,
+    title       = "Pilot",
+    description = "والتر وايت يبدأ رحلته",
+    language    = "ar",
+    resolution  = "1920x1080",
+    duration    = 3180.0,
+    tags        = ["drama", "crime"],
+    content_rating = "TV-MA",
+)
+print(result)  # ArchiveResult(series='Breaking Bad', size=42.5 MB, path=...)
+
+# قراءة الميتاداتا (بلا كلمة سر)
+meta = read_metadata("episode01.tslsl")
+print(meta.series_name)   # Breaking Bad
+print(meta.format_version) # 2
+
+# استخراج الفيديو
+extract_archive(
+    source   = "episode01.tslsl",
+    dest     = "restored.mp4",
+    password = "كلمة_سرية",
+)
+
+# الاستخدام مع bytes / BytesIO
+import io
+video_bytes = open("ep.mp4", "rb").read()
+buf = io.BytesIO()
+create_archive(source=video_bytes, dest=buf, password="pw", series_name="Test")
+```
+
+### JavaScript (Browser)
+
+```html
+<script type="module">
+import { createArchive, extractArchive, readMetadata,
+         readFile, downloadBlob } from "https://unpkg.com/tasalsul/src/tasalsul/tasalsul.js";
+
+// قراءة ملف من المستخدم
+const file    = document.querySelector('input').files[0];
+const data    = await readFile(file);
+
+// إنشاء أرشيف
+const archive = await createArchive(data, "password", {
+  series_name:       "Breaking Bad",
+  original_filename: file.name,
+  season: 1, episode: 1,
+});
+
+// تحميل الأرشيف
+downloadBlob(new Blob([archive]), "ep1.tslsl");
+
+// قراءة الميتاداتا
+const meta = readMetadata(archive);
+console.log(meta.series_name); // Breaking Bad
+</script>
+```
+
+### JavaScript (Node.js)
+
+```js
+import { readFile } from "fs/promises";
+import { createArchive, extractArchive, readMetadata } from "tasalsul";
+
+const video   = new Uint8Array(await readFile("ep.mp4"));
+const archive = await createArchive(video, "password", {
+  series_name: "My Series", season: 1, episode: 1,
+});
+
+const { data, metadata } = await extractArchive(archive, "password");
+console.log(metadata.series_name);
+```
+
+### CLI
+
+```bash
+# إنشاء أرشيف مع ميتاداتا كاملة
+tslsl create episode.mp4 \
+  --series "Breaking Bad" --season 1 --episode 1 \
+  --title "Pilot" --description "بداية القصة" \
+  --language ar --resolution 1920x1080 --duration 3180 \
+  --tag drama --tag crime \
+  --thumbnail thumb.jpg \
+  --subtitle ar:subs_ar.srt \
+  -o episode.tslsl
+
+# عرض الميتاداتا
+tslsl info episode.tslsl
+tslsl info episode.tslsl --json    # مخرج JSON
+
+# استخراج الفيديو
+tslsl extract episode.tslsl -o restored.mp4
+
+# ترقية أرشيف v1
+tslsl migrate old_episode.tslsl -o new_episode.tslsl
+```
+
+---
+
+## 🧱 بنية الملف (.tslsl v2)
+
+```
+┌──────────────┬─────────────────────────────────────────┐
+│ 8  bytes     │ MAGIC = "TSLSL002"                      │
+│ 2  bytes     │ FORMAT_VERSION = 2                      │
+│ 4  bytes     │ HEADER_LEN                              │
+│ N  bytes     │ HEADER (JSON / UTF-8, غير مشفّر)        │
+│ 16 bytes     │ SALT (عشوائي — لاشتقاق المفتاح)         │
+│ 16 bytes     │ IV (nonce AES-GCM)                      │
+│ M  bytes     │ PAYLOAD (zlib ثم AES-256-GCM)           │
+│ 16 bytes     │ GCM AUTH TAG (مدمج)                     │
+└──────────────┴─────────────────────────────────────────┘
+```
+
+---
+
+## 🔐 الأمان
+
+- **AES-256-GCM**: تشفير مصادق عليه — يكتشف أي تلاعب في البيانات
+- **PBKDF2-SHA256 (390,000 تكرار)**: حماية ضد هجمات القوة الغاشمة
+- **Salt عشوائي**: كل أرشيف مشفّر بمفتاح فريد حتى لو كانت كلمة السر ذاتها
+- **SHA-256**: فحص السلامة بعد فك التشفير
+
+> ⚠️ لا يمكن استعادة الملف بدون كلمة السر — التشفير غير قابل للكسر عملياً.
+
+---
+
+## 🧪 الاختبارات
+
+```bash
+pip install -e ".[dev]"
+pytest -v
+pytest --cov=tasalsul    # مع تغطية الكود
+```
+
+---
+
+## 🤝 المساهمة
+
+المساهمات مرحّب بها! افتح issue أو pull request.
+
+---
+
+## 📄 الترخيص
+
+MIT © Tasalsul Contributors

tasalsul-0.2.0/README.md

@@ -0,0 +1,212 @@
+# تسلسل (Tasalsul) 📦🔐
+
+<p align="center">
+  <img src="assets/tslsl-icon.svg" width="80" alt="تسلسل أيقونة"/>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/tasalsul/"><img src="https://img.shields.io/pypi/v/tasalsul?label=PyPI&color=6C63FF" alt="PyPI"/></a>
+  <a href="https://www.npmjs.com/package/tasalsul"><img src="https://img.shields.io/npm/v/tasalsul?label=npm&color=FF6584" alt="npm"/></a>
+  <img src="https://img.shields.io/pypi/pyversions/tasalsul?color=4ADE80" alt="Python"/>
+  <img src="https://img.shields.io/github/license/YOUR_USERNAME/tasalsul" alt="License"/>
+  <img src="https://img.shields.io/github/actions/workflow/status/YOUR_USERNAME/tasalsul/ci.yml?label=CI" alt="CI"/>
+</p>
+
+**تسلسل** هي صيغة أرشيف مفتوحة المصدر (`.tslsl`) لضغط وتشفير فيديوهات المسلسلات بشكل آمن، مع ميتاداتا قابلة للقراءة بلا كلمة سر.
+
+---
+
+## ✨ الميزات
+
+| الميزة | التفاصيل |
+|--------|----------|
+| 🔐 تشفير قوي | AES-256-GCM مع PBKDF2 (390,000 تكرار) |
+| 📦 ضغط | zlib — تقليص ملحوظ للحجم |
+| 📋 ميتاداتا غنية | اسم، موسم، حلقة، وصف، لغة، ترجمات، صورة مصغّرة |
+| 🌐 دعم الويب | JavaScript SDK للمتصفح و Node.js |
+| 🔄 بث (streaming) | يعمل مع ملفات ضخمة بكفاءة |
+| ✅ سلامة البيانات | SHA-256 للتحقق من الملف الأصلي |
+| 🔁 ترقية v1→v2 | أمر `migrate` مدمج |
+
+---
+
+## 📥 التثبيت
+
+### Python
+```bash
+pip install tasalsul
+```
+
+### JavaScript / Node.js
+```bash
+npm install tasalsul
+```
+
+### من المصدر
+```bash
+git clone https://github.com/YOUR_USERNAME/tasalsul
+cd tasalsul
+pip install -e ".[dev]"
+```
+
+---
+
+## 🚀 الاستخدام
+
+### Python API
+
+```python
+from tasalsul import create_archive, extract_archive, read_metadata, ThumbnailMeta
+
+# إنشاء أرشيف
+result = create_archive(
+    source      = "episode01.mp4",
+    dest        = "episode01.tslsl",
+    password    = "كلمة_سرية",
+    series_name = "Breaking Bad",
+    season      = 1,
+    episode     = 1,
+    title       = "Pilot",
+    description = "والتر وايت يبدأ رحلته",
+    language    = "ar",
+    resolution  = "1920x1080",
+    duration    = 3180.0,
+    tags        = ["drama", "crime"],
+    content_rating = "TV-MA",
+)
+print(result)  # ArchiveResult(series='Breaking Bad', size=42.5 MB, path=...)
+
+# قراءة الميتاداتا (بلا كلمة سر)
+meta = read_metadata("episode01.tslsl")
+print(meta.series_name)   # Breaking Bad
+print(meta.format_version) # 2
+
+# استخراج الفيديو
+extract_archive(
+    source   = "episode01.tslsl",
+    dest     = "restored.mp4",
+    password = "كلمة_سرية",
+)
+
+# الاستخدام مع bytes / BytesIO
+import io
+video_bytes = open("ep.mp4", "rb").read()
+buf = io.BytesIO()
+create_archive(source=video_bytes, dest=buf, password="pw", series_name="Test")
+```
+
+### JavaScript (Browser)
+
+```html
+<script type="module">
+import { createArchive, extractArchive, readMetadata,
+         readFile, downloadBlob } from "https://unpkg.com/tasalsul/src/tasalsul/tasalsul.js";
+
+// قراءة ملف من المستخدم
+const file    = document.querySelector('input').files[0];
+const data    = await readFile(file);
+
+// إنشاء أرشيف
+const archive = await createArchive(data, "password", {
+  series_name:       "Breaking Bad",
+  original_filename: file.name,
+  season: 1, episode: 1,
+});
+
+// تحميل الأرشيف
+downloadBlob(new Blob([archive]), "ep1.tslsl");
+
+// قراءة الميتاداتا
+const meta = readMetadata(archive);
+console.log(meta.series_name); // Breaking Bad
+</script>
+```
+
+### JavaScript (Node.js)
+
+```js
+import { readFile } from "fs/promises";
+import { createArchive, extractArchive, readMetadata } from "tasalsul";
+
+const video   = new Uint8Array(await readFile("ep.mp4"));
+const archive = await createArchive(video, "password", {
+  series_name: "My Series", season: 1, episode: 1,
+});
+
+const { data, metadata } = await extractArchive(archive, "password");
+console.log(metadata.series_name);
+```
+
+### CLI
+
+```bash
+# إنشاء أرشيف مع ميتاداتا كاملة
+tslsl create episode.mp4 \
+  --series "Breaking Bad" --season 1 --episode 1 \
+  --title "Pilot" --description "بداية القصة" \
+  --language ar --resolution 1920x1080 --duration 3180 \
+  --tag drama --tag crime \
+  --thumbnail thumb.jpg \
+  --subtitle ar:subs_ar.srt \
+  -o episode.tslsl
+
+# عرض الميتاداتا
+tslsl info episode.tslsl
+tslsl info episode.tslsl --json    # مخرج JSON
+
+# استخراج الفيديو
+tslsl extract episode.tslsl -o restored.mp4
+
+# ترقية أرشيف v1
+tslsl migrate old_episode.tslsl -o new_episode.tslsl
+```
+
+---
+
+## 🧱 بنية الملف (.tslsl v2)
+
+```
+┌──────────────┬─────────────────────────────────────────┐
+│ 8  bytes     │ MAGIC = "TSLSL002"                      │
+│ 2  bytes     │ FORMAT_VERSION = 2                      │
+│ 4  bytes     │ HEADER_LEN                              │
+│ N  bytes     │ HEADER (JSON / UTF-8, غير مشفّر)        │
+│ 16 bytes     │ SALT (عشوائي — لاشتقاق المفتاح)         │
+│ 16 bytes     │ IV (nonce AES-GCM)                      │
+│ M  bytes     │ PAYLOAD (zlib ثم AES-256-GCM)           │
+│ 16 bytes     │ GCM AUTH TAG (مدمج)                     │
+└──────────────┴─────────────────────────────────────────┘
+```
+
+---
+
+## 🔐 الأمان
+
+- **AES-256-GCM**: تشفير مصادق عليه — يكتشف أي تلاعب في البيانات
+- **PBKDF2-SHA256 (390,000 تكرار)**: حماية ضد هجمات القوة الغاشمة
+- **Salt عشوائي**: كل أرشيف مشفّر بمفتاح فريد حتى لو كانت كلمة السر ذاتها
+- **SHA-256**: فحص السلامة بعد فك التشفير
+
+> ⚠️ لا يمكن استعادة الملف بدون كلمة السر — التشفير غير قابل للكسر عملياً.
+
+---
+
+## 🧪 الاختبارات
+
+```bash
+pip install -e ".[dev]"
+pytest -v
+pytest --cov=tasalsul    # مع تغطية الكود
+```
+
+---
+
+## 🤝 المساهمة
+
+المساهمات مرحّب بها! افتح issue أو pull request.
+
+---
+
+## 📄 الترخيص
+
+MIT © Tasalsul Contributors

tasalsul-0.2.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires      = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name        = "tasalsul"
+version     = "0.2.0"
+description = "تسلسل: أرشيف مضغوط ومشفّر للمسلسلات (.tslsl v2)"
+readme      = "README.md"
+license      = { text = "MIT" }
+authors      = [{ name = "Tasalsul Contributors" }]
+keywords     = ["archive", "encryption", "video", "series", "tslsl"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Multimedia :: Video",
+  "Topic :: Security :: Cryptography",
+]
+requires-python = ">=3.9"
+dependencies    = ["cryptography>=42.0.0"]
+
+[project.optional-dependencies]
+dev  = ["pytest>=7.0", "pytest-cov"]
+docs = ["mkdocs-material"]
+
+[project.scripts]
+tslsl = "tasalsul.cli:main"
+
+[project.urls]
+Homepage   = "https://github.com/syrian-vcg/tasalsul"
+Repository = "https://github.com/syrian-vcg/tasalsul"
+Issues     = "https://github.com/syrian-vcg/tasalsul/issues"
+Changelog  = "https://github.com/syrian-vcg/tasalsul/blob/main/CHANGELOG.md"
+
+[tool.setuptools.package-dir]
+"" = "src"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts   = "-v --tb=short"

tasalsul-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tasalsul-0.2.0/src/tasalsul/__init__.py

@@ -0,0 +1,63 @@
+"""
+تسلسل (Tasalsul) — أرشيف مضغوط ومشفّر للمسلسلات.
+صيغة .tslsl v2: AES-256-GCM + zlib + ميتاداتا موسّعة.
+
+Quick start
+-----------
+>>> from tasalsul import create_archive, extract_archive, read_metadata
+>>> result = create_archive(
+...     source="episode.mp4",
+...     dest="episode.tslsl",
+...     password="سري",
+...     series_name="Breaking Bad",
+...     season=1, episode=1,
+... )
+>>> meta = read_metadata("episode.tslsl")
+>>> print(meta.series_name)
+"""
+
+from .engine import (
+    # functions
+    create_archive,
+    extract_archive,
+    read_metadata,
+    migrate_v1,
+    # result types
+    ArchiveResult,
+    ExtractResult,
+    # metadata models
+    SeriesMetadata,
+    SubtitleRef,
+    ThumbnailMeta,
+    # errors
+    TasalsulError,
+    InvalidPasswordError,
+    CorruptArchiveError,
+    UnsupportedVersionError,
+    # constants
+    FORMAT_VERSION,
+    MAGIC,
+)
+
+__version__  = "0.2.0"
+__author__   = "Tasalsul Contributors"
+__license__  = "MIT"
+
+__all__ = [
+    "create_archive",
+    "extract_archive",
+    "read_metadata",
+    "migrate_v1",
+    "ArchiveResult",
+    "ExtractResult",
+    "SeriesMetadata",
+    "SubtitleRef",
+    "ThumbnailMeta",
+    "TasalsulError",
+    "InvalidPasswordError",
+    "CorruptArchiveError",
+    "UnsupportedVersionError",
+    "FORMAT_VERSION",
+    "MAGIC",
+    "__version__",
+]