Documentation

Number Functions

Generate integers, decimals, and boolean values

Number Functions

Generate numeric values including integers, floating-point numbers, and booleans.


generate_random_int

Generate random integers within a range.

Category: Number Type: Generator Data Types: integer

Parameters

ParameterTypeDefaultDescription
mininteger1Minimum value
maxinteger1000Maximum value
stepinteger1Step size

Examples

Default range (1-1000):

columns:
  - name: quantity
    function: generate_random_int

Custom range:

columns:
  - name: age
    function: generate_random_int
    parameters:
      min: 18
      max: 65

With step (multiples of 5):

columns:
  - name: score
    function: generate_random_int
    parameters:
      min: 0
      max: 100
      step: 5

IDs in range:

columns:
  - name: product_id
    function: generate_random_int
    parameters:
      min: 10000
      max: 99999

Output Sample

42
18
500
12345

generate_random_float

Generate random floating-point numbers.

Category: Number Type: Generator Data Types: decimal, float

Parameters

ParameterTypeDefaultDescription
left_digitsinteger3Digits before decimal
right_digitsinteger2Digits after decimal
positivebooleantrueOnly positive numbers
min_valuefloatnoneMinimum value
max_valuefloatnoneMaximum value

Examples

Default:

columns:
  - name: temperature
    function: generate_random_float

Price range:

columns:
  - name: price
    function: generate_random_float
    parameters:
      min_value: 0.99
      max_value: 999.99
      right_digits: 2

Percentage:

columns:
  - name: discount_rate
    function: generate_random_float
    parameters:
      min_value: 0.0
      max_value: 0.5
      right_digits: 4

Allow negatives:

columns:
  - name: change
    function: generate_random_float
    parameters:
      positive: false
      min_value: -100
      max_value: 100

Output Sample

123.45
0.99
45.678
-12.34

generate_boolean

Generate boolean values (true/false).

Category: Helper Type: Generator Data Types: boolean

Parameters

ParameterTypeDefaultDescription
chance_of_getting_trueinteger50Percentage chance of true

Examples

50/50 chance:

columns:
  - name: is_active
    function: generate_boolean

80% true:

columns:
  - name: email_verified
    function: generate_boolean
    parameters:
      chance_of_getting_true: 80

10% true (rare events):

columns:
  - name: is_premium
    function: generate_boolean
    parameters:
      chance_of_getting_true: 10

Always true:

columns:
  - name: terms_accepted
    function: generate_boolean
    parameters:
      chance_of_getting_true: 100

Output Sample

true
false
true

Common Patterns

ID Generation

columns:
  - name: id
    function: generate_random_int
    parameters:
      min: 1
      max: 999999999

Quantity with Range

columns:
  - name: quantity
    function: generate_random_int
    parameters:
      min: 1
      max: 100

Ratings (1-5)

columns:
  - name: rating
    function: generate_random_int
    parameters:
      min: 1
      max: 5

Percentages

columns:
  - name: completion_percent
    function: generate_random_float
    parameters:
      min_value: 0
      max_value: 100
      right_digits: 1

Currency Amounts

columns:
  - name: amount
    function: generate_random_float
    parameters:
      min_value: 0.01
      max_value: 10000
      right_digits: 2