Skip to content

docs: add an Agent Skill for pydynox applications - #577

Merged
leandrodamascena merged 2 commits into
mainfrom
docs/using-pydynox-skill
Nov 2, 2026
Merged

leandrodamascena merged 2 commits into
mainfrom
docs/using-pydynox-skill

Conversation

@leandrodamascena

@leandrodamascena leandrodamascena commented Nov 2, 2026 •

Copy link
Copy Markdown
Member

Adds a using-pydynox Agent Skill for coding assistants building applications with the library. It covers pagination, queries and indexes, conditional and atomic writes, batches, transactions, model features, integrations, and application testing. The README and documentation explain how to install and use it.

Pagination is covered in the main skill and a dedicated reference: streaming versus bounded pages, limit versus page_size, continuation keys, empty filtered pages, descending order, and exhaustion. The bundled cursor helpers use one evaluated item per request to avoid skipping buffered results with the current iterator; the reference explains the extra requests and what a larger-page cursor would need to preserve.

The bundled Python recipes exercise CRUD, rejected writes, atomic increments, transaction rollback, cursor resumption, projections, scans, and GSI pagination in async and sync. Other references explain aliases, Decimal, TTL, smart save, hooks, optimistic locking, Pydantic/dataclasses, S3/KMS, consistency, throttling, and metrics. Changes under skills/ trigger CI and its example code is linted.

Validation:

  • 1,206 unit tests, 888 integration tests (8 skipped), and 212 documentation examples passed, including all 20 skill integration scenarios.
  • Installed the skill in a separate application with npx skills add and ran its entrypoints with MemoryBackend and LocalStack.
  • The basic examples and ten additional query recipes passed on the published pydynox 1.8.0 wheel. The two empty filtered-page recipes require the fix from Fix query pagination stopping after an empty filtered page #565, merged after 1.8.0; this version requirement was reproduced and is documented. All recipes pass against this branch.
  • Skill metadata, reference links, Ruff, ty, maturin, rustfmt, Clippy, and the documentation/API/llms.txt builds passed.

Closes #576

@sonarqubecloud

sonarqubecloud Bot commented Nov 2, 2026

Copy link
Copy Markdown

@codecov

codecov Bot commented Nov 2, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@leandrodamascena
leandrodamascena merged commit 799b455 into main Nov 2, 2026
17 of 18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add an Agent Skill for building applications with pydynox

1 participant