idm-cli 1.3.1__tar.gz → 1.3.3__tar.gz

{idm_cli-1.3.1/idm_cli.egg-info → idm_cli-1.3.3}/PKG-INFO

@@ -1,8 +1,7 @@
 Metadata-Version: 2.4
 Name: idm-cli
-Version: 1.3.1
+Version: 1.3.3
 Summary: A lightning-fast, universal command-line download manager
-Home-page: https://github.com/rj41-w2/idm-cli
 Author: Rehan
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/rj41-w2/idm-cli
@@ -14,22 +13,20 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: typer
 Requires-Dist: rich
-Requires-Dist: aiohttp
+Requires-Dist: curl-cffi>=0.7.0
 Requires-Dist: aiofiles
 Requires-Dist: yt-dlp
 Requires-Dist: pyfiglet
 Requires-Dist: questionary
-Requires-Dist: aiodns
-Requires-Dist: Brotli
 Requires-Dist: psutil
 Requires-Dist: platformdirs
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: packaging; extra == "dev"
-Dynamic: home-page
+Requires-Dist: ruff; extra == "dev"
 Dynamic: license-file
-Dynamic: requires-python
 
 <div align="center">
 
@@ -53,7 +50,7 @@ IDM-CLI splits files into multiple parallel chunks (default 8, up to 32) to maxi
 
 ## Features
 
-- **Parallel Chunk Engine** — Splits downloads into multiple concurrent chunks using `aiohttp` async sessions to fully saturate your bandwidth.
+- **Parallel Chunk Engine** — Splits downloads into multiple concurrent chunks using `curl-cffi` async sessions to fully saturate your bandwidth.
 - **Universal Downloader** — Paste any URL. yt-dlp handles 1000+ sites (YouTube, Facebook, Instagram, etc.), with automatic fallback to direct HTTP download for unsupported URLs.
 - **Audio Only / MP3 Conversion** — Download videos as audio. IDM-CLI automatically grabs the best audio stream and uses FFmpeg to convert it to `.mp3`.
 - **Smart Auto-Resume** — Internet dropped? Pressed `Ctrl+C`? No problem. IDM-CLI remembers the exact byte positions of all incomplete chunks. Paste the same link again to resume instantly.

{idm_cli-1.3.1 → idm_cli-1.3.3}/README.md

