The AddFlavor(flvr) function teaches the Generate function about a new flavor.  The flavor can be a procedure or a module definition, and it determines the form of the returned random object.

If flavor is a procedure, RandomTools[Generate](flvr) calls that procedure.

If flavor is a module, it must have an export named Main that is of type procedure. In this case, RandomTools[Generate](flvr) calls ${\mathrm{flavor}}_{'\mathrm{Main}'}$.

Note:  The call x[op1, op2](arg1, arg2) translates into the function call flavor['Main'][op1, op2](arg1, arg2).

This function is part of the RandomTools package, and so it can be used in the form AddFlavor(..) only after executing the command with(RandomTools). However, it can always be accessed through the long form of the command by using the form RandomTools[AddFlavor](..).

$\mathrm{with}\left(\mathrm{RandomTools}\right)\:$

$\mathrm{Generate}\left(A\right)$

Error, (in RandomTools:-Generate) the flavor `A` does not exist

$\mathrm{AddFlavor}\left(A=\mathrm{rand}\left(1..20\right)\right)\:$

$\mathrm{Generate}\left(A\right)$

$15$

$\mathrm{Generate}\left(A\right)$

$13$

$\mathrm{member}\left(A\,\left[\mathrm{GetFlavors}\left(\right)\right]\right)$

$\mathrm{true}$

$\mathrm{Generate}\left(\mathrm{alphachar}\right)$

Error, (in RandomTools:-Generate) the flavor `alphachar` does not exist

AddFlavor(alphachar = proc() [a,b,c,d,e,f][rand(1..6)()] end proc):

$\mathrm{member}\left(\mathrm{alphachar}\,\left[\mathrm{GetFlavors}\left(\right)\right]\right)$

$\mathrm{true}$