structables 0.4.5__tar.gz → 0.4.6__tar.gz

{structables-0.4.5 → structables-0.4.6}/.forgejo/workflows/docker.yml

@@ -6,6 +6,8 @@ on:
       - "*"
   workflow_dispatch:
 
+enable-openid-connect: true
+
 jobs:
   docker:
     name: Docker Build and Push to git.private.coffee
@@ -15,20 +17,39 @@ jobs:
       options: >-
         --privileged
     steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+
       - name: Install dependencies
         run: |
           apt update
-          apt install -y docker.io
+          apt install -y docker.io jq
+
       - name: Set up QEMU
         uses: docker/setup-qemu-action@v3
+
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
+
+      - name: Fetch JWT
+        id: jwt
+        env:
+          AUD: u:5:f67ef752-45f6-4a9d-933c-986806a9dc84
+        run: |
+          jwt=$(
+            curl --fail \
+              -H "Authorization: bearer $ACTIONS_ID_TOKEN_REQUEST_TOKEN" \
+              "$ACTIONS_ID_TOKEN_REQUEST_URL&audience=$AUD" \
+              | jq -r ".value"
+          )
+          echo "::add-mask::$jwt"
+          echo "jwt=$jwt" >> $FORGEJO_OUTPUT
+
       - name: Login to Forgejo
-        uses: docker/login-action@v3
-        with:
-          registry: git.private.coffee
-          username: ${{ secrets.FORGEJO_USER }}
-          password: ${{ secrets.FORGEJO_TOKEN }}
+        run: |
+          echo "${{ steps.jwt.outputs.jwt }}" \
+            | docker login --username token --password-stdin git.private.coffee
+
       - name: Build and push to Forgejo
         uses: docker/build-push-action@v6
         with:

{structables-0.4.5 → structables-0.4.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: structables
-Version: 0.4.5
+Version: 0.4.6
 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

{structables-0.4.5 → structables-0.4.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "structables"
-version = "0.4.5"
+version = "0.4.6"
 authors = [
   { name="Private.coffee Team", email="support@private.coffee" },
 ]

{structables-0.4.5 → structables-0.4.6}/src/structables/config.py

@@ -1,7 +1,6 @@
+import logging
 import os
 import tempfile
-import logging
-
 from pathlib import Path
 
 from .utils.helpers import get_typesense_api_key
@@ -10,11 +9,11 @@ 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))
+    DEBUG = os.environ.get("FLASK_DEBUG", os.environ.get("STRUCTABLES_DEBUG"))
+    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)
+    UNSAFE = os.environ.get("STRUCTABLES_UNSAFE")
     PRIVACY_FILE = os.environ.get("STRUCTABLES_PRIVACY_FILE")
     THEME = os.environ.get("STRUCTABLES_THEME", "auto")
     TYPESENSE_API_KEY = get_typesense_api_key()
@@ -39,19 +38,21 @@ class Config:
             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")
+        except Exception as e:  # noqa: BLE001
+            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)
+        os.environ.get("STRUCTABLES_CACHE_MAX_AGE", "604800")
     )  # 1 week default
     CACHE_MAX_SIZE = int(
-        os.environ.get("STRUCTABLES_CACHE_MAX_SIZE", 1024 * 1024 * 1024)
+        os.environ.get("STRUCTABLES_CACHE_MAX_SIZE", "1073741824")
     )  # 1GB default
     CACHE_CLEANUP_INTERVAL = int(
-        os.environ.get("STRUCTABLES_CACHE_CLEANUP_INTERVAL", 60 * 60)
+        os.environ.get("STRUCTABLES_CACHE_CLEANUP_INTERVAL", "3600")
     )  # 1 hour default
 
     @staticmethod

{structables-0.4.5 → structables-0.4.6}/src/structables/main.py

@@ -1,8 +1,6 @@
-#!/usr/bin/env python
+import logging
 
 from flask import Flask
-import logging
-import time
 
 from .config import Config
 from .routes import init_routes

