You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tinkerpop.apache.org by xi...@apache.org on 2025/05/12 23:49:20 UTC
(tinkerpop) branch 3.8-dev updated: CTR update docs for changes to multiple `by()` modulators for certain steps.
This is an automated email from the ASF dual-hosted git repository.
xiazcy pushed a commit to branch 3.8-dev
in repository https://gitbox.apache.org/repos/asf/tinkerpop.git
The following commit(s) were added to refs/heads/3.8-dev by this push:
new 12aa078b38 CTR update docs for changes to multiple `by()` modulators for certain steps.
12aa078b38 is described below
commit 12aa078b3887f6a6c92b7a21a23efc42ceb31779
Author: xiazcy <xi...@gmail.com>
AuthorDate: Mon May 12 16:49:13 2025 -0700
CTR update docs for changes to multiple `by()` modulators for certain steps.
---
CHANGELOG.asciidoc | 5 +----
docs/src/upgrade/release-3.8.x.asciidoc | 9 ++++++---
2 files changed, 7 insertions(+), 7 deletions(-)
diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc
index d3100c5c8a..48866594bf 100644
--- a/CHANGELOG.asciidoc
+++ b/CHANGELOG.asciidoc
@@ -25,7 +25,6 @@ image::https://raw.githubusercontent.com/apache/tinkerpop/master/docs/static/ima
This release also includes changes from <<release-3-7-XXX, 3.7.XXX>>.
-* Changed aggregate step to not allow multiple by modulators.
* Added UUID() + UUID(value) to grammar
* Modified `TraversalStrategy` construction in Javascript where configurations are now supplied as a `Map` of options.
* Fixed bug in GraphSON v2 and v3 where full round trip of `TraversalStrategy` implementations was failing.
@@ -67,8 +66,7 @@ This release also includes changes from <<release-3-7-XXX, 3.7.XXX>>.
* Added and made `OffsetDateTime` serializers the default for existing date types in Python, Go, JavaScript, and .NET. `Date` is only used to deserialize from server.
* Added missing strategies in `gremlin-go`, updated certain strategies to take varargs and updated `GoTranslatorVisitor` for corresponding translations.
* Fixed `BigInt` and `BigDecimal` parsing in `gremlin-go` cucumber test suite, fixed `UnscaledValue` type in `BigDecimal` struct and added `ParseBigDecimal` method.
-* Added validation to `valueMap()`/`propertyMap()`/`groupCount()` to prevent an invalid usage of multiple `by()` modulators.
-* Added validation to `groupCount()`, `sack()` and `dedup()` to prevent an invalid usage of multiple `by()` modulators.
+* Added validation to `valueMap()`, `propertyMap()`, `groupCount()`, `sack()`, `dedup()`, `sample()`, and `aggregate()` to prevent the invalid usage of multiple `by()` modulators.
* Deprecated `ProcessLimitedStandardSuite` and `ProcessLimitedComputerSuite` in favor of `ProcessEmbeddedStandardSuite` and `ProcessEmbeddedComputerSuite` respectively.
* Deprecated `ProcessStandardSuite` and the `ProcessComputerSuite` in favor of Gherkin testing and the `ProcessEmbeddedStandardSuite` and `ProcessEmbeddedComputerSuite` for testing JVM-specific Gremlin behaviors.
* Removed lambda oriented Gremlin testing from Gherkin test suite.
@@ -84,7 +82,6 @@ image::https://raw.githubusercontent.com/apache/tinkerpop/master/docs/static/ima
[[release-3-7-4]]
=== TinkerPop 3.7.4 (NOT OFFICIALLY RELEASED YET)
-* Changed sample step to not allow multiple by modulators.
* Added log entry in `WsAndHttpChannelizerHandler` to catch general errors that escape the handlers.
* Added a `MessageSizeEstimator` implementation to cover `Frame` allowing Gremlin Server to better estimate message sizes for the direct buffer.
* Improved logging around triggers of the `writeBufferHighWaterMark` so that they occur more than once but do not excessively fill the logs.
diff --git a/docs/src/upgrade/release-3.8.x.asciidoc b/docs/src/upgrade/release-3.8.x.asciidoc
index 42405cb098..0ff2596db1 100644
--- a/docs/src/upgrade/release-3.8.x.asciidoc
+++ b/docs/src/upgrade/release-3.8.x.asciidoc
@@ -303,13 +303,16 @@ The previous behavior attempted to round-robin the by() but this wasn't possible
See: link:https://issues.apache.org/jira/browse/TINKERPOP-2974[TINKERPOP-2974]
-==== groupCount() By Modulation Semantics
+==== groupCount(), dedup(), sack(), sample(), aggregate() By Modulation Semantics
-The `groupCount()` step has been changed to throw an error if multiple `by()` modulators are applied. The previous
-behavior would ignore previous `by()` modulators and apply the last one, which was not intuitive.
+The `groupCount()`, `dedup()`, `sack()`, `sample()`, and `aggregate()` steps has been changed to throw an error if
+multiple `by()` modulators are applied. The previous behavior would ignore previous `by()` modulators and apply the
+last one, which was not intuitive.
See: link:https://issues.apache.org/jira/browse/TINKERPOP-3121[TINKERPOP-3121]
+==== Additional By Modulation Semantics
+
=== Upgrading for Providers
==== Graph System Providers