app: vendor Bootstrap and htmx; add find_static() template global.

Author: lemon24

.gitattributes

@@ -2,3 +2,4 @@
 * text eol=lf
 *.png -text
 *.bat -text
+src/reader/_app/static/vendor/** -text -diff

.gitignore

@@ -103,3 +103,6 @@ ENV/
 
 # mypy
 .mypy_cache/
+
+# add back some stuff
+!src/reader/_app/static/vendor/*/dist/

scripts/vendor_app_stuff.py

@@ -0,0 +1,41 @@
+import pathlib
+import shutil
+
+import requests
+
+
+STUFF = {
+    "htmx.org@2.0.8": ["dist/htmx.min.js"],
+    "htmx-ext-response-targets@2.0.4": ["dist/response-targets.min.js"],
+    "bootstrap@5.3.8": [
+        "dist/css/bootstrap.min.css",
+        "dist/js/bootstrap.bundle.min.js",
+    ],
+    "bootstrap-icons@1.13.1": [
+        "font/bootstrap-icons.min.css",
+        "font/fonts/bootstrap-icons.woff",
+        "font/fonts/bootstrap-icons.woff2",
+    ],
+}
+
+self_path = pathlib.Path(__file__)
+root_dir = self_path.parent.parent
+vendor_dir = root_dir / "src/reader/_app/static/vendor"
+url_fmt = "https://cdn.jsdelivr.net/npm/{package}/{path}"
+
+shutil.rmtree(vendor_dir, ignore_errors=True)
+vendor_dir.mkdir(parents=True)
+(vendor_dir / "README").write_text(f"maintained by {self_path.name}")
+
+for package, paths in STUFF.items():
+    for path in paths:
+
+        src = url_fmt.format(package=package, path=path)
+        response = requests.get(src)
+        response.raise_for_status()
+
+        dst = vendor_dir.joinpath(package, *pathlib.PosixPath(path).parts)
+        dst.parent.mkdir(parents=True, exist_ok=True)
+        dst.write_bytes(response.content)
+
+        print(f"{package} {path} done")

src/reader/_app/__init__.py

@@ -1,3 +1,4 @@
+import pathlib
 from datetime import datetime
 from datetime import timedelta
 from datetime import timezone
@@ -317,6 +318,31 @@ def add_jinja_do_extension(setup_state):
     setup_state.app.jinja_env.add_extension('jinja2.ext.do')
 
 
+@blueprint.add_app_template_global
+def find_static(filename, blueprint=None):
+    blueprint = blueprint or request.blueprint
+    if blueprint:
+        endpoint = f'{blueprint}.static'
+        folder = current_app.blueprints[blueprint].static_folder
+    else:
+        endpoint = 'static'
+        folder = current_app.static_folder
+
+    dir = pathlib.Path(folder)
+    matches = [p.relative_to(dir) for p in dir.rglob(f'{filename}')]
+
+    if not matches:
+        raise RuntimeError(f"no such static file: {filename!r}")
+    if len(matches) > 1:
+        sep = '\n* '
+        raise RuntimeError(
+            f"more than one static file for {filename!r}:\n"
+            f"{sep}{sep.join(p.as_posix() for p in matches)}\n"
+        )
+
+    return url_for(endpoint, filename=matches[0])
+
+
 def create_app(reader_config):
     app = Flask(__name__)
     app.config['SECRET_KEY'] = 'secret'

src/reader/_app/static/vendor/README

@@ -0,0 +1 @@
+maintained by vendor_app_stuff.py