com.github.curiousoddman.rgxgen

Class RgxGen

java.lang.Object

com.github.curiousoddman.rgxgen.RgxGen

public class RgxGen
extends Object

String values generator based on regular expression pattern

Constructor Summary

Constructors

Constructor and Description
RgxGen(NodeTreeBuilder builder) Parse regex pattern using provided builder and prepare to generate values
RgxGen(String pattern) Parse pattern using DefaultTreeBuilder.

Method Summary

Modifier and Type	Method and Description
String	generate() Generate random string from the pattern.
String	generate(Random random) Generate random string from the pattern.
StringIterator	iterateUnique() Creates iterator over unique values.
BigInteger	numUnique() Returns estimation of unique values that can be generated with the pattern.
Stream<String>	stream() Creates infinite stream of randomly generated values.

Methods inherited from class java.lang.Object

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

Constructor Detail

RgxGen

public RgxGen(String pattern)

Parse pattern using DefaultTreeBuilder.

Parameters:

pattern - regex pattern for values generation

RgxGen

public RgxGen(NodeTreeBuilder builder)

Parse regex pattern using provided builder and prepare to generate values

Parameters:

builder - node tree builder implementation

Method Detail

numUnique

public BigInteger numUnique()

Returns estimation of unique values that can be generated with the pattern.

Returns:

number of unique values or null, if infinite

API Note:

This might not be accurate! For example the pattern "(a{0,2}|b{0,2})" will estimate to 6, though actual count is only 5, because right and left part of group can yield same value

stream

public Stream<String> stream()

Creates infinite stream of randomly generated values.

Returns:

stream of randomly generated strings

See Also:

generate()

iterateUnique

public StringIterator iterateUnique()

Creates iterator over unique values.

Returns:

Iterator over unique values

generate

public String generate()

Generate random string from the pattern.

Returns:

generated string.

generate

public String generate(Random random)

Generate random string from the pattern.

Parameters:

random - random to use for the generation.

Returns:

generated string.