mdl-cli 0.3.0__tar.gz

mdl_cli-0.3.0/.github/workflows/ci.yml

@@ -0,0 +1,70 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      # ─────────────────────────────
+      # ffmpeg
+      # ─────────────────────────────
+      - name: Install ffmpeg (Linux)
+        if: runner.os == 'Linux'
+        run: sudo apt update && sudo apt install -y ffmpeg
+
+      - name: Install ffmpeg (macOS)
+        if: runner.os == 'macOS'
+        run: brew install ffmpeg
+
+      - name: Install ffmpeg (Windows)
+        if: runner.os == 'Windows'
+        run: choco install ffmpeg
+
+      # ─────────────────────────────
+      # Install project 
+      # ─────────────────────────────
+      - name: Install project
+        run: |
+          python -m pip install -U pip
+          pip install -e ".[dev]"
+
+      # ─────────────────────────────
+      # Tests
+      # ─────────────────────────────
+      - name: Run tests
+        run: python -m pytest -q
+
+      # ─────────────────────────────
+      # CLI real
+      # ─────────────────────────────
+      - name: CLI check
+        run: |
+          mdl --help
+          mdl --version
+
+      # ─────────────────────────────
+      # Smoke tests
+      # ─────────────────────────────
+      - name: Smoke test
+        run: |
+          mdl smoke audio --print
+          mdl smoke video --print

mdl_cli-0.3.0/.github/workflows/release.yml

