Skip to content

v1.5.0 — CLI Version & Help Flags, macOS Chrome Incognito Example

Choose a tag to compare

@hapheus hapheus released this 23 Oct 15:05
· 6 commits to main since this release
61259a4

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 --version or torproxy -v cleanly reports the application version without attempting to bind service ports. Full --help usage instructions added via argparse.
  • Package Version: Exported __version__ in torproxy top-level namespace.
  • TDD Coverage: Added dedicated hermetic unit tests in tests/unit/test_cli.py verifying exit codes, output streams, and server lifecycle invocation.

🌐 Examples & Documentation

  • macOS Chrome Incognito: Added examples/macos-chrome-via-tor demonstrating ephemeral, isolated Chrome sessions routed entirely through torproxy.
  • 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.