You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@groovy.apache.org by pa...@apache.org on 2026/05/16 22:22:21 UTC

(groovy-website) branch asf-site updated (d1ee44e -> 3405d0a)

This is an automated email from the ASF dual-hosted git repository.

paulk-asert pushed a change to branch asf-site
in repository https://gitbox.apache.org/repos/asf/groovy-website.git


    from d1ee44e  add branch protection
     new 142f13b  minor release note tweaks
     new 3405d0a  minor release note tweaks

The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 site/src/site/releasenotes/groovy-6.0.adoc | 37 +++++++++++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)


(groovy-website) 01/02: minor release note tweaks

Posted by pa...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

paulk-asert pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/groovy-website.git

commit 142f13bf2837a92c91ab7016a926c6a195da05ba
Author: Paul King <pa...@asert.com.au>
AuthorDate: Sat May 16 20:46:13 2026 +1000

    minor release note tweaks
---
 site/src/site/releasenotes/groovy-6.0.adoc | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/site/src/site/releasenotes/groovy-6.0.adoc b/site/src/site/releasenotes/groovy-6.0.adoc
index 2bfc913..016ef7c 100644
--- a/site/src/site/releasenotes/groovy-6.0.adoc
+++ b/site/src/site/releasenotes/groovy-6.0.adoc
@@ -48,6 +48,7 @@ Some features described here as "incubating" may become stable before 6.0.0 fina
 - <<groovy-contracts,Loop invariants and termination measures>> via `@Invariant`/`@Decreases`.
 - Contracts (`@Requires`, `@Ensures`, `@Invariant`) now also work in scripts.
 - Each method becomes a self-contained specification — readable without descending into bodies.
+- Those verified declarations are machine-actionable — a foundation for AI skills and tooling, not just for reading.
 
 *_<<g6-new-modules,New Optional Modules>>_*
 
@@ -1123,6 +1124,19 @@ methods have no side effects. Without that guarantee, annotations
 would be just comments -- claims you'd still need to verify by
 reading the code.
 
+Reading and verification are two of the payoffs; a third is that the
+same declarations are _machine-actionable_. Because `@Pure`, `@Modifies`,
+`@Requires`/`@Ensures` and `@Invariant`/`@Decreases` are both
+machine-readable and compiler-enforced, tooling and AI skills can build
+on them rather than guess -- deriving tests and documentation, driving or
+validating refactorings and migrations, and treating each verified
+contract as a guardrail an agent must not cross. The compile-time
+guarantee is what makes this safe: a skill can rely on a `@Pure` method
+being pure because `PurityChecker` proved it, not because a comment
+claimed it. A Groovy 6 codebase is therefore not only easier for humans
+and AI to _read_ -- it is a verified specification they can reliably
+_build on_.
+
 [[val-keyword]]
 == `val` Keyword for Final Declarations
 


(groovy-website) 02/02: minor release note tweaks

Posted by pa...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

paulk-asert pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/groovy-website.git

commit 3405d0a2fb7fb5c30aa4b51c636ed2c3f5326d0f
Author: Paul King <pa...@asert.com.au>
AuthorDate: Sun May 17 08:22:14 2026 +1000

    minor release note tweaks
---
 site/src/site/releasenotes/groovy-6.0.adoc | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/site/src/site/releasenotes/groovy-6.0.adoc b/site/src/site/releasenotes/groovy-6.0.adoc
index 016ef7c..99ee649 100644
--- a/site/src/site/releasenotes/groovy-6.0.adoc
+++ b/site/src/site/releasenotes/groovy-6.0.adoc
@@ -1394,6 +1394,12 @@ The full specification for sealed types is in
 link:../wiki/GEP-13.html[GEP-13: Sealed Types], which was revised
 alongside the 6.0 graduation.
 
+* The `groovy-toml` module -- introduced as an incubating module in
+Groovy 4.0 -- is *promoted out of incubation in Groovy 6.0*
+(https://issues.apache.org/jira/browse/GROOVY-12010[GROOVY-12010]).
+Its public API is now covenanted and subject to binary-compatibility
+checks.
+
 [[g6-extensions]]
 == Extension method additions and improvements
 
@@ -1792,12 +1798,27 @@ def config = new XmlParser().parseTextAs(ServerConfig, xml)
 | --
 |===
 
-NOTE: For CSV, TOML, YAML, and XML, the `parseTextAs`/`parseAs` methods use
+[NOTE]
+====
+For CSV, TOML, YAML, and XML, the `parseTextAs`/`parseAs` methods use
 Jackson databinding and support `@JsonProperty`, `@JsonFormat`, etc.
 For simple cases, Groovy's `as` coercion works without Jackson.
 For XML, `jackson-dataformat-xml` can be used directly for full
 Jackson XML annotation support.
 
+The typed parse/write paths for CSV, TOML and YAML support `java.time`
+types -- `LocalDate`, `LocalTime`, `LocalDateTime` and `OffsetDateTime`
+-- with `OffsetDateTime` retaining its original zone offset rather than
+being normalised to UTC
+(https://issues.apache.org/jira/browse/GROOVY-12010[GROOVY-12010],
+https://issues.apache.org/jira/browse/GROOVY-12011[GROOVY-12011],
+https://issues.apache.org/jira/browse/GROOVY-12012[GROOVY-12012]).
+Date and time values (including legacy `java.util.Date`/`Calendar`) are
+written as ISO-8601 strings, not numeric timestamps. The *untyped*
+slurper path (`parseText`/`parse`) returns temporal values as `String`;
+use the typed `parseAs`/`parseTextAs` API for `java.time` fidelity.
+====
+
 [[xml-processing]]
 == XML Processing Improvements