Module kivakit.internal.testing

Package com.telenav.kivakit.internal.testing

Class RandomValueFactory

java.lang.Object

com.telenav.kivakit.internal.testing.RandomValueFactory

All Implemented Interfaces:

CastTrait, RandomNumeric

public class RandomValueFactory
extends Object
implements RandomNumeric

Utility class for tests used to create random values. The UnitTest class has a variety of methods for random testing that use this class. Projects can subclass this to provide additional random values relevant to the project.

Seeding

The seed used for random values can be set with seed(long). KivaKit tests will emit a seed value when a test fails. This value can be fed to seed(long) to reproduce the failure.

Values

Values of the given types can be randomly produced:

• Characters
• Strings
• Booleans
• Bytes
• Confidence
• Count
• Double
• Identifier
• Ints
• Longs
• Shorts
• Unsigned Doubles
• Unsigned Ints
• Unsigned Longs

Author:

jonathanl (shibo)

Field Summary

Fields

Modifier and Type	Field	Description
protected Random	random	Random number generator

Constructor Summary

Constructors

Constructor	Description
RandomValueFactory()
RandomValueFactory(long seed)

Method Summary

Modifier and Type	Method	Description
void	byteSequence(Matcher<Byte> include, Consumer<Byte> consumer)
void	byteSequence(Repeats repeats, Matcher<Byte> include, Consumer<Byte> consumer)
void	byteSequence(Repeats repeats, Consumer<Byte> consumer)
void	byteSequence(Consumer<Byte> consumer)
Confidence	confidence()
<T> T	from(Collection<T> values)
<T> T	from(T[] values)
Identifier	identifierExclusive(long maximum)
void	indexes(long maximum, Consumer<Integer> consumer)
void	indexes(Repeats repeats, long maximum, Consumer<Integer> consumer)
void	intSequence(Matcher<Integer> include, Consumer<Integer> consumer)
void	intSequence(Repeats repeats, Matcher<Integer> include, Consumer<Integer> consumer)
void	intSequence(Repeats repeats, Consumer<Integer> consumer)
void	intSequence(Consumer<Integer> consumer)
Count	iterations()
char	letter()
String	letters()
String	letters(int minLength, int maxLength)
<T extends Number> List<T>	list(Repeats repeats, Count count, long minimum, long maximum, Class<T> type)
<T extends Number> List<T>	list(Repeats repeats, Count count, long minimum, long maximum, Class<T> type, Matcher<T> include)
<T extends Number> List<T>	list(Repeats repeats, Count count, Class<T> type)
<T extends Number> List<T>	list(Repeats repeats, Count count, Class<T> type, Matcher<T> include)
<T extends Number> List<T>	list(Repeats repeats, Class<T> type)
<T extends Number> List<T>	list(Repeats repeats, Class<T> type, Matcher<T> include)
<T extends Number> List<T>	list(Class<T> type)
void	longSequence(Matcher<Long> include, Consumer<Long> consumer)
void	longSequence(Repeats repeats, Matcher<Long> include, Consumer<Long> consumer)
void	longSequence(Repeats repeats, Consumer<Long> consumer)
void	longSequence(Consumer<Long> consumer)
void	loop(Runnable code)
Random	random()
Count	randomCount(long maximum)
Count	randomCount(long minimum, long maximum)
double	randomDoubleZeroToOne()	Returns a random value between zero and one
final long	randomLongExclusive(long minimum, long exclusiveMaximum)
Range<Count>	rangeExclusive(long minimum, long exclusiveMaximum)
Range<Count>	rangeExclusive(long minimum, long exclusiveMaximum, long minimumWidth)
<T extends BaseCount<T>> Range<T>	rangeExclusive(T minimum, T exclusiveMaximum)
<T extends BaseCount<T>> Range<T>	rangeExclusive(T minimum, T exclusiveMaximum, long minimumWidth)
Range<Count>	rangeInclusive(long minimum, long inclusiveMaximum)
Range<Count>	rangeInclusive(long minimum, long inclusiveMaximum, long minimumWidth)
<T extends BaseCount<T>> Range<T>	rangeInclusive(T minimum, T inclusiveMaximum)
<T extends BaseCount<T>> Range<T>	rangeInclusive(T minimum, T inclusiveMaximum, long minimumWidth)
long	seed()
void	seed(long seed)
<T extends Number> void	sequence(Repeats repeats, long minimum, long maximum, Class<T> type, Consumer<T> consumer)
<T extends Number> void	sequence(Repeats repeats, long maximum, Class<T> type, Consumer<T> consumer)
<T extends Number> void	sequence(Repeats repeats, Count count, long minimum, long exclusiveMaximum, Class<T> type, Matcher<T> include, Consumer<T> consumer)
<T extends Number> void	sequence(Repeats repeats, Count count, long minimum, long maximum, Class<T> type, Consumer<T> consumer)
<T extends Number> void	sequence(Repeats repeats, Count count, Class<T> type, Matcher<T> include, Consumer<T> consumer)
<T extends Number> void	sequence(Repeats repeats, Count count, Class<T> type, Consumer<T> consumer)
<T extends Number> void	sequence(Repeats repeats, Class<T> type, Matcher<T> include, Consumer<T> consumer)
<T extends Number> void	sequence(Repeats repeats, Class<T> type, Consumer<T> consumer)
<T extends Number> void	sequence(Class<T> type, Consumer<T> consumer)
void	shortSequence(Matcher<Short> include, Consumer<Short> consumer)
void	shortSequence(Repeats repeats, Matcher<Short> include, Consumer<Short> consumer)
void	shortSequence(Repeats repeats, Consumer<Short> consumer)
void	shortSequence(Consumer<Short> consumer)
String	string()
String	string(int maximum)
String	string(int minimum, int maximum)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.telenav.kivakit.interfaces.numeric.CastTrait

