$ show RicterZ/doujinshi-dl
A Python CLI tool for searching, downloading, and organizing doujinshi (self-published manga) from configurable mirror sites. The architecture uses a plugin system defined via abstract base classes (BaseParser, BaseModel, BaseSerializer, BasePlugin) and discovered through Python entry points, allowing support for multiple sites (e.g., nhentai) without modifying the core code. The core package handles CLI argument parsing, asynchronous image downloading via httpx/asyncio with retry and proxy support, export to CBZ/PDF/ZIP, generation of HTML viewers for local browsing, and SQLite-based download history tracking. The codebase is well-structured with clear separation between core utilities and plugin-specific logic, though it contains duplicated viewer template files that indicate incomplete cleanup.
The LLM identified 3 files worth highlighting for reuse:
Defines the abstract base classes for the plugin architecture (BaseParser, BaseModel, BaseSerializer, BasePlugin) that any site plugin must implement. This is the contract that enables the main package to work with any supported site without hardcoding site-specific logic. The design is clean, minimal, and could be extracted to build a similar plugin-based tool for other content types.
Implements plugin discovery using Python's importlib.metadata.entry_points. Provides get_first_plugin() and get_plugin(name) functions that lazily load plugins registered under the 'doujinshi_dl.plugins' group. This pattern is reusable for any Python application that needs to discover and load third-party plugins at runtime.
Provides an async image downloader with concurrency control (asyncio.Semaphore), retry logic, proxy support, and mirror fallback for image URLs. The Downloader class uses a Singleton metaclass to share state across the application. A CompressedDownloader subclass writes directly to a ZIP file instead of the filesystem. The download logic is self-contained and could be reused for any batch image download task.