demodsl 2.0.0__tar.gz

demodsl-2.0.0/.github/workflows/deploy-docs.yml

@@ -0,0 +1,47 @@
+name: Deploy Docs to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: docs
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: npm
+          cache-dependency-path: docs/package-lock.json
+
+      - run: npm ci
+      - run: npm run build
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/out
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

demodsl-2.0.0/.github/workflows/publish.yml

@@ -0,0 +1,48 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/demodsl
+    permissions:
+      id-token: write  # trusted publishing
+    steps:
+      - name: Download artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

demodsl-2.0.0/.gitignore

@@ -0,0 +1,31 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Next.js docs
+docs/node_modules/
+docs/.next/
+docs/out/
+
+# Project
+output/
+*.mp4
+*.webm
+*.gif

demodsl-2.0.0/LICENSE

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

demodsl-2.0.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include LICENSE
+include README.md
+include example.yaml
+recursive-include demodsl *.py

demodsl-2.0.0/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: demodsl
+Version: 2.0.0
+Summary: DSL-driven automated product demo video generator
+Project-URL: Homepage, https://fran-cois.github.io/demodsl
+Project-URL: Repository, https://github.com/Fran-cois/demodsl
+Project-URL: Documentation, https://fran-cois.github.io/demodsl
+Project-URL: Issues, https://github.com/Fran-cois/demodsl/issues
+Author-email: Fran-cois <francois@demodsl.dev>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: automation,demo,dsl,playwright,tts,video
+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.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: ffmpeg-python>=0.2
+Requires-Dist: httpx>=0.25
+Requires-Dist: moviepy>=1.0
+Requires-Dist: pillow>=10.0
+Requires-Dist: playwright>=1.40
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pydub>=0.25
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: typer>=0.9
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# DemoDSL
+
+**DSL-driven automated product demo video generator.**
+
+Define your product demos in YAML or JSON — DemoDSL handles browser automation, voice narration, visual effects, video editing, and final export.
+
+## Features
+
+- **YAML & JSON DSL** — Declarative scenario definitions with steps, effects, and narration
+- **Browser Automation** — Playwright-powered capture (Chrome, Firefox, WebKit)
+- **Voice Narration** — ElevenLabs TTS with automatic sync to video
+- **18 Visual Effects** — Spotlight, confetti, glitch, neon glow, and more
+- **Video Composition** — Intro/outro, transitions, watermarks via MoviePy
+- **Audio Mixing** — Background music with smart ducking during narration
+- **Multi-format Export** — MP4, WebM, GIF + social media presets (YouTube, Instagram, Twitter)
+
+## Installation
+
+```bash
+pip install demodsl
+```
+
+Then install Playwright browsers:
+
+```bash
+playwright install chromium
+```
+
+## Quick Start
+
+**1. Generate a template:**
+
+```bash
+demodsl init
+```
+
+**2. Edit `demo.yaml`:**
+
+```yaml
+metadata:
+  title: "My Product Demo"
+
+scenarios:
+  - name: "Main Demo"
+    url: "https://myapp.com"
+    steps:
+      - action: "navigate"
+        url: "https://myapp.com"
+        narration: "Welcome to our product!"
+        effects:
+          - type: "spotlight"
+            duration: 2.0
+
+pipeline:
+  - generate_narration: {}
+  - edit_video: {}
+  - mix_audio: {}
+  - optimize:
+      format: "mp4"
+```
+
+**3. Run:**
+
+```bash
+demodsl run demo.yaml
+```
+
+**4. Validate without executing:**
+
+```bash
+demodsl validate demo.yaml
+```
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `demodsl run <config>` | Execute the full pipeline |
+| `demodsl validate <config>` | Validate config without executing |
+| `demodsl init` | Generate a minimal template |
+| `demodsl init -o demo.json` | Generate a JSON template |
+
+### Options
+
+- `--output-dir, -o` — Output directory (default: `output/`)
+- `--dry-run` — Log all steps without executing
+- `--skip-voice` — Skip TTS generation (dev mode)
+- `--verbose, -v` — Debug logging
+
+## Architecture
+
+DemoDSL uses a modular architecture with 5 design patterns:
+
+| Component | Pattern | Purpose |
+|-----------|---------|---------|
+| Providers | Abstract Factory | Voice, Browser, Render provider instantiation |
+| Browser Actions | Command | Navigate, Click, Type, Scroll, WaitFor, Screenshot |
+| Pipeline | Chain of Responsibility | 8 stages with critical/optional error handling |
+| Visual Effects | Registry + Strategy | 18 effects in 2 registries (browser JS + post-processing) |
+| Video Composition | Builder | Progressive intro → segments → watermark → outro assembly |
+
+## Pipeline Stages
+
+| Stage | Critical | Description |
+|-------|----------|-------------|
+| `restore_audio` | Optional | Denoise + normalize audio |
+| `restore_video` | Optional | Stabilize + sharpen video |
+| `apply_effects` | Optional | Post-processing visual effects |
+| `generate_narration` | **Critical** | TTS generation + video sync |
+| `render_device_mockup` | Optional | Device frame overlay |
+| `edit_video` | **Critical** | Intro, outro, transitions, watermark |
+| `mix_audio` | **Critical** | Voice + background music ducking |
+| `optimize` | **Critical** | Final encoding + compression |
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `ELEVENLABS_API_KEY` | ElevenLabs TTS API key |
+| `OPENAI_API_KEY` | OpenAI API key (tts-1-hd) |
+| `GOOGLE_APPLICATION_CREDENTIALS` | Path to Google Cloud service account JSON |
+| `AZURE_SPEECH_KEY` | Azure Cognitive Services Speech key |
+| `AZURE_SPEECH_REGION` | Azure region (default: `eastus`) |
+| `AWS_ACCESS_KEY_ID` | AWS access key for Polly |
+| `AWS_SECRET_ACCESS_KEY` | AWS secret key for Polly |
+| `AWS_DEFAULT_REGION` | AWS region (default: `us-east-1`) |
+| `COSYVOICE_API_URL` | CosyVoice API server URL (default: `http://localhost:50000`) |
+| `COQUI_MODEL` | Coqui TTS model name (default: `xtts_v2`) |
+| `COQUI_LANGUAGE` | Language code for Coqui TTS (default: `en`) |
+| `PIPER_BIN` | Path to piper binary (default: `piper`) |
+| `PIPER_MODEL` | Path to Piper `.onnx` voice model (required for `piper` engine) |
+| `LOCAL_TTS_URL` | OpenAI-compatible local TTS server URL (default: `http://localhost:8000`) |
+| `LOCAL_TTS_API_KEY` | API key for local TTS server (default: `not-needed`) |
+| `LOCAL_TTS_MODEL` | Model name for local TTS server (default: `tts-1`) |
+| `ESPEAK_BIN` | Path to eSpeak-NG binary (default: `espeak-ng`) |
+
+Without the required credentials, DemoDSL falls back to a silent dummy provider for development.
+
+> **Vintage / debug providers**: `espeak` and `gtts` need no API key — ideal pour le prototypage rapide. `espeak` donne un son robotique rétro, `gtts` utilise Google Translate (nécessite internet + `pip install gtts`).
+
+## License
+
+MIT