{structables-0.4.5 → structables-0.4.6}/src/structables/routes/__init__.py

@@ -1,12 +1,13 @@
-from .main import init_main_routes
 from .category import init_category_routes
+from .contest import init_contest_routes
+from .main import init_main_routes
 from .member import init_member_routes
 from .proxy import init_proxy_routes
-from .contest import init_contest_routes
+
 
 def init_routes(app):
     init_main_routes(app)
     init_category_routes(app)
     init_member_routes(app)
     init_proxy_routes(app)
-    init_contest_routes(app)
+    init_contest_routes(app)

{structables-0.4.5 → structables-0.4.6}/src/structables/routes/category.py

@@ -1,7 +1,9 @@
+import logging
+
 from flask import redirect
 from werkzeug.exceptions import NotFound
-from ..utils.helpers import project_list, category_page
-import logging
+
+from ..utils.helpers import category_page, project_list
 
 logger = logging.getLogger(__name__)
 

{structables-0.4.5 → structables-0.4.6}/src/structables/routes/contest.py

@@ -1,9 +1,11 @@
-from flask import render_template, request, abort, url_for
+import logging
 from urllib.error import HTTPError
 from urllib.parse import urlencode
+
+from flask import abort, render_template, request, url_for
+
 from ..utils.cache import get_cached_json
 from ..utils.helpers import proxy, thumbnail
-import logging
 
 logger = logging.getLogger(__name__)
 
@@ -28,8 +30,8 @@ def init_contest_routes(app):
         except HTTPError as e:
             logger.error(f"HTTP error fetching contest archive: {e.code}")
             abort(e.code)
-        except Exception as e:
-            logger.error(f"Error fetching contest archive: {str(e)}")
+        except Exception as e:  # noqa: BLE001
+            logger.error(f"Error fetching contest archive: {e!s}")
             abort(500)  # Handle other exceptions like JSON decode errors
 
         contests = data.get("contests", [])
@@ -108,7 +110,8 @@ def init_contest_routes(app):
         try:
             data = get_cached_json(
                 app,
-                "https://www.instructables.com/json-api/contest?" + urlencode({"path": contest}),
+                "https://www.instructables.com/json-api/contest?"
+                + urlencode({"path": contest}),
             )
             title = data["title"]
             logger.debug(f"Contest title: {title}")
@@ -157,14 +160,15 @@ def init_contest_routes(app):
         try:
             # Fetch current contests from the JSON API
             data = get_cached_json(
-                app, "https://www.instructables.com/json-api/getCurrentContests?limit=50&offset=0"
+                app,
+                "https://www.instructables.com/json-api/getCurrentContests?limit=50&offset=0",
             )
             logger.debug("Received current contests data")
         except HTTPError as e:
             logger.error(f"HTTP error fetching current contests: {e.code}")
             abort(e.code)
-        except Exception as e:
-            logger.error(f"Error fetching current contests: {str(e)}")
+        except Exception as e:  # noqa: BLE001
+            logger.error(f"Error fetching current contests: {e!s}")
             abort(500)  # Handle other exceptions such as JSON decode errors
 
         contests = data.get("contests", [])

{structables-0.4.5 → structables-0.4.6}/src/structables/routes/main.py

@@ -1,19 +1,24 @@
-from flask import render_template, abort, request
+import logging
+import pathlib
+from traceback import print_exc
 from urllib.error import HTTPError
-from bs4 import BeautifulSoup
 from urllib.parse import quote
-from werkzeug.exceptions import InternalServerError
-from markdown2 import Markdown
-from traceback import print_exc
 
-import pathlib
-import logging
+from bs4 import BeautifulSoup
+from flask import abort, render_template, request
+from markdown2 import Markdown
+from werkzeug.exceptions import InternalServerError
 
 from ..utils.cache import get_cached_json
