Skip to content

Commit 5e21853

Browse files
xiazcyxiazcy
committed
TinkerPop 3.8.1 release
1 parent 646c035 commit 5e21853

54 files changed

Lines changed: 113 additions & 92 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎CHANGELOG.asciidoc‎

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ under the License.
2323
image::https://raw.githubusercontent.com/apache/tinkerpop/master/docs/static/images/gremlin-67.png[width=185]
2424
2525
[[release-3-8-1]]
26-
=== TinkerPop 3.8.1 (NOT OFFICIALLY RELEASED YET)
26+
=== TinkerPop 3.8.1 (Release Date: April 1, 2026)
2727
2828
This release also includes changes from <<release-3-7-6, 3.7.6>>.
2929
@@ -38,6 +38,29 @@ This release also includes changes from <<release-3-7-6, 3.7.6>>.
3838
* Improved Gremlint formatting to do greedy argument packing when possible so that more arguments can appear on a single line.
3939
* Add custom type writer and serializer to gremlin-go
4040
41+
==== Bugs
42+
43+
* TINKERPOP-3214 TinkerGraph VertexProperty Id duplication
44+
* TINKERPOP-3218 Emit before repeat with barrier doesn't emit
45+
* TINKERPOP-3222 ReservedKeysVerificationStrategy verification fails when the invalid AddPropertyStep has an explicit cardinality set
46+
* TINKERPOP-3223 Argument to SubgraphStrategy.Builder.edges changes semantics when used along vertices
47+
* TINKERPOP-3230 GraphSON3 deserializer doesn't check for required meta field
48+
* TINKERPOP-3235 mergeE argument validation for onCreate overrides
49+
50+
==== Improvements
51+
52+
* TINKERPOP-2992 Gherkin suite missing orderability on set, uuid, date
53+
* TINKERPOP-3178 Clarify choose() with consistent semantics *(breaking)*
54+
* TINKERPOP-3210 cap() has strange interactions with barriers and side effects in OLAP
55+
* TINKERPOP-3213 Re-use connections for sessions
56+
* TINKERPOP-3217 Add mechanism to close session without closing connection on server
57+
* TINKERPOP-3219 Add public serialization API in gremlin-go for alternative transport protocols
58+
* TINKERPOP-3227 Add upgrade documentation for transaction connection reuse
59+
* TINKERPOP-3231 Optimize P.setValue() and P.getValue()
60+
* TINKERPOP-3232 Support deserialization of a set that has a non hashable element
61+
* TINKERPOP-3236 Limit use of FloatLiteral as step arguments in grammar
62+
* TINKERPOP-3237 Add Custom Type Writer/Serializer API for gremlin-go
63+
4164
[[release-3-8-0]]
4265
=== TinkerPop 3.8.0 (Release Date: November 12, 2025)
4366

‎docs/src/dev/developer/release.asciidoc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -217,7 +217,7 @@ current release was under development as this new release will have those change
217217
.. Manually update the `__version__` for `gremlin-python` in `gremlin-python/src/main/python/gremlin_python/__init__.py`
218218
. `mvn clean install -DskipTests` to update GLV versions
219219
.. Review `Gremlin.Net.csproj`, `Gremlin.Net.Template.csproj` and `Gremlin.Net.Template.nuspec` in `gremlin-dotnet`
220-
.. Review `package.json` and `package-lock.json` in `gremlin-javascript` and in `gremlint`
220+
.. Review `package.json` and `package-lock.json` in `gremlin-javascript`, `gremlint`, and `gremlin-mcp`
221221
. `pushd gremlin-console/bin; ln -fs ../target/apache-tinkerpop-gremlin-console-xx.yy.zz-standalone/bin/gremlin.sh gremlin.sh; popd`
222222
. `git diff` and review the updated files
223223
. `mvn clean install` - need to build first so that the right version of the console is used with `bin/publish-docs.sh`

‎docs/src/reference/gremlin-variants.asciidoc‎