demodsl-2.0.0/README.md

@@ -0,0 +1,143 @@
+# DemoDSL
+
+**DSL-driven automated product demo video generator.**
+
+Define your product demos in YAML or JSON — DemoDSL handles browser automation, voice narration, visual effects, video editing, and final export.
+
+## Features
+
+- **YAML & JSON DSL** — Declarative scenario definitions with steps, effects, and narration
+- **Browser Automation** — Playwright-powered capture (Chrome, Firefox, WebKit)
+- **Voice Narration** — ElevenLabs TTS with automatic sync to video
+- **18 Visual Effects** — Spotlight, confetti, glitch, neon glow, and more
+- **Video Composition** — Intro/outro, transitions, watermarks via MoviePy
+- **Audio Mixing** — Background music with smart ducking during narration
+- **Multi-format Export** — MP4, WebM, GIF + social media presets (YouTube, Instagram, Twitter)
+
+## Installation
+
+```bash
+pip install demodsl
+```
+
+Then install Playwright browsers:
+
+```bash
+playwright install chromium
+```
+
+## Quick Start
+
+**1. Generate a template:**
+
+```bash
+demodsl init
+```
+
+**2. Edit `demo.yaml`:**
+
+```yaml
+metadata:
+  title: "My Product Demo"
+
+scenarios:
+  - name: "Main Demo"
+    url: "https://myapp.com"
+    steps:
+      - action: "navigate"
+        url: "https://myapp.com"
+        narration: "Welcome to our product!"
+        effects:
+          - type: "spotlight"
+            duration: 2.0
+
+pipeline:
+  - generate_narration: {}
+  - edit_video: {}
+  - mix_audio: {}
+  - optimize:
+      format: "mp4"
+```
+
+**3. Run:**
+
+```bash
+demodsl run demo.yaml
+```
+
+**4. Validate without executing:**
+
+```bash
+demodsl validate demo.yaml
+```
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `demodsl run <config>` | Execute the full pipeline |
+| `demodsl validate <config>` | Validate config without executing |
+| `demodsl init` | Generate a minimal template |
+| `demodsl init -o demo.json` | Generate a JSON template |
+
+### Options
+
+- `--output-dir, -o` — Output directory (default: `output/`)
+- `--dry-run` — Log all steps without executing
+- `--skip-voice` — Skip TTS generation (dev mode)
+- `--verbose, -v` — Debug logging
+
+## Architecture
+
+DemoDSL uses a modular architecture with 5 design patterns:
+
+| Component | Pattern | Purpose |
+|-----------|---------|---------|
+| Providers | Abstract Factory | Voice, Browser, Render provider instantiation |
+| Browser Actions | Command | Navigate, Click, Type, Scroll, WaitFor, Screenshot |
+| Pipeline | Chain of Responsibility | 8 stages with critical/optional error handling |
+| Visual Effects | Registry + Strategy | 18 effects in 2 registries (browser JS + post-processing) |
+| Video Composition | Builder | Progressive intro → segments → watermark → outro assembly |
+
+## Pipeline Stages
+
+| Stage | Critical | Description |
+|-------|----------|-------------|
+| `restore_audio` | Optional | Denoise + normalize audio |
+| `restore_video` | Optional | Stabilize + sharpen video |
+| `apply_effects` | Optional | Post-processing visual effects |
+| `generate_narration` | **Critical** | TTS generation + video sync |
+| `render_device_mockup` | Optional | Device frame overlay |
+| `edit_video` | **Critical** | Intro, outro, transitions, watermark |
+| `mix_audio` | **Critical** | Voice + background music ducking |
+| `optimize` | **Critical** | Final encoding + compression |
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `ELEVENLABS_API_KEY` | ElevenLabs TTS API key |
+| `OPENAI_API_KEY` | OpenAI API key (tts-1-hd) |
+| `GOOGLE_APPLICATION_CREDENTIALS` | Path to Google Cloud service account JSON |
+| `AZURE_SPEECH_KEY` | Azure Cognitive Services Speech key |
+| `AZURE_SPEECH_REGION` | Azure region (default: `eastus`) |
+| `AWS_ACCESS_KEY_ID` | AWS access key for Polly |
+| `AWS_SECRET_ACCESS_KEY` | AWS secret key for Polly |
+| `AWS_DEFAULT_REGION` | AWS region (default: `us-east-1`) |
+| `COSYVOICE_API_URL` | CosyVoice API server URL (default: `http://localhost:50000`) |
+| `COQUI_MODEL` | Coqui TTS model name (default: `xtts_v2`) |
+| `COQUI_LANGUAGE` | Language code for Coqui TTS (default: `en`) |
+| `PIPER_BIN` | Path to piper binary (default: `piper`) |
+| `PIPER_MODEL` | Path to Piper `.onnx` voice model (required for `piper` engine) |
+| `LOCAL_TTS_URL` | OpenAI-compatible local TTS server URL (default: `http://localhost:8000`) |
+| `LOCAL_TTS_API_KEY` | API key for local TTS server (default: `not-needed`) |
+| `LOCAL_TTS_MODEL` | Model name for local TTS server (default: `tts-1`) |
+| `ESPEAK_BIN` | Path to eSpeak-NG binary (default: `espeak-ng`) |
+
+Without the required credentials, DemoDSL falls back to a silent dummy provider for development.
+
+> **Vintage / debug providers**: `espeak` and `gtts` need no API key — ideal pour le prototypage rapide. `espeak` donne un son robotique rétro, `gtts` utilise Google Translate (nécessite internet + `pip install gtts`).
+
+## License
+
+MIT