@@ -0,0 +1,38 @@
+name: Release to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: twine upload dist/*

mdl_cli-0.3.0/.gitignore

@@ -0,0 +1,35 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+
+# Virtualenvs
+.venv/
+venv/
+
+# OS
+.DS_Store
+
+# Editors
+.vscode/
+.idea/
+
+# Local logs/output
+*.log
+
+# Packaging / build
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Test cache
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Envs / tooling
+.env
+.env.*
+ 

mdl_cli-0.3.0/CHANGELOG.md

@@ -0,0 +1,43 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.3.0] - 2026-04-13
+
+### Added
+- PyPI packaging support (`pip install` / `pipx install mdl-cli`)
+- Cross-platform CI (Linux, macOS, Windows)
+- Development dependencies (`.[dev]` extras)
+
+## [0.2.0] - 2026-02-17
+
+### Added
+- New `mdl config` command to print the effective persistent configuration as JSON.
+- Added `--mode {auto,album,flat}` to `audio` command to control playlist layout behavior.
+- Playlist downloads now automatically strip a leading `Album - ` prefix from `playlist_title`.
+
+### Changed
+- `mdl info` no longer accepts `--print`; it now always executes `yt-dlp -F`.
+- Audio playlist layout now prefers the primary artist (`artists.0`) to prevent album fragmentation when tracks contain collaborators.
+- Default playlist layout mode for audio is now `auto` (`OLAK...` playlists → album layout, others → flat layout).
+- Video playlists now always use flat single-folder layout.
+
+## [0.1.1] - 2026-02-16
+
+### Fixed
+- Handle `None` correctly in `smoke_kind` conversion.
+
+### Added
+- Unit test suite across core modules (builders, config store, resolve, CLI, services).
+- Coverage reporting via `pytest-cov`.
+
+## [0.1.0] - 2026-02-15
+
+### Added
+- Initial alpha release of mdl-cli
+- `audio`, `video`, `info`, and `smoke` commands
+- Persistent configuration system
+- Safe and fast presets
+- Configurable output directory
+- Optional thumbnail embedding
+- Robust default download flags

mdl_cli-0.3.0/LICENSE

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

mdl_cli-0.3.0/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: mdl-cli
+Version: 0.3.0
+Summary: A human-friendly wrapper over yt-dlp.
+Author: Tomás Ezequiel Aguirre
+License: MIT License
+        
+        Copyright (c) 2026 Tomás Ezequiel Aguirre
+        
+        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.
+        
+Project-URL: Repository, https://github.com/tomieaguirre/mdl-cli
+Keywords: yt-dlp,downloader,cli,audio,video
+Classifier: Development Status :: 3 - Alpha
+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
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: yt-dlp>=2024.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pytest-cov>=4; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: black>=24.0; extra == "dev"
+Dynamic: license-file
+
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![CI](https://github.com/tomieaguirre/mdl-cli/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/tomieaguirre/mdl-cli/actions/workflows/ci.yml?query=branch%3Amain)
+
+# mdl-cli
+
+`mdl` is a cross-platform CLI wrapper around `yt-dlp` with safer defaults and a simpler command surface.
+
+## Requirements
+
+- Python `>=3.10`
+- `ffmpeg` available in `PATH`
+
+`mdl` executes `yt-dlp` under the hood. Ensure `yt-dlp` is installed and available in `PATH`.
+
+## Installation
+
+Recommended (isolated app install):
+
+```bash
+pipx install mdl-cli
+```
+
+Alternative (standard Python environment):
+
+```bash
+pip install mdl-cli
+```
+
+For OS-specific setup (Python, `ffmpeg`, `yt-dlp`, and verification), see the [Installation Guide](docs/installation.md).
+
+## Basic Usage
+
+```bash
+mdl audio "URL"
+mdl video "URL"
+mdl info "URL"
+mdl --help
+```
+
+Supported platforms: Linux, macOS, and Windows.
+
+## Documentation
+
+Full command reference and advanced configuration:
+- [Installation Guide](docs/installation.md)
+- [Usage Guide](docs/usage.md)
+
+## License
+
+MIT (see [License](LICENSE))

mdl_cli-0.3.0/README.md

@@ -0,0 +1,51 @@
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![CI](https://github.com/tomieaguirre/mdl-cli/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/tomieaguirre/mdl-cli/actions/workflows/ci.yml?query=branch%3Amain)
+
+# mdl-cli
+
+`mdl` is a cross-platform CLI wrapper around `yt-dlp` with safer defaults and a simpler command surface.
+
+## Requirements
+
+- Python `>=3.10`
+- `ffmpeg` available in `PATH`
+
+`mdl` executes `yt-dlp` under the hood. Ensure `yt-dlp` is installed and available in `PATH`.
+
+## Installation
+
+Recommended (isolated app install):
+
+```bash
+pipx install mdl-cli
+```
+
+Alternative (standard Python environment):
+
+```bash
+pip install mdl-cli
+```
+
+For OS-specific setup (Python, `ffmpeg`, `yt-dlp`, and verification), see the [Installation Guide](docs/installation.md).
+
+## Basic Usage
+
+```bash
+mdl audio "URL"
+mdl video "URL"
+mdl info "URL"
+mdl --help
+```
+
+Supported platforms: Linux, macOS, and Windows.
+
+## Documentation
+
+Full command reference and advanced configuration:
+- [Installation Guide](docs/installation.md)
+- [Usage Guide](docs/usage.md)
+
+## License
+
+MIT (see [License](LICENSE))

mdl_cli-0.3.0/docs/installation.md

@@ -0,0 +1,131 @@
+# Installation
+
+## Requirements
+
+- Python 3.10+
+- `ffmpeg` (required for some features)
+- `yt-dlp` available in `PATH`
+
+---
+
+## Install Python
+
+### Linux
+
+Use your distribution package manager. Example (Debian/Ubuntu):
+
+```bash
+sudo apt update
+sudo apt install -y python3 python3-pip python3-venv
+```
+
+### macOS
+
+```bash
+brew install python
+```
+
+### Windows
+
+PowerShell:
+
+```powershell
+winget install -e --id Python.Python.3.12
+```
+
+Manual installer:
+- https://www.python.org/downloads/windows/
+
+---
+
+## Install mdl-cli
+
+### Install pipx (if needed)
+
+Linux (Debian/Ubuntu):
+
+```bash
+sudo apt install pipx
+pipx ensurepath
+```
+
+macOS:
+
+```bash
+python3 -m pip install --user pipx
+python3 -m pipx ensurepath
+```
+
+Windows (PowerShell):
+
+```powershell
+py -m pip install --user pipx
+py -m pipx ensurepath
+```
+
+Open a new terminal after `ensurepath`.
+
+### Recommended (pipx)
+
+```bash
+pipx install mdl-cli
+```
+
+### Alternative (pip)
+
+```bash
+pip install mdl-cli
+```
+
+---
+
+## Install ffmpeg
+
+### Linux
+
+```bash
+sudo apt install ffmpeg
+```
+
+### macOS
+
+```bash
+brew install ffmpeg
+```
+
+### Windows
+
+PowerShell:
+
+```powershell
+winget install -e --id Gyan.FFmpeg
+```
+
+Manual install:
+- https://ffmpeg.org/download.html
+
+---
+
+## Install yt-dlp
+
+```bash
+pipx install yt-dlp
+```
+
+If you prefer `pip`:
+
+```bash
+pip install yt-dlp
+```
+
+---
+
+## Verify Installation
+
+```bash
+python --version
+yt-dlp --version
+ffmpeg -version
+mdl --version
+mdl smoke audio
+```