# Parity Suite

> How faithfully does each DynamoDB emulator match the real thing? An independent conformance suite, scored against live AWS DynamoDB and tracked run over run.

Parity Suite runs one conformance suite against live AWS DynamoDB (the baseline, diverging nowhere over full coverage by definition) and against each DynamoDB-compatible emulator, then scores how closely each one matches. Each target carries two figures, reported apart and never summed: divergence, the share of the whole suite it answers differently from real DynamoDB, where lower is better; and coverage, the share it implements at all. Both are also reported per tier, across three tiers. Each target also wears a letter grade (A+ to F), a reading of the pair: divergence sets the letter and coverage can only lower it, never raise it, under versioned criteria on the methodology page. The two figures, not the letter, are what to rank on. Every figure is derived at build time from the suite's own results, so the pages and the data below never disagree.

## Pages
- [Results](https://paritysuite.org/): the latest run's standings, with run-over-run movement.
- [About](https://paritysuite.org/about): why the suite exists and what the tiers mean.
- [Methodology](https://paritysuite.org/methodology): how a score is worked out, how runs are reconstructed, and what it doesn't tell you.
- [Regional ground truth](https://paritysuite.org/ground-truth): why the suite scores against every region, and how a target's best-matching region becomes its headline.
- [For agents](https://paritysuite.org/for-agents): how to read the scores, and where the machine-readable data is.
- [Capabilities](https://paritysuite.org/capabilities): every target against the same capability columns (GSI, PartiQL, transactions, streams, TTL and more).
- [Matrix](https://paritysuite.org/support): per-operation support across targets.
- [Runs](https://paritysuite.org/runs): every recorded run, browsable.
- [Changelog](https://paritysuite.org/changelog): how the suite has changed over time.

## Targets
- [DynamoDB](https://paritysuite.org/targets/dynamodb): conformance over time for DynamoDB.
- [Dynoxide](https://paritysuite.org/targets/dynoxide): conformance over time for Dynoxide.
- [Dynoxide (wasm)](https://paritysuite.org/targets/dynoxide-wasm): conformance over time for Dynoxide (wasm).
- [ExtendDB](https://paritysuite.org/targets/extenddb): conformance over time for ExtendDB.
- [ExtendDB (SQLite)](https://paritysuite.org/targets/extenddb-sqlite): conformance over time for ExtendDB (SQLite).
- [Ministack](https://paritysuite.org/targets/ministack): conformance over time for Ministack.
- [LocalStack](https://paritysuite.org/targets/localstack): conformance over time for LocalStack.
- [Dynalite](https://paritysuite.org/targets/dynalite): conformance over time for Dynalite.
- [DynamoDB Local](https://paritysuite.org/targets/dynamodb-local): conformance over time for DynamoDB Local.
- [Floci](https://paritysuite.org/targets/floci): conformance over time for Floci.

## Data
- [Latest run (JSON)](https://paritysuite.org/data/latest.json): per target, divergence and coverage overall and per tier, capabilities and operation areas.
- [All runs (JSON)](https://paritysuite.org/data/runs.json): the full history, newest first.
- [Data index (JSON)](https://paritysuite.org/data/index.json): the tier and capability vocabularies, the endpoints and the licence.
- [Runs feed (Atom)](https://paritysuite.org/feed.xml): one entry per run.
- [Full text corpus](https://paritysuite.org/llms-full.txt): About, Methodology, the agent guide and the latest results in one file.

Data is published under CC BY 4.0; credit paritysuite.org.