v3.0.0

.github/workflows/build.yml

@@ -159,7 +159,7 @@ jobs:
     runs-on: windows-latest
     strategy:
       matrix:
-        python-version: [ '3.8', '3.9', '3.10' ]
+        python-version: [ '3.10', '3.11', '3.12', '3.13' ]
 
     steps:
       # Make sure cancels CI when tags is released
@@ -206,7 +206,7 @@ jobs:
           Write-Output "python_version=${PythonVersion}" | Out-File -FilePath $env:GITHUB_ENV -Append
 
       # Build mangadex-downloader with PyInstaller
-      # only allow python 3.10
+      # only allow python 3.13
 
       - name: Setup python (x86)
         uses: actions/setup-python@v4
@@ -215,19 +215,19 @@ jobs:
           architecture: x86
 
       - name: Compile script
-        if: ${{ contains(env.python_version, '3.10') }}
+        if: ${{ contains(env.python_version, '3.13') }}
         run: |
           py -${{ matrix.python-version }}-64 -m PyInstaller "mangadex-dl_x64.spec" --distpath "./dist_x64"
           py -${{ matrix.python-version }}-32 -m PyInstaller "mangadex-dl_x86.spec" --distpath "./dist_x86"
 
       - name: Run compiled script
-        if: ${{ contains(env.python_version, '3.10') }}
+        if: ${{ contains(env.python_version, '3.13') }}
         run: |
           & ".\dist_x64\mangadex-dl_x64\mangadex-dl_x64.exe" --version
           & ".\dist_x86\mangadex-dl_x86\mangadex-dl_x86.exe" --version
 
       - name: Cleanup build
-        if: contains(env.python_version, '3.10')
+        if: contains(env.python_version, '3.13')
         run: |
           # x86 executable
           copy "LICENSE" "dist_x86\mangadex-dl_x86"
@@ -252,21 +252,21 @@ jobs:
           Compress-Archive -Path "dist_x64\mangadex-dl" -DestinationPath "mangadex-dl_x64_${{ github.ref_name }}.zip"
 
       - name: Upload artifact (x64)
-        if: contains(env.python_version, '3.10')
+        if: contains(env.python_version, '3.13')
         uses: actions/upload-artifact@v3
         with:
           name: mangadex-dl_x64
           path: dist_x64/mangadex-dl/
 
       - name: Upload artifact (x86)
-        if: contains(env.python_version, '3.10')
+        if: contains(env.python_version, '3.13')
         uses: actions/upload-artifact@v3
         with:
           name: mangadex-dl_x86
           path: dist_x86/mangadex-dl/
 
       - name: Get File hash
-        if: contains(env.python_version, '3.10')
+        if: contains(env.python_version, '3.13')
         run: |
           $File_x86 = "mangadex-dl_x86_${{ github.ref_name }}.zip"
           $File_x64 = "mangadex-dl_x64_${{ github.ref_name }}.zip"

.github/workflows/build_pr.yml

@@ -55,7 +55,7 @@ jobs:
     runs-on: windows-latest
     strategy:
       matrix:
-        python-version: [ '3.8', '3.9', '3.10' ]
+        python-version: [ '3.10', '3.11', '3.12', '3.13' ]
 
     steps:
       - name: Clone repo
@@ -96,22 +96,22 @@ jobs:
           Write-Output "python_version=${PythonVersion}" | Out-File -FilePath $env:GITHUB_ENV -Append
 
       # Build mangadex-downloader with PyInstaller
-      # only allow python 3.10
+      # only allow python 3.13
 
       - name: Compile script
-        if: ${{ contains(env.python_version, '3.10') }}
+        if: ${{ contains(env.python_version, '3.13') }}
         run: |
           py -${{ matrix.python-version }}-64 -m PyInstaller "mangadex-dl_x64.spec" --distpath "./dist_x64"
           py -${{ matrix.python-version }}-32 -m PyInstaller "mangadex-dl_x86.spec" --distpath "./dist_x86"
 
       - name: Run compiled script
-        if: ${{ contains(env.python_version, '3.10') }}
+        if: ${{ contains(env.python_version, '3.13') }}
         run: |
           & ".\dist_x64\mangadex-dl_x64\mangadex-dl_x64.exe" --version
           & ".\dist_x86\mangadex-dl_x86\mangadex-dl_x86.exe" --version
 
       - name: Cleanup build
