Release 4.8.0

[armandino]

What's Changed

Breaking changes to experimental APIs

• Renamed the Cartesian product creation method from list() to create()

Instancio.ofCartesianProduct(Class)
    .create(); // instead of list()

New Features

• New top-level API withUnique(TargetSelector) for generating unique values for a given selector

List<Customer> customers = Instancio.ofList(Customer.class)
    .size(100)
    .withUnique(field(Customer::getId))
    .create();

• New top-level as(Function) API for applying a Function to the result
  This is syntactic sugar that can be used, for example, to convert the result to JSON.

Sample usage:

String json = Instancio.of(Person.class).as(json());

// where json() is a user-defined function
static <T> Function<T, String> json() {
    return result -> new ObjectMapper()
            .writerWithDefaultPrettyPrinter()
            .writeValueAsString(result);
}

• New setting Keys.STRING_CASE for specifying the case of generated strings (upper, lower, mixed):

Comment comment = Instancio.of(Comment.class)
    .withSetting(Keys.STRING_CASE, StringCase.MIXED)
    .create();

or globally using instancio.properties:

string.case=MIXED

Improvements

• Improved handling of sealed abstract types.
  Instancio will use a random subclass as the subtype unless a specific subtype is specified explicitly.

• Error message improvements

Deprecation

Deprecated the experimental instancio-quickcheck module

---

• Bump com.puppycrawl.tools:checkstyle from 10.16.0 to 10.17.0 by @dependabot in Bump com.puppycrawl.tools:checkstyle from 10.16.0 to 10.17.0 #1035
• Refactored how Global is initialised by @armandino in Refactored how Global is initialised #1037
• Bump version.jooq from 3.19.8 to 3.19.9 by @dependabot in Bump version.jooq from 3.19.8 to 3.19.9 #1038
• Renamed the Cartesian product API method list() to create() by @armandino in Renamed the Cartesian product API method list() to create() #1040
• New top-level API withUnique(TargetSelector) by @armandino in New top-level API withUnique(TargetSelector) #1041
• Bump org.apache.maven.plugins:maven-enforcer-plugin from 3.4.1 to 3.5.0 by @dependabot in Bump org.apache.maven.plugins:maven-enforcer-plugin from 3.4.1 to 3.5.0 #1039
• Minor change to unused selector error by @armandino in Minor change to unused selector error #1045
• Bump com.google.guava:guava from 33.2.0-jre to 33.2.1-jre by @dependabot in Bump com.google.guava:guava from 33.2.0-jre to 33.2.1-jre #1042
• Improvements to handling sealed abstract types by @armandino in Improvements to handling sealed abstract types #1046
• New setting Keys.STRING_CASE by @armandino in New setting Keys.STRING_CASE #1054
• Bump org.sonarsource.scanner.maven:sonar-maven-plugin from 3.11.0.3922 to 4.0.0.4121 by @dependabot in Bump org.sonarsource.scanner.maven:sonar-maven-plugin from 3.11.0.3922 to 4.0.0.4121 #1052
• Bump org.apache.maven.plugins:maven-javadoc-plugin from 3.6.3 to 3.7.0 by @dependabot in Bump org.apache.maven.plugins:maven-javadoc-plugin from 3.6.3 to 3.7.0 #1044
• Bump org.apache.maven.plugins:maven-checkstyle-plugin from 3.3.1 to 3.4.0 by @dependabot in Bump org.apache.maven.plugins:maven-checkstyle-plugin from 3.3.1 to 3.4.0 #1055
• New top-level as(Function) API (Support for returning the result as a JSON String #1048) by @armandino in New top-level as(Function) API (#1048) #1056
• Deprecate the experimental instancio-quickcheck module by @armandino in Deprecate the experimental instancio-quickcheck module #1057

Full Changelog: instancio-parent-4.7.0...instancio-parent-4.8.0

---

This discussion was created from the release instancio-parent-4.8.0.