Skip to content

docs: correct Python transaction and value examples - #30

Open
tclinkenbeard-oai wants to merge 2 commits into
foundationdb-oss:mainfrom
tclinkenbeard-oai:dev/tclinkenbeard/codex/doc-site-python-api-patterns
Open

docs: correct Python transaction and value examples#30
tclinkenbeard-oai wants to merge 2 commits into
foundationdb-oss:mainfrom
tclinkenbeard-oai:dev/tclinkenbeard/codex/doc-site-python-api-patterns

Conversation

@tclinkenbeard-oai

@tclinkenbeard-oai tclinkenbeard-oai commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Summary

The Python binding does not provide the documented db.transaction() context manager, and transaction reads return Value futures even when a key is missing.

  • Remove the unsupported context-manager example and point readers to create_transaction() for explicit commits and retries.
  • Use Value.present() for presence checks, including stored empty byte strings, and resolve the counter read before checking or unpacking it.

Validation

  • Strict MkDocs builds passed for FoundationDB 7.1, 7.3, and 7.4.
  • Checked the documented APIs against the upstream 7.1.67, 7.3.77, and 7.4.6 release sources.

@vercel

vercel Bot commented Aug 19, 2026

Copy link
Copy Markdown

@tclinkenbeard-oai is attempting to deploy a commit to the panghy's projects Team on Vercel.

A member of the Team first needs to authorize it.

@tclinkenbeard-oai
tclinkenbeard-oai marked this pull request as ready for review August 19, 2026 23:36
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