Lines changed: 34 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1424,6 +1424,40 @@ Connection Pool Status (size=1 max=5 min=1 toCreate=0 bin=0)
14241424
-- bin --
14251425
----
14261426
1427+
[[gremlin-java-differences]]
1428+
=== Differences
1429+
1430+
Gremlin-Java provides additional syntactic sugar that leverages Java's type system for the `P.typeOf()` predicate,
1431+
which accepts Java `Class` objects directly, providing a more natural way to perform type checking:
1432+
1433+
[gremlin-groovy,modern]
1434+
----
1435+
// Java-specific syntax using Class objects
1436+
g.V().values("age").is(P.typeOf(Integer.class))
1437+
g.V().values("name").is(P.typeOf(String.class))
1438+
1439+
// Further simplification with Groovy sugar syntax
1440+
g.E().has("weight", P.typeOf(Double))
1441+
----
1442+
1443+
This is equivalent to using `GType` enums. Other Gremlin language variants must use the canonical `GType` enum approach:
1444+
1445+
[gremlin-groovy,modern]
1446+
----
1447+
// Canonical syntax available in all languages
1448+
g.V().values("age").is(P.typeOf(GType.INT))
1449+
g.V().values("name").is(P.typeOf(GType.STRING))
1450+
----
1451+
1452+
Any valid Java class accepted in the Console and with embedded Java is also accepted by `P.typeOf()`, as they are not
1453+
restricted by the grammar or serialization.
1454+
[gremlin-groovy,modern]
1455+
----
1456+
// Using java.awt.Color for example
1457+
g.inject(java.awt.Color.red)
1458+
g.inject(java.awt.Color.red, "hi", 123).is(P.typeOf(java.awt.Color))
1459+
----
1460+
14271461
anchor:java-application-examples[]
14281462
anchor:gremlin-archetypes[]
14291463
[[gremlin-java-archetypes]]
@@ -1511,40 +1545,6 @@ java -cp target/run-examples-shaded.jar examples.BasicGremlin
15111545
java -cp target/run-examples-shaded.jar examples.ModernTraversals
15121546
----
15131547
1514-
[[gremlin-java-differences]]
1515-
=== Differences
1516-
1517-
Gremlin-Java provides additional syntactic sugar that leverages Java's type system for the `P.typeOf()` predicate,
1518-
which accepts Java `Class` objects directly, providing a more natural way to perform type checking:
1519-
1520-
[gremlin-groovy,modern]
1521-
----
1522-
// Java-specific syntax using Class objects
1523-
g.V().values("age").is(P.typeOf(Integer.class))
1524-
g.V().values("name").is(P.typeOf(String.class))
1525-
1526-
// Further simplification with Groovy sugar syntax
1527-
g.E().has("weight", P.typeOf(Double))
1528-
----
1529-
1530-
This is equivalent to using `GType` enums. Other Gremlin language variants must use the canonical `GType` enum approach:
1531-
1532-
[gremlin-groovy,modern]
1533-
----
1534-
// Canonical syntax available in all languages
1535-
g.V().values("age").is(P.typeOf(GType.INT))
1536-
g.V().values("name").is(P.typeOf(GType.STRING))
1537-
----
1538-
1539-
Any valid Java class accepted in the Console and with embedded Java is also accepted by `P.typeOf()`, as they are not
1540-
restricted by the grammar or serialization.
1541-
[gremlin-groovy,modern]
1542-
----
1543-
// Using java.awt.Color for example
1544-
g.inject(java.awt.Color.red)
1545-
g.inject(java.awt.Color.red, "hi", 123).is(P.typeOf(java.awt.Color))
1546-
----
1547-
15481548
[[gremlin-javascript]]
15491549
== Gremlin-JavaScript
15501550

‎docs/src/upgrade/release-3.8.0.asciidoc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1556,7 +1556,7 @@ See: link:https://issues.apache.org/jira/browse/TINKERPOP-3168[TINKERPOP-3168]
15561556
15571557
==== Graph System Providers
15581558
1559-
==== Type Predicate
1559+
===== Type Predicate
15601560
15611561
The P.typeOf(String) predicate accepts custom type names registered in the `GlobalTypeCache`. Unregistered strings will
15621562
throw an `IllegalArgumentException` upon execution. Providers who wish to enable type comparison with custom data types

‎docs/src/upgrade/release-3.8.1.asciidoc‎

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ under the License.
1818
////
1919
== TinkerPop 3.8.1
2020
21-
*Release Date: NOT OFFICIALLY RELEASED YET*
21+
*Release Date: April 1, 2026*
2222
2323
Please see the link:https://github.com/apache/tinkerpop/blob/3.8.1/CHANGELOG.asciidoc#release-3-8-1[changelog] for a
2424
complete list of all the modifications that are part of this release.
@@ -140,5 +140,3 @@ New Gherkin test tags have been added for scenarios that require the graph to su
140140
the relevant tags in their `@CucumberOptions`. The full list of tags can be found
141141
link:https://tinkerpop.apache.org/docs/3.8.1/dev/developer/#gherkin-tags[here].
142142
143-
==== Graph Driver Providers
144-

‎gremlin-annotations/pom.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ limitations under the License.
2121
<parent>
2222
<artifactId>tinkerpop</artifactId>
2323
<groupId>org.apache.tinkerpop</groupId>
24-
<version>3.8.1-SNAPSHOT</version>
24+
<version>3.8.1</version>
2525
</parent>
2626

2727
<artifactId>gremlin-annotations</artifactId>

‎gremlin-archetype/gremlin-archetype-dsl/pom.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ limitations under the License.
2121
<parent>
2222
<groupId>org.apache.tinkerpop</groupId>
2323
<artifactId>gremlin-archetype</artifactId>
24-
<version>3.8.1-SNAPSHOT</version>
24+
<version>3.8.1</version>
2525
</parent>
2626

2727
<artifactId>gremlin-archetype-dsl</artifactId>

‎gremlin-archetype/gremlin-archetype-server/pom.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ limitations under the License.
2121
<parent>
2222
<groupId>org.apache.tinkerpop</groupId>
2323
<artifactId>gremlin-archetype</artifactId>
24-
<version>3.8.1-SNAPSHOT</version>
24+
<version>3.8.1</version>
2525
</parent>
2626

2727
<artifactId>gremlin-archetype-server</artifactId>

‎gremlin-archetype/gremlin-archetype-tinkergraph/pom.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ limitations under the License.
2121
<parent>
2222
<groupId>org.apache.tinkerpop</groupId>
2323
<artifactId>gremlin-archetype</artifactId>
24-
<version>3.8.1-SNAPSHOT</version>
24+
<version>3.8.1</version>
2525
</parent>
2626

2727
<artifactId>gremlin-archetype-tinkergraph</artifactId>

‎gremlin-archetype/pom.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ limitations under the License.
2121
<parent>
2222
<artifactId>tinkerpop</artifactId>
2323
<groupId>org.apache.tinkerpop</groupId>
24-
<version>3.8.1-SNAPSHOT</version>
24+
<version>3.8.1</version>
2525
</parent>
2626

2727
<artifactId>gremlin-archetype</artifactId>

0 commit comments

Comments
 (0)