All notable changes to headersvalidator are documented in this file.
Format follows Keep a Changelog. Version numbers follow Semantic Versioning.
0.1.4 — 2026-05-15
pytest-mock>=3.12added to dev extras.
assessor.assess(): parameters afterurlare now keyword-only (enforced by*,), preventing accidental positional mis-binding by callers.cli:--versionshort flag changed from-vto-V(uppercase), consistent with all other platform modules.reporter.save_report(): now raisesValueErrorfor unsupported file extensions instead of silently falling back to plain text, aligning behaviour with the existing docstring.verdict:VerdictSeveritygains aLOWmember (1 pt penalty) betweenMEDIUMandINFO, completing the five-tier severity vocabulary shared withmailvalidator.
0.1.3 — 2026-05-15
assessor.assess()accepts an optionalprogress_cb: Callable[[str], None]parameter, consistent with the platform-wide public API convention.reportermodule now exposes a publicconsolealias (Console(record=True)) and asave_report(path)function; the CLI imports these rather than duplicating the export logic internally.
- CLI migrated to use
reporter.consoleandreporter.save_report()— the private_save_report()helper incli.pyhas been removed.
0.1.2 — 2026-04-08
- Report header now shows the final redirect destination URL when a redirect was followed during the header fetch.
0.1.1 — 2026-04-08
- HTTP redirect followed correctly when the
https://port is closed and the server redirects tohttp://.
0.1.0 — 2026-04-08
- Initial release of headersvalidator.
- HTTP security-header validation against RFC 9110/9111, OWASP, and the IANA header registry.
- Scoring model:
PASS/WARN/FAIL/DEPRECATED/INFOstatus per header; letter-grade verdict (A+…F) derived from weighted penalty points. - Security Verdict panel with actionable recommendations surfaced in the terminal report.
- CLI:
headersvalidator check <url-or-domain>with--json,--output,--strictflags. headersvalidator info rules— lists all evaluated header rules.- Report export to
.txt,.svg,.html. - HEAD with GET fallback (on HTTP 405) for header fetching.