-from ..utils.data import update_data
-from ..utils.helpers import explore_lists, proxy, project_facets, projects_search, unslugify, thumbnail
+from ..utils.data import maybe_update_data, update_data
+from ..utils.helpers import (
+    project_facets,
+    projects_search,
+    proxy,
+    thumbnail,
+    unslugify,
+)
 from .category import project_list
-from ..utils.data import maybe_update_data
 
 logger = logging.getLogger(__name__)
 
@@ -60,17 +65,15 @@ def init_main_routes(app):
                                     if "downloadUrl" in item
                                     else ""
                                 ),
-                                "author": item["author"] if "author" in item else "",
+                                "author": item.get("author", ""),
                                 "channel": (
                                     item["classifications"][0]["channels"][0]["title"]
-                                    if "classifications" in item
-                                    and item["classifications"]
+                                    if item.get("classifications")
                                     else ""
                                 ),
                                 "channel_link": (
                                     f"/{item['classifications'][0]['name']}/{item['classifications'][0]['channels'][0]['name']}/"
-                                    if "classifications" in item
-                                    and item["classifications"]
+                                    if item.get("classifications")
                                     else ""
                                 ),
                             }
@@ -84,14 +87,14 @@ def init_main_routes(app):
                     )
 
                 except Exception as e:
-                    logger.error(f"Error processing category {category}: {str(e)}")
+                    logger.error(f"Error processing category {category}: {e!s}")
                     raise
                     sections.append((category.capitalize(), f"/{category}", []))
 
             return render_template("index.html", title="Explore", sections=sections)
 
-        except Exception as e:
-            logger.error(f"Error rendering explore page: {str(e)}")
+        except Exception as e:  # noqa: BLE001
+            logger.error(f"Error rendering explore page: {e!s}")
             print_exc()
 
             # Fallback to a static version if API fails
@@ -122,7 +125,9 @@ def init_main_routes(app):
         try:
             categories = project_facets(app)["category"]
             if parts:
-                categories = [name for name in categories if name.lower() == parts[0].lower()]
+                categories = [
+                    name for name in categories if name.lower() == parts[0].lower()
+                ]
                 if not categories:
                     abort(404)
 
@@ -131,21 +136,31 @@ def init_main_routes(app):
                 category_path = f"/{category.lower()}/"
                 if len(parts) == 2:
                     for channel in unslugify(parts[1]):
-                        hits, _ = projects_search(app, category=category, channel=channel)
+                        hits, _ = projects_search(
+                            app, category=category, channel=channel
+                        )
                         if hits:
                             break
                     channels = [
-                        [hit["document"]["title"], f'/{hit["document"]["urlString"]}']
+                        [hit["document"]["title"], f"/{hit['document']['urlString']}"]
                         for hit in hits
                     ]
                 else:
-                    channels = [[f"All {category} Projects", category_path + "projects/"]]
+                    channels = [
+                        [f"All {category} Projects", category_path + "projects/"]
+                    ]
                     for channel in project_facets(app, category)["channel"]:
                         slug = quote(channel.lower().replace(" ", "-"), safe="")
                         channels.append([channel, f"{category_path}{slug}/projects/"])
                 groups.append([category, category_path, channels])
             if not parts:
-                groups.append(["Teachers", "/teachers/", [["All Teachers Projects", "/teachers/projects/"]]])
+                groups.append(
+                    [
+                        "Teachers",
+                        "/teachers/",
+                        [["All Teachers Projects", "/teachers/projects/"]],
+                    ]
+                )
         except HTTPError as e:
             logger.error(f"HTTP error fetching sitemap: {e.code}")
             abort(e.code)
@@ -217,7 +232,7 @@ def init_main_routes(app):
 
                     for file in step["files"]:
                         if file["image"]:
