feat: Upgrade to Python 3.13 with full compatibility and modernization

- Upgrade base image from Ubuntu Jammy to Noble (24.04 LTS)
- Add deadsnakes PPA for Python 3.13.7 installation
- Update Dockerfile to use Python 3.13 with proper virtual environment setup
- Fix package dependencies (libldap2 vs libldap-2.5-0 for Noble)
- Create comprehensive pyproject.toml with Python 3.10-3.13 support declarations
- Update requirements.txt with conditional dependencies:
  * iso-639>=0.4.5,<0.5.0 for Python <3.12
  * pycountry>=24.6.1,<25.0.0 for Python >=3.12 (fixes pkg_resources deprecation)
- Update GitHub Actions workflow to use Python 3.13
- Move development documentation to DEV/ directory:
  * PYTHON_313_UPGRADE.md
  * PYTHON_313_UPGRADE_STATUS.md
  * V0.6.25_fixes_analysis.ipynb

Benefits:
- Improved performance and memory efficiency
- Enhanced error messages and debugging
- Future-proof with Python 3.13 support until 2029
- Eliminates pkg_resources deprecation warnings
- Maintains full backward compatibility

Tested: Full Docker build successful, all CWA services operational

Author: crocodilestick

.github/workflows/update-translations.yml

@@ -22,7 +22,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.12'
+          python-version: '3.13'
 
       - name: Install dependencies
         run: pip install Babel polib jinja2

CONTRIBUTORS

@@ -1,7 +1,7 @@
 CONTRIBUTORS
 
 This file is automatically generated. DO NOT EDIT MANUALLY.
-Generated on: 2025-09-02T15:06:44.716826Z
+Generated on: 2025-09-02T16:32:33.527271Z
 
 Upstream project: https://github.com/janeczku/calibre-web
 Fork project (Calibre-Web Automated, since 2024): https://github.com/crocodilestick/calibre-web-automated
@@ -289,7 +289,7 @@ Copyright (C) 2024-2025 Calibre-Web Automated contributors
 - zhiyue (1 commits)
 # Fork Contributors (crocodilestick/calibre-web-automated)
 
-- crocodilestick (598 commits)
+- crocodilestick (601 commits)
 - jmarmstrong1207 (73 commits)
 - demitrix (30 commits)
 - sirwolfgang (22 commits)
@@ -310,6 +310,7 @@ Copyright (C) 2024-2025 Calibre-Web Automated contributors
 - Valenth (2 commits)
 - Andrej Kralj (anon) (1 commits)
 - bcrdncola (1 commits)
+- brunofin (1 commits)
 - Buco7854 (1 commits)
 - cascandaliato (1 commits)
 - Daniel Egberts (anon) (1 commits)

Dockerfile

@@ -1,7 +1,7 @@
 # syntax=docker/dockerfile:1
 
 FROM ghcr.io/linuxserver/unrar:latest AS unrar
-FROM ghcr.io/linuxserver/baseimage-ubuntu:jammy
+FROM ghcr.io/linuxserver/baseimage-ubuntu:noble
 
 # Set the default shell for the following RUN instructions to bash instead of sh
 SHELL ["/bin/bash", "-c"]
@@ -37,45 +37,52 @@ LABEL maintainer="CrocodileStick"
 COPY --chown=abc:abc . /app/calibre-web-automated/
 # STEP 1 - Install Required Packages
 RUN \
-  # STEP 1.1 - Install required apt packages
-  echo "**** install build packages ****" && \
+  # STEP 1.1 - Add deadsnakes PPA for Python 3.13 and install required apt packages
+  echo "**** add deadsnakes PPA for Python 3.13 ****" && \
+  apt-get update && \
+  apt-get install -y --no-install-recommends software-properties-common && \
+  add-apt-repository ppa:deadsnakes/ppa && \
   apt-get update && \
+  echo "**** install build packages ****" && \
   apt-get install -y --no-install-recommends \
     build-essential \
     libldap2-dev \
     libsasl2-dev \
     gettext \
-    python3-dev && \
+    python3.13-dev \
+    python3.13-venv && \
   echo "**** install runtime packages ****" && \
   apt-get install -y --no-install-recommends \
     imagemagick \
     ghostscript \
-    libldap-2.5-0 \
+    libldap2 \
     libmagic1 \
     libsasl2-2 \
     libxi6 \
     libxslt1.1 \
     xdg-utils \
     inotify-tools \
-    python3 \
-    python3-pip \
+    python3.13 \
     nano \
     sqlite3 \
     zip \
