Generate Functions

Functions for generating values.

UUIDs

uuid

The gen::uuid function generates a unique identifier string. It produces a Version 4 UUID, which is generated purely from pseudo-random numbers.

gen::uuid()
# Example Result: "19249583-e9f8-40f5-9f83-3fbbf070fee3"

uuidv5

The gen::uuidv5 function generates a name-based UUID, following the guidelines for a "version 5" UUID. It uses a namespace and a name to ensure the same UUID is produced each time with the same inputs.

gen::uuidv5("dns", "www.redteamer.io")
# Example Result: "59508254-1454-55cb-a8da-ac56f0ba1b3c"

gen::uuidv5("url", "https://www.redteamer.io/")
# Example Result: "b302a8fa-17f1-530e-9707-28dd5d72acdf"

gen::uuidv5("oid", "1.3.6.1.4")
# Example Result: "af9d40a5-7a36-5c07-b23a-851cd99fbfa5"

gen::uuidv5("x500", "CN=Example,C=GB")
# Example Result: "84e09961-4aa4-57f8-95b7-03edb1073253"

gen::uuidv5("6ba7b810-9dad-11d1-80b4-00c04fd430c8", "www.redteamer.io")
# Example Result: "59508254-1454-55cb-a8da-ac56f0ba1b3c"

gen::uuidv5("743ac3c0-3bf7-4a5b-9e6c-59360447c757", "LIBS:diskfont.library")
# Example Result: "ede1a974-df7e-5f17-84b9-76208818b2c8"

Numbers

range

The gen::range function generates a list of numbers based on specified parameters, using a start value, a limit value, and a step value.

gen::range(3)
# Result: [0, 1, 2]

gen::range(1, 4)
# Result: [1, 2, 3]

gen::range(1, 8, 2)
# Result: [1, 3, 5, 7]

gen::range(1, 4, 0.5)
# Result: [1, 1.5, 2, 2.5, 3, 3.5]

gen::range(4, 1)
# Result: [4, 3, 2]

gen::range(10, 5, -2)
# Result: [10, 8, 6]