Skip to content

chore(release): v0.2.0 tests, benchmarks, and documentation#2

Merged
seanbrar merged 4 commits intodevfrom
release/v0.2.0-ergonomics
Feb 5, 2026
Merged

chore(release): v0.2.0 tests, benchmarks, and documentation#2
seanbrar merged 4 commits intodevfrom
release/v0.2.0-ergonomics

Conversation

@seanbrar
Copy link
Owner

@seanbrar seanbrar commented Feb 5, 2026

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

  • Performance benchmarks were pulled forward from the v0.4.0 roadmap to v0.2.0—they were needed to validate the _Scope class optimization and establish baselines.
  • NULLSCOPE_STRICT is documented only in the README env var table for now; design.md addition deferred unless users request clarification.
  • uv.lock is 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 tracking uv.lock for 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.

Sean Brar 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
@seanbrar seanbrar merged commit 3929ed8 into dev Feb 5, 2026
1 of 6 checks passed
@seanbrar seanbrar deleted the release/v0.2.0-ergonomics branch February 5, 2026 09:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant