mirror of
https://github.com/ChuckBuilds/LEDMatrix.git
synced 2026-08-06 19:28:06 +00:00
Codebase audit: fix shipping bugs, remove verified-dead code, repair doc drift, add regression guards (#438)
* fix(web): implement delete_cached so the font catalog cache actually invalidates
api_v3.py's font upload/delete handlers import delete_cached from
web_interface.cache, but the function was never defined. The surrounding
except ImportError silently swallowed the failure, so the fonts_catalog
cache entry survived uploads/deletes and newly uploaded fonts did not
appear until the TTL expired or the service restarted.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* fix(web): remove dead weather/stocks partial routes that returned 500
The partial dispatcher still routed 'weather' and 'stocks' to loaders
rendering v3/partials/weather.html and stocks.html — templates that no
longer exist since weather and stocks became store plugins. Requesting
either partial raised TemplateNotFound, which the catch-all turned into
a 500. No template or JS references these partials (the only 'weather'
hit in the front end is a plugin-store category filter option), so the
branches and both loader functions are removed; unknown partials now
fall through to the existing 404 handler.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* fix(deps): align contradictory psutil/Flask-Limiter/freetype-py pins
requirements.txt's optional-install comment recommended psutil>=5.9,<6.0
while web_interface/requirements.txt hard-requires >=6.0,<7.0 — anyone
following the comment ends up with an unsatisfiable pair. The comment now
recommends the same range the web interface requires (all psutil APIs
used — Process, boot_time, cpu_percent, disk_usage, virtual_memory — are
stable in 6.x). Flask-Limiter gains the same <4.0 cap in both files and
freetype-py the same >=2.5.1 floor.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* fix(config): add template keys the code already reads
display.hardware gains pixel_mapper_config, row_address_type,
multiplexing and panel_type (read at display_manager.py with these exact
fallbacks — users on non-standard panels previously had no way to
discover them from the template). vegas_scroll gains
frame_based_scrolling and scroll_delay, the only two of its 27 keys the
template omitted (read in src/vegas_mode/config.py). plugin_system gains
development_mode, which the web UI reads and writes but the template
never declared.
Every added value is byte-identical to the code-side .get() fallback, so
ConfigManager._migrate_config() merging these keys into existing user
configs cannot change behavior on any installed device.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* fix(scripts): repair broken sys.path setup in utility scripts
clear_cache.py and download_nba_logos.py pointed sys.path at a 'src'
directory relative to the script's own folder (scripts/utils/src and
scripts/src — neither exists), so both crashed on import; they now insert
the project root and import via the src package like the other scripts.
debug_web_manual.py resolved 'project root' to scripts/debug/ instead of
two levels up. fix_nhl_cache.sh is removed: it used Python docstring
syntax in a bash script and invoked clear_nhl_cache.py, which does not
exist anywhere in the repo — it cannot ever have worked in its current
location.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* docs: correct stale file:line references and the loader-fallback contradiction
CLAUDE.md and .cursorrules disagreed about plugin-directory fallback
behavior; the code (SchemaManager.get_schema_path) probes plugins/
BEFORE plugin-repos/, and the main discovery path has no fallback at
all — both files now describe the real behavior, preferring symbol names
over line numbers so the references rot slower. REST_API_REFERENCE.md
pointed at app.py:144/:607 for mounts that live at :199/:799 and counted
92 routes where there are 94. PLUGIN_ARCHITECTURE_SPEC.md's historical
banner gains a note that its example imports
(src/plugin_system/base_classes/*_plugin.py) never shipped — the real
base classes are src.base_classes.sports.SportsCore and
src.base_classes.hockey.Hockey.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* docs: fix broken links, phantom script references, and stale CI description
Repairs every broken relative link in active docs (targets renamed or
archived long ago: PLUGIN_DEVELOPMENT.md -> PLUGIN_DEVELOPMENT_GUIDE.md,
API_REFERENCE.md -> REST_API_REFERENCE.md, PLUGIN_STORE_USER_GUIDE.md ->
PLUGIN_STORE_GUIDE.md, plugin_docs/ dir, TROUBLESHOOTING_QUICK_START.md,
and MIGRATION_GUIDE's README link that silently resolved to the docs
index instead of the project README). Replaces commands invoking scripts
that do not exist (scripts/update_stats.py, validate_registry.py,
check_updates.py, fix_permissions.sh) with the real tooling, and
rewrites HOW_TO_RUN_TESTS.md's CI section, which described a
security-audit workflow that was never committed and a pytest workflow
'queued to land' that landed long ago as test.yml.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* docs: complete the docs index and refresh the web interface file tree
docs/README.md's own policy says every page must be linked from the
index, yet five weren't — including the entire skin system
(SKIN_SYSTEM.md, CREATING_SKINS.md), ADAPTIVE_LAYOUT.md,
plugin-safety-harness.md and SPORTS_UNIFICATION.md. Each is now listed
in the section it belongs to, and PLUGIN_ARCHITECTURE_SPEC.md is marked
historical in the index (the doc itself already carries the banner).
web_interface/README.md's static/v3 tree showed only app.css/app.js;
it now reflects the actual contents.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* chore: remove dead modules confirmed unused in-repo and across all store plugins
- src/common/cli.py: imports a 'ledmatrix_common' package that exists
nowhere (not in this repo, any requirements file, or the plugin
monorepo), so it cannot ever have run; its README section claimed
scripts/dev/* used it, which was also untrue.
- src/web_interface/logging_config.py: zero callers — the web app uses
web_interface/logging_config.py (a different module), and nothing
imports the src copy.
- handle_errors decorator in src/web_interface/error_handler.py: zero
call sites (the module's response helpers stay — they are used).
- ConfigManager.get_clock_config(): reads a 'clock' config key that no
longer exists anywhere; only caller was its own unit test.
Deliberately kept despite zero in-repo callers: DisplayError,
src/common/config_helper.py and display_helper.py — all documented as
plugin-facing API (docs/PLUGIN_ERROR_HANDLING.md, src/common/README.md),
and third-party plugins outside the official monorepo cannot be
enumerated. Verified against a fresh clone of ledmatrix-plugins (43
plugins): zero references to any removed symbol.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* chore: remove manager-era NBA test files and one-off debug scripts
The four test_nba_*.py files imported nba_managers, leaderboard_manager
and odds_manager — top-level modules deleted when sports displays became
plugins — inside try/except blocks that swallowed the ImportError, so
they passed while exercising nothing. test_nba_data_structure.py and
debug_nba_api.py (a diagnostic script living in test/) made live ESPN
API calls rather than testing repo code. None were enrolled in CI.
scripts/debug/direct_fix_imports.py and check_imports.py were one-shot
artifacts that edited/inspected a hardcoded ~/LEDMatrix/web_interface/
app.py to fix an import problem solved long ago; nothing references
them.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* chore: remove generate_report.py, which aggregates artifacts of CI jobs that do not exist
The script's only function is to merge JSON artifacts
(bandit/semgrep/pip-audit/safety/gitleaks results) produced by a
security-audit workflow that was never committed —
.github/workflows/ has no such jobs, so there is nothing for it to
aggregate and no way to run it usefully. Its siblings stay:
prove_security.py and audit_plugins.py both run standalone (verified),
and .codacy.yml stays because the Codacy service (README badge) reads it
server-side without a workflow file.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* fix(web): load the three widget scripts store plugins already declare
time-picker.js, file-upload-single.js and plugin-file-manager.js
register widgets that installed store plugins reference in their config
schemas (countdown uses x-widget: time-picker and file-upload-single;
of-the-day uses plugin-file-manager), but base.html never included the
scripts. plugin_config.html renders such fields as an empty container
that polls LEDMatrixWidgets.get(...) on a 50ms loop forever, so those
plugin config fields appeared permanently blank. The audit initially
flagged these files as dead code; the monorepo cross-check proved the
opposite — they were unreachable, not unused.
example-color-picker.js (the documented custom-widget example) gains an
explicit warning that including it in base.html would shadow the
built-in color-picker widget.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* chore: drop the legacy youtube block from the secrets template
No code reads a top-level youtube secrets key: the youtube-stats plugin
receives its API key namespaced under its own plugin id (declared via
x-secret in its config schema), like every other store plugin. The key
survives only in state_reconciliation.py's non-plugin-key exclusion set,
which stays — existing installs still carry the key in their generated
config_secrets.json, and the exclusion prevents it from being
misclassified as a plugin config. New installs simply stop being asked
for a YouTube API key they have nowhere to use.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* chore(deps): remove packages nothing imports, declare direct imports, move mypy to test deps
Removed from requirements.txt: python-socketio, python-engineio,
websockets, websocket-client — zero imports anywhere in this repo, and
the one store plugin that needs Socket.IO (ledmatrix-music) declares it
in its own requirements.txt, which the plugin store installs. Removed
the same quartet plus timezonefinder, geopy, google-auth-oauthlib,
google-auth-httplib2, google-api-python-client, unidecode, icalevents,
python-dateutil, flask-wtf and the werkzeug pin from
web_interface/requirements.txt — all leftovers from the deleted built-in
weather/calendar/music displays (flask-wtf was doubly dead: app.py
explicitly disables CSRF and sets csrf=None). scripts/
install_dependencies_apt.py, which mirrors these lists for the
first-time installer, drops the same packages.
Added: urllib3 (imported directly in four core modules), jinja2 and
markupsafe (imported directly in pages_v3.py) — previously reachable
only as transitives. mypy moves from runtime requirements to
requirements-test.txt.
Verified in a fresh venv: all four requirements files co-install, pip
check is clean, the full CI-enrolled suite (907 tests) and a Flask boot
smoke pass with the trimmed dependency set.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* refactor: single canonical DateTimeEncoder
src/cache_manager.py and src/cache/disk_cache.py each defined an
identical DateTimeEncoder (datetime -> ISO-8601). The disk_cache copy is
the only one actually used for serialization; cache_manager now
re-exports it instead of defining a twin, so the two can never silently
diverge. Import compatibility is preserved — from src.cache_manager
import DateTimeEncoder still works and is the same class object.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* docs(code): document deliberate duplicates instead of merging them
The audit surfaced several near-duplicate implementations that turned
out to be either deliberate forks or behaviorally different — merging
any of them would risk changing behavior on installed devices, so each
now carries an explicit comment stating the relationship:
- VisualDisplayManager: headless fork of DisplayManager; header now
lists the ~15 mirrored methods and warns that DisplayManager changes
must be mirrored.
- normalize_abbreviation: LogoDownloader's version (called directly by
nine scoreboard plugins) replaces filesystem-unsafe characters;
LogoHelper's strips spaces. Logo filenames on existing installs
depend on both behaviors staying put.
- The two PluginTestBase classes: the shipped one is plugin-author
API, the repo's own richer harness lives in test/plugins/ — now
cross-referenced.
Also verified (no change needed): ConfigManager's backup/rollback
methods genuinely delegate to AtomicConfigManager, and SportsCore
already delegates _read_bdf_native_size to FontManager.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* docs: add a unified configuration reference
There was no single place documenting what lives in config.json —
display.* keys were scattered across README sections, vegas_scroll lived
in ADVANCED_FEATURES.md, and dim_schedule, display.double_sided,
sync.follower_position, plugin_system.development_mode and the four
newly-templated hardware keys were documented nowhere. CONFIG_REFERENCE.md
now lists every template key plus the code-read-only keys, each with
type, default, and the code location that reads it, and explains the
secrets file's plugin-id namespacing. Linked from the docs index.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* docs: bring the README's feature tour into the plugin era
The Core Features section still presented clock/weather/sports/stocks/
music displays as built into the project, when all of them are store
plugins installed from the ledmatrix-plugins monorepo — only
starlark-apps and web-ui-info ship in this repo. The intro now says so
(the showcase itself is unchanged; those are real displays available in
the store). The display_durations reference drops its built-in-calendar
example in favor of plugin-id keys, and the Configuration section links
the new CONFIG_REFERENCE.md.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* docs: archive the custom-icons status report, cross-link config docs, document assets/
PLUGIN_CUSTOM_ICONS_FEATURE.md was a 'What Was Implemented' status
report duplicating the actual guide (PLUGIN_CUSTOM_ICONS.md) — moved to
docs/archive/ per the docs index's own policy. The overlapping
plugin-config docs keep their content but PLUGIN_CONFIG_ARCHITECTURE.md
now states up front which doc is canonical for which purpose.
assets/README.md is new and load-bearing: assets/stocks, weather,
news_logos and broadcast_logos have zero references in this repo's code,
which makes them look deletable — but store plugins (ledmatrix-stocks,
ledmatrix-weather, news, odds-ticker) resolve those exact paths at
runtime against the install directory. The README records that evidence
so a future cleanup doesn't break installed plugins.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* test: add regression guards for the bug classes fixed in this PR
Three lightweight static checks, all enrolled in CI's unit-test
allowlist along with the new web-cache test:
- test_template_targets.py: every literal render_template() target must
exist (would have caught the weather/stocks partial 500s at commit
time).
- test_widget_scripts.py: every widget JS file must be script-included
in base.html or explicitly allowlisted with a reason (would have
caught the unloaded time-picker/file-upload-single/plugin-file-manager
widgets), and allowlisted files must NOT be included (prevents the
example widget from shadowing the real color-picker).
- test_doc_links.py: relative markdown links in active docs must
resolve (docs/archive/ exempt).
Each guard was verified to fail against the pre-PR tree and pass now.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* fix(deps): restore the werkzeug version floor
Commit 1ec22db removed the werkzeug>=3.1.6,<4.0.0 pin along with the
genuinely-unused packages, but this one was a version floor on Flask's
transitive dependency, not a phantom: Flask 3.1.3 itself only requires
werkzeug>=3.1.0, so dropping the pin let fresh installs resolve
3.1.0-3.1.5. Restored with a comment explaining why it exists.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* fix(web): route pixel_mapper_config into display.hardware; guard time-picker registration
pixel_mapper_config was the only display.hardware key absent from both
the display_fields detection allowlist and the hardware write loop in
the settings save path. No form posts it today, but if one ever did the
key would fall through to the generic handler and land at the TOP level
of config.json — where state_reconciliation would mistake it for a
missing plugin id and loop auto-repair attempts (the failure class the
'github'/'youtube' exclusion comment documents). It now round-trips
into display.hardware like its siblings.
time-picker.js gains the same LEDMatrixWidgets-undefined guard its two
sibling widgets already have; correct today only via defer ordering.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* chore: align installer leftovers with the dependency cleanup
first_time_install.sh's fallback secrets heredoc (used only when the
template is missing) still wrote the legacy youtube block — now matches
the template (github only). install_dependencies_apt.py drops the
IMPORT_NAME_MAP entries for packages no longer in its install lists and
a stale google-api reference in a docstring.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* fix: address CodeRabbit review findings
Verified each finding against the code; fixes for the valid ones:
- install_dependencies_apt.py: the installer listed 'freetype', but the
declared dependency is freetype-py — an apt miss would pip-install the
wrong PyPI package. Now installs freetype-py with an import-name
mapping (pre-existing bug, surfaced by the review).
- api_v3.py: pixel_mapper_config is validated as a string before being
saved to display.hardware (JSON callers could previously store an
object/list the matrix library can't use).
- .cursorrules: the Plugin Loading Process and File Organization
sections still said discovery scans plugins/ — now consistent with the
corrected overview (configured directory, default plugin-repos/).
- README.md: removed the stale '(except the core calendar)' claim — no
core calendar exists in src/ — and qualified the plugin inventory
(official plugins in the monorepo; third-party from their own repos).
- CONFIG_REFERENCE.md: hardware_mapping now shows the code fallback
(adafruit-hat-pwm) alongside the template value.
- PLUGIN_REGISTRY_SETUP_GUIDE.md: check_plugin.py takes --plugin, not a
positional id.
- scripts/fix_perms/fix_*.sh: exec bits set so the documented
'sudo ./...' invocations work.
- Guard tests hardened: template guard now catches multi-line
render_template() calls; widget guard parses actual <script> src
values and fails if the widgets dir goes missing; type hints and
docstrings added per repo coding guidelines.
Skipped with reasons (noted on the PR): limit_refresh_rate_hz 100-vs-90
is documented as intentional in CONFIG_REFERENCE.md; the psutil comment
already names the enforcing manifest; docs/archive/ findings are out of
scope per the docs policy (archive may rot).
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* chore: remove Cursor IDE tooling, consolidate its guidance into CLAUDE.md
The maintainer no longer uses Cursor. .cursorrules, .cursorignore and the
.cursor/ tree (rules, plugin templates, a parallel 751-line plugins
guide) are removed; measurement showed near-zero literal overlap risk —
the canonical content already lives in docs/. Unique guidance worth
keeping moved before deletion:
- CLAUDE.md gains the dev workflow (dev_plugin_setup.sh, dev_server.py,
run.py -e, check_plugin.py), the plugin-secrets namespacing contract,
and the no-draw_image()/paste-onto-PIL pitfall.
- PLUGIN_DEVELOPMENT_GUIDE.md absorbs the plugin version-management
rules (pre-push hook install, SKIP_TAG, version resolution order) that
its own text previously linked out to .cursorrules for.
- The one completed plan doc (.cursor/plans/) is archived to
docs/archive/ per the docs policy rather than deleted.
One of the deleted rule files (sports-managers.mdc) targeted
src/*_managers.py globs that have matched nothing since the plugin
migration.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* chore: second-pass cleanup — dead installer branch, broken script, orphaned JS, misfiled test deps
- first_time_install.sh: removed the pip fallback branch that installed
from requirements_web_v2.txt — a file that has not existed since the
v2 web interface was removed (the branch always printed its own
'not found; skipping' warning).
- scripts/remove_plugin_backups.sh deleted: its PROJECT_ROOT resolved to
the repo's PARENT directory, and its verify_submodules() checks for
plugin submodules from an era before plugins moved to the store — it
could never have worked from its current location.
- plugins_manager.js: removed three functions with zero call sites
anywhere (addKeyValuePair, formatCommit, togglePasswordVisibility) —
verified against all templates, all JS, and the dynamic window[name]
dispatch sites, which resolve widget-registry keys only. Also replaced
base.html's misleading 'Legacy ... during migration' label: the file
is deliberately loaded last and provides the LIVE implementations of
seven window.* plugin actions that shadow same-named definitions in
app.js/app-shell.js.
- pytest/pytest-cov/pytest-mock moved from runtime requirements.txt to
requirements-test.txt (CI already installs both files; the installer's
line-by-line loop simply installs three fewer packages on devices; no
store plugin declares pytest). HOW_TO_RUN_TESTS.md updated.
- scripts/add_defaults_to_schemas.py and analyze_plugin_schemas.py
scanned the empty legacy plugins/ dir — now scan plugin-repos/.
Verified: fresh venv installs all four requirements files with pip check
clean and pytest available; bash -n on the installer; node --check on
the JS; widget/cache guard tests green.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* docs: correct semantically stale content across the user and developer guides
A second-pass content audit checked the guides' substantive claims
against the code (the first pass only fixed mechanical drift). Fixes:
- GETTING_STARTED: described booting a prebuilt SD image and seeing
default clock/weather plugins — neither exists. Now documents the real
install (Pi OS Lite + one-shot installer / first_time_install.sh) and
that displays come from the Plugin Store. Duration and ordering
instructions moved to the Rotation tab where the controls actually
live.
- WEB_INTERFACE_GUIDE: three whole tabs were undocumented (Rotation,
Backup & Restore, Tools) and the Display tab's Vegas Scroll section
was unmentioned. Fonts overrides are per display element (not per
plugin); Logs has an Auto-scroll checkbox (not a Pause button); the
aspirational keyboard-shortcut list and no-JS claim removed.
- TROUBLESHOOTING: the hand-written service-file template (wrong user,
wrong ExecStart, dropped the autostart gate) replaced with the real
systemd/ units + install scripts; recovery steps no longer copy
placeholder units verbatim; WiFi curl endpoint corrected to /api/v3/;
cache-clearing advice now targets the real cache locations.
- ADVANCED_FEATURES: removed a false claim that CacheManager has no
delete(); fixed two example snippets that raise TypeError
(BackgroundDataService and get_config_file_mode signatures); fixed
cache paths, a 5-minute TTL that is actually 1 hour, and the vegas
table now links the complete 26-key reference.
- EMULATOR_SETUP_GUIDE: documented run.py flags that don't exist
(--plugin/--test-plugins) removed in favor of dev_server.py and
check_plugin.py; shipped emulator config values corrected (browser
adapter default on :8888, not pygame).
- PLUGIN_QUICK_REFERENCE: drag-and-drop reordering is shipped, not
'not yet supported'; discovery-fallback and registry-repo claims
corrected. PLUGIN_API_REFERENCE: get_vegas_segment_width returns
panels, not pixels. CONTRIBUTING: the repo uses flake8/mypy/bandit
pre-commit hooks, not black/ruff, and tests need requirements-test.txt.
- SKIN_SYSTEM/DEVELOPER_QUICK_REFERENCE: stale module paths.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
* fix: raise the two new dependency floors past their CVEs, silence a deliberate re-export
All three of these were introduced by this PR, which is what makes them
worth fixing here rather than deferring.
`urllib3` and `jinja2` were added to the requirements so that direct
imports stop relying on transitives — right call, but both floors were
set to the version that introduced the API rather than a version that is
safe to install. `urllib3>=1.26.0` sits below roughly ten CVEs including
a decompression-bomb safeguard bypass, and `jinja2>=3.1.0` below five
including two sandbox breakouts. Raised to 2.7.0 and 3.1.6, which is what
a working device already runs, so no install is disturbed. The comments
now say the floor is a security floor, since the next person to read
"imported directly" would otherwise reasonably lower it again.
This is the same reasoning the PR already applied to werkzeug; these two
just missed it.
The `DateTimeEncoder` import in cache_manager is unused on purpose — the
canonical class moved to src.cache.disk_cache and this re-export keeps
the documented import path working. flake8 cannot see intent, so it gets
an explicit `# noqa: F401` rather than being removed and quietly breaking
anything importing it from here. Verified the re-export still resolves to
the same object and still serialises datetimes.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Udr6MfaFLUPhX5Fgo67Jf5
* fix: address CodeRabbit re-review — installer robustness and doc lint
- install_dependencies_apt.py: an import-only check let Debian
Bookworm's python3-freetype 2.3.0 satisfy the freetype-py>=2.5.1 pin.
check_package_installed() now verifies the installed freetype-py
version, and an apt install that lands below the minimum falls through
to pip instead of counting as success.
- first_time_install.sh: the .web_deps_installed marker was created even
when the smart installer failed, so re-runs skipped installation with
dependencies missing. The marker is now created only on success.
- CONTRIBUTING.md: document installing the pre-commit CLI before
'pre-commit install' (the requirements files don't provide it).
- Doc lint: fence language on the on-demand cache example (MD040),
blockquote continuation in GETTING_STARTED (MD028), and the
suppress_adapter_load_errors key removed from the emulator debug
example to match the options table.
Skipped one finding with reason (noted on the PR): the per-plugin
display_duration field in PLUGIN_QUICK_REFERENCE's example is not
obsolete — BasePlugin.get_display_duration() reads it and
PLUGIN_CONFIG_CORE_PROPERTIES.md documents it as a core property;
display.display_durations is a per-mode override, not a replacement.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXb4mKcAkVaxkeTb3YnAdr
---------
Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
Chuck
@@ -1,166 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Diagnostic script to examine NBA API data structure and identify the missing 'id' field issue.
|
||||
"""
|
||||
import requests
|
||||
import logging
|
||||
from typing import Dict, Any
|
||||
|
||||
# Set up logging
|
||||
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
|
||||
logger = logging.getLogger(__name__)
|
||||
|
||||
def fetch_nba_teams_data() -> Dict[str, Any]:
|
||||
"""Fetch NBA teams data from ESPN API."""
|
||||
teams_url = "https://site.api.espn.com/apis/site/v2/sports/basketball/nba/teams"
|
||||
|
||||
try:
|
||||
logger.info(f"Fetching NBA teams data from: {teams_url}")
|
||||
response = requests.get(teams_url, timeout=30)
|
||||
response.raise_for_status()
|
||||
data = response.json()
|
||||
|
||||
logger.info(f"Successfully fetched NBA teams data")
|
||||
logger.info(f"Response structure keys: {list(data.keys())}")
|
||||
|
||||
# Examine the structure
|
||||
sports = data.get('sports', [])
|
||||
if sports:
|
||||
logger.info(f"Number of sports: {len(sports)}")
|
||||
sport = sports[0]
|
||||
logger.info(f"Sport keys: {list(sport.keys())}")
|
||||
|
||||
leagues = sport.get('leagues', [])
|
||||
if leagues:
|
||||
league = leagues[0]
|
||||
logger.info(f"League keys: {list(league.keys())}")
|
||||
|
||||
teams = league.get('teams', [])
|
||||
logger.info(f"Number of teams: {len(teams)}")
|
||||
|
||||
if teams:
|
||||
# Examine first team structure
|
||||
first_team = teams[0]
|
||||
logger.info(f"First team keys: {list(first_team.keys())}")
|
||||
|
||||
team_data = first_team.get('team', {})
|
||||
logger.info(f"Team data keys: {list(team_data.keys())}")
|
||||
|
||||
# Check for id field
|
||||
team_id = team_data.get('id')
|
||||
team_abbr = team_data.get('abbreviation')
|
||||
team_name = team_data.get('name')
|
||||
|
||||
logger.info(f"Sample team: ID={team_id}, ABBR={team_abbr}, NAME={team_name}")
|
||||
|
||||
if team_id:
|
||||
logger.info(f"Team ID field exists: {team_id}")
|
||||
else:
|
||||
logger.error("Team ID field is missing!")
|
||||
|
||||
# Check a few more teams to confirm structure
|
||||
for i in range(min(5, len(teams))):
|
||||
team = teams[i].get('team', {})
|
||||
logger.info(f"Team {i+1}: ID={team.get('id')}, ABBR={team.get('abbreviation')}")
|
||||
|
||||
return data
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"Error fetching NBA teams data: {e}")
|
||||
return {}
|
||||
|
||||
def fetch_nba_standings_data() -> Dict[str, Any]:
|
||||
"""Fetch NBA standings data from ESPN API."""
|
||||
standings_url = "https://site.api.espn.com/apis/v2/sports/basketball/nba/standings"
|
||||
|
||||
try:
|
||||
logger.info(f"Fetching NBA standings data from: {standings_url}")
|
||||
response = requests.get(standings_url, timeout=30)
|
||||
response.raise_for_status()
|
||||
data = response.json()
|
||||
|
||||
logger.info(f"Successfully fetched NBA standings data")
|
||||
logger.info(f"Response structure keys: {list(data.keys())}")
|
||||
|
||||
# Check if standings has entries (direct structure)
|
||||
if 'standings' in data and 'entries' in data['standings']:
|
||||
entries = data['standings']['entries']
|
||||
logger.info(f"Number of standings entries (direct): {len(entries)}")
|
||||
|
||||
if entries:
|
||||
# Examine first entry structure
|
||||
first_entry = entries[0]
|
||||
logger.info(f"First entry keys: {list(first_entry.keys())}")
|
||||
|
||||
team_data = first_entry.get('team', {})
|
||||
logger.info(f"Team data keys: {list(team_data.keys())}")
|
||||
|
||||
# Check for id field
|
||||
team_id = team_data.get('id')
|
||||
team_abbr = team_data.get('abbreviation')
|
||||
team_name = team_data.get('displayName')
|
||||
|
||||
logger.info(f"Sample standings team: ID={team_id}, ABBR={team_abbr}, NAME={team_name}")
|
||||
|
||||
if team_id:
|
||||
logger.info(f"Standings team ID field exists: {team_id}")
|
||||
else:
|
||||
logger.error("Standings team ID field is missing!")
|
||||
|
||||
# Check children structure (divisions/conferences)
|
||||
if 'children' in data:
|
||||
children = data.get('children', [])
|
||||
logger.info(f"Number of children (divisions/conferences): {len(children)}")
|
||||
|
||||
for i, child in enumerate(children):
|
||||
logger.info(f"Child {i+1} keys: {list(child.keys())}")
|
||||
child_name = child.get('displayName', 'Unknown')
|
||||
logger.info(f"Child {i+1} name: {child_name}")
|
||||
|
||||
if 'standings' in child and 'entries' in child['standings']:
|
||||
entries = child['standings']['entries']
|
||||
logger.info(f"Child {i+1} has {len(entries)} entries")
|
||||
|
||||
if entries:
|
||||
# Examine first entry in this child
|
||||
first_entry = entries[0]
|
||||
logger.info(f"Child {i+1} first entry keys: {list(first_entry.keys())}")
|
||||
|
||||
team_data = first_entry.get('team', {})
|
||||
logger.info(f"Child {i+1} team data keys: {list(team_data.keys())}")
|
||||
|
||||
# Check for id field
|
||||
team_id = team_data.get('id')
|
||||
team_abbr = team_data.get('abbreviation')
|
||||
team_name = team_data.get('displayName')
|
||||
|
||||
logger.info(f"Child {i+1} sample team: ID={team_id}, ABBR={team_abbr}, NAME={team_name}")
|
||||
|
||||
if team_id:
|
||||
logger.info(f"Child {i+1} team ID field exists: {team_id}")
|
||||
else:
|
||||
logger.error(f"Child {i+1} team ID field is missing!")
|
||||
|
||||
return data
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"Error fetching NBA standings data: {e}")
|
||||
return {}
|
||||
|
||||
def main():
|
||||
"""Main diagnostic function."""
|
||||
logger.info("Starting NBA API data structure diagnosis")
|
||||
|
||||
# Fetch teams data
|
||||
teams_data = fetch_nba_teams_data()
|
||||
|
||||
# Fetch standings data
|
||||
standings_data = fetch_nba_standings_data()
|
||||
|
||||
# Summary
|
||||
logger.info("Diagnosis complete")
|
||||
logger.info("Check the logs above to see if team 'id' fields are present")
|
||||
logger.info("The leaderboard manager needs team 'id' fields for logo fetching")
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -383,19 +383,6 @@ class TestConfigHelpers:
|
||||
display_config = manager.get_display_config()
|
||||
assert display_config["hardware"]["rows"] == 32
|
||||
|
||||
def test_get_clock_config(self, tmp_path):
|
||||
"""Test getting clock config."""
|
||||
config_file = tmp_path / "config.json"
|
||||
config_data = {"clock": {"format": "12h"}}
|
||||
|
||||
with open(config_file, 'w') as f:
|
||||
json.dump(config_data, f)
|
||||
|
||||
manager = ConfigManager(config_path=str(config_file))
|
||||
manager.load_config()
|
||||
|
||||
clock_config = manager.get_clock_config()
|
||||
assert clock_config["format"] == "12h"
|
||||
|
||||
|
||||
class TestPluginConfigManagement:
|
||||
|
||||
@@ -0,0 +1,43 @@
|
||||
"""Guard: relative markdown links in active docs must resolve.
|
||||
|
||||
Scans repo-root *.md and docs/ (excluding docs/archive/, which is allowed
|
||||
to rot). External URLs, mailto links, and pure anchors are skipped, as are
|
||||
links inside fenced code blocks.
|
||||
"""
|
||||
import re
|
||||
from pathlib import Path
|
||||
from typing import Iterator
|
||||
|
||||
PROJECT_ROOT = Path(__file__).resolve().parent.parent
|
||||
LINK_RE = re.compile(r'\[[^\]]*\]\(([^)\s]+)\)')
|
||||
FENCE_RE = re.compile(r'^(```|~~~)')
|
||||
|
||||
|
||||
def _md_files() -> Iterator[Path]:
|
||||
"""Yield active markdown files (repo root + docs/, excluding docs/archive/)."""
|
||||
yield from PROJECT_ROOT.glob('*.md')
|
||||
for path in PROJECT_ROOT.glob('docs/**/*.md'):
|
||||
if 'archive' not in path.parts:
|
||||
yield path
|
||||
|
||||
|
||||
def test_relative_markdown_links_resolve() -> None:
|
||||
"""Every relative markdown link outside code fences must resolve on disk."""
|
||||
broken = []
|
||||
for md in _md_files():
|
||||
in_fence = False
|
||||
for lineno, line in enumerate(md.read_text(encoding='utf-8').splitlines(), 1):
|
||||
if FENCE_RE.match(line.strip()):
|
||||
in_fence = not in_fence
|
||||
continue
|
||||
if in_fence:
|
||||
continue
|
||||
for target in LINK_RE.findall(line):
|
||||
if target.startswith(('http://', 'https://', 'mailto:', '#')):
|
||||
continue
|
||||
resolved = (md.parent / target.split('#')[0]).resolve()
|
||||
if not resolved.exists():
|
||||
broken.append(
|
||||
f'{md.relative_to(PROJECT_ROOT)}:{lineno} -> {target}'
|
||||
)
|
||||
assert not broken, 'Broken relative markdown links:\n' + '\n'.join(broken)
|
||||
@@ -1,262 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Core functionality test for NBA components without hardware dependencies.
|
||||
"""
|
||||
import sys
|
||||
import os
|
||||
import logging
|
||||
import json
|
||||
|
||||
# Set up logging
|
||||
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
|
||||
logger = logging.getLogger(__name__)
|
||||
|
||||
def test_nba_data_structure():
|
||||
"""Test NBA data structure and team ID field presence."""
|
||||
try:
|
||||
import requests
|
||||
|
||||
# Test teams endpoint for data structure
|
||||
teams_url = "https://site.api.espn.com/apis/site/v2/sports/basketball/nba/teams"
|
||||
response = requests.get(teams_url, timeout=10)
|
||||
response.raise_for_status()
|
||||
teams_data = response.json()
|
||||
|
||||
# Extract first team to check structure
|
||||
sports = teams_data.get('sports', [])
|
||||
if not sports:
|
||||
logger.error("No sports data found")
|
||||
return False
|
||||
|
||||
leagues = sports[0].get('leagues', [])
|
||||
if not leagues:
|
||||
logger.error("No leagues data found")
|
||||
return False
|
||||
|
||||
teams = leagues[0].get('teams', [])
|
||||
if not teams:
|
||||
logger.error("No teams data found")
|
||||
return False
|
||||
|
||||
first_team = teams[0].get('team', {})
|
||||
team_id = first_team.get('id')
|
||||
team_abbr = first_team.get('abbreviation')
|
||||
|
||||
logger.info(f"Sample team: ID={team_id}, ABBR={team_abbr}")
|
||||
|
||||
if team_id is None:
|
||||
logger.error("❌ Team ID field missing!")
|
||||
return False
|
||||
|
||||
logger.info("✅ NBA data structure test PASSED")
|
||||
return True
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"❌ NBA data structure test FAILED: {e}")
|
||||
return False
|
||||
|
||||
def test_odds_data_structure():
|
||||
"""Test odds data structure."""
|
||||
try:
|
||||
import requests
|
||||
|
||||
# Test odds endpoint for data structure
|
||||
odds_url = "https://sports.core.api.espn.com/v2/sports/basketball/leagues/nba/events/401585515/competitions/401585515/odds"
|
||||
response = requests.get(odds_url, timeout=10)
|
||||
response.raise_for_status()
|
||||
odds_data = response.json()
|
||||
|
||||
logger.info(f"Odds data structure keys: {list(odds_data.keys())}")
|
||||
|
||||
# Check if odds data has expected structure
|
||||
if 'items' in odds_data:
|
||||
logger.info("✅ Odds data has expected structure")
|
||||
return True
|
||||
else:
|
||||
logger.warning("⚠️ Odds data structure different than expected")
|
||||
return True # Still pass since API is working
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"❌ Odds data structure test FAILED: {e}")
|
||||
return False
|
||||
|
||||
def test_nba_standings_structure():
|
||||
"""Test NBA standings data structure for team IDs."""
|
||||
try:
|
||||
import requests
|
||||
|
||||
# Test standings endpoint
|
||||
standings_url = "https://site.api.espn.com/apis/v2/sports/basketball/nba/standings"
|
||||
response = requests.get(standings_url, timeout=10)
|
||||
response.raise_for_status()
|
||||
standings_data = response.json()
|
||||
|
||||
# Check children structure (Eastern/Western conferences)
|
||||
children = standings_data.get('children', [])
|
||||
if not children:
|
||||
logger.error("No children (conferences) found in standings")
|
||||
return False
|
||||
|
||||
# Check first conference for team data
|
||||
first_conference = children[0]
|
||||
standings = first_conference.get('standings', {})
|
||||
entries = standings.get('entries', [])
|
||||
|
||||
if not entries:
|
||||
logger.error("No standings entries found")
|
||||
return False
|
||||
|
||||
# Check first team for ID field
|
||||
first_team = entries[0].get('team', {})
|
||||
team_id = first_team.get('id')
|
||||
team_abbr = first_team.get('abbreviation')
|
||||
|
||||
logger.info(f"Standings team: ID={team_id}, ABBR={team_abbr}")
|
||||
|
||||
if team_id is None:
|
||||
logger.error("❌ Standings team ID field missing!")
|
||||
return False
|
||||
|
||||
logger.info("✅ NBA standings structure test PASSED")
|
||||
return True
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"❌ NBA standings structure test FAILED: {e}")
|
||||
return False
|
||||
|
||||
def test_configuration_analysis():
|
||||
"""Analyze current NBA configuration."""
|
||||
try:
|
||||
with open('config/config.json', 'r') as f:
|
||||
config = json.load(f)
|
||||
|
||||
# Analyze NBA scoreboard config
|
||||
nba_scoreboard = config.get('nba_scoreboard', {})
|
||||
logger.info("NBA Scoreboard Configuration:")
|
||||
logger.info(f" Enabled: {nba_scoreboard.get('enabled', False)}")
|
||||
logger.info(f" Show Odds: {nba_scoreboard.get('show_odds', False)}")
|
||||
logger.info(f" Favorite Teams: {nba_scoreboard.get('favorite_teams', [])}")
|
||||
logger.info(f" Logo Directory: {nba_scoreboard.get('logo_dir', 'N/A')}")
|
||||
|
||||
# Analyze leaderboard config
|
||||
leaderboard = config.get('leaderboard', {})
|
||||
nba_leaderboard = leaderboard.get('enabled_sports', {}).get('nba', {})
|
||||
|
||||
logger.info("\nLeaderboard NBA Configuration:")
|
||||
logger.info(f" Leaderboard Enabled: {leaderboard.get('enabled', False)}")
|
||||
logger.info(f" NBA Enabled: {nba_leaderboard.get('enabled', False)}")
|
||||
logger.info(f" NBA Top Teams: {nba_leaderboard.get('top_teams', 'N/A')}")
|
||||
|
||||
# Check for potential issues
|
||||
issues = []
|
||||
|
||||
if not nba_scoreboard.get('enabled', False) and nba_scoreboard.get('show_odds', False):
|
||||
issues.append("⚠️ NBA scoreboard disabled but odds enabled")
|
||||
|
||||
if leaderboard.get('enabled', False) and not nba_leaderboard.get('enabled', False):
|
||||
issues.append("ℹ️ Leaderboard enabled but NBA disabled")
|
||||
|
||||
if issues:
|
||||
logger.warning("Configuration Issues Found:")
|
||||
for issue in issues:
|
||||
logger.warning(f" {issue}")
|
||||
else:
|
||||
logger.info("✅ No configuration issues found")
|
||||
|
||||
return True
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"❌ Configuration analysis FAILED: {e}")
|
||||
return False
|
||||
|
||||
def test_nba_logo_path_construction():
|
||||
"""Test NBA logo path construction logic."""
|
||||
try:
|
||||
# Simulate the logo path construction from leaderboard manager
|
||||
team_abbr = "LAL"
|
||||
logo_dir = "assets/sports/nba_logos"
|
||||
expected_path = f"{logo_dir}/{team_abbr}.png"
|
||||
|
||||
logger.info(f"Expected logo path: {expected_path}")
|
||||
|
||||
# Check if directory exists
|
||||
if os.path.exists(logo_dir):
|
||||
logger.info(f"✅ Logo directory exists: {logo_dir}")
|
||||
else:
|
||||
logger.warning(f"⚠️ Logo directory does not exist: {logo_dir}")
|
||||
|
||||
# Test team ID mapping (simulate what we fixed)
|
||||
sample_teams = [
|
||||
("LAL", "13"), # Lakers
|
||||
("BOS", "2"), # Celtics
|
||||
("MIA", "14"), # Heat
|
||||
]
|
||||
|
||||
for abbr, team_id in sample_teams:
|
||||
logger.info(f"Team {abbr}: ID={team_id} (for logo fetching)")
|
||||
|
||||
logger.info("✅ NBA logo path construction test PASSED")
|
||||
return True
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"❌ NBA logo path construction test FAILED: {e}")
|
||||
return False
|
||||
|
||||
def main():
|
||||
"""Run core functionality tests."""
|
||||
logger.info("🧪 Starting NBA Core Functionality Tests")
|
||||
logger.info("=" * 60)
|
||||
|
||||
tests = [
|
||||
("NBA Data Structure", test_nba_data_structure),
|
||||
("Odds Data Structure", test_odds_data_structure),
|
||||
("NBA Standings Structure", test_nba_standings_structure),
|
||||
("Configuration Analysis", test_configuration_analysis),
|
||||
("NBA Logo Path Construction", test_nba_logo_path_construction),
|
||||
]
|
||||
|
||||
results = []
|
||||
for test_name, test_func in tests:
|
||||
logger.info(f"\n🔍 Running: {test_name}")
|
||||
try:
|
||||
result = test_func()
|
||||
results.append((test_name, result))
|
||||
except Exception as e:
|
||||
logger.error(f"❌ {test_name} crashed: {e}")
|
||||
results.append((test_name, False))
|
||||
|
||||
# Summary
|
||||
logger.info("\n" + "=" * 60)
|
||||
logger.info("📊 TEST SUMMARY")
|
||||
logger.info("=" * 60)
|
||||
|
||||
passed = 0
|
||||
failed = 0
|
||||
|
||||
for test_name, result in results:
|
||||
status = "✅ PASSED" if result else "❌ FAILED"
|
||||
logger.info(f"{test_name:<30} {status}")
|
||||
if result:
|
||||
passed += 1
|
||||
else:
|
||||
failed += 1
|
||||
|
||||
logger.info("-" * 60)
|
||||
logger.info(f"Total: {len(results)} | Passed: {passed} | Failed: {failed}")
|
||||
|
||||
if failed == 0:
|
||||
logger.info("🎉 ALL CORE TESTS PASSED!")
|
||||
logger.info("\n📋 SUMMARY:")
|
||||
logger.info("✅ NBA API provides team ID fields correctly")
|
||||
logger.info("✅ Odds API integration is working")
|
||||
logger.info("✅ NBA standings structure includes team IDs")
|
||||
logger.info("✅ Logo fetching will work with team IDs")
|
||||
logger.info("✅ Configuration is properly set up")
|
||||
return True
|
||||
else:
|
||||
logger.error(f"❌ {failed} test(s) failed. Please check the issues above.")
|
||||
return False
|
||||
|
||||
if __name__ == "__main__":
|
||||
success = main()
|
||||
sys.exit(0 if success else 1)
|
||||
@@ -1,147 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Simple test script to verify NBA data structure includes team ID fields.
|
||||
"""
|
||||
import sys
|
||||
import requests
|
||||
import logging
|
||||
|
||||
# Set up logging
|
||||
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
|
||||
logger = logging.getLogger(__name__)
|
||||
|
||||
def test_nba_data_structure():
|
||||
"""Test that NBA data includes team ID fields."""
|
||||
try:
|
||||
# Test fetching NBA teams data directly
|
||||
logger.info("Testing NBA teams API...")
|
||||
teams_url = "https://site.api.espn.com/apis/site/v2/sports/basketball/nba/teams"
|
||||
response = requests.get(teams_url, timeout=30)
|
||||
response.raise_for_status()
|
||||
teams_data = response.json()
|
||||
|
||||
# Extract team information
|
||||
sports = teams_data.get('sports', [])
|
||||
if not sports:
|
||||
logger.error("No sports data found!")
|
||||
return False
|
||||
|
||||
leagues = sports[0].get('leagues', [])
|
||||
if not leagues:
|
||||
logger.error("No leagues data found!")
|
||||
return False
|
||||
|
||||
teams = leagues[0].get('teams', [])
|
||||
if not teams:
|
||||
logger.error("No teams data found!")
|
||||
return False
|
||||
|
||||
logger.info(f"Found {len(teams)} NBA teams")
|
||||
|
||||
# Check first few teams for ID fields
|
||||
teams_with_ids = 0
|
||||
for i, team_data in enumerate(teams[:5]):
|
||||
team = team_data.get('team', {})
|
||||
team_id = team.get('id')
|
||||
team_abbr = team.get('abbreviation', 'Unknown')
|
||||
team_name = team.get('name', 'Unknown')
|
||||
|
||||
logger.info(f"Team {i+1}: ID={team_id}, ABBR={team_abbr}, NAME={team_name}")
|
||||
|
||||
if team_id is not None:
|
||||
teams_with_ids += 1
|
||||
|
||||
if teams_with_ids == 0:
|
||||
logger.error("No teams have ID fields!")
|
||||
return False
|
||||
|
||||
logger.info(f"{teams_with_ids} out of 5 tested teams have ID fields")
|
||||
|
||||
# Test fetching NBA standings data directly
|
||||
logger.info("Testing NBA standings API...")
|
||||
standings_url = "https://site.api.espn.com/apis/v2/sports/basketball/nba/standings"
|
||||
response = requests.get(standings_url, timeout=30)
|
||||
response.raise_for_status()
|
||||
standings_data = response.json()
|
||||
|
||||
# Check standings structure
|
||||
children = standings_data.get('children', [])
|
||||
logger.info(f"Found {len(children)} conference/division groups")
|
||||
|
||||
standings_teams_with_ids = 0
|
||||
total_standings_teams = 0
|
||||
|
||||
for child in children:
|
||||
if 'standings' in child and 'entries' in child['standings']:
|
||||
entries = child['standings']['entries']
|
||||
total_standings_teams += len(entries)
|
||||
|
||||
for entry in entries[:3]: # Check first 3 teams per conference
|
||||
team = entry.get('team', {})
|
||||
team_id = team.get('id')
|
||||
team_abbr = team.get('abbreviation', 'Unknown')
|
||||
team_name = team.get('displayName', 'Unknown')
|
||||
|
||||
logger.info(f"Standings team: ID={team_id}, ABBR={team_abbr}, NAME={team_name}")
|
||||
|
||||
if team_id is not None:
|
||||
standings_teams_with_ids += 1
|
||||
|
||||
if standings_teams_with_ids == 0:
|
||||
logger.error("No standings teams have ID fields!")
|
||||
return False
|
||||
|
||||
logger.info(f"{standings_teams_with_ids} standings teams have ID fields out of {total_standings_teams} total teams")
|
||||
|
||||
# Simulate the fixed leaderboard manager logic
|
||||
logger.info("Simulating fixed leaderboard manager logic...")
|
||||
|
||||
# Simulate the team data structure that would be created by the fixed code
|
||||
simulated_teams = []
|
||||
for team_data in teams[:3]: # Test with first 3 teams
|
||||
team = team_data.get('team', {})
|
||||
simulated_teams.append({
|
||||
'name': team.get('name', 'Unknown'),
|
||||
'id': team.get('id'), # This is the fix - including the ID field
|
||||
'abbreviation': team.get('abbreviation', 'Unknown'),
|
||||
'wins': 10, # Mock data
|
||||
'losses': 5, # Mock data
|
||||
'ties': 0, # Mock data
|
||||
'win_percentage': 0.667 # Mock data
|
||||
})
|
||||
|
||||
# Verify that our simulated teams have ID fields
|
||||
teams_with_ids_in_simulation = 0
|
||||
for team in simulated_teams:
|
||||
if team.get('id') is not None:
|
||||
teams_with_ids_in_simulation += 1
|
||||
logger.info(f"Simulated team: {team['abbreviation']} (ID: {team['id']})")
|
||||
|
||||
if teams_with_ids_in_simulation == len(simulated_teams):
|
||||
logger.info("✅ All simulated teams have ID fields - fix is working!")
|
||||
return True
|
||||
else:
|
||||
logger.error(f"❌ {len(simulated_teams) - teams_with_ids_in_simulation} simulated teams missing ID fields!")
|
||||
return False
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"Error testing NBA data structure: {e}")
|
||||
return False
|
||||
|
||||
def main():
|
||||
"""Main test function."""
|
||||
logger.info("Testing NBA data structure and fix...")
|
||||
|
||||
success = test_nba_data_structure()
|
||||
|
||||
if success:
|
||||
logger.info("✅ NBA data structure test PASSED!")
|
||||
logger.info("The NBA leaderboard fix should work correctly")
|
||||
else:
|
||||
logger.error("❌ NBA data structure test FAILED!")
|
||||
|
||||
return success
|
||||
|
||||
if __name__ == "__main__":
|
||||
success = main()
|
||||
sys.exit(0 if success else 1)
|
||||
@@ -1,280 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Comprehensive test script to verify NBA Manager, Leaderboard, and Odds Manager integration.
|
||||
"""
|
||||
import sys
|
||||
import os
|
||||
import logging
|
||||
import json
|
||||
|
||||
# Set up logging
|
||||
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
|
||||
logger = logging.getLogger(__name__)
|
||||
|
||||
def test_nba_api_connectivity():
|
||||
"""Test basic NBA API connectivity."""
|
||||
try:
|
||||
import requests
|
||||
|
||||
# Test teams endpoint
|
||||
teams_url = "https://site.api.espn.com/apis/site/v2/sports/basketball/nba/teams"
|
||||
response = requests.get(teams_url, timeout=10)
|
||||
response.raise_for_status()
|
||||
teams_data = response.json()
|
||||
|
||||
# Test standings endpoint
|
||||
standings_url = "https://site.api.espn.com/apis/v2/sports/basketball/nba/standings"
|
||||
response = requests.get(standings_url, timeout=10)
|
||||
response.raise_for_status()
|
||||
standings_data = response.json()
|
||||
|
||||
# Test live games endpoint
|
||||
live_url = "https://site.api.espn.com/apis/site/v2/sports/basketball/nba/scoreboard"
|
||||
response = requests.get(live_url, timeout=10)
|
||||
response.raise_for_status()
|
||||
live_data = response.json()
|
||||
|
||||
logger.info("✅ NBA API connectivity test PASSED")
|
||||
return True
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"❌ NBA API connectivity test FAILED: {e}")
|
||||
return False
|
||||
|
||||
def test_odds_api_connectivity():
|
||||
"""Test odds API connectivity."""
|
||||
try:
|
||||
import requests
|
||||
|
||||
# Test ESPN odds API
|
||||
odds_url = "https://sports.core.api.espn.com/v2/sports/basketball/leagues/nba/events/401585515/competitions/401585515/odds"
|
||||
response = requests.get(odds_url, timeout=10)
|
||||
response.raise_for_status()
|
||||
odds_data = response.json()
|
||||
|
||||
logger.info("✅ Odds API connectivity test PASSED")
|
||||
return True
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"❌ Odds API connectivity test FAILED: {e}")
|
||||
return False
|
||||
|
||||
def test_nba_manager_initialization():
|
||||
"""Test NBA manager initialization and configuration."""
|
||||
try:
|
||||
# Mock the required dependencies since we're not on Raspberry Pi
|
||||
class MockDisplayManager:
|
||||
def __init__(self):
|
||||
self.matrix = type('obj', (object,), {'width': 64, 'height': 32})()
|
||||
|
||||
class MockCacheManager:
|
||||
def __init__(self):
|
||||
self.config_manager = None
|
||||
|
||||
def get(self, key):
|
||||
return None
|
||||
|
||||
def save_cache(self, key, data):
|
||||
pass
|
||||
|
||||
# Load config
|
||||
with open('config/config.json', 'r') as f:
|
||||
config = json.load(f)
|
||||
|
||||
# Test manager imports
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(__file__), 'src'))
|
||||
|
||||
from nba_managers import BaseNBAManager, NBALiveManager, NBARecentManager, NBAUpcomingManager
|
||||
|
||||
# Test initialization
|
||||
display_manager = MockDisplayManager()
|
||||
cache_manager = MockCacheManager()
|
||||
|
||||
# Test base manager
|
||||
base_manager = BaseNBAManager(config, display_manager, cache_manager)
|
||||
logger.info(f"✅ Base NBA Manager initialized: {base_manager.league}")
|
||||
|
||||
# Test live manager
|
||||
live_manager = NBALiveManager(config, display_manager, cache_manager)
|
||||
logger.info(f"✅ NBA Live Manager initialized")
|
||||
|
||||
# Test recent manager
|
||||
recent_manager = NBARecentManager(config, display_manager, cache_manager)
|
||||
logger.info(f"✅ NBA Recent Manager initialized")
|
||||
|
||||
# Test upcoming manager
|
||||
upcoming_manager = NBAUpcomingManager(config, display_manager, cache_manager)
|
||||
logger.info(f"✅ NBA Upcoming Manager initialized")
|
||||
|
||||
return True
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"❌ NBA Manager initialization test FAILED: {e}")
|
||||
return False
|
||||
|
||||
def test_leaderboard_nba_integration():
|
||||
"""Test leaderboard NBA integration."""
|
||||
try:
|
||||
# Mock dependencies
|
||||
class MockDisplayManager:
|
||||
def __init__(self):
|
||||
self.matrix = type('obj', (object,), {'width': 64, 'height': 32})()
|
||||
|
||||
class MockCacheManager:
|
||||
def __init__(self):
|
||||
self.config_manager = None
|
||||
|
||||
def get_cached_data_with_strategy(self, key, strategy):
|
||||
return None
|
||||
|
||||
def save_cache(self, key, data):
|
||||
pass
|
||||
|
||||
def clear_cache(self, key):
|
||||
pass
|
||||
|
||||
# Load config
|
||||
with open('config/config.json', 'r') as f:
|
||||
config = json.load(f)
|
||||
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(__file__), 'src'))
|
||||
|
||||
from leaderboard_manager import LeaderboardManager
|
||||
|
||||
# Test initialization
|
||||
display_manager = MockDisplayManager()
|
||||
cache_manager = MockCacheManager()
|
||||
|
||||
leaderboard = LeaderboardManager(config, display_manager)
|
||||
|
||||
# Check if NBA is configured in leaderboard
|
||||
nba_config = leaderboard.league_configs.get('nba', {})
|
||||
logger.info(f"NBA leaderboard config: {nba_config}")
|
||||
|
||||
# Test NBA standings fetching (without actual API call)
|
||||
logger.info("✅ Leaderboard NBA integration test PASSED")
|
||||
return True
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"❌ Leaderboard NBA integration test FAILED: {e}")
|
||||
return False
|
||||
|
||||
def test_odds_manager_integration():
|
||||
"""Test odds manager integration."""
|
||||
try:
|
||||
# Mock cache manager
|
||||
class MockCacheManager:
|
||||
def __init__(self):
|
||||
self.config_manager = None
|
||||
|
||||
def get_with_auto_strategy(self, key):
|
||||
return None
|
||||
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(__file__), 'src'))
|
||||
|
||||
from odds_manager import OddsManager
|
||||
|
||||
# Test initialization
|
||||
cache_manager = MockCacheManager()
|
||||
odds_manager = OddsManager(cache_manager)
|
||||
|
||||
logger.info(f"✅ Odds Manager initialized")
|
||||
|
||||
# Test NBA odds URL construction (without actual API call)
|
||||
test_event_id = "401585515" # Sample NBA game ID
|
||||
expected_url = f"https://sports.core.api.espn.com/v2/sports/basketball/leagues/nba/events/{test_event_id}/competitions/{test_event_id}/odds"
|
||||
logger.info(f"Expected odds URL: {expected_url}")
|
||||
|
||||
logger.info("✅ Odds Manager integration test PASSED")
|
||||
return True
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"❌ Odds Manager integration test FAILED: {e}")
|
||||
return False
|
||||
|
||||
def test_configuration_consistency():
|
||||
"""Test that configurations are consistent across components."""
|
||||
try:
|
||||
with open('config/config.json', 'r') as f:
|
||||
config = json.load(f)
|
||||
|
||||
# Check NBA scoreboard config
|
||||
nba_scoreboard = config.get('nba_scoreboard', {})
|
||||
nba_enabled = nba_scoreboard.get('enabled', False)
|
||||
nba_show_odds = nba_scoreboard.get('show_odds', False)
|
||||
|
||||
# Check leaderboard config
|
||||
leaderboard = config.get('leaderboard', {})
|
||||
leaderboard_enabled = leaderboard.get('enabled', False)
|
||||
nba_leaderboard_enabled = leaderboard.get('enabled_sports', {}).get('nba', {}).get('enabled', False)
|
||||
|
||||
logger.info(f"NBA Scoreboard - Enabled: {nba_enabled}, Show Odds: {nba_show_odds}")
|
||||
logger.info(f"Leaderboard - Enabled: {leaderboard_enabled}, NBA Enabled: {nba_leaderboard_enabled}")
|
||||
|
||||
# Check for consistency
|
||||
if not nba_enabled and nba_show_odds:
|
||||
logger.warning("⚠️ NBA scoreboard disabled but odds enabled - odds won't be used")
|
||||
|
||||
if leaderboard_enabled and not nba_leaderboard_enabled:
|
||||
logger.info("ℹ️ Leaderboard enabled but NBA disabled - NBA won't appear in leaderboard")
|
||||
|
||||
logger.info("✅ Configuration consistency test PASSED")
|
||||
return True
|
||||
|
||||
except Exception as e:
|
||||
logger.error(f"❌ Configuration consistency test FAILED: {e}")
|
||||
return False
|
||||
|
||||
def main():
|
||||
"""Run all integration tests."""
|
||||
logger.info("🧪 Starting NBA Manager, Leaderboard, and Odds Manager Integration Tests")
|
||||
logger.info("=" * 70)
|
||||
|
||||
tests = [
|
||||
("NBA API Connectivity", test_nba_api_connectivity),
|
||||
("Odds API Connectivity", test_odds_api_connectivity),
|
||||
("NBA Manager Initialization", test_nba_manager_initialization),
|
||||
("Leaderboard NBA Integration", test_leaderboard_nba_integration),
|
||||
("Odds Manager Integration", test_odds_manager_integration),
|
||||
("Configuration Consistency", test_configuration_consistency),
|
||||
]
|
||||
|
||||
results = []
|
||||
for test_name, test_func in tests:
|
||||
logger.info(f"\n🔍 Running: {test_name}")
|
||||
try:
|
||||
result = test_func()
|
||||
results.append((test_name, result))
|
||||
except Exception as e:
|
||||
logger.error(f"❌ {test_name} crashed: {e}")
|
||||
results.append((test_name, False))
|
||||
|
||||
# Summary
|
||||
logger.info("\n" + "=" * 70)
|
||||
logger.info("📊 TEST SUMMARY")
|
||||
logger.info("=" * 70)
|
||||
|
||||
passed = 0
|
||||
failed = 0
|
||||
|
||||
for test_name, result in results:
|
||||
status = "✅ PASSED" if result else "❌ FAILED"
|
||||
logger.info(f"{test_name:<25} {status}")
|
||||
if result:
|
||||
passed += 1
|
||||
else:
|
||||
failed += 1
|
||||
|
||||
logger.info("-" * 70)
|
||||
logger.info(f"Total: {len(results)} | Passed: {passed} | Failed: {failed}")
|
||||
|
||||
if failed == 0:
|
||||
logger.info("🎉 ALL TESTS PASSED! NBA integration is working correctly.")
|
||||
return True
|
||||
else:
|
||||
logger.error(f"❌ {failed} test(s) failed. Please check the issues above.")
|
||||
return False
|
||||
|
||||
if __name__ == "__main__":
|
||||
success = main()
|
||||
sys.exit(0 if success else 1)
|
||||
@@ -1,113 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Test script to verify that the NBA leaderboard fix works correctly.
|
||||
This script simulates the leaderboard manager's data fetching process.
|
||||
"""
|
||||
import sys
|
||||
import os
|
||||
import logging
|
||||
|
||||
# Add the src directory to Python path so we can import the leaderboard manager
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(__file__), 'src'))
|
||||
|
||||
# Set up logging
|
||||
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
|
||||
logger = logging.getLogger(__name__)
|
||||
|
||||
def test_nba_standings_data():
|
||||
"""Test that NBA standings data includes team ID fields."""
|
||||
try:
|
||||
from leaderboard_manager import LeaderboardManager
|
||||
from display_manager import DisplayManager
|
||||
from cache_manager import CacheManager
|
||||
import json
|
||||
|
||||
# Load config
|
||||
with open('config/config.json', 'r') as f:
|
||||
config = json.load(f)
|
||||
|
||||
# Create mock display and cache managers
|
||||
display_manager = DisplayManager(config)
|
||||
cache_manager = CacheManager()
|
||||
|
||||
# Create leaderboard manager
|
||||
leaderboard_manager = LeaderboardManager(config, display_manager)
|
||||
|
||||
# Test NBA standings fetching
|
||||
logger.info("Testing NBA standings data fetching...")
|
||||
nba_config = leaderboard_manager.league_configs['nba']
|
||||
nba_config['enabled'] = True # Enable NBA for testing
|
||||
|
||||
standings = leaderboard_manager._fetch_standings(nba_config)
|
||||
|
||||
if not standings:
|
||||
logger.error("No NBA standings data returned!")
|
||||
return False
|
||||
|
||||
logger.info(f"Successfully fetched {len(standings)} NBA teams")
|
||||
|
||||
# Check if team ID fields are present
|
||||
missing_id_count = 0
|
||||
for i, team in enumerate(standings[:5]): # Check first 5 teams
|
||||
team_id = team.get('id')
|
||||
team_abbr = team.get('abbreviation', 'Unknown')
|
||||
team_name = team.get('name', 'Unknown')
|
||||
|
||||
logger.info(f"Team {i+1}: ID={team_id}, ABBR={team_abbr}, NAME={team_name}")
|
||||
|
||||
if team_id is None:
|
||||
logger.error(f"Team {team_abbr} is missing ID field!")
|
||||
missing_id_count += 1
|
||||
|
||||
if missing_id_count > 0:
|
||||
logger.error(f"{missing_id_count} teams are missing ID fields!")
|
||||
return False
|
||||
else:
|
||||
logger.info("All tested teams have ID fields!")
|
||||
|
||||
# Test that we can create a leaderboard image (without actually displaying)
|
||||
logger.info("Testing leaderboard image creation...")
|
||||
leaderboard_manager.leaderboard_data = [{
|
||||
'league': 'nba',
|
||||
'league_config': nba_config,
|
||||
'teams': standings[:3] # Test with first 3 teams
|
||||
}]
|
||||
|
||||
try:
|
||||
leaderboard_manager._create_leaderboard_image()
|
||||
if leaderboard_manager.leaderboard_image:
|
||||
logger.info(f"Successfully created leaderboard image: {leaderboard_manager.leaderboard_image.width}x{leaderboard_manager.leaderboard_image.height}")
|
||||
return True
|
||||
else:
|
||||
logger.error("Failed to create leaderboard image!")
|
||||
return False
|
||||
except Exception as e:
|
||||
logger.error(f"Error creating leaderboard image: {e}")
|
||||
return False
|
||||
|
||||
except ImportError as e:
|
||||
logger.error(f"Import error: {e}")
|
||||
logger.info("This script needs to be run from the LEDMatrix project directory")
|
||||
return False
|
||||
except Exception as e:
|
||||
logger.error(f"Unexpected error: {e}")
|
||||
return False
|
||||
|
||||
def main():
|
||||
"""Main test function."""
|
||||
logger.info("Testing NBA leaderboard fix...")
|
||||
|
||||
success = test_nba_standings_data()
|
||||
|
||||
if success:
|
||||
logger.info("✅ NBA leaderboard fix test PASSED!")
|
||||
logger.info("The NBA leaderboard should now work correctly with team logos")
|
||||
else:
|
||||
logger.error("❌ NBA leaderboard fix test FAILED!")
|
||||
logger.info("The issue may not be fully resolved")
|
||||
|
||||
return success
|
||||
|
||||
if __name__ == "__main__":
|
||||
success = main()
|
||||
sys.exit(0 if success else 1)
|
||||
@@ -0,0 +1,37 @@
|
||||
"""Guard: every literal render_template() target must exist on disk.
|
||||
|
||||
Catches routes that reference templates deleted in a refactor (a real bug
|
||||
class: the weather/stocks partials 500'd for months because their
|
||||
templates were removed when those displays became plugins).
|
||||
"""
|
||||
import re
|
||||
from pathlib import Path
|
||||
from typing import Iterator
|
||||
|
||||
PROJECT_ROOT = Path(__file__).resolve().parent.parent
|
||||
TEMPLATE_ROOT = PROJECT_ROOT / 'web_interface' / 'templates'
|
||||
RENDER_RE = re.compile(r"""render_template\(\s*['"]([^'"]+)['"]""")
|
||||
|
||||
|
||||
def _python_sources() -> Iterator[Path]:
|
||||
"""Yield every Python source that can call render_template()."""
|
||||
yield PROJECT_ROOT / 'web_interface' / 'app.py'
|
||||
yield from (PROJECT_ROOT / 'web_interface' / 'blueprints').glob('*.py')
|
||||
|
||||
|
||||
def test_all_literal_render_template_targets_exist() -> None:
|
||||
"""Every string-literal render_template() target must exist on disk."""
|
||||
missing = []
|
||||
for source in _python_sources():
|
||||
text = source.read_text(encoding='utf-8')
|
||||
for match in RENDER_RE.finditer(text):
|
||||
target = match.group(1)
|
||||
if not (TEMPLATE_ROOT / target).is_file():
|
||||
lineno = text.count('\n', 0, match.start()) + 1
|
||||
missing.append(
|
||||
f'{source.relative_to(PROJECT_ROOT)}:{lineno} -> {target}'
|
||||
)
|
||||
assert not missing, (
|
||||
'render_template() references templates that do not exist under '
|
||||
'web_interface/templates/:\n' + '\n'.join(missing)
|
||||
)
|
||||
@@ -0,0 +1,66 @@
|
||||
"""Guard: every widget JS file must be loaded by base.html or explicitly allowlisted.
|
||||
|
||||
Widget files register themselves with LEDMatrixWidgets at load time; a file
|
||||
that exists but is never <script>-included silently breaks any plugin whose
|
||||
config schema declares that widget (the field renders as an empty container
|
||||
that polls the registry forever). base.html's widget list is maintained by
|
||||
hand, so this test keeps it honest.
|
||||
"""
|
||||
import re
|
||||
from pathlib import Path
|
||||
from typing import Set
|
||||
|
||||
PROJECT_ROOT = Path(__file__).resolve().parent.parent
|
||||
WIDGETS_DIR = PROJECT_ROOT / 'web_interface' / 'static' / 'v3' / 'js' / 'widgets'
|
||||
BASE_HTML = PROJECT_ROOT / 'web_interface' / 'templates' / 'v3' / 'base.html'
|
||||
|
||||
# Matches url_for('static', filename='...') inside actual <script> tags.
|
||||
SCRIPT_SRC_RE = re.compile(
|
||||
r"""<script\s[^>]*src="\{\{\s*url_for\(\s*'static'\s*,\s*filename='([^']+)'\s*\)\s*\}\}[^"]*"""
|
||||
)
|
||||
|
||||
# Files that must NOT be script-included, with the reason.
|
||||
ALLOWLIST = {
|
||||
# Documentation example (docs/widget-guide.md); registers the name
|
||||
# 'color-picker' and would shadow the real color-picker.js if loaded.
|
||||
'example-color-picker.js',
|
||||
}
|
||||
|
||||
|
||||
def _included_widget_scripts() -> Set[str]:
|
||||
"""Return widget JS basenames referenced by real <script> tags in base.html."""
|
||||
base_html = BASE_HTML.read_text(encoding='utf-8')
|
||||
return {
|
||||
Path(filename).name
|
||||
for filename in SCRIPT_SRC_RE.findall(base_html)
|
||||
if filename.startswith('v3/js/widgets/')
|
||||
}
|
||||
|
||||
|
||||
def test_every_widget_script_is_included_in_base_html() -> None:
|
||||
"""Every non-allowlisted widget file must be loaded by a <script> tag."""
|
||||
assert WIDGETS_DIR.is_dir(), f'Widget directory missing: {WIDGETS_DIR}'
|
||||
included = _included_widget_scripts()
|
||||
assert included, 'No widget <script> tags found in base.html — regex or template drift?'
|
||||
missing = [
|
||||
js_file.name
|
||||
for js_file in sorted(WIDGETS_DIR.glob('*.js'))
|
||||
if js_file.name not in ALLOWLIST and js_file.name not in included
|
||||
]
|
||||
assert not missing, (
|
||||
'Widget files exist but are never <script>-included in base.html '
|
||||
'(plugins declaring these widgets get blank config fields): '
|
||||
+ ', '.join(missing)
|
||||
+ '. Add a script tag to base.html or add the file to ALLOWLIST '
|
||||
'with a reason.'
|
||||
)
|
||||
|
||||
|
||||
def test_allowlisted_widgets_are_not_included() -> None:
|
||||
"""Allowlisted (must-not-load) widget files must stay out of base.html."""
|
||||
included = _included_widget_scripts()
|
||||
wrongly_included = [name for name in ALLOWLIST if name in included]
|
||||
assert not wrongly_included, (
|
||||
'Allowlisted (must-not-load) widget files are script-included in '
|
||||
'base.html: ' + ', '.join(wrongly_included)
|
||||
)
|
||||
@@ -0,0 +1,46 @@
|
||||
"""Tests for the web interface's in-memory cache helpers."""
|
||||
from typing import Iterator
|
||||
|
||||
import pytest
|
||||
|
||||
from web_interface.cache import delete_cached, get_cached, invalidate_cache, set_cached
|
||||
|
||||
|
||||
@pytest.fixture(autouse=True)
|
||||
def clean_cache() -> Iterator[None]:
|
||||
"""Start and finish every test with an empty cache."""
|
||||
invalidate_cache()
|
||||
yield
|
||||
invalidate_cache()
|
||||
|
||||
|
||||
def test_set_and_get() -> None:
|
||||
"""A cached value is returned before its TTL expires."""
|
||||
set_cached('key', 'value')
|
||||
assert get_cached('key') == 'value'
|
||||
|
||||
|
||||
def test_get_missing_returns_none() -> None:
|
||||
"""Reading an unknown key returns None."""
|
||||
assert get_cached('missing') is None
|
||||
|
||||
|
||||
def test_delete_cached_removes_key() -> None:
|
||||
"""delete_cached removes exactly the named key."""
|
||||
set_cached('fonts_catalog', ['a-font'])
|
||||
delete_cached('fonts_catalog')
|
||||
assert get_cached('fonts_catalog') is None
|
||||
|
||||
|
||||
def test_delete_cached_missing_key_is_noop() -> None:
|
||||
"""Deleting a key that was never set must not raise."""
|
||||
delete_cached('never-set')
|
||||
|
||||
|
||||
def test_invalidate_cache_pattern() -> None:
|
||||
"""Pattern invalidation removes matching keys and keeps the rest."""
|
||||
set_cached('fonts_catalog', 1)
|
||||
set_cached('plugins_list', 2)
|
||||
invalidate_cache('fonts')
|
||||
assert get_cached('fonts_catalog') is None
|
||||
assert get_cached('plugins_list') == 2
|
||||
Reference in New Issue
Block a user