magiastream 1.0.0__tar.gz

magiastream-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,49 @@
+name: MagiaStream CI
+
+on:
+  push:
+    branches: [ "master", "main" ]
+  pull_request:
+    branches: [ "master", "main" ]
+
+jobs:
+  build-and-lint:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Setup Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+        cache: 'pip'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e .[dev]
+
+    - name: Run Ruff Format Check
+      run: |
+        python -m ruff format --check magia_stream/
+
+    - name: Run Ruff Lint Check
+      run: |
+        python -m ruff check magia_stream/
+
+    - name: Run Mypy Type Checking
+      run: |
+        python -m mypy magia_stream/
+
+    - name: Run Pytest
+      run: |
+        python -m pytest tests/
+
+    - name: Build Wheel (Dry-run packaging)
+      run: |
+        pip install build
+        python -m build --wheel

magiastream-1.0.0/.gitignore

@@ -0,0 +1,47 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.so
+.build/
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+# Virtual environments
+venv/
+.venv/
+env/
+ENV/
+
+# Environment variables
+.env
+.env.*
+
+# IDE
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Application artifacts
+*.mp4
+*.tmp
+*.log
+downloads/
+*.sqlite
+venv/
+.env.local
+.env.test
+.cache/
+/.venv
+.playwright/

magiastream-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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.

