mirror of
https://github.com/kevinveenbirkenbach/homepage.veen.world.git
synced 2026-05-19 19:44:14 +00:00
Kevin Veen-Birkenbach
3f30621630
Probe-first asset resolution (regression fix)
---------------------------------------------
cache_manager.cache_file() returned either a relative cache path
(success) or None (failure). The previous app.py fallback
asset['cache'] = cached or asset['source'] mixed both types into
one field, which the template wrapped in url_for('static', ...)
regardless — producing broken
/static/https://file.infinito.nexus/.../logo.png URLs whenever the
source couldn't be downloaded.
- New app/utils/asset_resolver.py: HEAD-probes the URL (3 s
timeout, image/* content type). On hit, embed directly via a
new external_url field — no download required. On miss, fall
back to cache_manager.cache_file. If that also fails, expose
the source URL via external_url so the browser shows the alt
text instead of an empty src.
- app.py exposes an asset_src(asset) context processor that
picks external_url first, then url_for('static', cache),
so the template never wraps an absolute URL in a static prefix.
- Templates (base, navigation, card) switch to asset_src(...) and
gate the card image branch on cache or external_url.
- 16 unit tests cover every probe/cache/fallback branch; one live
integration test exercises the canonical
https://file.infinito.nexus/assets/img/logo.png to prove the
probe-first path works end-to-end (cache dir stays empty).
- config.sample.yaml: new Infinito.Nexus card driven by the same
canonical asset URL.
Single source of truth for IMAGE_NAME and PORT
----------------------------------------------
- env.example is now the only place the literal values live.
- Makefile and docker-compose.yml reference \$(IMAGE_NAME) /
\${IMAGE_NAME:?…} (same for PORT); no defaults, no silent
fallbacks.
- New make env / make config bootstrap .env / app/config.yaml
from their checked-in templates. Idempotent.
- All container-using targets depend on the two bootstrap targets
so a fresh checkout runs in a single invocation.
- Recipes source .env at recipe-execution time so they pick up a
freshly bootstrapped .env in the same make invocation.
README
------
- Screenshot added under the title.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
27 lines
943 B
YAML
27 lines
943 B
YAML
services:
|
|
portfolio:
|
|
# SPOT: IMAGE_NAME comes from .env (see env.example). No default —
|
|
# an empty tag would have compose fall back to `portfolio-portfolio`
|
|
# silently, which `make run-dev` would then fail to find.
|
|
image: ${IMAGE_NAME:?IMAGE_NAME must be set in .env (see env.example)}
|
|
build:
|
|
context: .
|
|
dockerfile: Dockerfile
|
|
container_name: portfolio
|
|
ports:
|
|
- "${PORT:?PORT must be set in .env (see env.example)}:${PORT:?PORT must be set in .env (see env.example)}"
|
|
env_file:
|
|
- .env
|
|
volumes:
|
|
- ./app:/app
|
|
- node_modules:/app/node_modules
|
|
- vendor:/app/static/vendor
|
|
# Run `npm install` on every container start so the named volumes
|
|
# reflect the current package.json (postinstall regenerates vendor/).
|
|
command: sh -c "npm install --prefix /app --no-audit --no-fund && python app.py"
|
|
restart: unless-stopped
|
|
|
|
volumes:
|
|
node_modules:
|
|
vendor:
|