Package io.github.joke.conventionalversion

@NullMarked package io.github.joke.conventionalversion

The Gradle surface: the settings plugin, its configuration, and the value source that reads git.

A settings plugin rather than a project plugin because isolated projects forbids cross-project model access, so a project plugin would have to read git once per project with nowhere to share the answer. Settings.gradle.lifecycle.beforeProject is the sanctioned replacement for allprojects and gives one calculation for any number of projects.

Unit tested and mutation tested like any other package. Being wiring does not put it out of reach: the action this package hands to Gradle is a named type, instantiated and invoked directly by its spec, so what it does to a project is asserted here rather than inferred from a real build.

Nothing in this project executes a Gradle build under test. Configuration cache and isolated projects compatibility rest on construction and review: git is read through a ValueSource so the cache re-evaluates it, and AssignVersion declares everything it captures. Neither property is verified by execution - see that class for what that has already cost once.

Related Packages

Package	Description
io.github.joke.conventionalversion.calc	The version calculation core: a pure function from repository facts to a version string.
io.github.joke.conventionalversion.config	Reads the configuration release-please keeps in the repository, so that every value which affects a calculated version comes from the release tooling's own declarations rather than from a restatement of them.
io.github.joke.conventionalversion.git	Gathers repository facts by running git.

Class	Description
ApplyProjectPlugin	How settings mode reaches every project: by applying ProjectVersionPlugin to each of them.
AssignVersion	Assigns one project the version of the package that claims it.
CatalogueSource	How either mode reaches the calculated catalogue: the core's only entry point.
ConventionalVersionPlugin	Assigns projects the version of the release-please package that claims them.
LinkedVersionReconciler	Raises every member of a linked group to the highest version any member calculated.
ProjectVersionPlugin	Project mode, and the whole of both modes: settings mode is this plugin applied to every project.
SettingsVersionPlugin	Settings mode: every project in the build is versioned, whether or not it takes part.
VersionCatalogue	Every package's version, and the answer for anything no package claims.
VersionCatalogue.PackageVersion	One package and what it resolved to.
VersionCatalogueService	The one calculated catalogue, shared by every project in the build.
VersionCatalogueService.Parameters
VersionInfo	What the calculation concluded, readable from any project's build logic.
VersionValueSource	Reads git and release-please's configuration, then calculates every package's version.
VersionValueSource.Parameters