chore(release): v0.2.0 tests, benchmarks, and documentation#2
Merged
Conversation
added 4 commits
February 5, 2026 00:41
- Refactor tests to use shared _reload_nullscope() helper - Add tests for @timed decorator (sync, async, disabled no-op) - Add async scope stack isolation test - Add reporter lifecycle hook forwarding test - Add strict mode validation test - Add integration test for runtime contract
Measures hot paths for both disabled (no-op) and enabled modes. Documents 16-29% improvements from _Scope class optimization.
- Add decorator usage examples (@telemetry.timed) - Add reporter lifecycle (flush/shutdown) documentation - Add async safety section with contextvars explanation - Document NULLSCOPE_STRICT environment variable - Update ROADMAP: v0.1.0 complete, v0.2.0 current with benchmarks
- Update version in pyproject.toml - Track uv.lock for reproducible CI environments
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds test coverage, performance benchmarks, and documentation for the v0.2.0 ergonomics features (decorators, lifecycle hooks, async safety, strict mode). Core implementation was landed in #1.
Notes
_Scopeclass optimization and establish baselines.NULLSCOPE_STRICTis documented only in the README env var table for now; design.md addition deferred unless users request clarification.uv.lockis now tracked for reproducible CI.Note
Low Risk
Primarily documentation, tests, and benchmarking additions plus a version bump and lockfile tracking; no production logic changes in the diff shown.
Overview
Updates the v0.2.0 release metadata and documentation to cover newly-added ergonomics features:
NULLSCOPE_STRICT,telemetry.timed()decorators (sync/async), reporter lifecycle (flush()/shutdown()), and async context isolation.Adds substantial test coverage for these behaviors (including strict-name validation, lifecycle hook forwarding, and async task isolation) plus a small integration-style contract test, and introduces a
benchmarks/suite with recorded baseline results to track performance over time. Also starts trackinguv.lockfor reproducible environments (and stops ignoring it) and refreshes the roadmap to mark v0.2.0 items as completed/current.Written by Cursor Bugbot for commit a6bca87. This will update automatically on new commits. Configure here.