Fixture — Test Data Fixture Generator

A CLI tool for generating, managing, and exporting test data fixtures. Create reproducible datasets from templates with seeded randomness for consistent test environments.

Prerequisites

• - Python 3.8+
• INLINECODE0 shell
• Write access to INLINECODE1

Data Storage

All fixtures are stored in JSONL format at ~/.fixture/data.jsonl. Templates are stored at ~/.fixture/templates.json.

Commands

Run commands via: INLINECODE4

create

Create a new fixture record with specified fields and values.

CODEBLOCK0

Arguments:

• - --name — Fixture name/label (required)
• INLINECODE6 — Fixture type/category (required)
• INLINECODE7 — JSON object of field values (required)

load

Load fixtures from a JSON or JSONL file into the fixture store.

CODEBLOCK1

Arguments:

• - --file — Input file path (required)
• INLINECODE9 — File format: json, jsonl (optional, default: auto-detect)

dump

Dump all fixtures or filtered subset to stdout or a file.

CODEBLOCK2

Arguments:

• - --type — Filter by fixture type (optional)
• INLINECODE13 — Output file path (optional, default: stdout)

list

List all fixtures with summary information.

CODEBLOCK3

Arguments:

• - --type — Filter by fixture type (optional)

seed

Generate multiple fixture records from a template with seeded random data.

CODEBLOCK4

Arguments:

• - --template — Template name to use (required)
• INLINECODE16 — Number of records to generate (required)
• INLINECODE17 — Random seed for reproducibility (optional)

reset

Clear all fixtures or a specific type from the data store.

CODEBLOCK5

Arguments:

• - --type — Only reset fixtures of this type (optional)
• INLINECODE19 — Skip confirmation prompt (optional)

template

Manage fixture templates: create, list, or show template definitions.

CODEBLOCK6

Arguments:

• - --list — List all templates (optional)
• INLINECODE21 — Create template with given name (optional)
• INLINECODE22 — JSON schema for template creation (optional)
• INLINECODE23 — Show a specific template (optional)

validate

Validate fixtures against their template schema.

CODEBLOCK7

Arguments:

• - --type — Validate only a specific type (optional)

export

Export fixtures to various formats: JSON, JSONL, CSV, SQL.

CODEBLOCK8

Arguments:

• - --output — Output file path (required)
• INLINECODE26 — Export format: json, jsonl, csv, sql (required)
• INLINECODE31 — Table name for SQL export (optional)

import

Import fixtures from external sources or standard formats.

CODEBLOCK9

Arguments:

• - --file — Input file path (required)
• INLINECODE33 — Assign fixture type (required)

help

Display help information and list all available commands.

CODEBLOCK10

version

Display the current tool version.

CODEBLOCK11

Examples

CODEBLOCK12

Notes

• - Templates define field types: string, email, int:min-max, float:min-max, bool, uuid, INLINECODE40
• Seeded generation guarantees identical output given the same seed
• Use validate to check fixtures match their template schema
• SQL export generates INSERT statements compatible with most databases