OracleTrace v2.0.0 — Release Notes 🎉

[KaykCaputo]

OracleTrace v2.0.0 — Release Notes

Date: 2026-04-09

This release consolidates major improvements across the CLI, performance regression workflows, test coverage, and documentation, with a strong focus on practical local usage and CI automation.

Summary

OracleTrace 2.0.0 introduces:

• New analysis and output controls (--csv, --ignore, --top)
• CI regression gating (--fail-on-regression + --threshold)
• Tracer improvements (including qualified function naming and timing)
• Automated CLI test coverage with pytest
• Expanded and fully aligned documentation

Changelog

Added

• CSV export for trace results (--csv)
• Regex-based filtering for functions/paths (--ignore)
• Top-N summary limiting (--top)
• Regression fail mode for pipelines (--fail-on-regression)
• Configurable regression threshold (--threshold)
• Automated CLI tests with pytest
• CI workflow running tests across multiple Python versions
• Issue and Pull Request templates for contribution consistency

Improved

• Clearer total execution timing in tracer output
• Fully qualified function naming with co_qualname for better trace identity
• More robust baseline vs current comparison flow for regression validation
• More predictable CLI error and exit behavior for automation

Documentation

• CLI Reference updated with current flags and usage
• Examples expanded (CSV export, ignore/top usage, CI regression gate)
• Quickstart updated with baseline/compare and optional CI gate flow
• README updated to reflect current features and recommended commands
• CONTRIBUTING updated to reflect the existing automated test suite

Fixes / Maintenance

• Test workflow maintenance updates (including runtime matrix adjustments)
• .gitignore update for generated docs paths
• Maintainer/contributor information updates

Compatibility and Migration Notes

• Requirement remains: Python >= 3.10
• Existing baseline + compare workflows remain valid
• No mandatory breaking migration for existing users
• For CI, recommended command pattern is:
  • --fail-on-regression
  • --threshold tuned to your tolerance (for example 10 or 25)

Recommended CI Command

oracletrace app.py --json current.json --compare baseline.json --fail-on-regression --threshold 10

Upgrade

pip install --upgrade oracletrace

Thanks

Thanks to all contributors who helped ship this release across features, docs, tests, and repository infrastructure.