Skip to content

seed

Load seed data from CSV files in the seeds directory into the database.

Seeds are typically used for reference data like country codes, status enums, or small lookup tables that don't change frequently.

Output adapts to environment:

  • Terminal: Styled, colored output
  • Piped/Scripted: Markdown format (agent-friendly)

Use --output to override: auto, text, markdown, json

Usage

bash
leapsql seed

Global Options

OptionShortDefaultDescription
--configconfig file (default: ./leapsql.yaml)
--databasePath to DuckDB database (empty for in-memory)
--envEnvironment name
--macros-dirPath to macros directory
--models-dirPath to models directory
--output-oOutput format (auto|text|markdown|json)
--project-dir-CProject root directory (auto-detected from models-dir or config file location)
--seeds-dirPath to seeds directory
--statePath to state database
--target-tTarget environment to use (e.g., dev, staging, prod)
--verbose-vfalseVerbose output

Examples

bash
# Load all seeds (auto-detect output format)
leapsql seed

# Load seeds as JSON
leapsql seed --output json

# Load seeds from a specific directory
leapsql seed --seeds-dir ./data/seeds

Released under the MIT License.