Skip to content

๐Ÿ“ง Email Transformer โ€‹

The Email transformer generates randomized or masked email addresses. You can control the local part, the domain, or both. Domains can be set either as a full string or as an object that defines individual domain parts.

๐Ÿ” Alternation โ€‹

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

โœ… Valid Data Types โ€‹

  • String

โš™๏ธ Options โ€‹

OptionTypeDescriptionDefault
domainString or ObjectFull domain string, or an object with optional second-level-domain and top-level-domainRandom hash
local-partStringOverride the local part (e.g. user in user@domain)Random hash

๐Ÿ”ง Domain Object Format โ€‹

When using the object format, you can override just part of the domain:

toml
transformer = { email = { domain = { top-level-domain = "xyz", second-level-domain = "skifta" } } }

Both fields are optional.

๐Ÿงช Examples โ€‹

Example 1: Default behavior โ€‹

Generates a random email address using hashed values for both parts.

toml
[[table.columns]]
name = "email"
transformer = "email"

Example 2: Specifying both domain and local-part as strings โ€‹

toml
[[table.columns]]
name = "email"
transformer = { email = { domain = "email.skifta.dev", local-part = "info" } }

Example 3: Specifying only domain as string โ€‹

toml
[[table.columns]]
name = "email"
transformer = { email = { domain = "skifta.dev" } }

Example 4: Specifying only local-part โ€‹

toml
[[table.columns]]
name = "email"
transformer = { email = { local-part = "skifta" } }

Example 5: Domain with only top-level-domain โ€‹

toml
[[table.columns]]
name = "email"
transformer = { email = { domain = { top-level-domain = "dev" } } }

Example 6: Domain with only second-level-domain โ€‹

toml
[[table.columns]]
name = "email"
transformer = { email = { domain = { second-level-domain = "skifta" } } }

Example 7: Domain with both second-level and top-level โ€‹

toml
[[table.columns]]
name = "email"
transformer = { email = { domain = { second-level-domain = "skifta", top-level-domain = "dev" } } }