structables 0.3.16__tar.gz → 0.4.1__tar.gz

{structables-0.3.16 → structables-0.4.1}/.forgejo/workflows/docker.yml

@@ -4,17 +4,14 @@ on:
   push:
     tags:
       - "*"
+  workflow_dispatch:
 
 jobs:
   docker:
     name: Docker Build and Push to Docker Hub
     container:
-      image: node:20-bookworm
+      image: catthehacker/ubuntu:act-latest
     steps:
-      - name: Install dependencies
-        run: |
-          apt update
-          apt install -y docker.io
       - name: Set up QEMU
         uses: docker/setup-qemu-action@v3
       - name: Set up Docker Buildx
@@ -25,9 +22,9 @@ jobs:
           username: ${{ secrets.DOCKERHUB_USERNAME }}
           password: ${{ secrets.DOCKERHUB_TOKEN }}
       - name: Build and push to Docker Hub
-        uses: docker/build-push-action@v5
+        uses: docker/build-push-action@v6
         with:
           push: true
           tags: |
             privatecoffee/structables:latest
-            privatecoffee/structables:${{ env.GITHUB_REF_NAME }}
+            privatecoffee/structables:${{ github.ref_name }}

{structables-0.3.16 → structables-0.4.1}/.forgejo/workflows/release.yml

@@ -10,7 +10,7 @@ jobs:
   publish:
     name: Publish to PyPI
     container:
-      image: node:20-bookworm
+      image: node:22-bookworm
 
     steps:
       - name: Check out code

{structables-0.3.16 → structables-0.4.1}/.gitignore

@@ -6,6 +6,8 @@ privacy.md
 privacy.txt
 *.pyc
 venv/
