Micronaut Utils

A collection of utility libraries for the Micronaut ecosystem.

Modules

Module	Description
assisted-inject	Assisted injection — factory interfaces that combine injected services with runtime parameters
hikari-health	Health indicator for HikariCP connection pools with detailed pool statistics
junit-jupiter	JUnit 5 extensions that catch common @MicronautTest lifecycle configuration mistakes
security-grpc	gRPC server interceptor that enforces Micronaut Security @Secured rules on gRPC methods
mock-oauth2-test-resource	Micronaut test-resources provider that starts a mock OAuth2 server for test and dev environments
security-grpc-processor	Annotation processor required by security-grpc to read @Secured metadata at compile time

Installation

Using the version catalog (recommended)

Add the catalog to your settings.gradle.kts:

dependencyResolutionManagement {
  versionCatalogs {
    create("pkwareMicronautUtils") {
      from("com.pkware.micronaut-utils:catalog:<version>")
    }
  }
}

Then reference modules by name in build.gradle.kts:

dependencies {
  implementation(pkwareMicronautUtils.assistedInject)
  implementation(pkwareMicronautUtils.hikariHealth)
  testImplementation(pkwareMicronautUtils.junitJupiter)

  // gRPC security requires both the runtime library and the annotation processor
  implementation(pkwareMicronautUtils.securityGrpc)
  annotationProcessor(pkwareMicronautUtils.securityGrpcProcessor)  // Java
  // ksp(pkwareMicronautUtils.securityGrpcProcessor)               // Kotlin KSP
}

Using coordinates directly

// build.gradle.kts
dependencies {
  implementation("com.pkware.micronaut-utils:assisted-inject:<version>")
  implementation("com.pkware.micronaut-utils:hikari-health:<version>")
  testImplementation("com.pkware.micronaut-utils:junit-jupiter:<version>")

  // gRPC security requires both the runtime library and the annotation processor
  implementation("com.pkware.micronaut-utils:security-grpc:<version>")
  annotationProcessor("com.pkware.micronaut-utils:security-grpc-processor:<version>")  // Java
  // ksp("com.pkware.micronaut-utils:security-grpc-processor:<version>")               // Kotlin KSP
}

Requirements

• Java 21+
• Micronaut 4.x

License

MIT — PKWARE, Inc.

Releasing

1. Change the relevant version in gradle.properties to a non-SNAPSHOT version.
2. git commit -am "Release version X.Y.Z." (where X.Y.Z is the new version)
3. Push or merge to the main branch.
4. Update gradle.properties to the next SNAPSHOT version.
5. git commit -am "Prepare next development version."
6. After the merge, tag the release commit on the main branch: git tag -a X.Y.Z -m "Version X.Y.Z"
7. git push --tags