Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/atulin/forged/llms.txt

Use this file to discover all available pages before exploring further.

ForgeText collects every string and identifier generator in Forged under the f.Text accessor. Whether you need a compact token, a human-readable placeholder word, a block of filler prose, a GUID, or a structured string matching a specific pattern, this module has a generator for it. Most string generators come in two overloads: a single-length form that produces a string of exactly that size, and a minLength/maxLength form that randomises the length within the given range.

​
Alphanumeric

Generates a string composed of random ASCII letters (a–z, A–Z) and digits (0–9). 
public Generator<string> Alphanumeric(int length)
public Generator<string> Alphanumeric(int minLength, int maxLength)
​
length
int
required
The exact character length of the generated string (single-length overload).
​
minLength
int
required
The minimum character length (range overload).
​
maxLength
int
required
The maximum character length (range overload).
​
returns
Generator<string>
A random alphanumeric string of the specified length.
SessionToken = f => f.Text.Alphanumeric(32),

​
Alpha

Generates a string composed only of random ASCII letters (a–z, A–Z) — no digits. 
public Generator<string> Alpha(int length)
public Generator<string> Alpha(int minLength, int maxLength)
​
length
int
required
The exact character length (single-length overload).
​
minLength
int
required
The minimum character length (range overload).
​
maxLength
int
required
The maximum character length (range overload).
​
returns
Generator<string>
A random alphabetic-only string of the specified length.
CountryCode = f => f.Text.Alpha(2),

​
Pronounceable

Generates a human-readable, syllable-based string built from consonant onsets, vowel nuclei, and optional codas. The result is not a real word but reads naturally and is easy to say aloud. The length / minLength / maxLength parameters control the number of syllables, not the character count. 
public Generator<string> Pronounceable(int length)
public Generator<string> Pronounceable(int minLength, int maxLength)
​
length
int
required
The exact number of syllables (single-length overload).
​
minLength
int
required
The minimum number of syllables (range overload).
​
maxLength
int
required
The maximum number of syllables (range overload).
​
returns
Generator<string>
A randomly assembled, pronounceable string.
// e.g. "kraeblint", "shoofen"
DisplayName = f => f.Text.Pronounceable(3),

​
Lorem

Generates a string of Lorem Ipsum filler text sampled from a built-in corpus of classical and extended Latin-like words. The length / minLength / maxLength parameters control the word count, and words are joined with single spaces. 
public Generator<string> Lorem(int length)
public Generator<string> Lorem(int minLength, int maxLength)
​
length
int
required
The exact number of words to include (single-length overload).
​
minLength
int
required
The minimum word count (range overload).
​
maxLength
int
required
The maximum word count (range overload).
​
returns
Generator<string>
A space-separated Lorem Ipsum string of the specified word count.
// e.g. "lorem ipsum dolor sit amet consectetur adipiscing elit sed do"
Excerpt = f => f.Text.Lorem(10),

​
Waffle

Generates one or more sentences of contextually plausible filler text using a locale-aware template corpus. Unlike Lorem, Waffle produces grammatically structured sentences with subjects, verbs, objects, and adjectives drawn from the selected style’s word lists. 
public Generator<string> Waffle(int sentences, WaffleStyle style = WaffleStyle.Technical)
​
sentences
int
required
The number of sentences to generate and concatenate.
​
style
WaffleStyle
The vocabulary style to use. Defaults to WaffleStyle.Technical.
ValueDescription
WaffleStyle.TechnicalCorporate / engineering language — systems, frameworks, architectures.
WaffleStyle.FictionNarrative / story language — characters, settings, actions.
​
returns
Generator<string>
A string of sentences generated sentences in the chosen style.
Summary = f => f.Text.Waffle(3),

​
Hex

Generates a lowercase hexadecimal string (characters 0–9, a–f). 
public Generator<string> Hex(int length)
public Generator<string> Hex(int minLength, int maxLength)
​
length
int
required
The exact character length of the hex string (single-length overload).
​
minLength
int
required
The minimum character length (range overload).
​
maxLength
int
required
The maximum character length (range overload).
​
returns
Generator<string>
A random lowercase hex string of the specified length.
ColorHex = f => f.Text.Hex(6),  // e.g. "3a9fc1"

​
Guid

Generates a random System.Guid. Two version variants are supported via the GuidGenerator.Kind enum. 
public Generator<Guid> Guid(GuidGenerator.Kind kind = GuidGenerator.Kind.V4)
​
kind
GuidGenerator.Kind
The GUID version to produce. Defaults to Kind.V4.
ValueDescription
GuidGenerator.Kind.V4Version 4 — fully random (uses Guid.NewGuid()).
GuidGenerator.Kind.V7Version 7 — time-ordered random (uses Guid.CreateVersion7()). Useful for database primary keys that benefit from monotonic ordering.
​
returns
Generator<Guid>
A random Guid of the specified version.
Id = f => f.Text.Guid(),

​
Template

Generates a string by expanding a template that contains special placeholder tokens. Literal characters outside the placeholders are passed through unchanged. A backslash (\) escapes the following character so it is never treated as a placeholder. 
public Generator<string> Template(string template)
​
template
string
required
A format string containing any combination of the placeholder tokens below, plus arbitrary literal characters.
TokenReplacement
#A random digit (0–9)
?A random ASCII letter (a–z, A–Z)
*A random alphanumeric character (a–z, A–Z, 0–9)
\Escape — the next character is emitted literally
​
returns
Generator<string>
A string with all placeholder tokens replaced by their corresponding random characters.
Examples 
// US phone number format: (555) 867-5309
PhoneNumber = f => f.Text.Template("(###) ###-####"),

// Alphanumeric product code: e.g. "BK-7392-4q"
ProductCode = f => f.Text.Template("??-####-*"),

// Literal hash sign — escaped so "#" is output verbatim
HashTag = f => f.Text.Template("\\#trending-???"),

Build docs developers (and LLMs) love

Get started for freeTalk to us