cast, cast, maximum, minimum

Methods inherited from interface com.telenav.kivakit.interfaces.numeric.RandomNumeric

random, random, randomBoolean, randomByte, randomByteExclusive, randomByteInclusive, randomChar, randomCharExclusive, randomCharInclusive, randomDouble, randomDouble, randomExclusive, randomExclusive, randomFloat, randomInclusive, randomInclusive, randomIndex, randomInt, randomInt, randomIntExclusive, randomIntInclusive, randomLong, randomLongInclusive, randomShort, randomShortExclusive, randomShortInclusive, randomUnsignedDouble, randomUnsignedDouble, randomUnsignedInt, randomUnsignedLong

Field Details

random

protected Random random

Random number generator

Constructor Details

RandomValueFactory

public RandomValueFactory(long seed)

RandomValueFactory

public RandomValueFactory()

Method Details

byteSequence

public void byteSequence(Consumer<Byte> consumer)

byteSequence

public void byteSequence(Repeats repeats,
 Matcher<Byte> include,
 Consumer<Byte> consumer)

byteSequence

public void byteSequence(Repeats repeats,
 Consumer<Byte> consumer)

byteSequence

public void byteSequence(Matcher<Byte> include,
 Consumer<Byte> consumer)

confidence

public Confidence confidence()

from

public <T> T from(Collection<T> values)

from

public <T> T from(T[] values)

identifierExclusive

public Identifier identifierExclusive(long maximum)

indexes

public void indexes(Repeats repeats,
 long maximum,
 Consumer<Integer> consumer)

indexes

public void indexes(long maximum,
 Consumer<Integer> consumer)

intSequence

public void intSequence(Consumer<Integer> consumer)

intSequence

public void intSequence(Repeats repeats,
 Matcher<Integer> include,
 Consumer<Integer> consumer)

intSequence

public void intSequence(Repeats repeats,
 Consumer<Integer> consumer)

intSequence

public void intSequence(Matcher<Integer> include,
 Consumer<Integer> consumer)

iterations

public Count iterations()

letter

public char letter()

letters

public String letters()

letters

public String letters(int minLength,
 int maxLength)

list

public <T extends Number> List<T> list(Repeats repeats,
 Count count,
 Class<T> type)

list

public <T extends Number> List<T> list(Repeats repeats,
 Class<T> type)

list

public <T extends Number> List<T> list(Class<T> type)

list

public <T extends Number> List<T> list(Repeats repeats,
 Class<T> type,
 Matcher<T> include)

list