demodsl-2.0.0/demodsl/__init__.py

@@ -0,0 +1,3 @@
+"""DemoDSL — DSL-driven automated product demo video generator."""
+
+__version__ = "2.0.0"

demodsl-2.0.0/demodsl/cli.py

@@ -0,0 +1,155 @@
+"""CLI for DemoDSL — Typer-based interface."""
+
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+
+import typer
+
+app = typer.Typer(name="demodsl", help="DSL-driven automated product demo video generator. Supports YAML and JSON configs.")
+
+
+@app.command()
+def run(
+    config: Path = typer.Argument(..., help="Path to the YAML or JSON config file."),
+    output_dir: Path = typer.Option("output", "--output-dir", "-o", help="Output directory."),
+    dry_run: bool = typer.Option(False, "--dry-run", help="Validate and log without executing."),
+    skip_voice: bool = typer.Option(False, "--skip-voice", help="Skip TTS generation."),
+    verbose: bool = typer.Option(False, "--verbose", "-v", help="Enable debug logging."),
+) -> None:
+    """Parse and execute a DemoDSL config (YAML or JSON)."""
+    _setup_logging(verbose)
+
+    from demodsl.engine import DemoEngine
+
+    engine = DemoEngine(
+        config_path=config,
+        dry_run=dry_run,
+        skip_voice=skip_voice,
+        output_dir=output_dir,
+    )
+    result = engine.run()
+    if result:
+        typer.echo(f"Done → {result}")
+    else:
+        typer.echo("Done (no output file produced).")
+
+
+@app.command()
+def validate(
+    config: Path = typer.Argument(..., help="Path to the YAML or JSON config file."),
+    verbose: bool = typer.Option(False, "--verbose", "-v"),
+) -> None:
+    """Validate a config (YAML or JSON) without executing."""
+    _setup_logging(verbose)
+
+    from demodsl.engine import DemoEngine
+
+    engine = DemoEngine(config_path=config, dry_run=True)
+    cfg = engine.validate()
+    typer.echo(f"Valid ✓  —  {cfg.metadata.title} (v{cfg.metadata.version})")
+    typer.echo(f"  Scenarios: {len(cfg.scenarios)}")
+    total_steps = sum(len(s.steps) for s in cfg.scenarios)
+    typer.echo(f"  Steps:     {total_steps}")
+    typer.echo(f"  Pipeline:  {len(cfg.pipeline)} stages")
+
+
+@app.command()
+def init(
+    output: Path = typer.Option("demo.yaml", "--output", "-o", help="Output file path (.yaml or .json)."),
+) -> None:
+    """Generate a minimal config template (YAML or JSON)."""
+    if output.suffix.lower() == ".json":
+        import json
+
+        template_data = {
+            "metadata": {
+                "title": "My Product Demo",
+                "description": "A quick demo",
+                "version": "1.0.0",
+            },
+            "voice": {"engine": "elevenlabs", "voice_id": "josh"},
+            "scenarios": [
+                {
+                    "name": "Main Demo",
+                    "url": "https://example.com",
+                    "browser": "chrome",
+                    "viewport": {"width": 1920, "height": 1080},
+                    "steps": [
+                        {
+                            "action": "navigate",
+                            "url": "https://example.com",
+                            "narration": "Welcome to the demo!",
+                            "wait": 2.0,
+                        }
+                    ],
+                }
+            ],
+            "pipeline": [
+                {"generate_narration": {}},
+                {"edit_video": {}},
+                {"mix_audio": {}},
+                {"optimize": {"format": "mp4", "codec": "h264", "quality": "high"}},
+            ],
+            "output": {
+                "filename": "demo.mp4",
+                "directory": "output/",
+                "formats": ["mp4"],
+            },
+        }
+        output.write_text(json.dumps(template_data, indent=2) + "\n")
+    else:
+        template = """\
+metadata:
+  title: "My Product Demo"
+  description: "A quick demo"
+  version: "1.0.0"
+
+voice:
+  engine: "elevenlabs"
+  voice_id: "josh"
+
+scenarios:
+  - name: "Main Demo"
+    url: "https://example.com"
+    browser: "chrome"
+    viewport:
+      width: 1920
+      height: 1080
+    steps:
+      - action: "navigate"
+        url: "https://example.com"
+        narration: "Welcome to the demo!"
+        wait: 2.0
+
+pipeline:
+  - generate_narration: {}
+  - edit_video: {}
+  - mix_audio: {}
+  - optimize:
+      format: "mp4"
+      codec: "h264"
+      quality: "high"
+
+output:
+  filename: "demo.mp4"
+  directory: "output/"
+  formats:
+    - "mp4"
+"""
+        output.write_text(template)
+    typer.echo(f"Template created → {output}")
+
+
+def _setup_logging(verbose: bool) -> None:
+    level = logging.DEBUG if verbose else logging.INFO
+    logging.basicConfig(
+        level=level,
+        format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
+        datefmt="%H:%M:%S",
+    )
+
+
+if __name__ == "__main__":
+    app()