Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -46,12 +46,12 @@ object CoreJvmCompiler {
/**
* The version used to in the build classpath.
*/
const val dogfoodingVersion = "2.0.0-SNAPSHOT.050"
const val dogfoodingVersion = "2.0.0-SNAPSHOT.051"

/**
* The version to be used for integration tests.
*/
const val version = "2.0.0-SNAPSHOT.050"
const val version = "2.0.0-SNAPSHOT.051"

/**
* The ID of the Gradle plugin.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ object Validation {
/**
* The version of the Validation library artifacts.
*/
const val version = "2.0.0-SNAPSHOT.392"
const val version = "2.0.0-SNAPSHOT.393"

/**
* The last version of Validation compatible with ProtoData.
Expand Down
60 changes: 30 additions & 30 deletions dependencies.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@


# Dependencies of `io.spine.tools:validation-context:2.0.0-SNAPSHOT.393`
# Dependencies of `io.spine.tools:validation-context:2.0.0-SNAPSHOT.394`

## Runtime
1. **Group** : com.fasterxml.jackson. **Name** : jackson-bom. **Version** : 2.20.0.
Expand Down Expand Up @@ -1139,14 +1139,14 @@

The dependencies distributed under several licenses, are used according their commercial-use-friendly license.

This report was generated on **Tue Jan 20 16:21:00 WET 2026** using
This report was generated on **Tue Jan 20 19:55:52 WET 2026** using
[Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under
[Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).




# Dependencies of `io.spine.tools:validation-context-tests:2.0.0-SNAPSHOT.393`
# Dependencies of `io.spine.tools:validation-context-tests:2.0.0-SNAPSHOT.394`

## Runtime
1. **Group** : com.fasterxml.jackson. **Name** : jackson-bom. **Version** : 2.20.0.
Expand Down Expand Up @@ -1731,14 +1731,14 @@ This report was generated on **Tue Jan 20 16:21:00 WET 2026** using

The dependencies distributed under several licenses, are used according their commercial-use-friendly license.

This report was generated on **Tue Jan 20 16:21:00 WET 2026** using
This report was generated on **Tue Jan 20 19:55:51 WET 2026** using
[Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under
[Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).




# Dependencies of `io.spine.tools:validation-gradle-plugin:2.0.0-SNAPSHOT.393`
# Dependencies of `io.spine.tools:validation-gradle-plugin:2.0.0-SNAPSHOT.394`

## Runtime
1. **Group** : com.fasterxml.jackson. **Name** : jackson-bom. **Version** : 2.20.0.
Expand Down Expand Up @@ -2807,14 +2807,14 @@ This report was generated on **Tue Jan 20 16:21:00 WET 2026** using

The dependencies distributed under several licenses, are used according their commercial-use-friendly license.

This report was generated on **Tue Jan 20 16:21:00 WET 2026** using
This report was generated on **Tue Jan 20 19:55:52 WET 2026** using
[Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under
[Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).




# Dependencies of `io.spine.tools:validation-java:2.0.0-SNAPSHOT.393`
# Dependencies of `io.spine.tools:validation-java:2.0.0-SNAPSHOT.394`

## Runtime
1. **Group** : com.fasterxml.jackson. **Name** : jackson-bom. **Version** : 2.20.0.
Expand Down Expand Up @@ -3901,14 +3901,14 @@ This report was generated on **Tue Jan 20 16:21:00 WET 2026** using

The dependencies distributed under several licenses, are used according their commercial-use-friendly license.

This report was generated on **Tue Jan 20 16:21:00 WET 2026** using
This report was generated on **Tue Jan 20 19:55:52 WET 2026** using
[Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under
[Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).




# Dependencies of `io.spine.tools:validation-java-bundle:2.0.0-SNAPSHOT.393`
# Dependencies of `io.spine.tools:validation-java-bundle:2.0.0-SNAPSHOT.394`

## Runtime
1. **Group** : com.google.auto.service. **Name** : auto-service-annotations. **Version** : 1.1.1.
Expand Down Expand Up @@ -3971,14 +3971,14 @@ This report was generated on **Tue Jan 20 16:21:00 WET 2026** using

The dependencies distributed under several licenses, are used according their commercial-use-friendly license.

This report was generated on **Tue Jan 20 16:21:00 WET 2026** using
This report was generated on **Tue Jan 20 19:55:51 WET 2026** using
[Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under
[Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).




# Dependencies of `io.spine:validation-jvm-runtime:2.0.0-SNAPSHOT.393`
# Dependencies of `io.spine:validation-jvm-runtime:2.0.0-SNAPSHOT.394`

## Runtime
1. **Group** : com.google.code.findbugs. **Name** : jsr305. **Version** : 3.0.2.
Expand Down Expand Up @@ -4811,14 +4811,14 @@ This report was generated on **Tue Jan 20 16:21:00 WET 2026** using

The dependencies distributed under several licenses, are used according their commercial-use-friendly license.

This report was generated on **Tue Jan 20 16:21:00 WET 2026** using
This report was generated on **Tue Jan 20 19:55:52 WET 2026** using
[Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under
[Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).




# Dependencies of `io.spine.tools:validation-ksp:2.0.0-SNAPSHOT.393`
# Dependencies of `io.spine.tools:validation-ksp:2.0.0-SNAPSHOT.394`

## Runtime
1. **Group** : com.google.auto.service. **Name** : auto-service-annotations. **Version** : 1.1.1.
Expand Down Expand Up @@ -5747,14 +5747,14 @@ This report was generated on **Tue Jan 20 16:21:00 WET 2026** using

The dependencies distributed under several licenses, are used according their commercial-use-friendly license.

This report was generated on **Tue Jan 20 16:21:00 WET 2026** using
This report was generated on **Tue Jan 20 19:55:52 WET 2026** using
[Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under
[Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).




# Dependencies of `io.spine.tools:validation-consumer:2.0.0-SNAPSHOT.393`
# Dependencies of `io.spine.tools:validation-consumer:2.0.0-SNAPSHOT.394`

## Runtime
1. **Group** : com.fasterxml.jackson. **Name** : jackson-bom. **Version** : 2.20.0.
Expand Down Expand Up @@ -6345,14 +6345,14 @@ This report was generated on **Tue Jan 20 16:21:00 WET 2026** using

The dependencies distributed under several licenses, are used according their commercial-use-friendly license.

This report was generated on **Tue Jan 20 16:21:00 WET 2026** using
This report was generated on **Tue Jan 20 19:55:51 WET 2026** using
[Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under
[Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).




# Dependencies of `io.spine.tools:validation-consumer-dependency:2.0.0-SNAPSHOT.393`
# Dependencies of `io.spine.tools:validation-consumer-dependency:2.0.0-SNAPSHOT.394`

## Runtime
1. **Group** : com.google.code.findbugs. **Name** : jsr305. **Version** : 3.0.2.
Expand Down Expand Up @@ -6863,14 +6863,14 @@ This report was generated on **Tue Jan 20 16:21:00 WET 2026** using

The dependencies distributed under several licenses, are used according their commercial-use-friendly license.

This report was generated on **Tue Jan 20 16:21:00 WET 2026** using
This report was generated on **Tue Jan 20 19:55:52 WET 2026** using
[Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under
[Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).




# Dependencies of `io.spine.tools:validation-extensions:2.0.0-SNAPSHOT.393`
# Dependencies of `io.spine.tools:validation-extensions:2.0.0-SNAPSHOT.394`

## Runtime
1. **Group** : com.fasterxml.jackson. **Name** : jackson-bom. **Version** : 2.20.0.
Expand Down Expand Up @@ -7554,14 +7554,14 @@ This report was generated on **Tue Jan 20 16:21:00 WET 2026** using

The dependencies distributed under several licenses, are used according their commercial-use-friendly license.

This report was generated on **Tue Jan 20 16:21:00 WET 2026** using
This report was generated on **Tue Jan 20 19:55:52 WET 2026** using
[Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under
[Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).




# Dependencies of `io.spine.tools:validation-runtime:2.0.0-SNAPSHOT.393`
# Dependencies of `io.spine.tools:validation-runtime:2.0.0-SNAPSHOT.394`

## Runtime
1. **Group** : com.google.code.findbugs. **Name** : jsr305. **Version** : 3.0.2.
Expand Down Expand Up @@ -8183,14 +8183,14 @@ This report was generated on **Tue Jan 20 16:21:00 WET 2026** using

The dependencies distributed under several licenses, are used according their commercial-use-friendly license.

This report was generated on **Tue Jan 20 16:21:00 WET 2026** using
This report was generated on **Tue Jan 20 19:55:52 WET 2026** using
[Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under
[Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).




# Dependencies of `io.spine.tools:validation-validating:2.0.0-SNAPSHOT.393`
# Dependencies of `io.spine.tools:validation-validating:2.0.0-SNAPSHOT.394`

## Runtime
1. **Group** : com.google.code.findbugs. **Name** : jsr305. **Version** : 3.0.2.
Expand Down Expand Up @@ -8855,14 +8855,14 @@ This report was generated on **Tue Jan 20 16:21:00 WET 2026** using

The dependencies distributed under several licenses, are used according their commercial-use-friendly license.

This report was generated on **Tue Jan 20 16:21:00 WET 2026** using
This report was generated on **Tue Jan 20 19:55:52 WET 2026** using
[Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under
[Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).




# Dependencies of `io.spine.tools:validation-validator:2.0.0-SNAPSHOT.393`
# Dependencies of `io.spine.tools:validation-validator:2.0.0-SNAPSHOT.394`

## Runtime
1. **Group** : com.fasterxml.jackson. **Name** : jackson-bom. **Version** : 2.20.0.
Expand Down Expand Up @@ -9613,14 +9613,14 @@ This report was generated on **Tue Jan 20 16:21:00 WET 2026** using

The dependencies distributed under several licenses, are used according their commercial-use-friendly license.

This report was generated on **Tue Jan 20 16:21:00 WET 2026** using
This report was generated on **Tue Jan 20 19:55:52 WET 2026** using
[Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under
[Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).




# Dependencies of `io.spine.tools:validation-validator-dependency:2.0.0-SNAPSHOT.393`
# Dependencies of `io.spine.tools:validation-validator-dependency:2.0.0-SNAPSHOT.394`

## Runtime
1. **Group** : com.google.code.findbugs. **Name** : jsr305. **Version** : 3.0.2.
Expand Down Expand Up @@ -9890,14 +9890,14 @@ This report was generated on **Tue Jan 20 16:21:00 WET 2026** using

The dependencies distributed under several licenses, are used according their commercial-use-friendly license.

This report was generated on **Tue Jan 20 16:21:00 WET 2026** using
This report was generated on **Tue Jan 20 19:55:51 WET 2026** using
[Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under
[Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).




# Dependencies of `io.spine.tools:validation-vanilla:2.0.0-SNAPSHOT.393`
# Dependencies of `io.spine.tools:validation-vanilla:2.0.0-SNAPSHOT.394`

## Runtime
1. **Group** : com.google.code.findbugs. **Name** : jsr305. **Version** : 3.0.2.
Expand Down Expand Up @@ -10248,6 +10248,6 @@ This report was generated on **Tue Jan 20 16:21:00 WET 2026** using

The dependencies distributed under several licenses, are used according their commercial-use-friendly license.

This report was generated on **Tue Jan 20 16:21:00 WET 2026** using
This report was generated on **Tue Jan 20 19:55:51 WET 2026** using
[Gradle-License-Report plugin](https://github.com/jk1/Gradle-License-Report) by Evgeny Naumenko, licensed under
[Apache 2.0 License](https://github.com/jk1/Gradle-License-Report/blob/master/LICENSE).
3 changes: 1 addition & 2 deletions docs/00-intro/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@
Spine Validation is a Protobuf-centric validation framework that generates
type-safe validation code directly from your `.proto` definitions.
It allows you to describe constraints on fields, messages, and collections using
declarative options and then automatically enforces these constraints at
runtime.
declarative options and then automatically enforces these constraints at runtime.

The library is part of the Spine toolchain but can also be used independently
in any Java/Kotlin backend that models data using Protocol Buffers.
Expand Down
7 changes: 5 additions & 2 deletions docs/01-getting-started/index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
# Getting Started

This section helps you set up Spine Validation, define your first validated Protobuf model, and see validation in action in Java and Kotlin.
This section helps you set up Spine Validation, define your first validated Protobuf model,
and see validation in action in Java and Kotlin.

If you are new to the library, read the short overview first:
- Introduction → [Overview](../00-intro/index.md)
Expand All @@ -22,7 +23,9 @@ If you are new to the library, read the short overview first:
- Protobuf compiler (`protoc`)
- Optional: Kotlin 2.2.20+ for the Kotlin Protobuf DSL

If your project already generates Java/Kotlin sources from `.proto` files, you’re 90% there. Spine Validation integrates into the build to generate and inject validation logic into the code produced by `protoc`.
If your project already generates Java/Kotlin sources from `.proto` files, you’re 90% there.
Spine Validation integrates into the build to generate and inject validation logic into
the code produced by `protoc`.

---

Expand Down
15 changes: 5 additions & 10 deletions docs/ToC.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,13 +84,8 @@
- [Cross-field Logic](07-recipes/cross-field-logic.md)
- [API Validation](07-recipes/api-validation.md)

## 8. Migration Guide
- [Overview](08-migration/index.md)
- [Migrating from `spine.base` Validation](08-migration/from-spine-base.md)
- [Version Changes](08-migration/version-changes.md)

## 9. Reference
- [Reference Overview](09-reference/index.md)
- [List of Validation Options](09-reference/options.md)
- [Java/Kotlin API Index](09-reference/api.md)
- [Glossary](09-reference/glossary.md)
## 8. Reference
- [Reference Overview](08-reference/index.md)
- [List of Validation Options](08-reference/options.md)
- [Java/Kotlin API Index](08-reference/api.md)
- [Glossary](08-reference/glossary.md)
Original file line number Diff line number Diff line change
Expand Up @@ -71,9 +71,9 @@ private val customOptions: List<ValidationOption> by lazy {
* Dynamically discovered instances of custom
* [MessageValidator][io.spine.validation.MessageValidator]s.
*
* Please note that the KSP module is responsible for the actual discovering
* of the message validators. The discovered validators are written to a text file
* in the KSP task output. This property loads the validators from that file.
* Note that the KSP module is responsible for the actual discovering of the message validators.
* The discovered validators are written to a text file in the KSP task output.
* This property loads the validators from that file.
*/
private val customValidators: Map<MessageClass, ValidatorClass> by lazy {
val workingDir = System.getProperty("user.dir")
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,8 +38,7 @@ import io.spine.tools.psi.java.method
/**
* Renders Java code to support `(set_once)` option for the given byte array [field].
*
* Please note, in the generated Java code, Protobuf uses [ByteString] to represent
* an array of bytes.
* Note that Protobuf uses [ByteString] to represent an array of bytes in the generated code.
*
* @param field The byte array field that declared the option.
* @param typeSystem The type system to resolve types.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,8 +39,7 @@ import io.spine.tools.psi.java.method
/**
* Renders Java code to support `(set_once)` option for the given enum [field].
*
* Please note, in the generated Java code, Protobuf uses an ordinal number
* to represent the currently set enum constant.
* Note that code generated by Protobuf uses an ordinal number to represent the currently set enum constant.
*
* @param field The enum field that declared the option.
* @param typeSystem The type system to resolve types.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,7 @@ import io.spine.annotation.SPI
* }
* ```
*
* Please note that standalone instances of [M] and fields of [M] type that occur in
* Note that standalone instances of [M] and fields of [M] type that occur in
* other external messages **will not be validated**.
*
* Consider the following example:
Expand Down
Loading
Loading