Part of the Alchemy Series, this library makes it easier to test your code by providing generators for common Objects and Data.

Introducing randomized data to tests helps improve test quality by assuring that your code can work over a wide range of data values, and not just what you hard-code in. It also increases confidence that code will work in a variety of circumstances.

• Download
  • Release
  • Snapshot
• [Javadocs](#javadocshttpwwwjavadociodoctechsirwellingtonalchemyalchemy-generator)
• API
  • Numbers
    • Integers
  • Longs
    • Doubles
  • Strings
    • Alphabetical
    • Alphanumeric
    • Hexadecimal
    • Any String
    • UUIDs
    • From Fixed Set
  • Binary
    • byte[]
    • ByteBuffer
  • Collections
    • Lists
    • Maps
  • Dates and Times
    • Generators for Instant type:
    • Generators for Date type:
  • Enums
  • People
  • POJOs
    • Nested POJOs
    • Collections
• Networking
  • URLs
  • Hostnames
  • Ports
  • MAC Addresses
• Requirements
• Building
• Feature Requests
• Release Notes
  • 1.5
  • 1.4
  • 1.3.1
  • 1.3
  • 1.2
  • 1.1
  • 1.0
• License

To use, simply add the following maven dependency.

<dependency>
	<groupId>tech.sirwellington.alchemy</groupId>
	<artifactId>alchemy-generator</artifactId>
	<version>2.4.1</version>
</dependency>

Examples use static imports Specifically, tech.sirwellington.alchemy.generator.Generators.one()

tech.sirwellington.alchemy.generator.NumberGenerators

//A number in the range [-50, 50)
int anInteger = integers(-50, 50).get();

//Get any positive long
long somePositiveNumber = positiveLongs().get();

//alternative way to get a single value
somePositiveNumber = one(positiveLongs());

//A double in the range [0.1, 1999.0]
AlchemyGenerator<Double> doubleGenerator = doubles(0.1, 1999.0);
for(int i = 0; i < 100; ++i)
{
	LOG.info("Received double {}", doubleGenerator.get());
}

tech.sirwellington.alchemy.generator.StringGenerators

Uses the Latin Alphabet, a-z | A-Z

String alphabetical = alphabeticStrings().get();

Uses the Latin Alphabet, and numbers 1-9.

String alphanumeric = one(alphanumericStrings());

String hex = hexadecimalString(32).get();

These strings may have unicode characters as well. These are great for testing against international character sets as well.

String anyCharacterString = strings(30).get();
assertThat(anyCharacterString.length(), is(30));

Guaranteed unique strings

int amount = one(smallPositiveIntegers());
AlchemyGenerator<String> uuids = uuids();
Set<String> ids = listOf(uuids, amount);

//Check for uniqueness
assertThat(ids.size(), is(amount));

Strings can be generated from a preselected set of String values.

//The generated strings can only be one of the supplied ones.
String stringFromList = stringsFromFixedList("one", "something else", "Java").get();

tech.sirwellington.alchemy.generator.BinaryGenerators

byte[] someBinary = one(BinaryGenerators.binary(10_000));
assertThat(someBinary.length, is(10_000));

ByteBuffer buffer = one(BinaryGenerators.byteBuffers(1_000));
assertThat(buffer, notNullValue());

tech.sirwellington.alchemy.generator.CollectionGenerators

List<String> randomStrings = listOf(alphabeticStrings(20), 100);
List<Integer> ages = listOf(integers(1, 100));

AlchemyGenerator<String> names = alphabeticalStrings();
AlchemyGenerator<Integer> ages = integers(1, 100);

int numberOfPeople = 50;
Map<String,Integer> ages = mapOf(names, ages, numberOfPeople);

AlchemyGenerator<Instant> alwaysNow = presentInstants();
Instant timeInThePast = pastInstants().get();
Instant timeInTheFuture = futureInstants().get();

tech.sirwellington.alchemy.generator.EnumGenerators

Sometimes you have an enum and you want to randomly access a value from it.

Alchemy Generator makes it simple:

enum Fruit
{
	APPLE,
	ORANGE,
	BANANA,
	GUAVA
}

You want a fruit, but don't care which one?

Fruit fruit = enumValueOf(Fruit.class).get();

Our code very often works people, and information about them tech.sirwellington.alchemy.generator.PeopleGenerators

String name = names().get();
int age = one(adultAges());
String phoneNumber = one(phoneNumberStrings());
String email = one(emails());

POJOs are dumb data objects, that is they tend to contain no functionality other than getters/setters and value methods like equals(), hashCode(), and toString(). Alchemy Generator provides Automatic Generation of POJOs.

tech.sirwellington.alchemy.generator.ObjectGenerators

Let's say you have a class like

class Computer
{
    private int yearReleased;
    private String modelName;
    private double cost;
    private String manufacturer;
    private String operatingSystem;
}

Rather than creating Boiler Plate generation code for each pojo, just use the pojos() generator.

@Test
public void testPurchaseOrder()
{
    Computer computer = one(pojos(Computer.class));
    shoppingCart.add(computer);
    shoppingCart.order();
    ...
}

The POJO generator contains a sophisticated recursive algorithm to generate complex hierarchies of POJOs, as long as it all eventually boils to down to primitive types (Integer, String, Double, Long, Date, etc).

class Developer
{
    private String name;
    private String alias;
    private int age;
    private Computer developerMachine;
    private Computer serverMachine;
}

Developer developer = one(pojos(Developer.class));

assertThat(developer, notNullValue());
assertThat(developer.name, not(isEmptyOrNullString()));
assertThat(developer.age, greaterThan(0));
assertThat(developer.developerMachine, notNullValue());
...

IMPORTANT: There can be NO circular references. A Computer cannot contain a Developer at the same time that Developer contains Computer. This would cause a StackOverflow.

tech.sirwellington.alchemy.generator.CollectionGenerators

The POJO Generator also handles Generic enum, List, Set, and Map types that contain either Primitive Types, or other POJOs.

class City
{
    private String name;
    private long population;
    private List<Developer> developersInTown;
    private Map<String, Building> addressDirectory;
}

City sampleCity = one(pojos(City.class));

IMPORTANT: Complicated and nested data structures increase the amount of time of Object Generation, since for each Collection, the algorithm must recurse to generate more POJOs for the collection. This library was designed for Unit Testing purposes, however, and so performance is less important.

tech.sirwellington.alchemy.generator.NetworkGenerators

NetworkGenerators contains generation code for Networking related concepts and data, such as URLs, hostnames, ports, etc.

URL httpUrl = one(httpUrls());
URL httpsUrl = one(httpsUrls());
URL tcpUrl = one(urlsWithProtocol("tcp"));

Create Network names in accordance to standards.

String hostname = one(localNetworkNames());
hostname = one(fullyQualifiedDomainNames());

int port = one(ports());

Coming Soon.

• Java 8
• Maven

This project builds with maven. Just run a mvn clean install to compile and install to your local maven repository

Feature Requests are definitely welcomed! Please drop a note in Issues.

This Software is licensed under the Apache 2.0 License

http://www.apache.org/licenses/LICENSE-2.0