Skip to content

docs(sdk-python): Sphinx + examples + changelog#2

Merged
sirambrosio merged 2 commits into
mainfrom
docs/sphinx-and-examples
Apr 20, 2026
Merged

docs(sdk-python): Sphinx + examples + changelog#2
sirambrosio merged 2 commits into
mainfrom
docs/sphinx-and-examples

Conversation

@sirambrosio
Copy link
Copy Markdown
Contributor

Summary

Closes developer-experience gaps on the Python SDK ahead of 2.1.0.

  • Sphinx: docs/ with conf.py, index.rst, and per-module pages (autodoc + napoleon + RTD theme). Build via sphinx-build docs docs/_build or hatch run docs:build. _build/ and _autosummary/ are git-ignored.
  • pyproject.toml: new [project.optional-dependencies].docs extra and [tool.hatch.envs.docs] environment.
  • CONTRIBUTING.md: venv setup, tests, lint, examples, PR flow, commit convention.
  • CHANGELOG.md: new [2.1.0] — 2026-04-20 entry synced with the TypeScript SDK version.
  • Examples: split the monolithic full_flow.py into four focused, runnable scripts:
    • examples/01_create_beo.py
    • examples/02_grant_consent.py
    • examples/03_submit_biorecord.py
    • examples/04_destroy_beo.py

Each example runs in simulated mode by default (no BSP_RELAYER_URL) and auto-promotes to live mode when the env var is set.

Test plan

  • pip install sphinx sphinx-rtd-theme succeeds
  • sphinx-build docs docs/_build generates docs/_build/index.html (verified locally)
  • Reviewer runs pytest to confirm nothing regressed
  • Reviewer runs python examples/01_create_beo.py and validates simulated output
  • CI green (CodeQL + any existing workflows)

sirambrosio and others added 2 commits April 20, 2026 10:42
- Sphinx: docs/ with conf.py, index.rst, and per-module pages
  (autodoc + napoleon + rtd theme). docs/_build/ and _autosummary/
  are git-ignored.
- pyproject.toml: new [project.optional-dependencies].docs extra and
  [tool.hatch.envs.docs] env with sphinx-build script.
- CONTRIBUTING.md: venv setup, tests, lint, examples, PR flow.
- CHANGELOG.md: 2.1.0 entry (consent APIs, Sphinx, ecdsa patch, CI).
- examples: split full_flow.py into four runnable scripts
  (01_create_beo, 02_grant_consent, 03_submit_biorecord, 04_destroy_beo).
@sirambrosio sirambrosio merged commit 5b78835 into main Apr 20, 2026
1 check passed
@sirambrosio sirambrosio deleted the docs/sphinx-and-examples branch April 20, 2026 14:40
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