# seedgraph

> Seed your SQLAlchemy models as a referentially-consistent graph — one call, shared parents, verified links.

seedgraph builds a graph of SQLAlchemy ORM objects from a declared shape (`seed(session, User, post=2, post__comment=3)`), writes it to the session, lets the database assign the keys and verifies every foreign key against the row it points at. Values come from Faker with a fixed seed, fit each column's type and stay unique against rows already in the database. Use it to create test data for SQLAlchemy 2.x models, in pytest or any test runner.

## Getting started

- [Home](https://jrachid.github.io/seedgraph/index.md): Installation, quick start, guarantees, limits

## Recipes

- [pytest on your own database](https://jrachid.github.io/seedgraph/recipes/pytest/index.md): Seed your own test database with one rolled-back session per test
- [FastAPI endpoints](https://jrachid.github.io/seedgraph/recipes/fastapi/index.md): Seed data for FastAPI endpoint tests through dependency_overrides
- [Custom and JSON columns](https://jrachid.github.io/seedgraph/recipes/custom-columns/index.md): Fill JSON and custom TypeDecorator columns with generators and overrides

## Coding agents

- [Coding agents](https://jrachid.github.io/seedgraph/agents/index.md): Install the Claude Code plugin, or paste a paragraph into AGENTS.md or CLAUDE.md

## Reference

- [API reference](https://jrachid.github.io/seedgraph/reference/index.md): seed, seed_async, Graph, the pytest fixtures and every error