+/output
+/cache/
 
 # Special rules needed for building the Docker image
 /dist/*

{structables-0.3.16 → structables-0.4.1}/Dockerfile

@@ -1,4 +1,4 @@
-FROM alpine:3.20
+FROM alpine:3.21
 
 ENV APP_ENV=/opt/venv
 ENV PATH="${APP_ENV}/bin:$PATH"
@@ -12,10 +12,8 @@ RUN $APP_ENV/bin/pip install --no-cache-dir pip && \
   $APP_ENV/bin/pip install /app && \
   adduser -S -D -H structables
 
-COPY entrypoint.sh /entrypoint.sh
-
 EXPOSE 8002
 
 USER structables
 
-ENTRYPOINT ["/entrypoint.sh"]
+ENTRYPOINT ["/app/entrypoint.sh"]

{structables-0.3.16 → structables-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: structables
-Version: 0.3.16
+Version: 0.4.1
 Summary: A simple frontend for Instructables
 Project-URL: Homepage, https://git.private.coffee/privatecoffee/structables
 Project-URL: Bug Tracker, https://git.private.coffee/privatecoffee/structables/issues
@@ -672,7 +672,7 @@ Classifier: License :: OSI Approved :: GNU Affero General Public License v3
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.10
-Requires-Dist: bs4
+Requires-Dist: beautifulsoup4
 Requires-Dist: flask
 Requires-Dist: markdown2[all]
 Description-Content-Type: text/markdown
@@ -692,18 +692,26 @@ An open source alternative front-end to Instructables. This is a fork of <a href
 
 ## Instances
 
-| URL                                                                     | Provided by                                     | Country | Comments |
-| ----------------------------------------------------------------------- | ----------------------------------------------- | ------- | -------- |
-| [structables.private.coffee](https://structables.private.coffee/)       | [Private.coffee](https://private.coffee/)       | Austria |          |
-| [structables.bloat.cat](https://structables.bloat.cat/)                 | [Bloat.cat](https://bloat.cat)                  | Germany |          |
-| [structables.darkness.services](https://structables.darkness.services/) | [Darkness.services](https://darkness.services/) | USA     |          |
+<!-- START_INSTANCE_LIST type:eq=clearnet -->
+
+| URL                                                                    | Provided by                                    | Country          | Notes         |
+| ---------------------------------------------------------------------- | ---------------------------------------------- | ---------------- | ------------- |
+| [structables.private.coffee](https://structables.private.coffee)       | [Private.coffee](https://private.coffee)       | Austria 🇦🇹 🇪🇺    | Main instance |
+| [structables.bloat.cat](https://structables.bloat.cat)                 | [Bloat.cat](https://bloat.cat)                 | Germany 🇩🇪 🇪🇺    |               |
+| [structables.darkness.services](https://structables.darkness.services) | [Darkness.services](https://darkness.services) | United States 🇺🇸 |               |
+
+<!-- END_INSTANCE_LIST -->
 
 ### Tor Hidden Services
 
-| URL                                                                                                                                                              | Provided by                                     | Country | Comments |
-| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | ------- | -------- |
-| [structables.coffee2m3bjsrrqqycx6ghkxrnejl2q6nl7pjw2j4clchjj6uk5zozad.onion](http://structables.coffee2m3bjsrrqqycx6ghkxrnejl2q6nl7pjw2j4clchjj6uk5zozad.onion/) | [Private.coffee](https://private.coffee/)       | Austria |          |
-| [structables.darknessrdor43qkl2ngwitj72zdavfz2cead4t5ed72bybgauww5lyd.onion](http://structables.darknessrdor43qkl2ngwitj72zdavfz2cead4t5ed72bybgauww5lyd.onion/) | [Darkness.services](https://darkness.services/) | USA     |          |
+<!-- START_INSTANCE_LIST type:eq=onion -->
+
+| URL                                                                                                                                                             | Provided by                                    | Country          | Notes         |
+| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | ---------------- | ------------- |
+| [structables.coffee2m3bjsrrqqycx6ghkxrnejl2q6nl7pjw2j4clchjj6uk5zozad.onion](http://structables.coffee2m3bjsrrqqycx6ghkxrnejl2q6nl7pjw2j4clchjj6uk5zozad.onion) | [Private.coffee](https://private.coffee)       | Austria 🇦🇹 🇪🇺    | Main instance |
+| [structables.darknessrdor43qkl2ngwitj72zdavfz2cead4t5ed72bybgauww5lyd.onion](http://structables.darknessrdor43qkl2ngwitj72zdavfz2cead4t5ed72bybgauww5lyd.onion) | [Darkness.services](https://darkness.services) | United States 🇺🇸 |               |
+
+<!-- END_INSTANCE_LIST -->
 
 ### Adding Your Instance
 
@@ -729,6 +737,8 @@ Of course, you can also join our [Matrix room](https://matrix.pcof.fi/#/#structa
 
 ### Production: Docker
 
+**Note:** The Docker image is now hosted on [git.private.coffee](https://git.private.coffee/privatecoffee/structables/packages) instead of Docker Hub. Please use the new image name `git.private.coffee/privatecoffee/structables` instead of `privatecoffee/structables` to continue receiving updates.
+
 1. Copy `.env.example` to `.env` and adjust the settings as necessary
 2. Copy `docker-compose-example.yml` to `docker-compose.yml` and adjust it as necessary, for example modifying resource limits or changing the port/host configuration
 3. Build and run the Docker container:
@@ -760,6 +770,12 @@ Structables supports the use of the following environment variables for configur
 - `STRUCTABLES_UNSAFE`: If set, allow embedding untrusted iframes (if unset, display a warning and allow loading the content manually)
 - `STRUCTABLES_PRIVACY_FILE`: The path to a text file or Markdown file (with .md suffix) to use for the Privacy Policy page (if unset, try `privacy.txt` or `privacy.md` in the working directory, or fall back to a generic message)
 - `STRUCTABLES_DEBUG`: If set, log additional debug information to stdout
+- `STRUCTABLES_THEME`: Allows selecting a theme for the frontend. Currently, only `dark` and `light` are supported. If not set, it will be automatically detected based on the user's system settings, and a toggle will be provided in the header.
+- `STRUCTABLES_CACHE_ENABLED`: Whether to enable caching of proxied content (default: true). Set to "false" or "0" to disable caching.
+- `STRUCTABLES_CACHE_DIR`: The directory to use for caching proxied content (default: `structables_cache` within the temporary directory as returned by `tempfile.gettempdir()`)
+- `STRUCTABLES_CACHE_MAX_AGE`: The maximum age of cached content in seconds before it's considered stale (default: 604800 seconds, or 1 week)
+- `STRUCTABLES_CACHE_MAX_SIZE`: The maximum size of the cache directory in bytes (default: 1073741824 bytes, or 1GB)
+- `STRUCTABLES_CACHE_CLEANUP_INTERVAL`: How often to run the cache cleanup process in seconds (default: 3600 seconds, or 1 hour)
 
 ## License
 

{structables-0.3.16 → structables-0.4.1}/README.md

@@ -13,18 +13,26 @@ An open source alternative front-end to Instructables. This is a fork of <a href
 
 ## Instances
 
-| URL                                                                     | Provided by                                     | Country | Comments |
-| ----------------------------------------------------------------------- | ----------------------------------------------- | ------- | -------- |
-| [structables.private.coffee](https://structables.private.coffee/)       | [Private.coffee](https://private.coffee/)       | Austria |          |
-| [structables.bloat.cat](https://structables.bloat.cat/)                 | [Bloat.cat](https://bloat.cat)                  | Germany |          |
-| [structables.darkness.services](https://structables.darkness.services/) | [Darkness.services](https://darkness.services/) | USA     |          |
+<!-- START_INSTANCE_LIST type:eq=clearnet -->
+
+| URL                                                                    | Provided by                                    | Country          | Notes         |
+| ---------------------------------------------------------------------- | ---------------------------------------------- | ---------------- | ------------- |
+| [structables.private.coffee](https://structables.private.coffee)       | [Private.coffee](https://private.coffee)       | Austria 🇦🇹 🇪🇺    | Main instance |
+| [structables.bloat.cat](https://structables.bloat.cat)                 | [Bloat.cat](https://bloat.cat)                 | Germany 🇩🇪 🇪🇺    |               |
+| [structables.darkness.services](https://structables.darkness.services) | [Darkness.services](https://darkness.services) | United States 🇺🇸 |               |
+
+<!-- END_INSTANCE_LIST -->
 
 ### Tor Hidden Services
 
-| URL                                                                                                                                                              | Provided by                                     | Country | Comments |
-| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | ------- | -------- |
-| [structables.coffee2m3bjsrrqqycx6ghkxrnejl2q6nl7pjw2j4clchjj6uk5zozad.onion](http://structables.coffee2m3bjsrrqqycx6ghkxrnejl2q6nl7pjw2j4clchjj6uk5zozad.onion/) | [Private.coffee](https://private.coffee/)       | Austria |          |
-| [structables.darknessrdor43qkl2ngwitj72zdavfz2cead4t5ed72bybgauww5lyd.onion](http://structables.darknessrdor43qkl2ngwitj72zdavfz2cead4t5ed72bybgauww5lyd.onion/) | [Darkness.services](https://darkness.services/) | USA     |          |
+<!-- START_INSTANCE_LIST type:eq=onion -->
+
+| URL                                                                                                                                                             | Provided by                                    | Country          | Notes         |
+| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | ---------------- | ------------- |
+| [structables.coffee2m3bjsrrqqycx6ghkxrnejl2q6nl7pjw2j4clchjj6uk5zozad.onion](http://structables.coffee2m3bjsrrqqycx6ghkxrnejl2q6nl7pjw2j4clchjj6uk5zozad.onion) | [Private.coffee](https://private.coffee)       | Austria 🇦🇹 🇪🇺    | Main instance |
+| [structables.darknessrdor43qkl2ngwitj72zdavfz2cead4t5ed72bybgauww5lyd.onion](http://structables.darknessrdor43qkl2ngwitj72zdavfz2cead4t5ed72bybgauww5lyd.onion) | [Darkness.services](https://darkness.services) | United States 🇺🇸 |               |
+
+<!-- END_INSTANCE_LIST -->
 
 ### Adding Your Instance
 
@@ -50,6 +58,8 @@ Of course, you can also join our [Matrix room](https://matrix.pcof.fi/#/#structa
 
 ### Production: Docker
 
+**Note:** The Docker image is now hosted on [git.private.coffee](https://git.private.coffee/privatecoffee/structables/packages) instead of Docker Hub. Please use the new image name `git.private.coffee/privatecoffee/structables` instead of `privatecoffee/structables` to continue receiving updates.
+
 1. Copy `.env.example` to `.env` and adjust the settings as necessary
 2. Copy `docker-compose-example.yml` to `docker-compose.yml` and adjust it as necessary, for example modifying resource limits or changing the port/host configuration
 3. Build and run the Docker container:
@@ -81,6 +91,12 @@ Structables supports the use of the following environment variables for configur
 - `STRUCTABLES_UNSAFE`: If set, allow embedding untrusted iframes (if unset, display a warning and allow loading the content manually)
 - `STRUCTABLES_PRIVACY_FILE`: The path to a text file or Markdown file (with .md suffix) to use for the Privacy Policy page (if unset, try `privacy.txt` or `privacy.md` in the working directory, or fall back to a generic message)
 - `STRUCTABLES_DEBUG`: If set, log additional debug information to stdout
+- `STRUCTABLES_THEME`: Allows selecting a theme for the frontend. Currently, only `dark` and `light` are supported. If not set, it will be automatically detected based on the user's system settings, and a toggle will be provided in the header.
+- `STRUCTABLES_CACHE_ENABLED`: Whether to enable caching of proxied content (default: true). Set to "false" or "0" to disable caching.
+- `STRUCTABLES_CACHE_DIR`: The directory to use for caching proxied content (default: `structables_cache` within the temporary directory as returned by `tempfile.gettempdir()`)
+- `STRUCTABLES_CACHE_MAX_AGE`: The maximum age of cached content in seconds before it's considered stale (default: 604800 seconds, or 1 week)
+- `STRUCTABLES_CACHE_MAX_SIZE`: The maximum size of the cache directory in bytes (default: 1073741824 bytes, or 1GB)
+- `STRUCTABLES_CACHE_CLEANUP_INTERVAL`: How often to run the cache cleanup process in seconds (default: 3600 seconds, or 1 hour)
 
 ## License
 

{structables-0.3.16 → structables-0.4.1}/docker-compose-example-dev.yml

@@ -5,12 +5,13 @@ services:
     build: .
     ports:
       - "127.0.0.1:8002:8002"
+    volumes:
+      - ./cache:/app/structables_cache
     env_file: .env
     security_opt:
       - no-new-privileges:true
     cap_drop:
       - ALL
-    read_only: true
     deploy:
       resources:
         limits:

{structables-0.3.16 → structables-0.4.1}/docker-compose-example.yml

@@ -2,15 +2,16 @@ services:
   structables:
     container_name: structables
     restart: unless-stopped
-    image: privatecoffee/structables:latest
+    image: git.private.coffee/privatecoffee/structables:latest
     ports:
       - "127.0.0.1:8002:8002"
+    volumes:
+      - ./cache:/app/structables_cache
     env_file: .env
     security_opt:
       - no-new-privileges:true
     cap_drop:
       - ALL
-    read_only: true
     deploy:
       resources:
         limits:

structables-0.4.1/instances.json

@@ -0,0 +1,54 @@
+[
+    {
+        "name": "structables.private.coffee",
+        "url": "https://structables.private.coffee",
+        "type": "clearnet",
+        "provider": {
+            "name": "Private.coffee",
+            "url": "https://private.coffee"
+        },
+        "location": "AT",
+        "notes": "Main instance"
+    },
+    {
+        "name": "structables.coffee2m3bjsrrqqycx6ghkxrnejl2q6nl7pjw2j4clchjj6uk5zozad.onion",
+        "url": "http://structables.coffee2m3bjsrrqqycx6ghkxrnejl2q6nl7pjw2j4clchjj6uk5zozad.onion",
+        "type": "onion",
+        "provider": {
+            "name": "Private.coffee",
+            "url": "https://private.coffee"
+        },
+        "location": "AT",
+        "notes": "Main instance"
+    },
+    {
+        "name": "structables.bloat.cat",
+        "url": "https://structables.bloat.cat",
+        "type": "clearnet",
+        "provider": {
+            "name": "Bloat.cat",
+            "url": "https://bloat.cat"
+        },
+        "location": "DE"
+    },
+    {
+        "name": "structables.darkness.services",
+        "url": "https://structables.darkness.services",
+        "type": "clearnet",
+        "provider": {
+            "name": "Darkness.services",
+            "url": "https://darkness.services"
+        },
+        "location": "US"
+    },
+    {
+        "name": "structables.darknessrdor43qkl2ngwitj72zdavfz2cead4t5ed72bybgauww5lyd.onion",
+        "url": "http://structables.darknessrdor43qkl2ngwitj72zdavfz2cead4t5ed72bybgauww5lyd.onion",
+        "type": "onion",
+        "provider": {
+            "name": "Darkness.services",
+            "url": "https://darkness.services"
+        },
+        "location": "US"
+    }
+]

{structables-0.3.16 → structables-0.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "structables"
-version = "0.3.16"
+version = "0.4.1"
 authors = [
   { name="Private.coffee Team", email="support@private.coffee" },
 ]
@@ -19,7 +19,7 @@ classifiers = [
 ]
 dependencies = [
   "flask",
-  "bs4",
+  "beautifulsoup4",
   "markdown2[all]",
 ]
 

structables-0.4.1/renovate.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": [
+    "config:recommended"
+  ]
+}

structables-0.4.1/requirements-dev.txt

@@ -0,0 +1,6 @@
+ruff
+black
+isort
+mypy
+types-beautifulsoup4
+types-colorama

structables-0.4.1/src/structables/config.py

@@ -0,0 +1,59 @@
+import os
+import tempfile
+import logging
+
+from pathlib import Path
+
+from .utils.helpers import get_typesense_api_key
+
+logger = logging.getLogger(__name__)
+
+
+class Config:
+    DEBUG = os.environ.get("FLASK_DEBUG", os.environ.get("STRUCTABLES_DEBUG", False))
+    PORT = int(os.environ.get("STRUCTABLES_PORT", 8002))
+    LISTEN_HOST = os.environ.get("STRUCTABLES_LISTEN_HOST", "127.0.0.1")
+    INVIDIOUS = os.environ.get("STRUCTABLES_INVIDIOUS")
+    UNSAFE = os.environ.get("STRUCTABLES_UNSAFE", False)
+    PRIVACY_FILE = os.environ.get("STRUCTABLES_PRIVACY_FILE")
+    THEME = os.environ.get("STRUCTABLES_THEME", "auto")
+    TYPESENSE_API_KEY = get_typesense_api_key()
+
+    # Cache settings
+    CACHE_ENABLED = os.environ.get("STRUCTABLES_CACHE_ENABLED", "true").lower() not in (
+        "false",
+        "0",
+        "no",
+        "off",
+        "n",
+    )
+    CACHE_DIR = os.environ.get("STRUCTABLES_CACHE_DIR")
+
+    if CACHE_ENABLED and CACHE_DIR is None:
+        try:
+            CACHE_DIR = Path(tempfile.gettempdir()) / "structables_cache"
+        except FileNotFoundError:
+            CACHE_DIR = Path(os.getcwd()) / "structables_cache"
+
+        try:
+            CACHE_DIR.mkdir(parents=True, exist_ok=True)
+            (CACHE_DIR / "test").write_text("test")
+            (CACHE_DIR / "test").unlink()
+        except Exception as e:
+            logger.error(f"Could not create or write to cache directory: {e} - disabling cache")
+            CACHE_ENABLED = False
+            CACHE_DIR = None
+
+    CACHE_MAX_AGE = int(
+        os.environ.get("STRUCTABLES_CACHE_MAX_AGE", 60 * 60 * 24 * 7)
+    )  # 1 week default
+    CACHE_MAX_SIZE = int(
+        os.environ.get("STRUCTABLES_CACHE_MAX_SIZE", 1024 * 1024 * 1024)
+    )  # 1GB default
+    CACHE_CLEANUP_INTERVAL = int(
+        os.environ.get("STRUCTABLES_CACHE_CLEANUP_INTERVAL", 60 * 60)
+    )  # 1 hour default
+
+    @staticmethod
+    def init_app(app):
+        pass

structables-0.4.1/src/structables/main.py

@@ -0,0 +1,65 @@
+#!/usr/bin/env python
+
+from flask import Flask
+import threading
+import time
+import logging
+
+from .config import Config
+from .routes import init_routes
+from .utils.data import update_data
+from .routes.proxy import start_cache_cleanup_thread
+
+# Configure logging
+logger = logging.getLogger(__name__)
+
+app = Flask(__name__, template_folder="templates", static_folder="static")
+app.config.from_object(Config)
+
+logger.debug("Initializing routes")
+init_routes(app)
+logger.debug("Performing initial data update")
+update_data(app)
+
+def background_update_data(app):
+    """Runs the update_data function every 5 minutes.
+
+    This replaces the need for a cron job to update the data.
+
+    Args:
+        app (Flask): The Flask app instance.
+    """
+    logger.debug("Starting background update thread")
+    while True:
+        logger.debug("Running scheduled data update")
+        update_data(app)
+        logger.debug("Data update complete, sleeping for 5 minutes")
+        time.sleep(300)
+
+def main():
+    if app.config["DEBUG"]:
+        logging.basicConfig(
+            level=logging.DEBUG,
+            format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
+        )
+    else:
+        logging.basicConfig(
+            level=logging.INFO,
+            format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
+        )
+    
+    logger.debug("Starting background update thread")
+    threading.Thread(target=background_update_data, args=(app,), daemon=True).start()
+    
+    # Start the cache cleanup thread
+    start_cache_cleanup_thread(app)
+    
+    logger.info(f"Starting Structables on {app.config['LISTEN_HOST']}:{app.config['PORT']}")
+    app.run(
+        port=app.config["PORT"],
+        host=app.config["LISTEN_HOST"],
+        debug=app.config["DEBUG"],
+    )
+
+if __name__ == "__main__":
+    main()

{structables-0.3.16 → structables-0.4.1}/src/structables/routes/category.py

@@ -1,15 +1,22 @@
 from flask import redirect
 from werkzeug.exceptions import NotFound
 from ..utils.helpers import project_list, category_page
+import logging
+
+logger = logging.getLogger(__name__)
 
 
 def init_category_routes(app):
     @app.route("/<category>/<channel>/projects/")
     def route_channel_projects(category, channel):
+        logger.debug(f"Rendering channel projects for {category}/{channel}")
         return project_list(app, channel.title())
 
     @app.route("/<category>/<channel>/projects/<sort>/")
     def route_channel_projects_sort(category, channel, sort):
+        logger.debug(
+            f"Rendering channel projects for {category}/{channel} sorted by {sort}"
+        )
         return project_list(
             app,
             channel.title(),
@@ -18,50 +25,62 @@ def init_category_routes(app):
 
     @app.route("/<category>/projects/")
     def route_category_projects(category):
+        logger.debug(f"Rendering category projects for {category}")
         return project_list(app, category.title())
 
     @app.route("/<category>/projects/<sort>/")
     def route_category_projects_sort(category, sort):
+        logger.debug(f"Rendering category projects for {category} sorted by {sort}")
         return project_list(app, category.title(), " Sorted by " + sort.title())
 
     @app.route("/projects/")
     def route_projects():
+        logger.debug("Rendering all projects")
         return project_list(app, "")
 
     @app.route("/projects/<sort>/")
     def route_projects_sort(sort):
+        logger.debug(f"Rendering all projects sorted by {sort}")
         return project_list(app, "", " Sorted by " + sort.title())
 
     @app.route("/circuits/")
     def route_circuits():
+        logger.debug("Rendering circuits category page")
         return category_page(app, "Circuits")
 
     @app.route("/workshop/")
     def route_workshop():
+        logger.debug("Rendering workshop category page")
         return category_page(app, "Workshop")
 
     @app.route("/craft/")
     def route_craft():
+        logger.debug("Rendering craft category page")
         return category_page(app, "Craft")
 
     @app.route("/cooking/")
     def route_cooking():
+        logger.debug("Rendering cooking category page")
         return category_page(app, "Cooking")
 
     @app.route("/living/")
     def route_living():
+        logger.debug("Rendering living category page")
         return category_page(app, "Living")
 
     @app.route("/outside/")
     def route_outside():
+        logger.debug("Rendering outside category page")
         return category_page(app, "Outside")
 
     @app.route("/teachers/")
     def route_teachers():
+        logger.debug("Rendering teachers category page")
         return category_page(app, "Teachers", True)
 
     @app.route("/<category>/<channel>/")
     def route_channel_redirect(category, channel):
+        logger.debug(f"Channel redirect for {category}/{channel}")
         if (
             category == "circuits"
             or category == "workshop"
@@ -71,6 +90,8 @@ def init_category_routes(app):
             or category == "outside"
             or category == "teachers"
         ):
+            logger.debug(f"Redirecting to /{category}/{channel}/projects/")
             return redirect(f"/{category}/{channel}/projects/", 307)
         else:
+            logger.warning(f"Invalid category: {category}")
             raise NotFound()