Generator Overrides

Override auto-detected generators with a YAML file.

Generator Overrides

Override auto-detected generators for specific columns using a YAML configuration file.

Syntax

<table_name>:
  <column_name>:
    generator: <generator_name>
    params:
      <param_name>: <value>
    disabled: true|false

Example

users:
  email:
    generator: email
  role:
    generator: weighted_choice
    params:
      choices:
        admin: 5
        user: 95
  created_at:
    generator: now
  internal_code:
    disabled: true

orders:
  total:
    generator: amount
    params:
      min: 10.00
      max: 9999.99
  status:
    generator: weighted_choice
    params:
      choices:
        pending: 30
        completed: 60
        cancelled: 10

Usage

seedling generate --count 10000 --generators overrides.yaml --output seed.sql

Merging Behavior

Override generators are merged on top of auto-detected generators:

• If a column has an override, it replaces the auto-detected generator
• If a column has disabled: true, no data is generated (NULL or default)
• Columns not mentioned in the override file use auto-detected generators
• Unknown table or column names in overrides produce a warning

Parameter Reference

Generator	Parameters
email	—
name	—
phone	—
uuid	—
bool	—
lorem	min_words, max_words
constant	value
weighted_choice	choices (map of value → weight)
random_int	min, max
float_range	min, max, precision
amount	min, max
timestamp	min_date, max_date
time_ago	max_duration