Randomization functions

You can use functions to generate random values
Tags:
Categories:

You can use functions to generate random values:

  • randInt
  • randString
  • uuid

These functions can be utilized in different parts of the scenarios with specific usage characteristics:

Usage

uuid

Generates a random uuid v4.

randInt

Generates a pseudorandom number.

Arguments are optional. Calling the function without arguments will generate a random number in the range of 0-9.

Providing one argument will generate a random number in the range from 0 to that number.

Providing two arguments will generate a random number in the range between these two numbers.

randString

Generates a random string.

Arguments are optional. Calling the function without arguments will generate one random character.

Providing one argument (a number) X will generate a string of length X.

Providing a second argument (a string of characters) Y will use only characters from the specified string Y for generation.

In Templates

Since the standard Go templating engine is used, it is possible to use built-in functions. More details about these functions can be found at Go template functions.

uuid

{% raw %}{{ uuid }}{% endraw %}

randInt

no arguments

{% raw %}{{ randInt }}{% endraw %}

1 argument

{% raw %}{{ randInt 10 }}{% endraw %}

2 arguments

{% raw %}{{ randInt 100 200 }}{% endraw %}

2 arguments using source variable

{% raw %}{{ randInt 200 .source.global.max_rand_int }}{% endraw %}

randString

no arguments

{% raw %}{{ randString }}{% endraw %}

1 argument

{% raw %}{{ randString 10 }}{% endraw %}

2 arguments

{% raw %}{{ randString 10 abcde }}{% endraw %}

2 arguments using source variable

{% raw %}{{ randString 20 .source.global.letters }}{% endraw %}

In the Data Source - variables

You can use random value generation functions in the variables type data source.

Function calls should be passed as strings (in quotes).

variable_source "global" "variables" {
  variables = {
    my_uuid = "uuid()"
    my_random_int1 = "randInt()"                # no arguments
    my_random_int2 = "randInt(10)"              # 1 argument
    my_random_int3 = "randInt(100, 200)"        # 2 arguments
    my_random_string1 = "randString()"          # no arguments
    my_random_string2 = "randString(10)"        # 1 argument
    my_random_string3 = "randString(100, abcde)" # 2 arguments
  }
}

In Preprocessors

You can use random value generation functions in preprocessors.

preprocessor {
  mapping = {
    my_uuid = "uuid()"
    my_random_int1 = "randInt()"                # no arguments
    my_random_int2 = "randInt(10)"              # 1 argument
    my_random_int3 = "randInt(100, 200)"        # 2 arguments
    my_random_int4 = "randInt(100, .request.my_req_name.postprocessor.var_from_response)" # 2 arguments, using from response of request my_req_name
    my_random_string1 = "randString()"          # no arguments
    my_random_string2 = "randString(10)"        # 1 argument
    my_random_string3 = "randString(100, abcde)" # 2 arguments
    my_random_string4 = "randString(100, .request.my_req_name.postprocessor.var_from_response)"  # 2 arguments, using from response of request my_req_name
  }
}

HCL functions

You can use follow function