-    lsof \
-    python3-venv && \
+    lsof && \
+  # Create python3 symlink to point to python3.13
+  ln -sf /usr/bin/python3.13 /usr/bin/python3 && \
+  # Install pip for Python 3.13
+  curl -sS https://bootstrap.pypa.io/get-pip.py | python3.13 && \
   # STEP 1.2 - Set up a python virtual environment and install pip and wheel packages
   cd /app/calibre-web-automated && \
-  python3 -m venv /lsiopy && \
-  pip install -U --no-cache-dir \
+  python3.13 -m venv /lsiopy && \
+  /lsiopy/bin/pip install -U --no-cache-dir \
     pip \
     wheel && \
   # STEP 1.3 - Installing the required python packages listed in 'requirements.txt' and 'optional-requirements.txt'
     # HOWEVER, they are not pulled from PyPi directly, they are pulled from linuxserver's Ubuntu Wheel Index
     # This is essentially a repository of precompiled some of the most popular packages with C/C++ source code
     # This provides the install maximum compatibility with multiple different architectures including: x86_64, armv71 and aarch64
     # You can read more about python wheels here: https://realpython.com/python-wheels/
-  pip install -U --no-cache-dir --find-links https://wheel-index.linuxserver.io/ubuntu/ -r \
+  /lsiopy/bin/pip install -U --no-cache-dir --find-links https://wheel-index.linuxserver.io/ubuntu/ -r \
     requirements.txt -r optional-requirements.txt && \
 # STEP 2 - Move contents of /app/calibre-web-automated/root to / and delete the /app/calibre-web-automated/root directory
   cp -R /app/calibre-web-automated/root/* / && \
@@ -175,7 +182,8 @@ RUN \
     libldap2-dev \
     libsasl2-dev \
     gettext \
-    python3-dev && \
+    python3.13-dev \
+    software-properties-common && \
   apt-get -y autoremove && \
   rm -rf \
     /tmp/* \

cps/db.py

@@ -125,12 +125,18 @@ def format_type(self):
             return "ISSN"
         elif format_type == "isfdb":
             return "ISFDB"
-        if format_type == "lubimyczytac":
+        elif format_type == "lubimyczytac":
             return "Lubimyczytac"
-        if format_type == "databazeknih":
+        elif format_type == "databazeknih":
             return "Databáze knih"
-        if format_type == "hardcover-slug":
+        elif format_type == "hardcover-slug":
             return "Hardcover"
+        elif format_type == "storygraph":
+            return "StoryGraph"
+        elif format_type == "smashwords":
+            return "Smashwords"
+        elif format_type == "ebooks":
+            return "Ebooks.com"
         else:
             return self.type
 
@@ -170,6 +176,12 @@ def __repr__(self):
             return "https://hardcover.app/books/{0}".format(self.val)
         elif format_type == "ibdb":
             return "https://ibdb.dev/book/{0}".format(self.val)
+        elif format_type == "storygraph":
+            return "https://app.thestorygraph.com/books/{0}".format(self.val)
+        elif format_type == "smashwords":
+            return "https://www.smashwords.com/books/view/{0}".format(self.val)
+        elif format_type == "ebooks":
+            return "https://www.ebooks.com/en-{0}".format(self.val)
         elif self.val.lower().startswith("javascript:"):
             return quote(self.val)
         elif self.val.lower().startswith("data:"):

requirements.txt

@@ -5,6 +5,7 @@ Flask-Babel>=3.0.0,<4.1.0
 Flask-Principal>=0.3.2,<0.5.1
 Flask>=1.0.2,<3.2.0
 iso-639>=0.4.5,<0.5.0;python_version<'3.12'
+pycountry>=24.6.1,<25.0.0;python_version>='3.12'
 pypdf>=6.0.0
 pytz>=2016.10
 requests>=2.32.0,<2.33.0
@@ -31,7 +32,6 @@ requests>=2.32.4
 tabulate>=0.9.0
 urllib3>=2.5.0
 qrcode>=8.1
-pycountry>=24.6.1
 polib>=1.2.0
 
 # GDrive Integration
@@ -73,7 +73,6 @@ beautifulsoup4>=4.0.1,<4.14.0
 faust-cchardet>=2.1.18,<2.1.20
 py7zr>=0.15.0,<0.21.0
 mutagen>=1.40.0,<1.50.0
-pycountry>=20.0.0,<25.0.0
 
 # Comics
 natsort>=2.2.0,<8.5.0