Skip to content

docs: make the README quickstart executable and accurate - #93

Merged
ma2za merged 5 commits into
ma2za:mainfrom
mazzasaverio:docs/executable-readme-examples
Oct 11, 2026
Merged

ma2za merged 5 commits into
ma2za:mainfrom
mazzasaverio:docs/executable-readme-examples

Conversation

@mazzasaverio

@mazzasaverio mazzasaverio commented Oct 2, 2026 •

Copy link
Copy Markdown
Contributor

The first README quickstart failed because it expected <EMAIL_1> while the package emits <EML_1>. Align aliases and execute all Python examples in an integration test, providing the file example's input in a temporary directory. Also label the historical benchmark as overlap scoring and document the heuristic streaming boundary limitation. Library behavior and token formats do not change.

Validation: 11 focused README/stream/session tests passed. Full CI passed 525 tests per matrix job with 95.00% to 95.06% coverage, plus quality, docs, performance, property, packaging and installed-wheel checks: https://github.com/ma2za/pseudonymize/actions/runs/36972876550 . The README async function is compiled by the new test; existing integration tests exercise asynchronous streaming.

Current review status

Review priority: 5 of 9; PR #100 is the packaging prerequisite. Updated against main 17e8fcc while preserving development version 1.37.0 and the hosted-service changes. Includes the shared service-extra audit correction from #100. No PR has been merged.

Current branch validation: 12 focused tests passed; Ruff formatting/lint, mypy, wheel/sdist builds and release verification passed. Fresh CI on the current head completed with 18 successful checks, one skipped check, and no failures.

@mazzasaverio
mazzasaverio marked this pull request as ready for review October 2, 2026 06:33
@mazzasaverio
mazzasaverio requested a review from ma2za as a code owner October 2, 2026 06:33
@ma2za
ma2za merged commit 8f74bc5 into ma2za:main Oct 11, 2026
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.

2 participants