Skip to content

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)
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.