Skip to content

๐Ÿง‘ Name Transformer โ€‹

The Name transformer is used to generate realistic names. It supports generation of first names, last names, or both combined as a full name.

๐Ÿ” Alternation โ€‹

This transformer does not mutate the existing row value โ€” it generates a new value.

โœ… Valid Data Types โ€‹

  • String

โš™๏ธ Options โ€‹

OptionTypeDescriptionDefault
first-nameBooleanWhether to include a first nametrue
last-nameBooleanWhether to include a last nametrue

๐Ÿงช Examples โ€‹

Example 1: Default (First + Last Name) โ€‹

toml
[[table.columns]]
name = "column-example"
transformer = "name"
Output: "Daphney Schimmel"

Example 2: Only First Name โ€‹

toml
[[table.columns]]
name = "column-example"
transformer = { name = { first-name = true } }
Output: "Rae"

Example 3: Only Last Name โ€‹

toml
[[table.columns]]
name = "column-example"
transformer = { name = { last-name = true } }
Output: "Greenfelder"

๐Ÿช„ Alias Support โ€‹

Instead of using the object-based config, you can use transformer aliases:

toml
[[table.columns]]
name = "column-example"
transformer = "first-name"
toml
[[table.columns]]
name = "column-example"
transformer = "last-name"

These are shorthand alternatives to:

toml
transformer = { name = { first-name = true, last-name = false } }

and

toml
transformer = { name = { first-name = false, last-name = true } }