dyntastic

What it is and what it does

Dyntastic bridges Pydantic models and DynamoDB by letting you define table schemas as Python classes that inherit from Dyntastic (itself a Pydantic BaseModel). You get automatic serialization, validation, and type hints, plus a fluent API for DynamoDB operations: single-item reads and writes, queries with range-key conditions and filters, scans, batch reads and writes, and transactions. All operations are built on top of boto3, so they integrate with your existing AWS authentication and configuration.

The library handles common DynamoDB patterns—pagination, consistent reads, sparse indexes, and conditional updates—without requiring you to write raw boto3 calls or manage item marshalling. Because it extends Pydantic, models work seamlessly in FastAPI and other frameworks that already know how to serialize and validate Pydantic objects.

Use it for

• Define a DynamoDB table schema as a Pydantic model and perform type-safe CRUD operations without raw boto3 calls.
• Query DynamoDB with range-key conditions and filter expressions using a fluent attribute API (e.g., A.timestamp < datetime(...)).
• Batch read or write multiple items in a single operation, with automatic chunking to respect DynamoDB's 25-item and 16MB limits.
• Use transactional writes to ensure multiple items are updated atomically or fail together.
• Integrate DynamoDB models directly into FastAPI endpoints or other Pydantic-aware frameworks for request/response validation.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

dyntastic on PyPI

Before you install

Low friction: pure Python wheel with three runtime dependencies (boto3, pydantic, importlib-metadata). Maintenance is aging—last commit was 2025-04-08 and the project has not released since 2025-04-06, but the repository is active and not archived.

Requires AWS credentials configured (via environment variables, IAM role, or boto3 config) and an existing DynamoDB table matching the model's __table_name__.

License in practice

MIT license is permissive; you can use, modify, and distribute this package with minimal restrictions, provided you include the license notice.

Quickstart

from dyntastic import Dyntastic
from pydantic import Field
import uuid

class Product(Dyntastic):
    __table_name__ = "products"
    __hash_key__ = "product_id"
    product_id: str = Field(default_factory=lambda: str(uuid.uuid4()))
    name: str
    price: float

product = Product(name="bread", price=3.99)
product.save()
fetched = Product.get(product.product_id)

Package facts

Evidence: dyntastic-0.18.0-py3-none-any.whl

Tags

More Database packages

See also pydynamodb · pydantic_yaml · numpydantic · beanie · python-dynamodb-lock · types-boto3-dynamodb · mypy-boto3-dynamodb · drf-pydantic · pynamodb · aws-cdk.aws-dynamodb