magiastream-1.0.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: magiastream
+Version: 1.0.0
+Summary: Un CLI industriel, résilient et interactif pour scraper et télécharger des flux HLS (animes/vidéos).
+Project-URL: Homepage, https://github.com/Dilane17/MagiaStream
+Project-URL: Repository, https://github.com/Dilane17/MagiaStream.git
+Project-URL: Bug Tracker, https://github.com/Dilane17/MagiaStream/issues
+Author-email: dylankode <ahouandjinougael733@gmail.com>
+License-File: LICENSE
+Keywords: anime,cli,downloader,hls,magiastream,playwright,scraper
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.10
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: questionary>=2.0.1
+Requires-Dist: requests>=2.31.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer[all]>=0.9.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.9.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.12.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# MagiaStream
+
+MagiaStream est un orchestrateur de téléchargement CLI avancé en Python 3.14+, spécialement conçu pour rechercher, scrapper et télécharger des séries d'animes de manière robuste et interactive.
+
+## ✨ Fonctionnalités Principales
+
+- **Mode Interactif (Wizard)** : Plus besoin de taper des commandes longues ! L'interface interactive vous guide pas-à-pas (Recherche, Choix de la saison, Résolution, etc.).
+- **Recherche AJAX Dynamique** : Le scraper Playwright reproduit un comportement humain pour exploiter la barre de recherche (support de l'autocomplétion) et esquiver les limitations anti-bot.
+- **Téléchargement HLS Ultra-Résilient** : Construit au-dessus de `aria2c` et `ffmpeg`, le moteur de téléchargement gère parfaitement les connexions instables :
+  - **Reprise automatique** en cas de coupure (Code 5).
+  - **Barre de progression en direct** (grâce à `rich`).
+  - **Boucle auto-réparatrice** infinie qui s'acharne jusqu'à ce que tous les segments soient récupérés sans jamais recommencer à zéro.
+- **Support Stealth & Proxies** : Intégration de serveurs Proxy, Playwright Stealth et manipulation d'User-Agents pour passer sous les radars des CDNs capricieux.
+
+## 🚀 Installation
+
+### 🌍 Compatibilité (Multiplateforme)
+MagiaStream est 100% compatible avec **Windows, macOS et toutes les distributions Linux**.
+Les seules exigences système à installer via votre gestionnaire de paquets (`apt`, `brew`, `winget`, etc.) sont :
+- Python 3.10 ou supérieur
+- `aria2c` (moteur de téléchargement ultra-rapide)
+- `ffmpeg` (pour la fusion finale des vidéos)
+
+### Méthode 1 : Installation Globale avec `pipx` (Recommandée)
+`pipx` est l'outil standard pour installer des applications CLI Python de manière globale, sans polluer le système.
+
+```bash
+# 1. Installer pipx si vous ne l'avez pas déjà
+python -m pip install --user pipx
+python -m pipx ensurepath
+
+# 2. Installer MagiaStream directement depuis le dépôt Git
+pipx install git+https://github.com/Dilane17/MagiaStream.git
+
+# 3. Finaliser l'installation (télécharge le navigateur fantôme nécessaire)
+magia setup
+```
+
+*(Note : Remplacez `ton-profil/MagiaStream.git` par l'URL réelle de votre dépôt Github).*
+
+### 🔄 Mise à jour Automatique
+Mettre à jour MagiaStream vers la toute dernière version se fait en une seule commande, peu importe la méthode d'installation choisie :
+```bash
+magia update
+```
+
+### Méthode 2 : Installation pour le Développement (Local)
+Si vous souhaitez modifier le code ou contribuer au projet :
+
+```bash
+# 1. Cloner et préparer l'environnement virtuel
+git clone https://github.com/ton-profil/MagiaStream.git
+cd MagiaStream
+python -m venv venv
+source venv/bin/activate
+
+# 2. Installer le package et ses dépendances
+pip install -e .
+
+# 3. Installer le navigateur Playwright
+playwright install chromium
+```
+
+## 🎮 Utilisation
+
+La manière la plus simple et la plus recommandée d'utiliser MagiaStream est le **mode interactif**. Tapez simplement :
+
+```bash
+magia
+```
+*L'assistant s'ouvrira, vous demandera quelle série chercher, affichera les vrais résultats du menu déroulant (VF/VOSTFR) via les touches fléchées, et lancera le téléchargement.*
+
+### Mode CLI Classique
+
+Si vous préférez écrire une commande complète d'un trait (pour des scripts ou des batchs) :
+
+```bash
+# Télécharger toute la saison 1 en 720p
+magia download --serie "wistoria-wand-and-sword-vf" --saison 1 --resolution 720p --all
+
+# Télécharger uniquement l'épisode 3
+magia download --serie "wistoria-wand-and-sword-vf" --saison 1 --episode 3 --resolution 1080p
+
+# Télécharger de l'épisode 5 à 12
+magia download --serie "wistoria-wand-and-sword-vf" --saison 1 --range "5-12"
+```
+
+## ⚙️ Configuration
+
+MagiaStream utilise un fichier `.env` pour stocker sa configuration.
+Copiez le fichier d'exemple :
+```bash
+cp .env.example .env
+```
+Paramètres importants :
+- `PROXY_URL` : Un proxy pour contourner d'éventuels ban d'IP.
+- `TIMEOUT_SECONDS` : Temps d'attente maximum pour les requêtes web.
+- `HEADLESS` : Mettez `False` pour voir le navigateur fantôme travailler en arrière-plan.
+
+## 🛠️ À propos du moteur de téléchargement
+
+Le gestionnaire de téléchargement a été optimisé pour les **réseaux très instables**. 
+Plutôt que d'abandonner lorsqu'un CDN étrangle la connexion ou qu'une micro-coupure survient, MagiaStream isole les segments échoués et relance automatiquement `aria2c` en boucle toutes les 5 secondes jusqu'au succès total.

magiastream-1.0.0/README.md

@@ -0,0 +1,103 @@
+# MagiaStream
+
+MagiaStream est un orchestrateur de téléchargement CLI avancé en Python 3.14+, spécialement conçu pour rechercher, scrapper et télécharger des séries d'animes de manière robuste et interactive.
+
+## ✨ Fonctionnalités Principales
+
+- **Mode Interactif (Wizard)** : Plus besoin de taper des commandes longues ! L'interface interactive vous guide pas-à-pas (Recherche, Choix de la saison, Résolution, etc.).
+- **Recherche AJAX Dynamique** : Le scraper Playwright reproduit un comportement humain pour exploiter la barre de recherche (support de l'autocomplétion) et esquiver les limitations anti-bot.
+- **Téléchargement HLS Ultra-Résilient** : Construit au-dessus de `aria2c` et `ffmpeg`, le moteur de téléchargement gère parfaitement les connexions instables :
+  - **Reprise automatique** en cas de coupure (Code 5).
+  - **Barre de progression en direct** (grâce à `rich`).
+  - **Boucle auto-réparatrice** infinie qui s'acharne jusqu'à ce que tous les segments soient récupérés sans jamais recommencer à zéro.
+- **Support Stealth & Proxies** : Intégration de serveurs Proxy, Playwright Stealth et manipulation d'User-Agents pour passer sous les radars des CDNs capricieux.
+
+## 🚀 Installation
+
+### 🌍 Compatibilité (Multiplateforme)
+MagiaStream est 100% compatible avec **Windows, macOS et toutes les distributions Linux**.
+Les seules exigences système à installer via votre gestionnaire de paquets (`apt`, `brew`, `winget`, etc.) sont :
+- Python 3.10 ou supérieur
+- `aria2c` (moteur de téléchargement ultra-rapide)
+- `ffmpeg` (pour la fusion finale des vidéos)
+
+### Méthode 1 : Installation Globale avec `pipx` (Recommandée)
+`pipx` est l'outil standard pour installer des applications CLI Python de manière globale, sans polluer le système.
+
+```bash
+# 1. Installer pipx si vous ne l'avez pas déjà
+python -m pip install --user pipx
+python -m pipx ensurepath
+
+# 2. Installer MagiaStream directement depuis le dépôt Git
+pipx install git+https://github.com/Dilane17/MagiaStream.git
+
+# 3. Finaliser l'installation (télécharge le navigateur fantôme nécessaire)
+magia setup
+```
+
+*(Note : Remplacez `ton-profil/MagiaStream.git` par l'URL réelle de votre dépôt Github).*
+
+### 🔄 Mise à jour Automatique
+Mettre à jour MagiaStream vers la toute dernière version se fait en une seule commande, peu importe la méthode d'installation choisie :
+```bash
+magia update
+```
+
+### Méthode 2 : Installation pour le Développement (Local)
+Si vous souhaitez modifier le code ou contribuer au projet :
+
+```bash
+# 1. Cloner et préparer l'environnement virtuel
+git clone https://github.com/ton-profil/MagiaStream.git
+cd MagiaStream
+python -m venv venv
+source venv/bin/activate
+
+# 2. Installer le package et ses dépendances
+pip install -e .
+
+# 3. Installer le navigateur Playwright
+playwright install chromium
+```
+
+## 🎮 Utilisation
+
+La manière la plus simple et la plus recommandée d'utiliser MagiaStream est le **mode interactif**. Tapez simplement :
+
+```bash
+magia
+```
+*L'assistant s'ouvrira, vous demandera quelle série chercher, affichera les vrais résultats du menu déroulant (VF/VOSTFR) via les touches fléchées, et lancera le téléchargement.*
+
+### Mode CLI Classique
+
+Si vous préférez écrire une commande complète d'un trait (pour des scripts ou des batchs) :
+
+```bash
+# Télécharger toute la saison 1 en 720p
+magia download --serie "wistoria-wand-and-sword-vf" --saison 1 --resolution 720p --all
+
+# Télécharger uniquement l'épisode 3
+magia download --serie "wistoria-wand-and-sword-vf" --saison 1 --episode 3 --resolution 1080p
+
+# Télécharger de l'épisode 5 à 12
+magia download --serie "wistoria-wand-and-sword-vf" --saison 1 --range "5-12"
+```
+
+## ⚙️ Configuration
+
+MagiaStream utilise un fichier `.env` pour stocker sa configuration.
+Copiez le fichier d'exemple :
+```bash
+cp .env.example .env
+```
+Paramètres importants :
+- `PROXY_URL` : Un proxy pour contourner d'éventuels ban d'IP.
+- `TIMEOUT_SECONDS` : Temps d'attente maximum pour les requêtes web.
+- `HEADLESS` : Mettez `False` pour voir le navigateur fantôme travailler en arrière-plan.
+
+## 🛠️ À propos du moteur de téléchargement
+
+Le gestionnaire de téléchargement a été optimisé pour les **réseaux très instables**. 
+Plutôt que d'abandonner lorsqu'un CDN étrangle la connexion ou qu'une micro-coupure survient, MagiaStream isole les segments échoués et relance automatiquement `aria2c` en boucle toutes les 5 secondes jusqu'au succès total.

magiastream-1.0.0/docs/PLAN_DEVELOPPEMENT.md

@@ -0,0 +1,226 @@
+# PLAN_DEVELOPPEMENT — MagiaStream
+
+Document pragmatique et phasé pour achever et produire une v1 de `MagiaStream`.
+
+---
+
+## Résumé de l'état actuel (audit rapide)
+
+- `voiranime_downloader/` : package principal
+  - `__init__.py` : contient `__version__ = "0.1.0"`.
+  - `cli.py` : CLI Typer minimal avec commande `download` et options `--serie`, `--saison`, `--episode`, `--resolution`. Initialise logging via `setup_logging()` puis orchestre `Scraper` et `Downloader`.
+  - `scraper.py` : classe `Scraper` dataclass avec `search_episode()` non implémentée (lève `ScraperError`).
+  - `downloader.py` : classe `Downloader` dataclass qui appelle le scraper, construit un nom de fichier et retourne un chemin simulé (pas d'appel réel à aria2c).
+  - `config.py` : dataclass `Config` avec `BASE_URL`, `output_dir`, `temp_dir`, `user_agent`, `timeout_seconds`.
+  - `utils.py` : `setup_logging()` et `ensure_directory()` simples.
+  - `exceptions.py` : exceptions métier (`MagiaStreamError`, `ScraperError`, `DownloadError`).
+
+- `tests/` : test unitaire initial basé sur `unittest` (`tests/test_scraper.py`) qui vérifie que `Scraper.search_episode` lève `ScraperError`.
+- `requirements.txt` : liste basique (`playwright`, `typer[all]`, `rich`, `python-dotenv`, `tqdm`).
+- `.gitignore`, `README.md`, `pyproject.toml` : présents ; `pyproject.toml` déclare le script `voiranime = "voiranime_downloader.cli:main"`.
+
+### Résumé : ce qui fonctionne
+
+- Structure initiale cohérente ; tests unitaires basiques passent.
+- Typage moderne (annotations), utilisation de Typer et Rich.
+
+### Manquants / limites immédiates
+
+- `Scraper` non implémenté (aucune interaction Playwright / HTTP).
+- Aucun gestionnaire d'authentification, de parsing .m3u8, ni de gestion d'iframes/anti-bot.
+- `Downloader` ne lance pas `aria2c` ni la gestion de reprise / multi-connexion.
+- Pas de parsing `.env` ni configuration centralisée via `python-dotenv`.
+- Logging basique ; pas de rotation, pas de niveau configuré via fichier/env.
+- Aucun test d'intégration, pas de CI, pas de packaging final (wheel, tests automatisés).
+- `pyproject.toml` a `dependencies = []` (les dépendances ne sont pas inscrites dans `pyproject`), à corriger si on veut publier.
+- README mentionne `voiranime` mais le nom du package est `MagiaStream` — cohérence mineure à ajuster.
+
+### Bilan d'exécution au 2026-07-19
+
+- Terminé : `Phase 0`, `Phase 1`, `Phase 2`, `Phase 3`, `Phase 4`, `Phase 5`, `Phase 6`.
+- En cours : `Phase 7` (Futures fonctionnalités Optionnelles).
+- Non démarré : `Phase 7`.
+- Point important : Le pipeline de téléchargement et l'orchestration industrielle (mode batch JSON, commandes list/search/cleanup, partage de contexte Playwright, rattrapage d'erreurs) sont désormais 100% opérationnels.
+
+---
+
+## Observations techniques et recommandations rapides
+
+- Garder la séparation `Scraper` (récupération) vs `Downloader` (transfert) vs CLI.
+- Prévoir un composant `http`/`browser` qui encapsule Playwright, gestion des headers, proxies et retry.
+- Stocker la configuration en priorité dans `.env` + `Config` qui hydrate depuis l'environnement.
+- Utiliser `subprocess.run` ou `asyncio.create_subprocess_exec` pour appeler `aria2c` et capter la sortie (progression). Préférer `aria2c` en mode `--enable-rpc`/`--input-file` pour listes longues.
+- Ajouter des métriques/logs structurés (JSON) pour faciliter debug en production.
+
+---
+
+## Actions réalisées
+
+- Lecture et vérification des fichiers listés ci-dessus.
+- Tests unitaires basiques exécutés : OK.
+
+---
+
+# Plan de développement par phases
+
+Chaque phase liste tâches, priorités et edge-cases à anticiper. Dépendances = phases précédentes.
+
+### Phase 0 — Finalisation setup (priorité: critique) — TERMINÉ
+
+Objectif : rendre le projet exécutable localement, reproductible et versionnable.
+Tâches :
+
+- Initialiser `venv` et documenter la commande d'activation dans `README.md`.
+- Mettre à jour `requirements.txt` et `pyproject.toml` (répliquer deps dans `pyproject` si publication prévue).
+- `git init` si non fait, ajouter `LICENSE` (MIT par défaut) et premiers commits.
+- Ajouter `.env.example` avec variables : `BASE_URL`, `ARIA2C_PATH`, `OUTPUT_DIR`, `TIMEOUT`, `PLAYWRIGHT_BROWSERS`.
+- Ajouter script simple `scripts/setup.sh` (optionnel) pour apt/dnf deps: `aria2`, `libnss3`, `libatk1.0`, etc. (Playwright deps).
+- Vérifier `playwright install --with-deps chromium` dans README.
+
+Edge-cases : utilisateur sans `aria2c`, sans droits root, version Python <3.13.
+Dépendances: none.
+
+### Phase 1 — Configuration & Utils (priorité: haute) — TERMINÉ (2026-07-18)
+
+Note: Phase 1 est marquée comme terminée. Le projet a subi des corrections de packaging, nettoyage legacy et ajout de tests unitaires de base. Ready for Phase 2 after fixes.
+
+Objectif : robustifier config et utilitaires transverses.
+Tâches :
+
+- Charger `.env` via `python-dotenv` dans `Config` (méthode de classe `from_env()` et validation zod-like simple).
+- Améliorer `utils.setup_logging()` : support niveau via env, fichier `LOG_LEVEL`, `RotatingFileHandler` optionnel, JSON formatter optionnel.
+- Ajouter utilitaires `retry` (backoff exponentiel) configurable (utiliser `tenacity` si acceptable, sinon implémenter petit wrapper).
+- Installer gestion d'horodatage/format uniforme et gestion `--verbose` dans CLI.
+- Ajouter utilitaires pour gestion de chemins (safe filename sanitization) et housekeeping du `temp_dir`.
+
+Edge-cases : chemins non écriturables, quotas disque, collisions de noms de fichiers.
+Dépendances: Phase 0.
+
+**Statut actuel** : Phase 2 terminée. Le scraper, le cache et la navigation Wistoria/voir-anime.to sont validés, avec cache hit confirmé sur deux passes consécutives.
+
+### Phase 2 — Scraper core (priorité: critique) — TERMINÉ
+
+Objectif : implémenter le cœur du scraping robuste avec Playwright.
+Tâches :
+
+- Créer module `browser.py` encapsulant Playwright (sync ou async — choisir async si besoin de scalabilité).
+- Créer module `browser.py` encapsulant Playwright (sync ou async — choisir async si besoin de scalabilité).
+- Sub-tâches découvertes lors de l'audit :
+  - Ajouter une couche `network_monitor` pour intercepter requêtes et extraire `.m3u8`/tokens.
+  - Implémenter une stratégie de backoff et gestion des challenges JS (rejouer scripts dans le contexte Playwright).
+  - Écrire tests unitaires pour `Scraper` en mockant Playwright (utiliser pytest + pytest-asyncio + respx/vcrpy).
+- Patterns : session persistante, reuse browser contexts, options headless, user-agent, proxy support.
+- Techniques anti-bot : randomisation d'user-agent, injection de waits/stall, utilisation de `stealth` script si nécessaire.
+- Navigation sur `https://voir-anime.to` : découvrir structure HTML, pages séries, pages épisodes.
+- Implémenter `Scraper.search_episode()` :
+  - recherche série par nom (fuzzy matching), sélection de saison, liste d'épisodes ;
+  - normaliser les titres et retourner métadonnées : titre, saison, épisode, page_url, iframe_url(s), timestamp, available_resolutions.
+- Persistance légère des métadonnées en cache (sqlite ou fichier JSON) pour réduire requests.
+
+Edge-cases : Cloudflare/anti-bot (JS challenge), pages dynamiques chargées via XHR, pagination infinie, redirections.
+Dépendances: Phase 1.
+
+### Phase 3 — Extraction des flux vidéo (priorité: élevée) — TERMINÉ
+
+Objectif : extraire les URLs de flux (m3u8 / mp4) depuis pages/iframes et gérer anti-bot.
+Tâches :
+
+- Gérer les iframes : naviguer dans l'iframe (Playwright) et inspecter DOM/requests réseau.
+- Intercepter requêtes réseau (route/response) pour localiser `.m3u8` ou `.mp4` et tokens temporaires.
+- Parser les playlists `.m3u8` (variant playlists) pour choisir la piste correspondant à la résolution désirée.
+- Résoudre signatures/jetons si fournis via JS (exécuter le script JS dans le contexte du navigateur si nécessaire).
+- Enumérer cas: flux HLS chiffré (AES-128) — si chiffré, détecter et exposer message d'erreur ou tenter récupération des clés si accessible.
+
+Edge-cases : liens temporaires (signed URLs), fragments chiffrés, tokens expirants, CORS, redirections 302.
+Dépendances: Phase 2.
+
+### Phase 4 — Downloader (priorité: élevée) — TERMINÉ
+
+Objectif : fiabiliser le téléchargement via `aria2c` avec reprise et multi-connexions.
+Tâches :
+
+- Implémenter wrapper `downloader/aria2_wrapper.py` : construction de la commande, options par défaut `-x 16 -s 16`, contrôle timeout, retry.
+- Support pour `.m3u8` : si flux HLS, possibilité 1) utiliser `ffmpeg` pour downloader et remuxer; 2) utiliser `aria2c` sur segments quand possible; documenter les deux approches.
+- Progression : parser la sortie `aria2c` et exposer progression en % vers `rich.progress`.
+- Reprise : utiliser option `--continue`/`--allow-overwrite=false` et garder métadonnées `.aria2`/`.tmp` en `temp_dir`.
+- Organisation répertoires : `{output}/{serie}/Saison {saison}/{serie}.s{s:02d}e{e:02d}.{resolution}.mp4`.
+
+Edge-cases : quotas de connexion, serveurs limitant shards, fichiers incomplets, DRM/HLS chiffré.
+Dépendances: Phase 3, Phase 1.
+
+**Statut actuel** : TERMINÉ. Le downloader propage désormais les en-têtes navigateur, parse les manifestes HLS via Python pour contourner les erreurs 403, télécharge les segments manquants via aria2c, gère la reprise locale intelligente (skip), et concatène via ffmpeg sans ré-encodage.
+
+### Phase 5 — CLI avancée (priorité: moyenne) — TERMINÉ
+
+Objectif : rendre le CLI complet et ergonomique pour workflows courants.
+Tâches :
+
+- Étendre `cli.py` : options `--range` (ex: `1-12`), `--all` pour télécharger toute une saison, `--parallel` pour télécharger plusieurs séries/épisodes.
+- Ajouter commandes : `list-episodes`, `search`, `resume`, `cleanup`, `config show`.
+- Intégrer `rich` pour sorties colorées et `prompt` pour confirmation.
+- Support d'un fichier d'entrée (YAML/JSON) pour batch jobs.
+
+Edge-cases : gestion des interruptions (SIGINT), verrouillage de dossier pour éviter écritures concurrentes.
+Dépendances: Phase 4.
+
+**Statut actuel** : TERMINÉ. Le CLI dispose désormais des commandes d'utilité (list, search, cleanup) et d'un orchestrateur `batch` lisant du JSON avec gestion de contexte Playwright partagé, tolérance aux pannes et interruptions propres.
+
+### Phase 6 — Gestion erreurs, tests, packaging (priorité: haute) — TERMINÉ
+
+Objectif : durcir la solution et rendre le build repoducible.
+Tâches :
+
+- Tests : ajouter tests unitaires pour `utils`, mocks pour `browser`/Playwright, tests d'intégration limités (optionnels) via fixtures (vcrpy/ad-hoc mocking).
+- CI : config GitHub Actions — lint (ruff/flake8), type-check (mypy), tests, build wheel, publish on tag.
+- Gestion erreurs : erreurs sûres remontées vers le CLI, logs structurés et codes de sortie cohérents.
+- Packaging : finaliser `pyproject.toml` (mettre `dependencies`), build `wheel`, ajouter `entry_points` si nécessaire.
+
+Edge-cases : secrets exposés dans logs, tests flakys à cause de JS/temps réseau.
+Dépendances: Phases 0–5.
+
+**Statut actuel** : TERMINÉ. Le projet dispose d'un packaging PEP 621 (Hatchling), d'un typage Mypy strict, d'un formatage Ruff, de tests automatisés (Pytest avec Mocking), et d'une pipeline CI/CD GitHub Actions pour garantir sa pérennité.
+
+### Phase 7 — Features futures (priorité: basse) — EN COURS
+
+Objectif : roadmap pour évolutions non bloquantes.
+Tâches :
+
+- Multi-séries / file d'attente (queue) et persistence (sqlite/redis).
+- Notifications (desktop, email, webhook) à la fin du job.
+- Web UI léger pour orchestrer les téléchargements (FastAPI + UI minimal).
+- Support multi-sources (autres sites) via adaptateurs `site_adapter`.
+- Téléchargement distribué (worker pattern).
+
+Edge-cases : sécurité des webhooks, scalabilité, licences légales.
+
+---
+
+## Dépendances entre phases (rappel synthétique)
+
+- Phase 0 → Phase 1 (config & utils nécessaires pour tout le reste)
+- Phase 1 → Phase 2 (scraper s'appuie sur config & utils)
+- Phase 2 → Phase 3 (extraction flux dépend du navigateur)
+- Phase 3 → Phase 4 (downloader a besoin des URLs de flux)
+- Phase 4 → Phase 5 (CLI avancée orchestre le downloader)
+- Phase 5 → Phase 6 (tests/packaging après fonctionnalités)
+
+---
+
+## Checklist opérationnelle et KPI de succès
+
+- Script d'installation fonctionnel (`venv`, `pip install`, `playwright install`): success
+- `Scraper.search_episode` retourne métadonnées pour 80% des séries ciblées (mesure initiale)
+- Téléchargement `aria2c` stable pour fichiers >100MB avec reprise
+- Tests unitaires couvrant >60% du core non-IO, CI green
+
+---
+
+## Annexes / notes pratiques
+
+- Respect légal : vérifier les CGU des sources et éviter redistribution non autorisée.
+- Sécurité : ne pas committer `.env` ni clés API; utiliser `.env.example`.
+- Playwright stealth : ne pas utiliser de librairies propriétaires risquant des licences non compatibles.
+
+---
+
+Fin du plan.

magiastream-1.0.0/magia_stream/__init__.py

@@ -0,0 +1,3 @@
+"""MagiaStream package principal."""
+
+__version__ = "0.1.0"