-        if: contains(env.python_version, '3.10')
+        if: contains(env.python_version, '3.13')
         run: |
           # x86 executable
           copy "LICENSE" "dist_x86\mangadex-dl_x86"
@@ -134,23 +134,23 @@ jobs:
           Compress-Archive -Path "dist_x64\mangadex-dl" -DestinationPath "mangadex-dl_x64.zip"
 
       - name: Upload artifact (x64)
-        if: contains(env.python_version, '3.10')
+        if: contains(env.python_version, '3.13')
         uses: actions/upload-artifact@v3
         with:
           name: mangadex-dl_x64
           path: dist_x64/mangadex-dl/
 
       - name: Upload artifact (x86)
-        if: contains(env.python_version, '3.10')
+        if: contains(env.python_version, '3.13')
         uses: actions/upload-artifact@v3
         with:
           name: mangadex-dl_x86
           path: dist_x86/mangadex-dl/
 
-      # Only build docs in Python 3.10
+      # Only build docs in Python 3.13
 
       - name: Build docs
-        if: contains(env.python_version, '3.10')
+        if: contains(env.python_version, '3.13')
         run: |
           cd docs
           sphinx-build -M "html" "." "_build"

.gitignore

@@ -5,4 +5,5 @@ docs/_build
 *.code-workspace
 bugs.txt
 ideas.txt
-*.db
+*.db
+env

.readthedocs.yml

@@ -14,9 +14,14 @@ sphinx:
 formats:
    - pdf
 
+# Set the OS, Python version and other tools you might need
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.12"
+
 # Optionally set the version of Python and requirements required to build your docs
 python:
-   version: "3.8"
    install: 
     - method: pip
       path: .

.vscode/launch.json

@@ -0,0 +1,15 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Python Debugger: Current File",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "test5.py",
+            "console": "integratedTerminal"
+        }
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,13 @@
+{
+    "ruff.lint.args": [
+        "--config=${workspaceFolder}/ruff.toml"
+    ],
+    "[python]": {
+        "editor.formatOnSave": true,
+        "editor.defaultFormatter": "ms-python.black-formatter",
+        "editor.codeActionsOnSave": {
+            "source.fixAll": "explicit"
+        }
+    },
+    "python.formatting.provider": "none"
+}

CONTRIBUTING.md