-                            if "embedType" not in "file":
+                            if "embedType" not in file:
                                 step_imgs.append(
                                     {
                                         "src": thumbnail(file["downloadUrl"], 1024),
@@ -274,7 +289,7 @@ def init_main_routes(app):
                                     )
 
                         elif not file["image"]:
-                            if "downloadUrl" in file.keys():
+                            if "downloadUrl" in file:
                                 step_downloads.append(
                                     {
                                         "src": proxy(file["downloadUrl"], file["name"]),
@@ -412,8 +427,8 @@ def init_main_routes(app):
                     thumbnails=thumbnails,
                 )
 
-        except Exception as e:
-            logger.error(f"Error processing article: {str(e)}")
+        except Exception as e:  # noqa: BLE001
+            logger.error(f"Error processing article: {e!s}")
             print_exc()
             raise InternalServerError()
 
@@ -468,8 +483,7 @@ def init_main_routes(app):
                         content = Markdown().convert(content)
 
             except OSError as e:
-                logger.error(f"Error reading privacy policy file: {str(e)}")
-                pass
+                logger.error(f"Error reading privacy policy file: {e!s}")
 
         return render_template(
             "privacypolicy.html", title="Privacy Policy", content=content

{structables-0.4.5 → structables-0.4.6}/src/structables/routes/member.py

@@ -1,9 +1,11 @@
-from flask import render_template, abort, request
+import logging
 from urllib.error import HTTPError
 from urllib.parse import quote
+
+from flask import abort, render_template, request
+
 from ..utils.cache import get_cached_json
-from ..utils.helpers import member_header, thumbnail, projects_search, get_pagination
-import logging
+from ..utils.helpers import get_pagination, member_header, projects_search, thumbnail
 
 logger = logging.getLogger(__name__)
 
@@ -84,7 +86,11 @@ def init_member_routes(app):
             "member.html",
             title=header_content["title"] + "'s Profile",
             header_content=header_content,
-            ible_list_title=("Top Instructables" if top_projects else "Recent Instructables") if ibles else "",
+            ible_list_title=(
+                "Top Instructables" if top_projects else "Recent Instructables"
+            )
+            if ibles
+            else "",
             ibles=ibles,
             ach_list_title="Contest Achievements" if achs else "",
             achs=achs,

{structables-0.4.5 → structables-0.4.6}/src/structables/routes/proxy.py

@@ -1,14 +1,15 @@
-from flask import render_template, request, Response, abort
-from werkzeug.exceptions import BadRequest
-from werkzeug.http import dump_options_header
-from urllib.error import HTTPError
-from urllib.request import Request, urlopen
-from urllib.parse import quote
+import hashlib
 import logging
 import os
-import hashlib
-import time
 import shutil
+import time
+from urllib.error import HTTPError
+from urllib.parse import quote
+from urllib.request import Request, urlopen
+
+from flask import Response, abort, render_template, request
+from werkzeug.exceptions import BadRequest
+from werkzeug.http import dump_options_header
 
 logger = logging.getLogger(__name__)
 
@@ -196,8 +197,8 @@ def maybe_cleanup_cache(app):
             f"Cache cleanup complete. New size: {total_size / (1024 * 1024):.2f} MB"
         )
 
-    except Exception as e:
-        logger.error(f"Error during cache cleanup: {str(e)}")
+    except Exception as e:  # noqa: BLE001
+        logger.error(f"Error during cache cleanup: {e!s}")
 
 
 def init_proxy_routes(app):
@@ -227,20 +228,30 @@ def init_proxy_routes(app):
         maybe_cleanup_cache(app)
 
         if url is not None:
-            if url.startswith((
-                "https://cdn.instructables.com/",
-                "https://content.instructables.com/",
-                "https://www.instructables.com/static/defaultIMG/",
-            )):
+            if url.startswith(
+                (
+                    "https://cdn.instructables.com/",
+                    "https://content.instructables.com/",
+                    "https://www.instructables.com/static/defaultIMG/",
+                )
+            ):
                 logger.debug(f"Valid proxy URL: {url}")
                 unquoted_url = url
 
-                headers = {"Cache-Control": f"public, max-age={app.config['CACHE_MAX_AGE']}"}
+                headers = {
+                    "Cache-Control": f"public, max-age={app.config['CACHE_MAX_AGE']}"
+                }
                 if filename is not None:
-                    options = {"filename": filename} if filename.isascii() else {
-                        "filename*": "UTF-8''" + quote(filename, safe=""),
-                    }
-                    headers["Content-Disposition"] = dump_options_header("attachment", options)
+                    options = (
+                        {"filename": filename}
+                        if filename.isascii()
+                        else {
+                            "filename*": "UTF-8''" + quote(filename, safe=""),
+                        }
+                    )
+                    headers["Content-Disposition"] = dump_options_header(
+                        "attachment", options
+                    )
 
                 # Check if the content is already cached
                 if is_cached(app, unquoted_url):
@@ -323,16 +334,24 @@ def init_proxy_routes(app):
                     except HTTPError as e:
                         logger.error(f"HTTP error during streaming: {e.code}")
                         abort(e.code)
-                    except Exception as e:
-                        logger.error(f"Error fetching content: {str(e)}")
+                    except Exception as e:  # noqa: BLE001
+                        logger.error(f"Error fetching content: {e!s}")
                         abort(500)
 
                 try:
                     logger.debug(f"Getting content type for {unquoted_url}")
-                    data = urlopen(Request(unquoted_url, headers={
-                        "Referer": "https://www.instructables.com/",
-                    }), timeout=30)
-                    content_type = data.headers.get("content-type", "application/octet-stream")
+                    data = urlopen(
+                        Request(
+                            unquoted_url,
+                            headers={
+                                "Referer": "https://www.instructables.com/",
+                            },
+                        ),
+                        timeout=30,
+                    )
+                    content_type = data.headers.get(
+                        "content-type", "application/octet-stream"
+                    )
                     logger.debug(f"Content type: {content_type}")
                 except HTTPError as e:
                     logger.error(f"HTTP error getting content type: {e.code}")

{structables-0.4.5 → structables-0.4.6}/src/structables/utils/data.py

@@ -1,51 +1,51 @@
 import logging
 import time
-from .helpers import thumbnail, projects_search
+
+from .helpers import projects_search, thumbnail
 
 logger = logging.getLogger(__name__)
 
 # Track the last data update time
 last_data_update = 0
 
+
 def update_data(app):
     """Update the application's cached data.
-    
+
     This function fetches fresh data from Instructables.com and updates
     the app's global cache.
-    
+
     Args:
         app: The Flask app instance.
     """
     logger.debug("Starting data update")
 
-    try:
-        app.global_ibles
-    except AttributeError:
+    if not hasattr(app, "global_ibles"):
         logger.debug("Initializing global_ibles dictionary")
         app.global_ibles = {"/projects": []}
 
     try:
         logger.debug("Fetching featured projects")
         projects = []
-        project_ibles, total = projects_search(app, filter_by="featureFlag:=true")
-        
+        project_ibles, _total = projects_search(app, filter_by="featureFlag:=true")
+
         logger.debug(f"Found {len(project_ibles)} featured projects")
         if not project_ibles:
             return
 
         for ible in project_ibles:
             link = f"/{ible['document']['urlString']}"
-            img = thumbnail(ible['document']['coverImageUrl'])
+            img = thumbnail(ible["document"]["coverImageUrl"])
 
-            title = ible['document']['title']
-            author = ible['document']['screenName']
+            title = ible["document"]["title"]
+            author = ible["document"]["screenName"]
             author_link = f"/member/{author}"
 
-            channel = ible['document']['primaryClassification']
+            channel = ible["document"]["primaryClassification"]
             channel_link = f"/channel/{channel}"
 
-            views = ible['document']['views']
-            favorites = ible['document']['favorites']
+            views = ible["document"]["views"]
+            favorites = ible["document"]["favorites"]
 
             projects.append(
                 {
@@ -62,10 +62,12 @@ def update_data(app):
             )
 
         app.global_ibles["/projects"] = projects
-        logger.debug(f"Updated global projects list with {len(app.global_ibles['/projects'])} projects")
+        logger.debug(
+            f"Updated global projects list with {len(app.global_ibles['/projects'])} projects"
+        )
         logger.debug("Data update completed successfully")
-    except Exception as e:
-        logger.error(f"Error updating data: {str(e)}")
+    except Exception as e:  # noqa: BLE001
+        logger.error(f"Error updating data: {e!s}")
 
 
 def maybe_update_data(app):
@@ -78,10 +80,10 @@ def maybe_update_data(app):
     """
     global last_data_update
     current_time = time.time()
-    
+
     # Update every 5 minutes (300 seconds)
     if current_time - last_data_update >= 300:
         logger.debug("Running scheduled data update")
         update_data(app)
         last_data_update = current_time
-        logger.debug("Data update complete")
+        logger.debug("Data update complete")

{structables-0.4.5 → structables-0.4.6}/src/structables/utils/helpers.py

@@ -1,21 +1,24 @@
-from urllib.parse import urlencode, urlparse, quote, urlsplit, urlunsplit, parse_qsl
-from urllib.request import urlopen
-from bs4 import BeautifulSoup
-import re
 import logging
 import math
-from flask import request, render_template, abort
+import re
+from urllib.parse import parse_qsl, quote, urlencode, urlparse, urlsplit, urlunsplit
+from urllib.request import urlopen
+
+from bs4 import BeautifulSoup
+from flask import abort, render_template, request
+
 from .cache import get_cached_json
 
 logger = logging.getLogger(__name__)
 
+
 def proxy(url, filename=None):
     """Generate a proxy URL for external content.
-    
+
     Args:
         url (str): The original URL to proxy.
         filename (str, optional): The filename to use for downloads.
-        
+
     Returns:
         str: The proxied URL.
     """
@@ -25,6 +28,7 @@ def proxy(url, filename=None):
         args["filename"] = filename
     return "/proxy/?" + urlencode(args)
 
+
 def thumbnail(url, width=600):
     parts = urlsplit(url)
     if parts.hostname in ("content.instructables.com", "cdn.instructables.com"):
@@ -36,7 +40,7 @@ def thumbnail(url, width=600):
 
 def get_typesense_api_key():
     """Extract the Typesense API key from Instructables.com.
-    
+
     Returns:
         str: The Typesense API key.
     """
@@ -56,8 +60,9 @@ def get_typesense_api_key():
                 return api_key
 
         logger.error("Failed to get Typesense API key")
-    except Exception as e:
-        logger.error(f"Error getting Typesense API key: {str(e)}")
+    except Exception as e:  # noqa: BLE001
+        logger.error(f"Error getting Typesense API key: {e!s}")
+
 
 def unslugify(slug):
     """Return a list of possible original titles for a slug.
@@ -82,14 +87,15 @@ def unslugify(slug):
     logger.debug(f"Unslugify results: {results}")
     return results
 
+
 def get_pagination(request, total, per_page=1):
     """Generate pagination links.
-    
+
     Args:
         request: The Flask request object.
         total (int): The total number of items.
         per_page (int): The number of items per page.
-        
+
     Returns:
         list: A list of pagination link dictionaries.
     """
@@ -150,6 +156,7 @@ def get_pagination(request, total, per_page=1):
     logger.debug(f"Generated {len(pagination)} pagination links")
     return pagination
 
+
 def member_header(data):
     """Extract profile header information from the author API response."""
     signup = (data.get("signup") or "")[:10]
@@ -168,10 +175,10 @@ def member_header(data):
 
 def explore_lists(soup):
     """Parse the explore lists from the homepage.
-    
+
     Args:
         soup: The BeautifulSoup element containing the list.
-        
+
     Returns:
         list: A list of dictionaries with project information.
     """
@@ -208,20 +215,21 @@ def explore_lists(soup):
                 }
             )
         logger.debug(f"Found {len(list_)} items in explore list")
-    except Exception as e:
-        logger.error(f"Error parsing explore list: {str(e)}")
-    
+    except Exception as e:  # noqa: BLE001
+        logger.error(f"Error parsing explore list: {e!s}")
+
     return list_
 
+
 def project_list(app, head, sort="", per_page=20):
     """Generate a list of projects for display.
-    
+
     Args:
         app: The Flask app instance.
         head (str): The header title.
         sort (str, optional): Sort description.
         per_page (int, optional): Number of items per page.
-        
+
     Returns:
         Response: The rendered template.
     """
@@ -244,7 +252,7 @@ def project_list(app, head, sort="", per_page=20):
             parts = path.split("/")
             category = "" if parts[1] == "projects" else parts[1]
             channel = "" if not category or parts[2] == "projects" else parts[2]
-            
+
             logger.debug(f"Category: {category}, Channel: {channel}")
 
             channel_names = unslugify(channel)
@@ -261,7 +269,9 @@ def project_list(app, head, sort="", per_page=20):
                 )
 
                 if project_ibles:
