minigen

A library for generating random data in the Erlang ecosystem, written in Gleam.

Installation

For Erlang ang Gleam projects, this package can be installed by adding it to our rebar.config dependencies:

{deps, [
    {minigen, "0.0.1"}
]}.

For Elixir projects, this package can be installed by adding it to our mix.exs dependencies:

defp deps do
  [
    {:minigen, "~> 0.0.1"}
  ]
end

Usage

The examples below use the run function that will probably return different values on each call. If we want to get the same values on each call, we need to use run_with_seed instead.

Don't forget to visit https://hexdocs.pm/minigen/minigen/ to see the signature of the available functions: list, then, always, map, map2, map3, map4, map5. Their combination can generate values for any data type.

More examples can be found in the test directory of the GitHub repository.

Erlang examples

Create a random float number

GEN=minigen:float(),
minigen:run(GEN).
0.7938520785840248

Create a random integer number

GEN=minigen:integer(10),
minigen:run(GEN).
4

Create a random boolean value

GEN=minigen:boolean(),
minigen:run(GEN).
true

Get a random element from a list

GEN=minigen:element_of_list([1, 2, 3]),
minigen:run(GEN).
{ok,2}

GEN=minigen:element_of_list([]),
minigen:run(GEN).
{error,nil}

Shuffle a list

GEN=minigen:shuffled_list([1, 2, 3]),
minigen:run(GEN).
[2,1,3]

Create a random string

GEN=minigen:string(6),
minigen:run(GEN).
"3Rzpqd"

Elixir examples

Create a random float number

:minigen.float
|> :minigen.run
0.36087782004967894

Create a random integer number

:minigen.integer(10)
|> :minigen.run
8

Create a random boolean value

:minigen.boolean
|> :minigen.run
false

Get a random element from a list

:minigen.element_of_list(["a", "b", "c", "d"])
|> :minigen.run
{:ok, "c"}

:minigen.element_of_list([])
|> :minigen.run
{:error, nil}

Shuffle a list

:minigen.shuffled_list(["a", "b", "c", "d"])
|> :minigen.run
["c", "d", "b", "a"]

Create a random string

:minigen.string(7)
|> :minigen.run
"eJKp8sc"

Gleam examples

import minigen

Create a random float number

minigen.float()
|> minigen.run
0.16296012690374562

Create a random integer number

minigen.integer(10)
|> minigen.run
6

Create a random boolean value

minigen.boolean()
|> minigen.run
True

Get a random element from a list

minigen.element_of_list([0.5348931595479329, 0.47372875562526207, 0.7109364198110805])
|> minigen.run
Ok(0.7109364198110805)

minigen.element_of_list([])
|> minigen.run
Error(Nil)

Shuffle a list

minigen.shuffled_list([0.5348931595479329, 0.47372875562526207, 0.7109364198110805])
|> minigen.run
[0.47372875562526207, 0.5348931595479329, 0.7109364198110805]

Create a random string