Package de.cuioss.test.generator.impl

package de.cuioss.test.generator.impl

Core implementation classes for the CUI test generator framework. This package provides concrete implementations of various test data generators.

Generator Categories

Collection and Array Generators

• CollectionGenerator - Creates Lists, Sets, and other collections
• PrimitiveArrayGenerators - Generates arrays of primitive types

Date and Time Generators

• LocalDateGenerator - Generates dates within a reasonable epoch range
• LocalTimeGenerator - Creates times with second precision
• LocalDateTimeGenerator - Combines date and time generation
• ZonedDateTimeGenerator - Adds time zone support
• ZoneOffsetGenerator - Generates time zone offsets

Numeric Generators

• NumberGenerator - Generic number generation
• FloatObjectGenerator - Float values with configurable ranges
• ShortObjectGenerator - Short values across the full range

String and URL Generators

• NonBlankStringGenerator - Non-empty string generation
• URLGenerator - Valid URL generation from predefined sets

Utility Generators

• DecoratorGenerator - Wraps and enhances other generators

Common Usage Patterns

 
 // Basic generator usage
 var stringGen = new NonBlankStringGenerator();
 String value = stringGen.next();
 
 // Collection generation
 TypedGenerator<Integer> intGen = Generators.integers(1, 100);
 var collectionGen = new CollectionGenerator<>(intGen);
 List<Integer> list = collectionGen.list(5);
 
 // Date/Time generation with zones
 var dateTimeGen = new ZonedDateTimeGenerator();
 ZonedDateTime future = dateTimeGen.future();
 
 // Numeric generation with ranges
 var floatGen = new FloatObjectGenerator(0.0f, 100.0f);
 Float number = floatGen.next();
 
 // Create a generator for integers
 TypedGenerator<Integer> intGen = Generators.integers(1, 100);
 
 // Wrap it in a collection generator
 var collectionGen = new CollectionGenerator<>(intGen);
 
 // Generate lists and sets
 List<Integer> list = collectionGen.list(5);  // List of 5 integers
 Set<Integer> set = collectionGen.set(3);     // Set of 3 integers
 
 

Implementation Notes

• All generators are thread-safe unless explicitly noted otherwise
• Generators follow the fail-fast principle for invalid inputs
• Each generator provides specific configuration options where appropriate
• Documentation includes usage examples from actual tests
• Generators can be combined using the CollectionGenerator or DecoratorGenerator

Author:

Oliver Wolff, Eugen Fischer

See Also:

• TypedGenerator
• Generators

Related Packages

Package	Description
de.cuioss.test.generator	Generators
de.cuioss.test.generator.domain	Provides domain-specific test data generators implementing TypedGenerator.
de.cuioss.test.generator.junit	Provides JUnit 5 integration for the CUI test generator framework.

Class	Description
CollectionGenerator<T>	Enhances a TypedGenerator with collection generation capabilities.
DecoratorGenerator<T>	A decorator pattern implementation for TypedGenerator that allows wrapping and enhancing existing generators.
FloatObjectGenerator	Generates Float objects within a configurable range.
LocalDateGenerator	Generates LocalDate instances within a reasonable range around the epoch.
LocalDateTimeGenerator	Generates random LocalDateTime instances for testing purposes.
LocalTimeGenerator	Generates LocalTime instances covering all possible times within a day.
NonBlankStringGenerator	Generates non-empty and non-blank string values for testing purposes.
NumberGenerator	Generates Number instances using integer values.
PrimitiveArrayGenerators	Provides generators for arrays of all Java primitive types.
ShortObjectGenerator	Generates Short objects across the full range of possible short values.
URLGenerator	Generates valid URL instances from a predefined set of well-known websites.
ZonedDateTimeGenerator	Generates ZonedDateTime instances with random dates, times, and time zones.
ZoneOffsetGenerator	Generates ZoneOffset instances based on the available system time zones.