-                    logger.debug(f"Found {len(project_ibles)} projects for {channel_name}")
+                    logger.debug(
+                        f"Found {len(project_ibles)} projects for {channel_name}"
+                    )
                     break
 
         elif "search" in path.split("/"):
@@ -288,17 +298,17 @@ def project_list(app, head, sort="", per_page=20):
 
         for ible in project_ibles:
             link = f"/{ible['document']['urlString']}"
-            img = thumbnail(ible['document']['coverImageUrl'])
+            img = thumbnail(ible["document"]["coverImageUrl"])
 
-            title = ible['document']['title']
-            author = ible['document']['screenName']
+            title = ible["document"]["title"]
+            author = ible["document"]["screenName"]
             author_link = f"/member/{author}"
 
-            channel = ible['document']['primaryClassification']
+            channel = ible["document"]["primaryClassification"]
             channel_link = f"/channel/{channel}"
 
-            views = ible['document']['views']
-            favorites = ible['document']['favorites']
+            views = ible["document"]["views"]
+            favorites = ible["document"]["favorites"]
 
             ibles.append(
                 {
@@ -313,12 +323,12 @@ def project_list(app, head, sort="", per_page=20):
                     "favorites": favorites,
                 }
             )
-        
+
         logger.debug(f"Processed {len(ibles)} projects for display")
 
     pagination = get_pagination(request, total, per_page)
     logger.debug(f"Rendering project list template with {len(ibles)} projects")
