Repository navigation
v1.5.0 — CLI Version & Help Flags, macOS Chrome Incognito Example
Release Highlights
This release introduces native command-line interface flags (-v/--version and -h/--help) to the torproxy executable entrypoint, exports package-level version metadata, and provides a new automated macOS Chrome incognito example.
✨ Features & CLI Runtime
- CLI Flags: Running
torproxy --versionortorproxy -vcleanly reports the application version without attempting to bind service ports. Full--helpusage instructions added viaargparse. - Package Version: Exported
__version__intorproxytop-level namespace. - TDD Coverage: Added dedicated hermetic unit tests in
tests/unit/test_cli.pyverifying exit codes, output streams, and server lifecycle invocation.
🌐 Examples & Documentation
- macOS Chrome Incognito: Added
examples/macos-chrome-via-tordemonstrating ephemeral, isolated Chrome sessions routed entirely throughtorproxy. - OpenSSF Best Practices: Integrated OpenSSF Best Practices badge in
README.md. - Tooling Alignment: Standardized testing and linting guides around
uv.
🔄 Compatibility Contract
- 100% backward compatible drop-in replacement.
- Unchanged port listeners (
8118,9050,8080), environment variables (TORPROXY_*), and REST control API endpoints.