Release 5.3.0

[armandino]

What's Changed

New Features

• New top-level APIs Instancio.fill(T) and Instancio.ofObject(T) (New top-level APIs Instancio.fill(T) and Instancio.ofObject(T) (#1252) #1268)

  Example: given a partially populated object:

  class Person {
      String name;
      String email;
      LocalDate dateOfBirth;
      // getters/setters
  }
  
  Person person = new Person();
  person.setDateOfBirth(LocalDate.of(1980, 12, 31));
  
  // The remaining fields can be populated as follows:
  Instancio.fill(person);
  
  // Sample output:
  // Person[name=VCNSOU email=ONVERFS, dateOfBirth=1980-12-31]

  Additionally, the ofObject() builder API supports all of the usual Instancio methods:

  Person person = new Person();
  person.setDateOfBirth(LocalDate.of(1980, 12, 31));
  
  Instancio.ofObject(person)
      .generate(field(Person::getEmail), gen -> gen.net().email())
      .fill();
  
  // Sample output:
  // Person[name=VCNSOU, [email protected], dateOfBirth=1980-12-31]

Bug Fixes

• Overwrite initialised field via assign() (Bug fix: overwrite initialised field via assign() #1253)

Breaking Changes

• Experimental API breaking change: renamed @DataSpec to @AliasSpec (Experimental API breaking change: renamed @DataSpec to @AliasSpec #1244)

---

• Bump com.puppycrawl.tools:checkstyle from 10.20.2 to 10.21.0 by @dependabot in Bump com.puppycrawl.tools:checkstyle from 10.20.2 to 10.21.0 #1243
• Experimental API breaking change: renamed @DataSpec to @AliasSpec by @armandino in Experimental API breaking change: renamed @DataSpec to @AliasSpec #1244
• Bump org.junit:junit-bom from 5.11.3 to 5.11.4 by @dependabot in Bump org.junit:junit-bom from 5.11.3 to 5.11.4 #1249
• Bump com.google.guava:guava from 33.3.1-jre to 33.4.0-jre by @dependabot in Bump com.google.guava:guava from 33.3.1-jre to 33.4.0-jre #1248
• Upgrade assertj to 3.27.0 by @armandino in Upgrade assertj to 3.27.0 #1251
• Bug fix: overwrite initialised field via assign() by @armandino in Bug fix: overwrite initialised field via assign() #1253
• Bump nl.jqno.equalsverifier:equalsverifier-nodep from 3.17.5 to 3.18 by @dependabot in Bump nl.jqno.equalsverifier:equalsverifier-nodep from 3.17.5 to 3.18 #1254
• Cleanup tests by @armandino in Cleanup tests #1255
• Cleanup tests cont'd by @armandino in Cleanup tests cont'd #1256
• Refactor: cleanup handling of selector targets to remove instanceof checks by @armandino in Refactor: cleanup handling of selector targets to remove instanceof checks #1257
• Refactor: renamed util method by @armandino in Refactor: renamed util method #1258
• Bump com.puppycrawl.tools:checkstyle from 10.21.0 to 10.21.1 by @dependabot in Bump com.puppycrawl.tools:checkstyle from 10.21.0 to 10.21.1 #1259
• Updated license headers by @armandino in Updated license headers #1260
• Bump org.assertj:assertj-bom from 3.27.0 to 3.27.1 by @dependabot in Bump org.assertj:assertj-bom from 3.27.0 to 3.27.1 #1261
• Bump org.assertj:assertj-bom from 3.27.1 to 3.27.2 by @dependabot in Bump org.assertj:assertj-bom from 3.27.1 to 3.27.2 #1262
• Bump version.jooq from 3.19.16 to 3.19.17 by @dependabot in Bump version.jooq from 3.19.16 to 3.19.17 #1264
• Bump nl.jqno.equalsverifier:equalsverifier-nodep from 3.18 to 3.18.1 by @dependabot in Bump nl.jqno.equalsverifier:equalsverifier-nodep from 3.18 to 3.18.1 #1266
• Bump com.github.siom79.japicmp:japicmp-maven-plugin from 0.23.0 to 0.23.1 by @dependabot in Bump com.github.siom79.japicmp:japicmp-maven-plugin from 0.23.0 to 0.23.1 #1265
• Bump version.jooq from 3.19.17 to 3.19.18 by @dependabot in Bump version.jooq from 3.19.17 to 3.19.18 #1269
• New top-level APIs Instancio.fill(T) and Instancio.ofObject(T) (Support for populating existing object instances #1252) by @armandino in New top-level APIs Instancio.fill(T) and Instancio.ofObject(T) (#1252) #1268
• Updated build to use java 23 by @armandino in Updated build to use java 23 #1270
• Refactor: cleanup error message creation by @armandino in Refactor: cleanup error message creation #1271
• Bump org.assertj:assertj-bom from 3.27.2 to 3.27.3 by @dependabot in Bump org.assertj:assertj-bom from 3.27.2 to 3.27.3 #1272

Full Changelog: instancio-parent-5.2.1...instancio-parent-5.3.0

---

This discussion was created from the release 5.3.0.