@@ -1,137 +1,137 @@
-<div align="center">
-
-<h1>IDM-CLI</h1>
-
-**A lightning-fast, cross-platform command-line download manager written in Python.**
-
-*The official IDM asks you to pay after 30 days — IDM-CLI is 100% free, open-source, and yours to modify!*
-
-[![PyPI version](https://img.shields.io/pypi/v/idm-cli?color=blue&label=pypi%20version)](https://pypi.org/project/idm-cli/)
-[![Downloads](https://static.pepy.tech/badge/idm-cli)](https://pepy.tech/project/idm-cli)
-[![License](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/rj41-w2/idm-cli/blob/main/LICENSE)
-![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)
-[![Install](https://img.shields.io/badge/install-pip%20install%20idm--cli-brightgreen)](https://pypi.org/project/idm-cli/)
-
-[Download via PyPI](https://pypi.org/project/idm-cli/) · [Report a Bug](https://github.com/rj41-w2/idm-cli/issues)
-
-</div>
-
-IDM-CLI splits files into multiple parallel chunks (default 8, up to 32) to maximize your internet speed. It supports downloading from **YouTube**, **Facebook**, **Instagram**, and any **Direct File URL** (`.exe`, `.zip`, `.pdf`, etc.).
-
-## Features
-
-- **Parallel Chunk Engine** — Splits downloads into multiple concurrent chunks using `aiohttp` async sessions to fully saturate your bandwidth.
-- **Universal Downloader** — Paste any URL. yt-dlp handles 1000+ sites (YouTube, Facebook, Instagram, etc.), with automatic fallback to direct HTTP download for unsupported URLs.
-- **Audio Only / MP3 Conversion** — Download videos as audio. IDM-CLI automatically grabs the best audio stream and uses FFmpeg to convert it to `.mp3`.
-- **Smart Auto-Resume** — Internet dropped? Pressed `Ctrl+C`? No problem. IDM-CLI remembers the exact byte positions of all incomplete chunks. Paste the same link again to resume instantly.
-- **Persistent Queue System** — Add multiple files to a queue with `-Q` and type `start queue` to download them all sequentially.
-- **Interactive UI** — Modern terminal interface powered by `rich` and `questionary` with real-time speed, ETA, and progress bars. Press `p` to pause, `r` to resume.
-- **Cross-Platform** — Works on Windows, macOS, and Linux with platform-specific FFmpeg handling.
-- **Auto-Update Check** — Checks PyPI once a day and notifies you when a new version is available.
-
-## Prerequisites
-
-- **Python 3.8+**
-- **FFmpeg** — Required for muxing video and audio streams, and converting to `.mp3`. IDM-CLI can auto-download it for you, or you can install it manually:
-  - Windows: `winget install ffmpeg`
-  - macOS: `brew install ffmpeg`
-  - Linux: `sudo apt install ffmpeg`
-
-## Installation
-
-```bash
-# From PyPI
-pip install idm-cli
-
-# From source
-git clone https://github.com/rj41-w2/idm-cli.git
-cd IDM-CLI
-pip install -r requirements.txt
-pip install -e .
-```
-
-## Usage
-
-Run the app interactively:
-
-```bash
-idm
-```
-
-This opens a prompt where you can paste your link, select video quality, or queue the download.
-
-### CLI Flags (Fast Mode)
-
-Skip the interactive menus by passing arguments directly:
-
-```bash
-# Download a video at 1080p
-idm "https://youtube.com/watch?v=..." -q 1080p -v
-
-# Audio only (converts to MP3)
-idm "https://youtube.com/watch?v=..." -a
-
-# 16 parallel chunks for maximum speed
-idm "https://example.com/largefile.zip" -c 16
-
-# Add to queue
-idm "https://facebook.com/..." -Q
-```
-
-| Flag | Description |
-|------|-------------|
-| `-q <resolution>` | Set video quality (e.g., `1080p`, `720p`) |
-| `-a` | Audio only — download and convert to MP3 |
-| `-v` | Download video + audio (bypasses quality prompt) |
-| `-Q` | Add to queue instead of downloading immediately |
-| `-c <num>` | Number of parallel chunks (default: 8) |
-| `-f <filename>` | Force a custom output filename |
-
-### Interactive Commands
-
-| Command | Description |
-|---------|-------------|
-| `<URL>` | Download a video or file |
-| `resume` | Resume or delete incomplete downloads |
-| `start queue` | Process all queued downloads |
-| `help` | Show available commands and flags |
-| `exit` | Exit the application |
-
-### Troubleshooting: Windows Device Guard
-
-If you get `"idm.exe was blocked by your organization's Device Guard policy"`, run the Python module directly:
-
-```bash
-python -m idm_cli
-```
-
-## Architecture
-
-```
-idm_cli/
-├── config.py                # Platform-aware config, logging, paths
-├── update_checker.py        # PyPI version check
-├── ui/
-│   ├── cli.py               # Main interactive CLI
-│   └── utils.py             # Console, progress listener, validators
-├── downloader/
-│   ├── core.py              # Download orchestration & FFmpeg setup
-│   ├── downloader.py        # Async chunk download engine
-│   ├── handlers.py          # Queue & resume handlers
-│   ├── muxer.py             # FFmpeg mux/conversion
-│   └── state.py             # Atomic JSON state persistence
-├── extractors/
-│   ├── ytdlp.py             # YouTube/social media extractor
-│   ├── direct.py            # Direct HTTP file downloader
-│   └── winget.py            # Windows Package Manager extractor
-```
-
-## Contributing
-
-Contributions are welcome. Fork the repo, make your changes on a feature branch, and open a PR against `main`. Keep changes focused and follow the existing code style.
-
-For bug reports and feature requests, [open an issue](https://github.com/rj41-w2/idm-cli/issues).
-
-## License
-
-This project is licensed under the [MIT License](LICENSE).
+<div align="center">
+
+<h1>IDM-CLI</h1>
+
+**A lightning-fast, cross-platform command-line download manager written in Python.**
+
+*The official IDM asks you to pay after 30 days — IDM-CLI is 100% free, open-source, and yours to modify!*
+
+[![PyPI version](https://img.shields.io/pypi/v/idm-cli?color=blue&label=pypi%20version)](https://pypi.org/project/idm-cli/)
+[![Downloads](https://static.pepy.tech/badge/idm-cli)](https://pepy.tech/project/idm-cli)
+[![License](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/rj41-w2/idm-cli/blob/main/LICENSE)
+![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)
+[![Install](https://img.shields.io/badge/install-pip%20install%20idm--cli-brightgreen)](https://pypi.org/project/idm-cli/)
+
+[Download via PyPI](https://pypi.org/project/idm-cli/) · [Report a Bug](https://github.com/rj41-w2/idm-cli/issues)
+
+</div>
+
+IDM-CLI splits files into multiple parallel chunks (default 8, up to 32) to maximize your internet speed. It supports downloading from **YouTube**, **Facebook**, **Instagram**, and any **Direct File URL** (`.exe`, `.zip`, `.pdf`, etc.).
+
+## Features
+
+- **Parallel Chunk Engine** — Splits downloads into multiple concurrent chunks using `curl-cffi` async sessions to fully saturate your bandwidth.
+- **Universal Downloader** — Paste any URL. yt-dlp handles 1000+ sites (YouTube, Facebook, Instagram, etc.), with automatic fallback to direct HTTP download for unsupported URLs.
+- **Audio Only / MP3 Conversion** — Download videos as audio. IDM-CLI automatically grabs the best audio stream and uses FFmpeg to convert it to `.mp3`.
+- **Smart Auto-Resume** — Internet dropped? Pressed `Ctrl+C`? No problem. IDM-CLI remembers the exact byte positions of all incomplete chunks. Paste the same link again to resume instantly.
+- **Persistent Queue System** — Add multiple files to a queue with `-Q` and type `start queue` to download them all sequentially.
+- **Interactive UI** — Modern terminal interface powered by `rich` and `questionary` with real-time speed, ETA, and progress bars. Press `p` to pause, `r` to resume.
+- **Cross-Platform** — Works on Windows, macOS, and Linux with platform-specific FFmpeg handling.
+- **Auto-Update Check** — Checks PyPI once a day and notifies you when a new version is available.
+
+## Prerequisites
+
+- **Python 3.8+**
+- **FFmpeg** — Required for muxing video and audio streams, and converting to `.mp3`. IDM-CLI can auto-download it for you, or you can install it manually:
+  - Windows: `winget install ffmpeg`
+  - macOS: `brew install ffmpeg`
+  - Linux: `sudo apt install ffmpeg`
+
+## Installation
+
+```bash
+# From PyPI
+pip install idm-cli
+
+# From source
+git clone https://github.com/rj41-w2/idm-cli.git
+cd IDM-CLI
+pip install -r requirements.txt
+pip install -e .
+```
+
+## Usage
+
+Run the app interactively:
+
+```bash
+idm
+```
+
+This opens a prompt where you can paste your link, select video quality, or queue the download.
+
+### CLI Flags (Fast Mode)
+
+Skip the interactive menus by passing arguments directly:
+
+```bash
+# Download a video at 1080p
+idm "https://youtube.com/watch?v=..." -q 1080p -v
+
+# Audio only (converts to MP3)
+idm "https://youtube.com/watch?v=..." -a
+
+# 16 parallel chunks for maximum speed
+idm "https://example.com/largefile.zip" -c 16
+
+# Add to queue
+idm "https://facebook.com/..." -Q
+```
+
+| Flag | Description |
+|------|-------------|
+| `-q <resolution>` | Set video quality (e.g., `1080p`, `720p`) |
+| `-a` | Audio only — download and convert to MP3 |
+| `-v` | Download video + audio (bypasses quality prompt) |
+| `-Q` | Add to queue instead of downloading immediately |
+| `-c <num>` | Number of parallel chunks (default: 8) |
+| `-f <filename>` | Force a custom output filename |
+
+### Interactive Commands
+
+| Command | Description |
+|---------|-------------|
+| `<URL>` | Download a video or file |
+| `resume` | Resume or delete incomplete downloads |
+| `start queue` | Process all queued downloads |
+| `help` | Show available commands and flags |
+| `exit` | Exit the application |
+
+### Troubleshooting: Windows Device Guard
+
+If you get `"idm.exe was blocked by your organization's Device Guard policy"`, run the Python module directly:
+
+```bash
+python -m idm_cli
+```
+
+## Architecture
+
+```
+idm_cli/
+├── config.py                # Platform-aware config, logging, paths
+├── update_checker.py        # PyPI version check
+├── ui/
+│   ├── cli.py               # Main interactive CLI
+│   └── utils.py             # Console, progress listener, validators
+├── downloader/
+│   ├── core.py              # Download orchestration & FFmpeg setup
+│   ├── downloader.py        # Async chunk download engine
+│   ├── handlers.py          # Queue & resume handlers
+│   ├── muxer.py             # FFmpeg mux/conversion
+│   └── state.py             # Atomic JSON state persistence
+├── extractors/
+│   ├── ytdlp.py             # YouTube/social media extractor
+│   ├── direct.py            # Direct HTTP file downloader
+│   └── winget.py            # Windows Package Manager extractor
+```
+
+## Contributing
+
+Contributions are welcome. Fork the repo, make your changes on a feature branch, and open a PR against `main`. Keep changes focused and follow the existing code style.
+
+For bug reports and feature requests, [open an issue](https://github.com/rj41-w2/idm-cli/issues).
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

idm_cli-1.3.3/idm_cli/__init__.py

@@ -0,0 +1,3 @@
+# IDM-CLI Package
+
+__version__ = "1.3.3"

idm_cli-1.3.3/idm_cli/config.py

@@ -0,0 +1,156 @@
+import json
+import logging
+import os
+import shutil
+from logging.handlers import RotatingFileHandler
+
+from platformdirs import user_data_dir, user_downloads_dir
+
+__all__ = [
+    "CONFIG_DIR",
+    "CONFIG_FILE",
+    "load_config",
+    "logger",
+    "mute_console_logging",
+    "save_config",
+    "setup_logging",
+    "unmute_console_logging",
+]
+
+APP_NAME = "idm-cli"
+APP_AUTHOR = "idm-cli"
+CONFIG_DIR = user_data_dir(APP_NAME, APP_AUTHOR)
+CONFIG_FILE = os.path.join(CONFIG_DIR, "config.json")
+LOG_FILE = os.path.join(CONFIG_DIR, "idm.log")
+
+
+def _migrate_old_config() -> None:
+    old_dir = os.path.expanduser("~/.idm_cli")
+    if old_dir == CONFIG_DIR:
+        return
+    if not os.path.isdir(old_dir):
+        return
+    os.makedirs(CONFIG_DIR, exist_ok=True)
+    for item in os.listdir(old_dir):
+        if item == "__pycache__":
+            continue
+        src = os.path.join(old_dir, item)
+        dst = os.path.join(CONFIG_DIR, item)
+        if not os.path.exists(dst):
+            try:
+                if os.path.isdir(src):
+                    shutil.copytree(src, dst)
+                else:
+                    shutil.copy2(src, dst)
+            except OSError:
+                pass
+
+
+def _get_default_download_dir() -> str:
+    return user_downloads_dir()
+
+
+def setup_logging() -> logging.Logger:
+    logger = logging.getLogger("idm_cli")
+    logger.setLevel(logging.DEBUG)
+    if not logger.handlers:
+        formatter = logging.Formatter(
+            "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
+        )
+
+        try:
+            _migrate_old_config()
+            os.makedirs(CONFIG_DIR, exist_ok=True)
+            file_handler = RotatingFileHandler(
+                LOG_FILE, maxBytes=5 * 1024 * 1024, backupCount=2, encoding="utf-8"
+            )
+            file_handler.setFormatter(formatter)
+            logger.addHandler(file_handler)
+        except OSError:
+            # Logging must never prevent the CLI from starting (for example in a
+            # read-only home directory or a restricted CI environment).
+            pass
+
+        stream_handler = logging.StreamHandler()
+        stream_handler.setLevel(logging.INFO)
+        stream_handler.setFormatter(formatter)
+        try:
+            stream_handler.stream.reconfigure(errors="backslashreplace")
+        except AttributeError:
+            pass
+        logger.addHandler(stream_handler)
+    return logger
+
+
+logger = setup_logging()
+
+DEFAULT_CONFIG = {
+    "default_chunks": 8,
+    "default_quality": "720p",
+    "download_dir": _get_default_download_dir(),
+    "last_version": "0.0.0",
+}
+
+
+def load_config() -> dict:
+    config = DEFAULT_CONFIG.copy()
+    if os.path.exists(CONFIG_FILE):
+        try:
+            with open(CONFIG_FILE, "r") as f:
+                user_config = json.load(f)
+                if isinstance(user_config, dict):
+                    config.update(user_config)
+                else:
+                    raise TypeError("config root must be an object")
+        except (OSError, TypeError, json.JSONDecodeError) as e:
+            logger.warning(f"Failed to load config: {e}")
+    chunks = config.get("default_chunks")
+    if not isinstance(chunks, int) or not 1 <= chunks <= 32:
+        config["default_chunks"] = DEFAULT_CONFIG["default_chunks"]
+    if not isinstance(config.get("default_quality"), str):
+        config["default_quality"] = DEFAULT_CONFIG["default_quality"]
+    if (
+        not isinstance(config.get("download_dir"), str)
+        or not config["download_dir"].strip()
+    ):
+        config["download_dir"] = DEFAULT_CONFIG["download_dir"]
+    return config
+
+
+def save_config(config_data: dict) -> None:
+    os.makedirs(CONFIG_DIR, exist_ok=True)
+    try:
+        with open(CONFIG_FILE, "w") as f:
+            json.dump(config_data, f, indent=4)
+    except OSError as e:
+        logger.error(f"Failed to save config: {e}")
+
+
+def mute_console_logging() -> None:
+    """Remove the StreamHandler from the logger so logs go to file only (used during active downloads)."""
+    _logger = logging.getLogger("idm_cli")
+    for handler in list(_logger.handlers):
+        if isinstance(handler, logging.StreamHandler) and not isinstance(
+            handler, RotatingFileHandler
+        ):
+            _logger.removeHandler(handler)
+
+
+def unmute_console_logging() -> None:
+    """Re-attach a StreamHandler if it was removed."""
+    _logger = logging.getLogger("idm_cli")
+    has_stream = any(
+        isinstance(h, logging.StreamHandler) and not isinstance(h, RotatingFileHandler)
+        for h in _logger.handlers
+    )
+    if not has_stream:
+        formatter = logging.Formatter(
+            "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
+        )
+        stream_handler = logging.StreamHandler()
+        stream_handler.setFormatter(formatter)
+        try:
+            stream_handler.stream.reconfigure(errors="backslashreplace")
+        except AttributeError:
+            pass
+        _logger.addHandler(stream_handler)