shinkansen-cli 1.0.2__tar.gz

shinkansen_cli-1.0.2/LICENSE

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

shinkansen_cli-1.0.2/PKG-INFO

@@ -0,0 +1,253 @@
+Metadata-Version: 2.4
+Name: shinkansen-cli
+Version: 1.0.2
+Summary: Fast, reliable anime downloader for AnimePahe - built with lessons from autopahe
+Author: Pasindu Janith
+License: MIT
+Project-URL: Homepage, https://github.com/pasindujanith/anime-pahe-dl
+Project-URL: Repository, https://github.com/pasindujanith/anime-pahe-dl.git
+Project-URL: Bug Tracker, https://github.com/pasindujanith/anime-pahe-dl/issues
+Keywords: anime,downloader,animepahe,cli,playwright
+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.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1.0
+Requires-Dist: playwright>=1.45.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: tqdm>=4.66.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: InquirerPy>=0.3.4
+Requires-Dist: nest_asyncio>=1.5.0
+Provides-Extra: test
+Requires-Dist: pytest>=7.4.0; extra == "test"
+Requires-Dist: pytest-mock>=3.12.0; extra == "test"
+Requires-Dist: pytest-cov>=4.1.0; extra == "test"
+Requires-Dist: responses>=0.24.0; extra == "test"
+Provides-Extra: dev
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+Requires-Dist: mypy>=1.10.0; extra == "dev"
+Requires-Dist: pre-commit>=3.7.0; extra == "dev"
+Dynamic: license-file
+
+# 🚅 Shinkansen - Anime Downloader (anime-pahe-dl)
+
+> **A blazing-fast, fully interactive terminal application for downloading anime.**
+
+<p align="left">
+  <img src="demo.gif" alt="Shinkansen TUI Demo" width="700" height="450" >
+</p>
+
+`Shinkansen` is a powerful Terminal User Interface (TUI) that lets you search and batch-download anime directly
+from [AnimePahe](https://animepahe.si).
+It natively bypasses Cloudflare, fetches episodes in true parallel, and features an elegant interactive full-width
+menu right in your terminal.
+
+---
+
+## 🚀 Quick Start (1-Command Install)
+
+For the absolute easiest setup across Mac/Linux/Windows, install the tool globally in its own isolated environment
+using [pipx](https://pipx.pypa.io/) (the modern standard for Python CLIs):
+
+```bash
+# Safely install globally using the official PyPI release (Zero Configuration!)
+pipx install shinkansen-cli
+```
+
+## ⚙️ Manual Installation (For Development)
+
+If you are cloning the repository directly instead of using the 1-command install:
+```bash
+git clone https://github.com/sano0007/Shinkansen.git
+cd Shinkansen
+pip install -e .
+
+# Note: The embedded auto-installer will automatically secure Playwright on first run!
+```
+
+## 🎮 Usage
+
+### Interactive Mode (Recommended)
+
+Simply type the root command anywhere in your terminal to launch the pure TUI experience:
+```bash
+shinkansen
+```
+
+This launches a beautiful, dynamically-rendered menu offering Search & Download, Library browsing, History tracking, and
+recursive Settings management—all fully navigable via your arrow keys!
+
+### Advanced Command-Line Execution
+
+```bash
+# Interactive download directly from a query
+shinkansen get "naruto"
+
+# Search for anime
+shinkansen search "naruto"
+
+# List episodes
+shinkansen episodes <session>
+
+# Download a single episode
+shinkansen download <session> --episode 1 --quality 720 --name "Naruto"
+
+# Download a range of episodes
+shinkansen download <session> --range 1-12 --quality 1080
+
+# Download all episodes
+shinkansen download <session> --all
+
+# Override parallel workers (default: from config)
+shinkansen download <session> --all --workers 5
+
+# Show available sources for an episode
+shinkansen sources <session> 1
+
+# View download history
+shinkansen history
+
+# Browse downloaded anime library
+shinkansen library
+
+# Find anime in library
+shinkansen find "naruto"
+
+# Manage configuration
+shinkansen config show
+shinkansen config set quality 720
+shinkansen config set create_folder true
+```
+
+## Features
+
+- **HTTP-first approach** -- tries direct API calls before launching a browser, for speed
+- **Cloudflare bypass** -- Playwright fallback when Cloudflare blocks HTTP requests
+- **Persistent cookie caching** -- saves Cloudflare session cookies to disk (`~/.shinkansen/cookies.json`) so subsequent
+  runs skip the challenge entirely (25-min TTL)
+- **Parallel batch downloads** -- spawns multiple Playwright browser instances (`prepare_workers`, default 3) to prepare
+  episodes in true parallel, with a separate download thread pool (`max_downloads`, default 5); 200 episodes drops from
+  ~5 hours to ~2 hours
+- **Pipelined downloading** -- each episode's download starts the moment it's resolved, overlapping Playwright prep
+  with file I/O
+- **Multiple quality options** -- select 360p, 480p, 720p, 1080p, best, or worst
+- **Sub/Dub preference** -- choose between Japanese audio with subtitles or English dub
+- **Download resume** -- partial downloads are resumed automatically via HTTP Range headers
+- **Episode ranges** -- download specific episodes (`--range 1-12`), comma-separated (`--range 1,3,5-7`), or all (
+  `--all`)
+- **Download history** -- tracks every download with anime name, episode, quality, and date
+- **Anime library** -- browse and search your downloaded collection
+- **Config system** -- persistent settings at `~/.shinkansen/config.json` (default quality, output dir, folder creation,
+  etc.)
+- **Interactive TUI** -- run `shinkansen` to access a beautiful arrow-key navigable main menu routing your entire
+  application
+- **Automatic Retries** -- any episodes that timeout or fail directly prompt you to instantly retry them at the end of
+  the batch
+- **Rich terminal UI** -- Claude-style split screen welcome banners, colored output, live progress bars, tables, and
+  spinners
+
+## Architecture
+
+```
+AnimePahe API (JSON)
+    |
+    v
+AnimePaheClient (client.py)
+    - HTTP-first with Playwright fallback
+    - Cookie caching for Cloudflare sessions
+    - Paginated episode fetching
+    |
+    v
+Downloader (downloader.py)
+    - pahe.win -> kwik.cx -> direct .mp4 URL
+    - Split into prepare() + download_prepared() for pipelining
+    - Resume support via Range headers
+    - Pluggable backends: requests (default) or aria2c
+    |
+    v
+WorkerPool (worker_pool.py)
+    - N PrepareWorkers (own Playwright browser + thread each)
+    - Download ThreadPoolExecutor (bounded by max_downloads)
+    - Cookie sharing: Worker 0 clears Cloudflare, others load cached cookies
+    - Rich Live progress display
+    |
+    v
+CLI (cli.py)
+    - Click commands with Rich output
+    - History and library management
+```
+
+## Configuration
+
+Settings are stored at `~/.shinkansen/config.json`:
+
+| Setting              | Default     | Description                                          |
+|----------------------|-------------|------------------------------------------------------|
+| `default_quality`    | `best`      | Preferred video quality                              |
+| `default_output`     | `downloads` | Output directory                                     |
+| `auto_retry`         | `true`      | Retry failed downloads                               |
+| `retry_count`        | `3`         | Number of retry attempts                             |
+| `create_folder`      | `true`      | Create per-anime subfolders                          |
+| `parallel_downloads` | `3`         | Number of episodes to prefetch/download concurrently |
+| `download_backend`   | `requests`  | Download engine: `requests` or `aria2c`              |
+| `aria2c_path`        | `aria2c`    | Path to aria2c binary (if not in `$PATH`)            |
+| `aria2c_connections` | `16`        | Segments per file for aria2c (`--split`)             |
+| `prepare_workers`    | `3`         | Parallel Playwright browser instances for batch prep |
+| `max_downloads`      | `5`         | Max concurrent file downloads                        |
+
+## Testing
+
+```bash
+# Install test dependencies
+pip install -e ".[test]"
+
+# Run all tests
+pytest tests/ -v
+
+# Run with coverage
+pytest tests/ --cov=anime_pahe_dl --cov-report=term-missing
+
+# Run a specific test module
+pytest tests/test_config.py -v
+```
+
+## 🤝 Contributing & New Anime Sources
+
+**We want to grow!** Shinkansen currently supports downloading directly from AnimePahe, but our goal is to build a
+massive ecosystem supporting multiple anime sources.
+
+We highly encourage the open-source community to get involved:
+
+- **Suggest new anime sites** to support by opening an Issue.
+- **Fork the repository** and open Pull Requests implementing new fetchers/extractors.
+- Improve the interactive TUI or squash bugs.
+
+Please read our `CONTRIBUTING.md` guidelines to easily get started. Let's build the ultimate anime CLI together!
+
+## 💖 Support
+
+If you love the blinding speed of Shinkansen and want to say thanks for the hours saved, you can buy me a coffee! It
+goes a long way in keeping the project alive and well-maintained.
+
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/sanoo)
+
+## Requirements
+
+- Python >= 3.9
+- [Playwright](https://playwright.dev/python/) (Chromium) -- for Cloudflare bypass and source extraction
+- [Click](https://click.palletsprojects.com/) -- CLI framework
+- [Rich](https://rich.readthedocs.io/) -- terminal UI
+- [requests](https://requests.readthedocs.io/) -- HTTP client
+- [tqdm](https://tqdm.github.io/) -- progress bars

shinkansen_cli-1.0.2/README.md

@@ -0,0 +1,210 @@
+# 🚅 Shinkansen - Anime Downloader (anime-pahe-dl)
+
+> **A blazing-fast, fully interactive terminal application for downloading anime.**
+
+<p align="left">
+  <img src="demo.gif" alt="Shinkansen TUI Demo" width="700" height="450" >
+</p>
+
+`Shinkansen` is a powerful Terminal User Interface (TUI) that lets you search and batch-download anime directly
+from [AnimePahe](https://animepahe.si).
+It natively bypasses Cloudflare, fetches episodes in true parallel, and features an elegant interactive full-width
+menu right in your terminal.
+
+---
+
+## 🚀 Quick Start (1-Command Install)
+
+For the absolute easiest setup across Mac/Linux/Windows, install the tool globally in its own isolated environment
+using [pipx](https://pipx.pypa.io/) (the modern standard for Python CLIs):
+
+```bash
+# Safely install globally using the official PyPI release (Zero Configuration!)
+pipx install shinkansen-cli
+```
+
+## ⚙️ Manual Installation (For Development)
+
+If you are cloning the repository directly instead of using the 1-command install:
+```bash
+git clone https://github.com/sano0007/Shinkansen.git
+cd Shinkansen
+pip install -e .
+
+# Note: The embedded auto-installer will automatically secure Playwright on first run!
+```
+
+## 🎮 Usage
+
+### Interactive Mode (Recommended)
+
+Simply type the root command anywhere in your terminal to launch the pure TUI experience:
+```bash
+shinkansen
+```
+
+This launches a beautiful, dynamically-rendered menu offering Search & Download, Library browsing, History tracking, and
+recursive Settings management—all fully navigable via your arrow keys!
+
+### Advanced Command-Line Execution
+
+```bash
+# Interactive download directly from a query
+shinkansen get "naruto"
+
+# Search for anime
+shinkansen search "naruto"
+
+# List episodes
+shinkansen episodes <session>
+
+# Download a single episode
+shinkansen download <session> --episode 1 --quality 720 --name "Naruto"
+
+# Download a range of episodes
+shinkansen download <session> --range 1-12 --quality 1080
+
+# Download all episodes
+shinkansen download <session> --all
+
+# Override parallel workers (default: from config)
+shinkansen download <session> --all --workers 5
+
+# Show available sources for an episode
+shinkansen sources <session> 1
+
+# View download history
+shinkansen history
+
+# Browse downloaded anime library
+shinkansen library
+
+# Find anime in library
+shinkansen find "naruto"
+
+# Manage configuration
+shinkansen config show
+shinkansen config set quality 720
+shinkansen config set create_folder true
+```
+
+## Features
+
+- **HTTP-first approach** -- tries direct API calls before launching a browser, for speed
+- **Cloudflare bypass** -- Playwright fallback when Cloudflare blocks HTTP requests
+- **Persistent cookie caching** -- saves Cloudflare session cookies to disk (`~/.shinkansen/cookies.json`) so subsequent
+  runs skip the challenge entirely (25-min TTL)
+- **Parallel batch downloads** -- spawns multiple Playwright browser instances (`prepare_workers`, default 3) to prepare
+  episodes in true parallel, with a separate download thread pool (`max_downloads`, default 5); 200 episodes drops from
+  ~5 hours to ~2 hours
+- **Pipelined downloading** -- each episode's download starts the moment it's resolved, overlapping Playwright prep
+  with file I/O
+- **Multiple quality options** -- select 360p, 480p, 720p, 1080p, best, or worst
+- **Sub/Dub preference** -- choose between Japanese audio with subtitles or English dub
+- **Download resume** -- partial downloads are resumed automatically via HTTP Range headers
+- **Episode ranges** -- download specific episodes (`--range 1-12`), comma-separated (`--range 1,3,5-7`), or all (
+  `--all`)
+- **Download history** -- tracks every download with anime name, episode, quality, and date
+- **Anime library** -- browse and search your downloaded collection
+- **Config system** -- persistent settings at `~/.shinkansen/config.json` (default quality, output dir, folder creation,
+  etc.)
+- **Interactive TUI** -- run `shinkansen` to access a beautiful arrow-key navigable main menu routing your entire
+  application
+- **Automatic Retries** -- any episodes that timeout or fail directly prompt you to instantly retry them at the end of
+  the batch
+- **Rich terminal UI** -- Claude-style split screen welcome banners, colored output, live progress bars, tables, and
+  spinners
+
+## Architecture
+
+```
+AnimePahe API (JSON)
+    |
+    v
+AnimePaheClient (client.py)
+    - HTTP-first with Playwright fallback
+    - Cookie caching for Cloudflare sessions
+    - Paginated episode fetching
+    |
+    v
+Downloader (downloader.py)
+    - pahe.win -> kwik.cx -> direct .mp4 URL
+    - Split into prepare() + download_prepared() for pipelining
+    - Resume support via Range headers
+    - Pluggable backends: requests (default) or aria2c
+    |
+    v
+WorkerPool (worker_pool.py)
+    - N PrepareWorkers (own Playwright browser + thread each)
+    - Download ThreadPoolExecutor (bounded by max_downloads)
+    - Cookie sharing: Worker 0 clears Cloudflare, others load cached cookies
+    - Rich Live progress display
+    |
+    v
+CLI (cli.py)
+    - Click commands with Rich output
+    - History and library management
+```
+
+## Configuration
+
+Settings are stored at `~/.shinkansen/config.json`:
+
+| Setting              | Default     | Description                                          |
+|----------------------|-------------|------------------------------------------------------|
+| `default_quality`    | `best`      | Preferred video quality                              |
+| `default_output`     | `downloads` | Output directory                                     |
+| `auto_retry`         | `true`      | Retry failed downloads                               |
+| `retry_count`        | `3`         | Number of retry attempts                             |
+| `create_folder`      | `true`      | Create per-anime subfolders                          |
+| `parallel_downloads` | `3`         | Number of episodes to prefetch/download concurrently |
+| `download_backend`   | `requests`  | Download engine: `requests` or `aria2c`              |
+| `aria2c_path`        | `aria2c`    | Path to aria2c binary (if not in `$PATH`)            |
+| `aria2c_connections` | `16`        | Segments per file for aria2c (`--split`)             |
+| `prepare_workers`    | `3`         | Parallel Playwright browser instances for batch prep |
+| `max_downloads`      | `5`         | Max concurrent file downloads                        |
+
+## Testing
+
+```bash
+# Install test dependencies
+pip install -e ".[test]"
+
+# Run all tests
+pytest tests/ -v
+
+# Run with coverage
+pytest tests/ --cov=anime_pahe_dl --cov-report=term-missing
+
+# Run a specific test module
+pytest tests/test_config.py -v
+```
+
+## 🤝 Contributing & New Anime Sources
+
+**We want to grow!** Shinkansen currently supports downloading directly from AnimePahe, but our goal is to build a
+massive ecosystem supporting multiple anime sources.
+
+We highly encourage the open-source community to get involved:
+
+- **Suggest new anime sites** to support by opening an Issue.
+- **Fork the repository** and open Pull Requests implementing new fetchers/extractors.
+- Improve the interactive TUI or squash bugs.
+
+Please read our `CONTRIBUTING.md` guidelines to easily get started. Let's build the ultimate anime CLI together!
+
+## 💖 Support
+
+If you love the blinding speed of Shinkansen and want to say thanks for the hours saved, you can buy me a coffee! It
+goes a long way in keeping the project alive and well-maintained.
+
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/sanoo)
+
+## Requirements
+
+- Python >= 3.9
+- [Playwright](https://playwright.dev/python/) (Chromium) -- for Cloudflare bypass and source extraction
+- [Click](https://click.palletsprojects.com/) -- CLI framework
+- [Rich](https://rich.readthedocs.io/) -- terminal UI
+- [requests](https://requests.readthedocs.io/) -- HTTP client
+- [tqdm](https://tqdm.github.io/) -- progress bars

shinkansen_cli-1.0.2/pyproject.toml

@@ -0,0 +1,66 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "shinkansen-cli"
+version = "1.0.2"
+description = "Fast, reliable anime downloader for AnimePahe - built with lessons from autopahe"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "Pasindu Janith" }]
+requires-python = ">=3.9"
+keywords = ["anime", "downloader", "animepahe", "cli", "playwright"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "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 :: Internet",
+    "Topic :: Multimedia :: Video",
+]
+dependencies = [
+    "click>=8.1.0",
+    "playwright>=1.45.0",
+    "requests>=2.31.0",
+    "tqdm>=4.66.0",
+    "rich>=13.0.0",
+    "InquirerPy>=0.3.4",
+    "nest_asyncio>=1.5.0",
+]
+
+[project.scripts]
+shinkansen = "anime_pahe_dl.cli:cli"
+
+[project.optional-dependencies]
+test = [
+    "pytest>=7.4.0",
+    "pytest-mock>=3.12.0",
+    "pytest-cov>=4.1.0",
+    "responses>=0.24.0",
+]
+dev = [
+    "ruff>=0.4.0",
+    "mypy>=1.10.0",
+    "pre-commit>=3.7.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/pasindujanith/anime-pahe-dl"
+Repository = "https://github.com/pasindujanith/anime-pahe-dl.git"
+"Bug Tracker" = "https://github.com/pasindujanith/anime-pahe-dl/issues"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = [
+    "integration: tests requiring real network or Playwright",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]

shinkansen_cli-1.0.2/setup.cfg

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