public <T extends Number> List<T> list(Repeats repeats,
 Count count,
 long minimum,
 long maximum,
 Class<T> type,
 Matcher<T> include)

list

public <T extends Number> List<T> list(Repeats repeats,
 Count count,
 long minimum,
 long maximum,
 Class<T> type)

list

public <T extends Number> List<T> list(Repeats repeats,
 Count count,
 Class<T> type,
 Matcher<T> include)

longSequence

public void longSequence(Consumer<Long> consumer)

longSequence

public void longSequence(Repeats repeats,
 Matcher<Long> include,
 Consumer<Long> consumer)

longSequence

public void longSequence(Repeats repeats,
 Consumer<Long> consumer)

longSequence

public void longSequence(Matcher<Long> include,
 Consumer<Long> consumer)

loop

public void loop(Runnable code)

random

public Random random()

randomCount

public Count randomCount(long maximum)

randomCount

public Count randomCount(long minimum,
 long maximum)

randomDoubleZeroToOne

public double randomDoubleZeroToOne()

Description copied from interface: RandomNumeric

Returns a random value between zero and one

Specified by:

randomDoubleZeroToOne in interface RandomNumeric

randomLongExclusive

public final long randomLongExclusive(long minimum,
 long exclusiveMaximum)

Specified by:

randomLongExclusive in interface RandomNumeric

rangeExclusive

public Range<Count> rangeExclusive(long minimum,
 long exclusiveMaximum)

rangeExclusive

public Range<Count> rangeExclusive(long minimum,
 long exclusiveMaximum,
 long minimumWidth)

rangeExclusive

public <T extends BaseCount<T>> Range<T> rangeExclusive(T minimum,
 T exclusiveMaximum,
 long minimumWidth)

rangeExclusive

public <T extends BaseCount<T>> Range<T> rangeExclusive(T minimum,
 T exclusiveMaximum)

rangeInclusive

public <T extends BaseCount<T>> Range<T> rangeInclusive(T minimum,
 T inclusiveMaximum)

rangeInclusive

public Range<Count> rangeInclusive(long minimum,
 long inclusiveMaximum)

rangeInclusive

public <T extends BaseCount<T>> Range<T> rangeInclusive(T minimum,
 T inclusiveMaximum,
 long minimumWidth)

rangeInclusive

public Range<Count> rangeInclusive(long minimum,
 long inclusiveMaximum,
 long minimumWidth)

seed

public long seed()

seed

public void seed(long seed)

sequence

public <T extends Number> void sequence(Class<T> type,
 Consumer<T> consumer)

sequence

public <T extends Number> void sequence(Repeats repeats,
 Class<T> type,
 Consumer<T> consumer)

sequence

public <T extends Number> void sequence(Repeats repeats,
 Count count,
 Class<T> type,
 Consumer<T> consumer)

sequence

public <T extends Number> void sequence(Repeats repeats,
 long minimum,
 long maximum,
 Class<T> type,
 Consumer<T> consumer)

sequence

public <T extends Number> void sequence(Repeats repeats,
 long maximum,
 Class<T> type,
 Consumer<T> consumer)

sequence

public <T extends Number> void sequence(Repeats repeats,
 Count count,
 long minimum,
 long maximum,
 Class<T> type,
 Consumer<T> consumer)

sequence

public <T extends Number> void sequence(Repeats repeats,
 Count count,
 Class<T> type,
 Matcher<T> include,
 Consumer<T> consumer)

sequence

public <T extends Number> void sequence(Repeats repeats,
 Class<T> type,
 Matcher<T> include,
 Consumer<T> consumer)

sequence

public <T extends Number> void sequence(Repeats repeats,
 Count count,
 long minimum,
 long exclusiveMaximum,
 Class<T> type,
 Matcher<T> include,
 Consumer<T> consumer)

shortSequence

public void shortSequence(Consumer<Short> consumer)

shortSequence

public void shortSequence(Repeats repeats,
 Matcher<Short> include,
 Consumer<Short> consumer)

shortSequence

public void shortSequence(Repeats repeats,
 Consumer<Short> consumer)

shortSequence

public void shortSequence(Matcher<Short> include,
 Consumer<Short> consumer)

string

public String string()

string

public String string(int maximum)

string

public String string(int minimum,
 int maximum)