@@ -16,5 +16,5 @@ Make sure you provide detailed informations like:
 
 Want to add new features ? fix a bug ? made changes to help the app better and faster ? Fork the repository and [send the Pull Request](https://github.com/mansuf/mangadex-downloader/pulls). 
 
-**NOTE:** Before sending a pull request, you have to make sure the code that you're writing are compatible with Python 3.8. 
-Because minimum Python version for developing this app are 3.8
+**NOTE:** Before sending a pull request, you have to make sure the code that you're writing are compatible with Python 3.10. 
+Because minimum Python version for developing this app are 3.10

Dockerfile

@@ -1,4 +1,4 @@
-FROM python:3.11-alpine
+FROM python:3.13-alpine
 
 COPY . /app
 WORKDIR /app

Dockerfile.optional

@@ -1,4 +1,4 @@
-FROM python:3.11
+FROM python:3.13
 
 COPY . /app
 WORKDIR /app
@@ -8,7 +8,7 @@ RUN apt update && apt install wget
 ENV RUSTUP_HOME=/usr/local/rustup \
     CARGO_HOME=/usr/local/cargo \
     PATH=/usr/local/cargo/bin:$PATH \
-    RUST_VERSION=1.78.0
+    RUST_VERSION=1.84.0
 RUN wget https://sh.rustup.rs -O rustup.sh
 RUN chmod +x ./rustup.sh
 RUN ./rustup.sh -y --no-modify-path --profile minimal --default-toolchain $RUST_VERSION

README.md

@@ -3,7 +3,6 @@
 [![pypi-release-ver](https://img.shields.io/pypi/v/mangadex-downloader?style=for-the-badge)](https://pypi.org/project/mangadex-downloader)
 [![](https://dcbadge.limes.pink/api/server/NENvQ5b5Pt)](https://discord.gg/NENvQ5b5Pt)
 
-
 # mangadex-downloader
 
 [![Indonesian](https://img.shields.io/badge/Language-Indonesian-blue.svg)](https://github.com/mansuf/mangadex-downloader/blob/main/README.id.md)
@@ -35,16 +34,17 @@ A command-line tool to download manga from [MangaDex](https://mangadex.org/), wr
 - Download manga, cover manga, chapter, or list directly from MangaDex
 - Download manga or list from user library
 - Find and download MangaDex URLs from MangaDex forums ([https://forums.mangadex.org/](https://forums.mangadex.org/))
+- Download manga in each chapters, each volumes, or wrap all chapters into single file
+- Search (with filters) and download manga
+- Filter chapters with scalantion groups or users
+- Manga tags, groups, and users blacklist support
 - Batch download support
-- Legacy MangaDex url support
-- Scanlation groups filter support
-- Authentication support
+- Authentication (with cache) support
 - Control how many chapters and pages you want to download
-- Compressed images support
-- HTTP / SOCKS proxy support
-- DNS-over-HTTPS support
 - Multi languages support
+- Legacy MangaDex url support
 - Save as raw images, EPUB, PDF, Comic Book Archive (.cbz or .cb7)
+- Respect API rate limit
 
 ***And ability to not download oneshot chapter***
 
@@ -123,11 +123,11 @@ You can use tag ending with `-optional`
 ```sh
 # Dockerhub
 docker pull mansuf/mangadex-downloader:latest-optional
-docker pull mansuf/mangadex-downloader:v2.10.3-optional
+docker pull mansuf/mangadex-downloader:v3.0.0-optional
 
 # AWS ECR (Alternative)
 docker pull public.ecr.aws/mansuf/mangadex-downloader:latest-optional
-docker pull public.ecr.aws/mansuf/mangadex-downloader:v2.10.3-optional
+docker pull public.ecr.aws/mansuf/mangadex-downloader:v3.0.0-optional
 ```
 
 **NOTE**: If you're wondering why optional tags doesn't have arm/v6 platform support. 

docs/changelog.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## v3.0.0
+
+### Breaking changes
+
+- Change `--path` behaviour to absolute path with placeholders support
+- Now, if a manga that doesn't have no volume, it will get separated (chapters format) rather than being merged into single file called `No volume.cbz` (example). However if you prefer old behaviour (merge no volume chapters into single file) you can use `--create-no-volume`.
+- Dropped support for Python v3.8 and v3.9
+
+### Improvements
+
+- Refactored code base using ruff linter and black formatter
+- The app now showing `X-Request-ID` if the app encountered `Unhandled HTTP error` that can be reported to MangaDex devs
+- Missing dependencies error is now closing the application (do not ignore it)
+- `ComicInfo.xml` file are now generated for volumes as well
+- Options `--start-page` and `--end-page` are now support negative values (relative to end of chapter)
+
+### New features
+
+- Added `--ignore-missing-chapters` option to ignore missing chapters
+- Added support for oauth private client
+- Added `--create-manga-info` option to download manga information only
+- Added `--order` option to change chapters released order (newest or oldest)
+- Added `--group-nomatch-behaviour` to manage `--group` filter behaviour
+- Added `--no-metadata` option to disable metadata creation on any cbz formats
+- Added `--page-size` option to manage maximum items fit per page in any commands
+- Added `--run-forever` to run the app indefinitely until crashed or stopped manually by user
+
+### Fix bugs
+
+- Fix `download.db` is modified if there is not new chapters available. 
+- Fix `epub-volume` format doesn't adding cover art
+- Fix default volume covers behaviour. (See [#105](https://github.com/mansuf/mangadex-downloader/issues/105) for more info)
+
 ## v2.10.3
 
 ### Fix bugs

docs/cli_ref/cli_options.md

@@ -124,6 +124,15 @@ Volume cover will be placed in first page in each volume files.
 Download sorting method, by default it's selected to `volume`
 ```
 
+````{option} --ignore-missing-chapters -imc
+```{warning}
+This option cannot be used with `--no-track` option
+```
+
+Ignore missing chapters. 
+This will prevent the application to re-download the missing chapters.
+````
+
 ## Chapter page related
 
 ```{option} --start-page -sp PAGE