-    
+
     return render_template(
         "projects.html",
         title=unslugify(head)[0],
@@ -327,14 +337,15 @@ def project_list(app, head, sort="", per_page=20):
         pagination=pagination,
     )
 
+
 def category_page(app, name, teachers=False):
     """Generate a category page.
-    
+
     Args:
         app: The Flask app instance.
         name (str): The category name.
         teachers (bool, optional): Whether this is the teachers category.
-        
+
     Returns:
         Response: The rendered template.
     """
@@ -353,36 +364,36 @@ def category_page(app, name, teachers=False):
             and channel["channel"] not in channels
         ):
             channels.append(channel["channel"])
-    
+
     logger.debug(f"Found {len(channels)} channels for category {name}")
 
     # Get featured projects
     if teachers:
         logger.debug("Fetching teachers projects")
-        category_ibles, total = projects_search(
+        category_ibles, _total = projects_search(
             app, teachers=True, page=page, filter_by="featureFlag:=true"
         )
     else:
         logger.debug(f"Fetching featured projects for category {name}")
-        category_ibles, total = projects_search(
+        category_ibles, _total = projects_search(
             app, category=name, page=page, filter_by="featureFlag:=true"
         )
-    
+
     logger.debug(f"Found {len(category_ibles)} featured projects")
 
     for ible in category_ibles:
         link = f"/{ible['document']['urlString']}"
-        img = thumbnail(ible['document']['coverImageUrl'])
+        img = thumbnail(ible["document"]["coverImageUrl"])
 
-        title = ible['document']['title']
-        author = ible['document']['screenName']
+        title = ible["document"]["title"]
+        author = ible["document"]["screenName"]
         author_link = f"/member/{author}"
 
-        channel = ible['document']['primaryClassification']
+        channel = ible["document"]["primaryClassification"]
         channel_link = f"/channel/{channel}"
 
-        views = ible['document']['views']
-        favorites = ible['document']['favorites']
+        views = ible["document"]["views"]
+        favorites = ible["document"]["favorites"]
 
         ibles.append(
             {
@@ -408,20 +419,28 @@ def category_page(app, name, teachers=False):
         path=path,
     )
 
+
 def project_facets(app, category=""):
-    args = urlencode({
-        "q": "*",
-        "query_by": "title",
-        "facet_by": "category,channel",
-        "max_facet_values": 250,
-        "per_page": 0,
-        "include_fields": "id",
-        "filter_by": f"category:={category}" if category else "",
-    })
+    args = urlencode(
+        {
+            "q": "*",
+            "query_by": "title",
+            "facet_by": "category,channel",
+            "max_facet_values": 250,
+            "per_page": 0,
+            "include_fields": "id",
+            "filter_by": f"category:={category}" if category else "",
+        }
+    )
     url = f"https://www.instructables.com/api_proxy/search/collections/projects/documents/search?{args}"
-    result = get_cached_json(app, url, headers={
-        "x-typesense-api-key": app.config["TYPESENSE_API_KEY"],
-    }, max_age=24 * 60 * 60)
+    result = get_cached_json(
+        app,
+        url,
+        headers={
+            "x-typesense-api-key": app.config["TYPESENSE_API_KEY"],
+        },
+        max_age=24 * 60 * 60,
+    )
     return {
         facet["field_name"]: sorted(item["value"] for item in facet["counts"])
         for facet in result["facet_counts"]
@@ -443,7 +462,7 @@ def projects_search(
     typesense_api_key=None,
 ):
     """Search for projects using the Typesense API.
-    
+
     Args:
         app: The Flask app instance.
         query (str, optional): The search query.
@@ -457,7 +476,7 @@ def projects_search(
         sort_by (str, optional): The sort order.
         timeout (int, optional): The request timeout.
         typesense_api_key (str, optional): The Typesense API key.
-        
+
     Returns:
         tuple: A tuple of (projects, total_pages).
     """
@@ -480,7 +499,9 @@ def projects_search(
     query = quote(query)
     filter_by = quote(filter_by)
 
-    logger.debug(f"Searching projects: query='{query}', filter='{filter_by}', page={page}, per_page={per_page}")
+    logger.debug(
+        f"Searching projects: query='{query}', filter='{filter_by}', page={page}, per_page={per_page}"
+    )
 
     projects_headers = {"x-typesense-api-key": app.config["TYPESENSE_API_KEY"]}
 
@@ -498,15 +519,19 @@ def projects_search(
 
     url = f"https://www.instructables.com/api_proxy/search/collections/projects/documents/search?{args_str}"
     logger.debug(f"Making request to {url}")
-    
+
     try:
-        project_obj = get_cached_json(app, url, headers=projects_headers, timeout=timeout)
+        project_obj = get_cached_json(
+            app, url, headers=projects_headers, timeout=timeout
+        )
         project_ibles = project_obj["hits"]
         total_found = project_obj["found"]
-        
-        logger.debug(f"Search returned {len(project_ibles)} projects out of {total_found} total matches")
-        
+
+        logger.debug(
+            f"Search returned {len(project_ibles)} projects out of {total_found} total matches"
+        )
+
         return project_ibles, math.ceil(total_found / per_page)
-    except Exception as e:
-        logger.error(f"Error searching projects: {str(e)}")
+    except Exception as e:  # noqa: BLE001
+        logger.error(f"Error searching projects: {e!s}")
         return [], 0