Merge branch 'tp32' into tp33
[tinkerpop.git] / CHANGELOG.asciidoc
1 ////
2 Licensed to the Apache Software Foundation (ASF) under one or more
3 contributor license agreements.  See the NOTICE file distributed with
4 this work for additional information regarding copyright ownership.
5 The ASF licenses this file to You under the Apache License, Version 2.0
6 (the "License"); you may not use this file except in compliance with
7 the License.  You may obtain a copy of the License at
8
9   http://www.apache.org/licenses/LICENSE-2.0
10
11 Unless required by applicable law or agreed to in writing, software
12 distributed under the License is distributed on an "AS IS" BASIS,
13 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 See the License for the specific language governing permissions and
15 limitations under the License.
16 ////
17 = TinkerPop3 CHANGELOG
18
19 == TinkerPop 3.3.0 (Gremlin Symphony #40 in G Minor)
20
21 image::https://raw.githubusercontent.com/apache/tinkerpop/master/docs/static/images/gremlin-mozart.png[width=185]
22
23 [[release-3-3-2]]
24 === TinkerPop 3.3.2 (Release Date: NOT OFFICIALLY RELEASED YET)
25
26 This release also includes changes from <<release-3-2-8, 3.2.8>>.
27
28 * Fixed regression issue where the HTTPChannelizer doesn't instantiate the specified AuthenticationHandler
29 * Defaulted GLV tests for gremlin-python to run for GraphSON 3.0.
30 * In gremlin-python, the GraphSON 3.0 `g:Set` type is now deserialized to `List`.
31
32 [[release-3-3-1]]
33 === TinkerPop 3.3.1 (Release Date: December 17, 2017)
34
35 This release also includes changes from <<release-3-2-7, 3.2.7>>.
36
37 * Added `NoneStep` and `Traversal.none()` for full filtering integration with `iterate()`.
38 * Fixed bug in serialization of `Path` for GraphSON 3.0 in `gremlin-python`.
39 * Added support for GraphSON 3.0 in Gremlin.Net.
40 * Added `math()`-step which supports scientific calculator capabilities for numbers within a traversal.
41 * Added missing `GraphTraversalSource.addE()`-method to `GremlinDslProcessor`.
42 * Changed `to()` and `from()` traversal-based steps to take a wildcard `?` instead of of `E`.
43 * Added `addV(traversal)` and `addE(traversal)` so that created element labels can be determined dynamically.
44 * `PageRankVertexProgram` supports `maxIterations` but will break out early if epsilon-based convergence occurs.
45 * Added support for epsilon-based convergence in `PageRankVertexProgram`.
46 * Fixed two major bugs in how PageRank was being calculated in `PageRankVertexProgram`.
47 * Added `Io.requiresVersion(Object)` to allow graph providers a way to check the `Io` type and version being constructed.
48 * Defaulted `IoCore.gryo()` and `IoCore.graphson()` to both use their 3.0 formats which means that `Graph.io()` will use those by default.
49 * Bumped Neo4j 3.2.3
50
51 ==== Bugs
52
53 * TINKERPOP-1773 Lop should be created as a "software" and not a "person"
54 * TINKERPOP-1783 PageRank gives incorrect results for graphs with sinks *(breaking)*
55 * TINKERPOP-1799 Failure to serialize path() in gremlin-python
56 * TINKERPOP-1847 tinkergraph-gremlin dependency on gremlin-test, bad scope?
57
58 ==== Improvements
59
60 * TINKERPOP-1632 Create a set of default functions
61 * TINKERPOP-1692 Bump to Neo4j 3.2.3
62 * TINKERPOP-1717 Update name and link of DynamoDB storage backend in landing page
63 * TINKERPOP-1730 Gremlin .NET support for GraphSON 3.0
64 * TINKERPOP-1767 Method for graph providers to check an IO version and type
65 * TINKERPOP-1793 addE() should allow dynamic edge labels
66 * TINKERPOP-1834 Consider iterate() as a first class step
67
68 [[release-3-3-0]]
69 === TinkerPop 3.3.0 (Release Date: August 21, 2017)
70
71 This release also includes changes from <<release-3-2-6, 3.2.6>>.
72
73 * Removed previously deprecated `ScriptElementFactory`.
74 * Added `GraphTraversalSource.addE(String)` in support of `g.addE().from().to()`.
75 * Added support for `to(Vertex)` and `from(Vertex)` as a shorthand for `to(V(a))` and `from(V(b))`.
76 * Bumped to support Spark 2.2.0.
77 * Detected if type checking was required in `GremlinGroovyScriptEngine` and disabled related infrastructure if not.
78 * Removed previously deprecated `GraphTraversal.selectV3d0()` step.
79 * Removed previously deprecated `DetachedEdge(Object,String,Map,Pair,Pair)` constructor.
80 * Removed previously deprecated `Bindings` constructor. It is now a private constructor.
81 * Removed previously deprecated `TraversalSource.withBindings()`.
82 * Removed previously deprecated `GraphTraversal.sack(BiFunction,String)`.
83 * `TraversalMetrics` and `Metrics` Gryo 1.0 formats changed given internal changes to their implementations.
84 * Made `TraversalMetrics` safe to write to from multiple threads.
85 * Removed previously deprecated `TraversalSideEffects` methods.
86 * Removed previously deprecated `finalization.LazyBarrierStrategy` (moved to `optimization.LazyBarrierStrategy`).
87 * Removed previously deprecated `Constants` in Hadoop.
88 * Removed previously deprecated `VertexComputing.generateComputer(Graph)`.
89 * Removed previously deprecated `ConfigurationTraversal`.
90 * Established the Gryo 3.0 format.
91 * `GryoVersion` now includes a default `ClassResolver` to supply to the `GryoMapper`.
92 * `GryoClassResolver` renamed to `GryoClassResolverV1d0` which has an abstract class that for providers to extend in `AbstractGryoClassResolver`.
93 * Removed previously deprecated `Order` enums of `keyIncr`, `keyDecr`, `valueIncr`, and `valueDecr.`
94 * Removed previously deprecated `GraphTraversal.mapKeys()` step.
95 * Removed previously deprecated `GraphTraversal.mapValues()` step.
96 * Removed previously deprecated `GraphTraversal#addV(Object...)`.
97 * Removed previously deprecated `GraphTraversal#addE(Direction, String, String, Object...)`.
98 * Removed previously deprecated `GraphTraversal#addOutE(String, String, Object...)`.
99 * Removed previously deprecated `GraphTraversal#addInV(String, String, Object...)`.
100 * Removed previously deprecated `GraphTraversal.groupV3d0()` and respective `GroupSideEffectStepV3d0` and `GroupStepV3d0`.
101 * Removed previously deprecated `TraversalSource.Builder` class.
102 * Removed previously deprecated `ConnectiveP`, `AndP`, `OrP` constructors.
103 * Removed previously deprecated `TraversalScriptFunction` class.
104 * Removed previously deprecated `TraversalScriptHelper` class.
105 * Removed previously deprecated `ScriptEngineCache` class.
106 * Removed previously deprecated `CoreImports` class.
107 * Removed previously deprecated `GremlinJythonScriptEngine#()` constructor.
108 * Removed access to previously deprecated `CoreGremlinPlugin#INSTANCE` field.
109 * `gremlin.sh` and `gremln.bat` no longer support the option to pass a script as an argument for execution mode without using the `-i` option.
110 * Graphite and Ganglia are no longer packaged with the Gremlin Server distribution.
111 * `TransactionException` is no longer a class of `AbstractTransaction` and it extends `RuntimeException`.
112 * Included an ellipse on long property names that are truncated.
113 * Renamed `RangeByIsCountStrategy` to `CountStrategy`.
114 * Added more specific typing to various `__` traversal steps. E.g. `<A,Vertex>out()` is `<Vertex,Vertex>out()`.
115 * Updated Docker build scripts to include Python dependencies (NOTE: users should remove any previously generated TinkerPop Docker images).
116 * Added "attachment requisite" `VertexProperty.element()` and `Property.element()` data in GraphSON serialization.
117 * GraphSON 3.0 is now the default serialization format in TinkerGraph and Gremlin Server.
118 * Changed `ServerGremlinExecutor` to not use generics since there really is no flexibility in the kind of `ScheduledExecutorService` that will be used.
119 * Removed support for passing a byte array on the `sasl` parameter.
120 * Removed previously deprecated `GraphSONMapper$Builder#embedTypes` option.
121 * Removed previously deprecated `:remote config timeout max`.
122 * Removed previously deprecated `ConnectionPoolSettings.sessionId` and `ConnectionPoolSettings.optionalSessionId()`.
123 * Removed previously deprecated `reconnectInitialDelay` setting from the Java driver.
124 * Removed previously deprecated `useMapperFromGraph` option.
125 * Established the GraphSON 3.0 format with new `g:Map`, `g:List` and `g:Set` types.
126 * Removed previously deprecated `Io.Builder#registry(IoRegistry)` method.
127 * Removed previously deprecated `GryoMessageSerializerV1d0(GryoMapper)` constructor.
128 * Removed previously deprecated `TinkerIoRegistry`.
129 * Removed previously deprecated `getInstance()` methods on all TinkerPop classes.
130 * Removed previously deprecated `VertexPropertyFeatures.supportsAddProperty()`.
131 * Removed previously deprecated TinkerGraph configuration member variables.
132 * Removed previously deprecated `Transaction.submit(Function)`.
133 * Removed previously deprecated `OpSelectorHandler.errorMeter` and `AbstractEvalOpProcessor.errorMeter` fields.
134 * Removed previously deprecated `AbstractEvalOpProcessor.validBindingName` field.
135 * Removed previously deprecated `SimpleAuthenticator.CONFIG_CREDENTIALS_LOCATION` field.
136 * Removed previously deprecated `IteratorHandler`, `NioGremlinResponseEncoder` and `WsGremlinResponseEncoder` classes.
137 * Removed previously deprecated `Session.kill()` and `Session.manualKill()`.
138 * Removed previously deprecated `Authenticator.newSaslNegotiator()` and its method implementations in classes that were assignable to that interface.
139 * Removed `gremlin-groovy-test`.
140 * Removed previously deprecated "G" functions in `gremlin-groovy` (i.e. `GFunction`).
141 * Removed references to the old `GremlinPlugin` system that was in `gremlin-groovy` - the revised `GremlinPlugin` system in `gremlin-core` is the only one now in use.
142 * `GremlinGroovyScriptEngine` no longer implements the now removed `DependencyManager`.
143 * Added `Vertex`, `Edge`, `VertexProperty`, and `Property` serializers to Gremlin-Python and exposed tests that use graph object arguments.
144 * `Bytecode.getSourceInstructions()` and `Bytecode.getStepInstructions()` now returns `List<Instruction>` instead of `Iterable<Instruction>`.
145 * Added various `TraversalStrategy` registrations with `GryoMapper`.
146 * Fixed a naming mistake in Gremlin-Python: `IdentityRemoveStrategy` is now called `IdentityRemovalStrategy`.
147 * Added `TranslationStrategy` test infrastructure that verifies `Bytecode` generated from a translation is equal to the original `Bytecode`.
148 * Moved `NumberHelper` into the `org.apache.tinkerpop.gremlin.util` package.
149 * Added `Pop.mixed` instead of using `null` to represent such semantics.
150 * `select()`-step now defaults to using `Pop.last` instead of `Pop.mixed`.
151 * Added `gremlin-io-test` module to validate IO formats.
152 * `RequestMessage` and `ResponseMessage` are now registered with `GryoMapper` as part of the TinkerPop range of type identifiers.
153 * Removed previously deprecated `Console` constructor that took a `String` as an argument from `gremlin-console`.
154 * Removed previously deprecated `ConcurrentBindings` from `gremlin-groovy`.
155 * Removed previously deprecated `ScriptExecutor` from `gremlin-groovy`.
156 * Removed previously deprecated `SandboxExtension` from `gremlin-groovy`.
157 * Removed previously deprecated `GremlinGroovyScriptEngine` constructor that took `ImportCustomizerProvider` as an argument from `gremlin-groovy`.
158 * Removed previously deprecated `GremlinGroovyScriptEngine#plugins()` from `gremlin-groovy`.
159 * Added `OptionalStep` for use with `optional()` to better handle issues associated with branch side-effects.
160 * `UnfoldStep` now supports unfolding of arrays.
161 * Removed all performance tests that were not part of `gremlin-benchmark`.
162 * Removed dependency on `junit-benchmarks` and it's related reference to `h2`.
163 * Moved the source for the "home page" into the repository under `/site` so that it easier to accept contributions.
164 * Added `UnshadedKryoShimService` as the new default serializer model for `SparkGraphComputer`.
165 * `GryoRegistrator` is more efficient than the previous `GryoSerializer` model in `SparkGraphComputer`.
166 * Added support for `IoRegistry` custom serialization in Spark/Giraph and provided a general `hadoop-gremlin` test suite.
167 * Replaced term `REST` with `HTTP` to remove any confusion as to the design of the API.
168 * Moved `gremlin-benchmark` under `gremlin-tools` module.
169 * Added `gremlin-tools` and its submodule `gremlin-coverage`.
170 * Removed `tryRandomCommit()` from `AbstractGremlinTest`.
171 * Changed `gremlin-benchmark` system property for the report location to `benchmarkReportDir` for consistency.
172 * Added SysV and systemd init scripts.
173 * `GraphTraversal.valueMap(includeTokens,propertyKeys...)` now returns a `Map<Object,E>` since keys could be `T.id` or `T.label`.
174 * Added `skip(long)` and `skip((Scope,long)` which call the `range(low,high)` equivalents with -1 as the high.
175 * Added Kerberos authentication to `gremlin-server` for websockets and nio transport.
176 * Added audit logging of authenticated users and gremlin queries to `gremlin-server`.
177
178 ==== Bugs
179
180 * TINKERPOP-1211 UnfoldStep should unfold arrays. *(breaking)*
181 * TINKERPOP-1426 GryoSerializer should implement Java serialization interface
182 * TINKERPOP-1465 Remove deprecated newSaslNegotiator *(breaking)*
183 * TINKERPOP-1483 PropertyMapStep returns Map<String,E> but puts non String keys in it!
184 * TINKERPOP-1520 Difference between 'has' step generated graphson2.0 in java and python glv implementation
185 * TINKERPOP-1533 Storage and IoRegistry
186 * TINKERPOP-1597 PathRetractionStrategy messing up certain traversals
187 * TINKERPOP-1635 gremlin-python: Duplicate serialization of element property in PropertySerializer
188 * TINKERPOP-1658 Graphson2 map keys are serialised as strings
189 * TINKERPOP-1716 Traversal strategies are not applied with remote in Gremlin Console
190
191 ==== Improvements
192
193 * TINKERPOP-832 Remove deprecated addV/E/InE/OutE methods *(breaking)*
194 * TINKERPOP-833 Remove deprecated GremlinGroovyScriptEngine constructor and plugins() *(breaking)*
195 * TINKERPOP-834 Remove deprecated sack() method *(breaking)*
196 * TINKERPOP-880 Remove deprecated GroupStepV3d0 and GroupSideEffectStepV3d0 *(breaking)*
197 * TINKERPOP-929 Remove Deprecated TinkerGraph public static methods. *(breaking)*
198 * TINKERPOP-980 Add a service script or daemon mode in the distribution *(breaking)*
199 * TINKERPOP-999 ServerGremlinExecutor construction need not use generics for ExecutorService *(breaking)*
200 * TINKERPOP-1004 Make Transaction.commit() failures consistent across implementations. *(breaking)*
201 * TINKERPOP-1010 Remove deprecated credentialsDbLocation for SimpleAuthenticator *(breaking)*
202 * TINKERPOP-1024 Remove deprecated tryRandomCommit() *(breaking)*
203 * TINKERPOP-1028 Remove deprecated ConnectionPoolSettings session settings *(breaking)*
204 * TINKERPOP-1040 Remove deprecated SandboxExtension *(breaking)*
205 * TINKERPOP-1046 Remove deprecated Gremlin Server handler implementations *(breaking)*
206 * TINKERPOP-1049 Remove deprecated error meter member variables in Gremlin Server handlers *(breaking)*
207 * TINKERPOP-1094 Remove deprecated VertexPropertyFeatures.FEATURE_ADD_PROPERTY *(breaking)*
208 * TINKERPOP-1116 Some anonymous traversal steps can be hard typed. *(breaking)*
209 * TINKERPOP-1130 Each release should store Kryo/GraphSON/GraphML versions to ensure future compatibility *(breaking)*
210 * TINKERPOP-1142 Remove deprecated valueIncr, valueDecr, keyIncr, keyDecr. *(breaking)*
211 * TINKERPOP-1169 Remove deprecated TraversalScriptFunction and TraversalScriptHelper *(breaking)*
212 * TINKERPOP-1170 Remove deprecated ConfigurationTraversal. *(breaking)*
213 * TINKERPOP-1171 Remove deprecated TraversalSource.Builder *(breaking)*
214 * TINKERPOP-1235 Remove deprecated ProcessPerformanceSuite and TraversalPerformanceTest *(breaking)*
215 * TINKERPOP-1275 Remove deprecated max setting for :remote *(breaking)*
216 * TINKERPOP-1283 Remove deprecated ScriptExecutor *(breaking)*
217 * TINKERPOP-1289 Remove deprecated ConnectiveP, AndP, and OrP constructors. *(breaking)*
218 * TINKERPOP-1291 Remove deprecated mapValues and mapKeys methods *(breaking)*
219 * TINKERPOP-1313 Rename RangeByIsCountStrategy *(breaking)*
220 * TINKERPOP-1316 Remove deprecated constructor from GryoMessageSerializers *(breaking)*
221 * TINKERPOP-1327 Bring GryoRegistrator to the forefront and deprecate GryoSerializer *(breaking)*
222 * TINKERPOP-1363 Cleanup Docker build script for next major release *(breaking)*
223 * TINKERPOP-1369 Replace REST API with HTTP API
224 * TINKERPOP-1389 Support Spark 2.0.0
225 * TINKERPOP-1399 NumberHelper needs to go into util and have a private constructor *(breaking)*
226 * TINKERPOP-1404 Path/label optimization
227 * TINKERPOP-1408 Remove Deprecated Io.Builder.registry() *(breaking)*
228 * TINKERPOP-1414 Change default GraphSON version to 3.0 *(breaking)*
229 * TINKERPOP-1420 Remove deprecated ConcurrentBindings in gremlin-groovy *(breaking)*
230 * TINKERPOP-1421 Remove deprecated ControlOps *(breaking)*
231 * TINKERPOP-1427 GraphSON 3.0 needs collection types and consistent number typing.
232 * TINKERPOP-1443 Use an API checker during build
233 * TINKERPOP-1445 Large nested VertexProperties and Properties do not get printed well
234 * TINKERPOP-1454 Create Serializers for Graph objects in Gremlin-Python
235 * TINKERPOP-1481 Remove deprecated reconnectInitialDelay in Java driver *(breaking)*
236 * TINKERPOP-1485 Move source for TinkerPop site to source code repo
237 * TINKERPOP-1506 Optional/Coalesce should not allow sideEffect traversals.
238 * TINKERPOP-1514 Restructure for gremlin-tools module *(breaking)*
239 * TINKERPOP-1524 Bytecode.getXXXInstructions should return a List, not Iterable.
240 * TINKERPOP-1526 Remove deprecated Session kill() overloads *(breaking)*
241 * TINKERPOP-1536 Include GLVs in Docker build
242 * TINKERPOP-1541 Select should default to Pop.last semantics *(breaking)*
243 * TINKERPOP-1549 Implement skip()
244 * TINKERPOP-1550 Make Graphite and Ganglia optional dependencies
245 * TINKERPOP-1563 Remove deprecated getInstance() methods *(breaking)*
246 * TINKERPOP-1565 Setup GraphSON 3.0
247 * TINKERPOP-1566 Kerberos authentication for gremlin-server
248 * TINKERPOP-1574 Get rid of untyped GraphSON in 3.0
249 * TINKERPOP-1603 Remove support for SASL byte array in protocol *(breaking)*
250 * TINKERPOP-1612 Remove gremlin-groovy-test module *(breaking)*
251 * TINKERPOP-1621 Remove deprecated GremlnPlugin and related infrastructure *(breaking)*
252 * TINKERPOP-1622 Remove deprecated G functions in gremlin-groovy *(breaking)*
253 * TINKERPOP-1651 Remove deprecated gremlin.sh init syntax *(breaking)*
254 * TINKERPOP-1686 Make TraversalMetrics thread safe *(breaking)*
255 * TINKERPOP-1698 Gryo 3.0
256 * TINKERPOP-1699 Remove deprecated userMapperFromGraph *(breaking)*
257 * TINKERPOP-1700 Remove deprecated embedTypes option
258 * TINKERPOP-1706 Remove deprecated ScriptEngineCache and related dead code *(breaking)*
259 * TINKERPOP-1715 Bump to Spark 2.2
260 * TINKERPOP-1719 Remove deprecated Traversal related code *(breaking)*
261 * TINKERPOP-1720 Remove deprecated Hadoop code *(breaking)*
262 * TINKERPOP-1721 Remove deprecated Bindings related code *(breaking)*
263 * TINKERPOP-1724 Remove deprecated ScriptElementFactory
264 * TINKERPOP-1729 Remove deprecated select steps.
265 * TINKERPOP-1740 Add vertex parameter overload to to() and from()
266 * TINKERPOP-1747 Streamline inheritance for gremlin-python GraphSON serializer classes
267
268 == TinkerPop 3.2.0 (Nine Inch Gremlins)
269
270 image::https://raw.githubusercontent.com/apache/tinkerpop/master/docs/static/images/nine-inch-gremlins.png[width=185]
271
272 [[release-3-2-8]]
273 === TinkerPop 3.2.8 (Release Date: NOT OFFICIALLY RELEASED YET)
274
275 * Added `checkAdjacentVertices` option to `SubgraphStrategy`.
276 * Modified `GremlinDslProcessor` so that it generated the `getAnonymousTraversalClass()` method to return the DSL version of `__`.
277 * Added the "Kitchen Sink" test data set.
278 * Added `idleConnectionTimeout` and `keepAliveInterval` to Gremlin Server that enables a "ping" and auto-close for seemingly dead clients.
279 * Fixed a bug in `NumberHelper` that led to wrong min/max results if numbers exceeded the Integer limits.
280 * Delayed setting of the request identifier until `RequestMessage` construction by the builder.
281 * `ReferenceElement` avoids `UnsupportedOperationException` handling in construction thus improving performance.
282 * Improved error messaging for failed serialization and deserialization of request/response messages.
283 * Removed hardcoded expectation in metrics serialization test suite as different providers may have different outputs.
284 * Added `IndexedTraverserSet` which indexes on the value of a `Traverser` thus improving performance when used.
285 * Utilized `IndexedTraverserSet` in `TraversalVertexProgram` to avoid extra iteration when doing `Vertex` lookups.
286 * Fixed a bug in Gremlin Console which prevented handling of `gremlin.sh` flags that had an "=" between the flag and its arguments.
287 * Fixed bug where `SparkMessenger` was not applying the `edgeFunction` from `MessageScope`.
288 * Fixed a bug in `ComputerAwareStep` that didn't handle `reset()` properly and thus occasionally produced some extra traversers.
289
290 [[release-3-2-7]]
291 === TinkerPop 3.2.7 (Release Date: December 17, 2017)
292
293 * Added core GraphSON classes for Gremlin-Python: `UUID`, `Date`, and `Timestamp`.
294 * Documented the recommended method for constructing DSLs with Gremlin.Net.
295 * Provided a method to configure detachment options with `EventStrategy`.
296 * Fixed a race condition in `TinkerIndex`.
297 * Fixed bug in handling of the long forms of `-e` and `-i` (`--execute` and `--interactive` respectively) for Gremlin Console.
298 * Fixed bug in `LambdaRestrictionStrategy` where traversals using `Lambda` scripts weren't causing the strategy to trigger.
299 * Improved error messaging for bytecode deserialization errors in Gremlin Server.
300 * Fixed an `ArrayOutOfBoundsException` in `hasId()` for the rare situation when the provided collection is empty.
301 * Bump to Netty 4.0.53
302 * `TraversalVertexProgram` `profile()` now accounts for worker iteration in `GraphComputer` OLAP.
303 * Returned the `Builder` instance from the `DetachedEdge.Builder` methods of `setOutE` and `setOutV`.
304 * Added test framework for GLVs.
305 * Fixed bug in `TraversalHelper.replaceStep()` where the step being replaced needed to be removed prior to the new one being added.
306 * Added alias support in the .NET `DriverRemoteConnection`.
307 * Added a test for self-edges and fixed `Neo4jVertex` to provided repeated self-edges on `BOTH`.
308 * Better respected permissions on the `plugins.txt` file and prevented writing if marked as read-only.
309 * Added getters for the lambdas held by `LambdaCollectingBarrierStep`, `LambdaFlatMapStep` and `LambdaSideEffectStep`.
310 * Fixed an old hack in `GroovyTranslator` and `PythonTranslator` where `Elements` were being mapped to their id only.
311 * Fixed an "attachement"-bug in `InjectStep` with a solution generalized to `StartStep`.
312 * Truncate the script in error logs and error return messages for "Method code too large" errors in Gremlin Server.
313 * Fixed a bug in `LambdaRestrictionStrategy` where it was too eager to consider a step as being a lambda step.
314 * `ReferenceVertex` was missing its `label()` string. `ReferenceElement` now supports all label handling.
315 * Fixed a bug where bytecode containing lambdas would randomly select a traversal source from bindings.
316 * Deprecated `GremlinScriptEngine.eval()` methods and replaced them with new overloads that include the specific `TraversalSource` to bind to.
317 * Added `GraphHelper.cloneElements(Graph original, Graph clone)` to the `gremlin-test` module to quickly clone a graph.
318 * Added `GremlinDsl.AnonymousMethod` annotation to help provide explicit types for anonymous methods when the types are not easily inferred.
319 * Bump to GMavenPlus 1.6.
320 * Added better error message for illegal use of `repeat()`-step.
321 * Fixed a bug in `RangeByIsCountStrategy` that led to unexpected behaviors when predicates were used with floating point numbers.
322 * Bump to Jackson 2.8.10.
323 * Deprecated `MutationListener.vertexPropertyChanged()` method that did not use `VertexProperty` and added a new method that does.
324 * Added an `EmbeddedRemoteConnection` so that it's possible to mimic a remote connection within the same JVM.
325 * Supported interruption for remote traversals.
326 * Allow the `:remote` command to accept a `Cluster` object defined in the console itself.
327 * The Console's `plugin.txt` file is only updated if there were manually uninstalled plugins.
328 * Fixed a bug in `MatchStep` where mid-traversal `where()` variables were not being considered in start-scope.
329 * Generalized `MatchStep` to locally compute all clauses with barriers (not just reducing barriers).
330 * Ensured that plugins were applied in the order they were configured.
331 * Fixed a bug in `Neo4jGremlinPlugin` that prevented it from loading properly in the `GremlinPythonScriptEngine`.
332 * Fixed a bug in `ComputerVerificationStrategy` where child traversals were being analyzed prior to compilation.
333 * Fixed a bug that prevented Gremlin from ordering lists and streams made of mixed number types.
334 * Fixed a bug where `keepLabels` were being corrupted because a defensive copy was not being made when they were being set by `PathRetractionStrategy`.
335 * Cancel script evaluation timeout in `GremlinExecutor` when script evaluation finished.
336 * Added a recipe for OLAP traversals with Spark on YARN.
337 * Added `spark-yarn` dependencies to the manifest of `spark-gremlin`.
338
339 ==== Bugs
340
341 * TINKERPOP-1650 PathRetractionStrategy makes Match steps unsolvable
342 * TINKERPOP-1731 Docker build does not appear to work for gremlin-dotnet
343 * TINKERPOP-1745 Gremlin .NET: Use DateTimeOffset instead of DateTime to represent g:Date
344 * TINKERPOP-1753 OrderStep not able to order by non-integer numbers
345 * TINKERPOP-1760 OLAP compilation failing around ConnectiveStrategy
346 * TINKERPOP-1761 GremlinExecutor: Timeout future not cancelled on successful script evaluation
347 * TINKERPOP-1762 Make MatchStep analyze mid-clause variables for executing ordering purposes.
348 * TINKERPOP-1764 Generalize MatchStep to localize all barriers, not just reducing barriers.
349 * TINKERPOP-1766 Gremlin.Net: Closed connections should not be re-used
350 * TINKERPOP-1782 RangeByIsCountStrategy doesn't handle floating point numbers properly
351 * TINKERPOP-1789 Reference elements should be represented by id and label *(breaking)*
352 * TINKERPOP-1790 GraphSON 3.0 doc updates
353 * TINKERPOP-1791 GremlinDsl custom step with generic end type produces invalid code in __.java
354 * TINKERPOP-1792 Random TraversalSource Selection in GremlinScriptEngine
355 * TINKERPOP-1795 Getting Lambda comparator message for .profile() step
356 * TINKERPOP-1796 Driver connection pool SSL properties missing
357 * TINKERPOP-1797 LambdaRestrictionStrategy and LambdaMapStep in `by()`-modulation.
358 * TINKERPOP-1798 MutationListener.vertexPropertyChanged oldValue should be a VertexProperty
359 * TINKERPOP-1801 OLAP profile() step return incorrect timing
360 * TINKERPOP-1802 hasId() fails for empty collections
361 * TINKERPOP-1803 inject() doesn't re-attach with remote traversals
362 * TINKERPOP-1819 documentation query and description mismatch
363 * TINKERPOP-1821 Consistent behavior of self-referencing edges
364 * TINKERPOP-1825 Gremlin .NET: Constant() step has incorrect parameter defined
365 * TINKERPOP-1830 Race condition in Tinkergraph index creation
366 * TINKERPOP-1832 TraversalHelper.replaceStep sets previousStep to the wrong step
367 * TINKERPOP-1846 LambdaRestrictionStrategy not triggering for Lambda scripts
368 * TINKERPOP-1848 Fix g:Date assertion in python tests
369 * TINKERPOP-1851 Gremlin long options for -e and -i are not working properly
370
371 ==== Improvements
372
373 * TINKERPOP-1661 Docker-built documentation does not always point locally
374 * TINKERPOP-1725 DotNet GLV: Make traversal generation deterministic
375 * TINKERPOP-1734 DSL for Gremlin .NET
376 * TINKERPOP-1746 Better error message on wrong ordering of emit()/until()/has()
377 * TINKERPOP-1752 Gremlin.Net: Generate completely type-safe methods
378 * TINKERPOP-1756 Provide a way to easily mock a RemoteConnection for tests
379 * TINKERPOP-1759 Improve hashcode and equals for Traverser implementations
380 * TINKERPOP-1768 Bump to Jackson 2.8.10
381 * TINKERPOP-1770 Remote traversal timeout
382 * TINKERPOP-1771 gremlin.bat doesn't support paths containing spaces
383 * TINKERPOP-1779 Bump to GMavenPlus 1.6
384 * TINKERPOP-1784 Gremlin Language Test Suite
385 * TINKERPOP-1785 Gremlin.Net should be strong-name signed
386 * TINKERPOP-1786 Recipe and missing manifest items for Spark on Yarn
387 * TINKERPOP-1787 Allow :remote command to accept a user defined Cluster instance
388 * TINKERPOP-1806 Consistently use Gremlin.Net instead of Gremlin-DotNet
389 * TINKERPOP-1807 Gremlin-Python doesn't support GraphSON types g:Date, g:Timestamp and g:UUID
390 * TINKERPOP-1808 Add ability to get the consumer in LambdaSideEffectStep
391 * TINKERPOP-1811 Improve error reporting for serialization errors between gremlin-python and gremlin-server
392 * TINKERPOP-1812 ProfileTest assumes that graph implementations will not add their own steps
393 * TINKERPOP-1813 Subgraph step requires the graph API
394 * TINKERPOP-1814 Some process tests require the graph API
395 * TINKERPOP-1820 Include .NET GLV tests on TravisCI
396 * TINKERPOP-1824 Update netty version to 4.0.52
397 * TINKERPOP-1827 Gremlin .NET: Test Suite Runner
398 * TINKERPOP-1829 Improve flexibility of detachment for EventStrategy
399 * TINKERPOP-1833 DetachedEdge.Builder#setInV and setOutV doesn't return the builder
400 * TINKERPOP-1835 Bump Netty 4.0.53
401 * TINKERPOP-1837 Gremlin .NET: Provide type coercion between IDictionary<K, V> instances
402
403 [[release-3-2-6]]
404 === TinkerPop 3.2.6 (Release Date: August 21, 2017)
405
406 This release also includes changes from <<release-3-1-8, 3.1.8>>.
407
408 * Bump to Netty 4.0.50
409 * Registered `HashMap$TreeNode` to Gryo.
410 * Fixed a lambda-leak in `SackValueStep` where `BiFunction` must be tested for true lambda status.
411 * Fixed a bug in `RangeByIsCountStrategy` that broke any `ConnectiveStep` that included a child traversal with an optimizable pattern.
412 * Allowed access to `InjectStep.injections` for `TraversalStrategy` analysis.
413 * Exceptions that occur during result iteration in Gremlin Server will now return `SCRIPT_EVALUATION_EXCEPTION` rather than `SERVER_ERROR`.
414 * `AddEdgeStep` attaches detached vertices prior to edge creation.
415 * Added graph element GraphSON serializers in Gremlin-Python.
416 * Initialization scripts for Gremlin Server will not timeout.
417 * Added Gremlin.Net.
418 * `ProfileTest` is now less stringent about assertions which will reduce burdens on providers.
419 * `GremlinExecutor` begins timeout of script evaluation at the time the script was submitted and not from the time it began evaluation.
420 * Added Gremlin.Net.
421 * `ReferenceFactory` and `DetachedFactory` now detach elements in collections accordingly.
422 * Deprecated `GryoLiteMessageSerializerV1d0` in favor of `HaltedTraverserStrategy`.
423 * Deprecated the `useMapperFromGraph` configuration option for Gremlin Server serializers.
424 * `JavaTranslator` is now smart about handling `BulkSet` and `Tree`.
425 * Added annotations to the traversal metrics pretty print.
426 * `EdgeOtherVertexStep` is no longer final and can be extended by providers.
427 * `EdgeVertexStep` is no longer final and can be extended by providers.
428 * Deprecated `Transaction.submit(Function)`.
429 * Fixed `HADOOP_GREMLIN_LIBS` parsing for Windows.
430 * Improved GraphSON serialization performance around `VertexProperty`.
431 * Changed some tests in `EventStrategyProcessTest` which were enforcing some unintended semantics around transaction state.
432 * Added WsAndHttpChannelizer and SaslAndHttpBasicAuthenticationHandler to be allow for servicing Http and Websocket requests to the same server
433 * Added deep copy of `Bytecode` to `DefaultTraversal.clone()`.
434
435 ==== Bugs
436
437 * TINKERPOP-1385 Refactor Profiling test cases
438 * TINKERPOP-1679 Detached side-effects aren't attached when remoted
439 * TINKERPOP-1683 AbstractHadoopGraphComputer on Windows
440 * TINKERPOP-1691 Some EventStrategyProcessTest assume element state is synced in memory
441 * TINKERPOP-1704 XXXTranslators are not being respective of BulkSet and Tree.
442 * TINKERPOP-1727 Bytecode object shallow copied when traversals are cloned
443 * TINKERPOP-1742 RangeByIsCountStrategy fails for ConnectiveSteps
444 * TINKERPOP-1743 LambdaRestrictionStrategy does not catch lambdas passed to sack()
445 * TINKERPOP-1744 Gremlin .NET: Exception from sync execution gets wrapped in AggregateException
446
447 ==== Improvements
448
449 * TINKERPOP-741 Remove Options For Transaction Retry
450 * TINKERPOP-915 Gremlin Server supports REST and Websockets simultanteously
451 * TINKERPOP-920 Test case needed for ensuring same cardinality for key.
452 * TINKERPOP-1552 C# Gremlin Language Variant
453 * TINKERPOP-1669 EdgeVertexStep should be designed for extension
454 * TINKERPOP-1676 Improve GraphSON 2.0 Performance  *(breaking)*
455 * TINKERPOP-1688 Include TraversalMetrics annotation in pretty print
456 * TINKERPOP-1694 Deprecate useMapperFromGraph
457 * TINKERPOP-1701 HaltedTraverserStrategy should recurse into collections for detachment.
458 * TINKERPOP-1703 Make EdgeOtherVertexStep non-final
459 * TINKERPOP-1708 Add a "Note on Scopes" document
460 * TINKERPOP-1709 Add a list of all the steps that support by()/from()/to()/as()/option()
461 * TINKERPOP-1710 Add a note on tree() by-modulation and uniqueness of tree branches.
462 * TINKERPOP-1714 Gremlin Server scriptEvaluationTimeout should take into account request arrival time
463 * TINKERPOP-1718 Deprecate GryoLiteMessageSerializerV1d0
464 * TINKERPOP-1748 Callout comments break code snippets
465 * TINKERPOP-1749 Bump to Netty 4.0.50
466
467 [[release-3-2-5]]
468 === TinkerPop 3.2.5 (Release Date: June 12, 2017)
469
470 This release also includes changes from <<release-3-1-7, 3.1.7>>.
471
472 * Fixed folding of multiple `hasId()` steps into `GraphStep`.
473 * Added string performance options to `StarGraph`.
474 * Fixed a bug in `until(predicate)` where it was actually calling `emit(predicate)`.
475 * Fixed inconsistency in GraphSON serialization of `Path` where properties of graph elements were being included when serialized.
476 * Improved performance and memory usage of GraphSON when serializing `TinkerGraph` and graph elements.
477 * Removed use of `stream()` in `DetachedEdge` and `DetachedVertex`.
478 * Deprecated a constructor in `DetachedEdge` that made use of `Pair` in favor of a new one that just uses the objects that were in the `Pair`.
479 * Improved error messaging on the `g.addV(Object...)` when passing an invalid arguments.
480 * Reduced memory usage for TinkerGraph deserialization in GraphSON by streaming vertices and edges.
481 * Added the `gremlin-archetype-dsl` to demonstrate how to structure a Maven project for a DSL.
482 * Developed and documented patterns for Domain Specific Language implementations.
483 * Removed the Groovy dependency from `gremlin-python` and used Groovy Templates and the `gmavenplus-plugin` to generate the python GLV classes.
484 * Now using Groovy `[...]` map notation in `GroovyTranslator` instead of `new LinkedHashMap(){{ }}`.
485 * Maintained type information on `Traversal.promise()`.
486 * Propagated exception to `Future` instead of calling thread in `RemoteConnection`.
487 * Fixed a bug in `RepeatUnrollStrategy` where `LoopsStep` and `LambdaHolder` should invalidate the strategy's application.
488 * Deprecated `authentication.className` setting in favor of using `authentication.authenticator`.
489 * Added `authentication.authenticationHandler` setting.
490 * Added abstraction to authorization to allow users to plug in their own `AbstractAuthorizationHandler` implementations.
491 * Fixed a `NullPointerException` bug in `B_LP_O_S_SE_SL_Traverser`.
492 * `PathRetractionStrategy` now uses the marker-model to reduce recursive lookups of invalidating steps.
493 * `ProfileStrategy` now uses the marker-model to reduce recursive lookups of `ProfileSideEffectStep`.
494 * `Mutating` steps now implement `Scoping` interface.
495 * Fixed a step id compilation bug in `AddVertexStartStep`, `AddVertexStep`, `AddEdgeStep`, and `AddPropertyStep`.
496 * Added more details to Gremlin Server client side messages - exception hierarchy and stack trace.
497 * Deprecated "Exception-Class" in the Gremlin Server HTTP protocol in favor of the new "exceptions" field.
498 * De-registered metrics on Gremlin Server shutdown.
499 * Added "help" command option on `:remote config` for plugins that support that feature in the Gremlin Console.
500 * Allowed for multiple scripts and related arguments to be passed to `gremlin.sh` via `-i` and `-e`.
501 * `LABELED_PATH` requirement is now set if any step in the traversal is labeled.
502 * Updated `PathRetractionStrategy` to not run if the provided traversal contains a `VertexProgramStep` that has a `LABELED_PATH` requirement.
503 * Added various metrics to the `GremlinGroovyScriptEngine` around script compilation and exposed them in Gremlin Server.
504 * Moved the `caffeine` dependency down to `gremlin-groovy` and out of `gremlin-server`.
505 * Improved script compilation in `GremlinGroovyScriptEngine` to use better caching, log long compile times and prevent failed compilations from recompiling on future requests.
506 * Synchronized script compilation.
507 * Logged Script compilation times.
508 * Prevented failed scripts from recompiling.
509 * Logged warnings for scripts that take "too long" to compile.
510 * Improved memory usage of the `GremlinGroovyScriptEngine`.
511 * Added `cyclicPath().from().to().by()` support to `GraphTraversal`.
512 * Added `simplePath().from().to().by()` support to `GraphTraversal`.
513 * Added `path().from().to()` support to `GraphTraversal` so sub-paths can be isolated from the current path.
514 * Added `FromToModulating` interface for use with `to()`- and `from()`-based step modulators.
515 * Added `Path.subPath()` which supports isolating a sub-path from `Path` via to/from-labels.
516 * Fixed `NullPointerException` in `GraphMLReader` that occurred when an `<edge>` didn't have an ID field and the base graph supported ID assignment.
517 * Added `ScopingStrategy` which will computer and provide all `Scoping` steps with the path labels of the global `Traversal`.
518 * Split `ComputerVerificationStrategy` into two strategies: `ComputerVerificationStrategy` and `ComputerFinalizationStrategy`.
519 * Removed `HasTest.g_V_hasId_compilationEquality` from process test suite as it makes too many assumptions about provider compilation.
520 * Deprecated `CustomizerProvider` infrastructure.
521 * Deprecated `PluginAcceptor` infrastructure.
522 * Improved consistency of the application of bindings to `GremlinScriptEngine` implementations in the `BindingsGremlinPlugin`.
523 * Fixed a bug in OLAP `ComputerAwareStep` where end-step labels were not being appended to the traverser correctly.
524 * Refactor `SparkContext` handler to support external kill and stop operations.
525 * Fixed an optimization bug in `LazyBarrierStrategy` around appending barriers to the end of a `Traversal`.
526 * Fixed an optimization bug in `PathRetractionStrategy` around appending barriers to the end of a `Traversal`.
527 * `TraverserIterator` in GremlinServer is smart to try and bulk traversers prior to network I/O.
528 * Improved error handling of compilation failures for very large or highly parameterized script sent to Gremlin Server.
529 * Fixed a bug in `RangeByIsCountStrategy` that changed the meaning of inner traversals.
530 * Improved Gremlin-Python Driver implementation by adding a threaded client with basic connection pooling and support for pluggable websocket clients.
531 * Changed `GraphManager` from a final class implementation to an interface.
532 * Updated `GraphManager` interface to include methods for opening/instantiating a graph and closing a graph.
533 * Implemented `DefaultGraphManager` to include previous `GraphManager` functionality and adhere to updated interface.
534 * Deprecated `GraphManager.getGraphs()` and added `GraphManager.getGraphNames()`.
535 * Deprecated `GraphManager.getTraversalSources()` and added `GraphManager.getTraversalSourceNames()`.
536 * Fixed a bug so now users can supply a YAML with an empty `staticVariableTypes` to be used by the `FileSandboxExtension`
537
538 ==== Bugs
539
540 * TINKERPOP-1258 HasTest.g_V_hasId_compilationEquality makes GraphStep assumptions
541 * TINKERPOP-1528 CountByIsRangeStrategy fails for a particular query
542 * TINKERPOP-1626 choose() is buggy in OLAP
543 * TINKERPOP-1638 count() is optimized away in where()
544 * TINKERPOP-1640 ComputerVerificationStrategy gives false errors
545 * TINKERPOP-1652 Disable PathRetractionStrategy strategy if VertexProgramStep has LABELLED_PATH requirement
546 * TINKERPOP-1660 Documentation links should not link to TINKERPOP-xxxx branches
547 * TINKERPOP-1666 NPE in FileSandboxExtension if staticVariableTypes is empty in supplied YAML file
548 * TINKERPOP-1668 RepeatUnrollStrategy should not execute if there is a LoopStep used.
549 * TINKERPOP-1670 End type lost when using promise()
550 * TINKERPOP-1673 GroovyTranslator produces Gremlin that can't execute on :remote
551 * TINKERPOP-1675 RemoteStep#processNextStart() throws CompletionException instead of underlying exception
552 * TINKERPOP-1681 Multiple hasId's are or'd into GraphStep
553
554 ==== Improvements
555
556 * TINKERPOP-761 Some basic mathematical functions / steps
557 * TINKERPOP-786 Patterns for DSL Development
558 * TINKERPOP-1044 ResponseMessage should contain server-side exception name.
559 * TINKERPOP-1095 Create a custom ScriptContext
560 * TINKERPOP-1266 Make memory available to benchmarks configurable
561 * TINKERPOP-1303 add help for :remote config for Gephi Plugin
562 * TINKERPOP-1340 docs do not state at what version an API was introduced (or deprecated)
563 * TINKERPOP-1387 from and to modulators for path steps
564 * TINKERPOP-1438 Consider GraphManager as an interface*(breaking)*
565 * TINKERPOP-1453 Allow Gremlin-Python to handle asynchronous failure
566 * TINKERPOP-1577 Provide support for Python3 or Python2 in the Docker builds.
567 * TINKERPOP-1599 implement real gremlin-python driver
568 * TINKERPOP-1614 Improve documentation for Graph.V() and Graph.E() on main docs page
569 * TINKERPOP-1618 Remove groovy dependency from gremlin-python
570 * TINKERPOP-1627 LazyBarrierStrategy should not append an end barrier.
571 * TINKERPOP-1631 Fix visibility issues with the BindingsGremlinPlugin
572 * TINKERPOP-1634 Deprecate old methods of GremlinGroovyScriptEngine customization
573 * TINKERPOP-1642 Improve performance of mutating traversals
574 * TINKERPOP-1644 Improve script compilation process and include metrics
575 * TINKERPOP-1653 Allow multiple scripts with arguments to be passed to the Console
576 * TINKERPOP-1657 Provide abstraction to easily allow different HttpAuth schemes
577 * TINKERPOP-1663 Validate a maximum for the number of parameters passed to Gremlin Server
578 * TINKERPOP-1665 Remove unittest from Gremlin-Python tests
579 * TINKERPOP-1671 Default method for RemoteConnection.submitAsync throws exception from submit on calling thread instead of failing the future
580 * TINKERPOP-1677 Bump Groovy to 2.4.11
581 * TINKERPOP-1680 Add string performance options to StarGraph
582
583 [[release-3-2-4]]
584 === TinkerPop 3.2.4 (Release Date: February 8, 2017)
585
586 This release also includes changes from <<release-3-1-6, 3.1.6>>.
587
588 * Fixed a bug where `PathProcessor.keepLabels` were not being pushed down into child traversals by `PathRetractionStrategy`.
589 * Added default `MessagePassingReductionStrategy` for `GraphComputer` that can reduce the number of message passing iterations.
590 * Fixed a bug associated with user-provided maps and `GroupSideEffectStep`.
591 * `GroupBiOperator` no longer maintains a detached traversal and thus, no more side-effect related OLAP inconsistencies.
592 * Added `ProjectedTraverser` which wraps a traverser with a `List<Object>` of projected data.
593 * Fixed an optimization bug in `CollectingBarrierSteps` where the barrier was being consumed on each `addBarrier()`.
594 * `OrderGlobalStep` and `SampleGlobalStep` use `ProjectedTraverser` and now can work up to the local star graph in OLAP.
595 * SASL negotiation supports both a byte array and Base64 encoded bytes as a string for authentication to Gremlin Server.
596 * Deprecated all test suites in `gremlin-groovy-test` - Graph Providers no longer need to implement these.
597 * Deprecated `TinkerIoRegistry` replacing it with the more consistently named `TinkerIoRegistryV1d0`.
598 * Made error messaging more consistent during result iteration timeouts in Gremlin Server.
599 * Fixed a memory leak in the classloader for the `GremlinGroovyScriptEngine` where classes in the loader were not releasing from memory as a strong reference was always maintained.
600 * `PathRetractionStrategy` does not add a `NoOpBarrierStep` to the end of local children as its wasted computation in 99% of traversals.
601 * Fixed a bug in `AddVertexStartStep` where if a side-effect was being used in the parametrization, an NPE occurred.
602 * Fixed a bug in `LazyBarrierStrategy` where `profile()` was deactivating it accidentally.
603 * Fixed a bug in `RepeatUnrollStrategy` where stateful `DedupGlobalStep` was cloned and thus, maintained two deduplication sets.
604 * Added documentation around "terminal steps" in Gremlin: `hasNext()`, `next()`, `toList()`, etc.
605 * Added specific GraphSON serializers for `RequestMessage` and `ResponseMessage` in GraphSON 2.0.
606 * Added `CloseableIterator` to allow `Graph` providers who open expensive resources a way to let users release them.
607 * Fixed minor bug in `gremlin-driver` where closing a session-based `Client` without initializing it could generate an error.
608 * Relieved synchronization pressure in various areas of `TinkerGraphComputer`.
609 * Fixed an optimization bug in OLAP-based `DedupGlobalStep` where deduping occurred twice.
610 * `MemoryComputeKey` now implements `Cloneable` which is useful for `BiOperator` reducers that maintain thread-unsafe state.
611 * `TinkerGraphComputer` now supports distributed `Memory` with lock-free partition aggregation.
612 * `TinkerGraph` Gryo and GraphSON deserialization is now configured to use multi-properties.
613 * Changed behavior of `ElementHelper.areEqual(Property, Property)` to not throw exceptions with `null` arguments.
614 * Added `GryoVersion` for future flexibility when introducing a new verison of Gryo and moved serializer registrations to it.
615 * Fixed Gryo serialization of `ConnectiveP` instances.
616 * Lessened the severity of Gremlin Server logging when it encounters two or more serializers addressing the same mime type.
617 * Bumped to Netty 4.0.42.final.
618 * Added `ByteBuffer`, `InetAddress`, `Timestamp` to the list of Gryo supported classes.
619 * Fixed Gryo serialization of `Class`.
620 * Fixed GraphSON serialization of enums like `T`, `P`, etc. where values were overriding each other in the GraphSON type registry.
621 * Fixed a bug in Gremlin-Python around `__.__()` and `__.start()`.
622 * Fixed a bug around long serialization in Gremlin-Python when using Python3.
623 * Deprecated `TraversalSource.withBindings()` as it is no longer needed in Gremlin-Java and never was needed for other variants.
624 * Fixed a bug in Gremlin-Java `Bytecode` where anonymous traversals were not aware of parent bindings.
625 * Fixed a bug in Gremlin-Java GraphSON deserialization around `P.within()` and `P.without()`.
626 * Converted Spark process suite tests to "integration" tests.
627 * Fixed a bug in `InlineFilterStrategy` having to do with folding `HasContainers` into `VertexStep`.
628 * Deprecated `HasContainer.makeHasContainers()` which was used to dissect `AndP` and shouldn't be used at the TinkerPop-level.
629 * `GraphTraversal.has()` now will try and fold-left `HasContainer` if end step is a `HasContainerHolder`.
630 * Created explicit `P`-predicate methods for `GraphTraversal.hasXXX()`.
631 * Fixed a bug in `FilterRankStrategy` around `where().by()` ordering.
632 * Added another optimization in `RangeByIsCountStrategy`, that removes `count().is()` altogether if it's not needed.
633 * Fixed a OLAP `MatchStep.clone()`-bug that occurs when the `match()` is in a local child.
634 * Added another optimization in `RangeByIsCountStrategy`, that removes `count().is()` altogether if it's not needed.
635 * Fixed a bug in `RangeByIsCountStrategy` where labeled parents shouldn't have the strategy applied to their children.
636 * Fixed a bug in `PathRetractionStrategy` where `MatchEndStep` labels were being dropped when they shouldn't be.
637 * Added `TinkerGraphCountStrategy` which translates `g.V().map*.count()` patterns into direct `Map.size()` calls in `TinkerGraph`.
638 * Added `Path.head()` and `Path.isEmpty()` with default method implementations.
639 * Fixed a `NoSuchElementException` bug with `GroupXXXStep` where if the reduced `TraverserSet` is empty, don't add the key/value.
640 * Fixed a `NullPointerException` bug with profiling `GroupSideEffectStep` in OLTP.
641 * Improved ability to release resources in `GraphProvider` instances in the test suite.
642 * Factored `GremlinPlugin` functionality out of gremlin-groovy and into gremlin-core - related classes were deprecated.
643 * Added a `force` option for killing sessions without waiting for transaction close or timeout of a currently running job or multiple jobs.
644 * Deprecated `Session.kill()` and `Session.manualKill()`.
645 * Added `Traversal.promise()` method to allow for asynchronous traversal processing on "remote" traversals.
646 * Deprecated `RemoteConnection.submit(Bytecode)` in favor of `submitAsync(Bytecode)`.
647 * Added `choose(predicate,traversal)` and `choose(traversal,traversal)` to effect if/then-semantics (no else). Equivalent to `choose(x,y,identity())`.
648 * Removed `ImmutablePath.TailPath` as it is no longer required with new recursion model.
649 * Removed call stack recursion in `ImmutablePath`.
650 * Gremlin-Python serializes `Bytecode` as an object (instead of a JSON string) when submit over the `RemoteConnection`.
651 * Fixed the handling of the `DriverRemoteConnection` pass-through configurations to the driver.
652 * `IncidentToAdjacentStrategy` now uses a hidden label marker model to avoid repeated recursion for invalidating steps.
653 * `PathProcessorStrategy` can inline certain `where(traversal)`-steps in order to increase the likelihood of star-local children.
654 * `SparkGraphComputer` no longer starts a worker iteration if the worker's partition is empty.
655 * Added `ProjectStep.getProjectKeys()` for strategies that rely on such information.
656 * Added `VertexFeatures.supportsDuplicateMultiProperties()` for graphs that only support unique values in multi-properties.
657 * Deprecated the "performance" tests in `OptIn`.
658 * Deprecated `getInstance()` methods in favor of `instance()` for better consistency with the rest of the API.
659 * Block calls to "remote" traversal side-effects until the traversal read is complete which signifies an end to iteration.
660 * Added `Pick.none` and `Pick.any` to the serializers and importers.
661 * Added a class loader to `TraversalStrategies.GlobalCache` which guarantees strategies are registered prior to `GlobalCache.getStrategies()`.
662 * Fixed a severe bug where `GraphComputer` strategies are not being loaded until the second use of the traversal source.
663 * The root traversal now throws regular `NoSuchElementException` instead of `FastNoSuchElementException`. (*breaking*)
664 * Added a short sleep to prevent traversal from finishing before it can be interrupted during `TraversalInterruptionComputerTest`.
665 * Added support for SSL client authentication
666
667 ==== Bugs
668
669 * TINKERPOP-1380 dedup() doesn't dedup in rare cases
670 * TINKERPOP-1384 Description of filter function in traversal documentation
671 * TINKERPOP-1428 profile() throws NPE for union(group, group)
672 * TINKERPOP-1521 Mutating steps don't recognize side-effects
673 * TINKERPOP-1525 Plug VertexProgram iteration leak on empty Spark RDD partitions
674 * TINKERPOP-1534 Gremlin Server instances leaking in tests
675 * TINKERPOP-1537 Python tests should not use hard-coded number of workers
676 * TINKERPOP-1547 Two bugs found associated with MatchStep: Path retraction and range count.
677 * TINKERPOP-1548 Traversals can complete before interrupted in TraversalInterruptionComputerTest
678 * TINKERPOP-1560 Cache in GroovyClassLoader may continue to grow
679 * TINKERPOP-1561 gremiln-python GraphSONWriter doesn't properly serialize long in Python 3.5
680 * TINKERPOP-1567 GraphSON deserialization fails with within('a')
681 * TINKERPOP-1573 Bindings don't work in coalesce
682 * TINKERPOP-1576 gremlin-python calls non-existent methods
683 * TINKERPOP-1581 Gremlin-Python driver connection is not thread safe.
684 * TINKERPOP-1583 PathRetractionStrategy retracts keys that are actually needed
685 * TINKERPOP-1585 OLAP dedup over non elements
686 * TINKERPOP-1587 Gremlin Server Subgraph Cardinality Not Respected
687 * TINKERPOP-1594 LazyBarrierStrategy does not activate with ProfileStep
688 * TINKERPOP-1605 gremlin-console 3.2.3 -e can no longer take paths relative to current working directory
689
690 ==== Improvements
691
692 * TINKERPOP-887 FastNoSuchElementException hides stack trace in client code
693 * TINKERPOP-919 Features needs to specify whether 2 vertex properties with same key/value is allowed.
694 * TINKERPOP-932 Add ability to cancel script execution associated with a Gremlin Server Session
695 * TINKERPOP-1248 OrderGlobalStep should use local star graph to compute sorts, prior to reduction.
696 * TINKERPOP-1261 Side-effect group().by() can't handle user-defined maps
697 * TINKERPOP-1292 TinkerGraphComputer VertexProgramInterceptors
698 * TINKERPOP-1372 ImmutablePath should not use Java recursion (call stacks are wack)
699 * TINKERPOP-1433 Add steps to dev docs to help committers get their keys in order
700 * TINKERPOP-1434 Block calls to traversal side-effects until read is complete
701 * TINKERPOP-1471 IncidentToAdjacentStrategy use hidden marker to avoid repeated recursion.
702 * TINKERPOP-1473 Given PathRetractionStrategy, PathProcessorStrategy can be extended to support partial where() inlining.
703 * TINKERPOP-1482 has(x).has(y) chains should be has(x.and(y))
704 * TINKERPOP-1490 Provider a Future based Traversal.async(Function<Traversal,V>) terminal step
705 * TINKERPOP-1502 Chained has()-steps should simply left-append HasContainers in Gremlin-Java.
706 * TINKERPOP-1507 Pick.any and Pick.none are not in GraphSON or Gremlin-Python
707 * TINKERPOP-1508 Add choose(predicate,trueTraversal)
708 * TINKERPOP-1527 Do not override registered strategies in TraversalStrategies.GlobalCache
709 * TINKERPOP-1530 Consistent use of instance()
710 * TINKERPOP-1539 Create a ComplexTraversalTest with crazy nested gnarly traversals.
711 * TINKERPOP-1542 Add Path.isEmpty() with a default implementation.
712 * TINKERPOP-1562 Migrate ScriptEngine-related code to gremlin-core
713 * TINKERPOP-1570 Bump to Netty 4.0.42
714 * TINKERPOP-1582 TraversalOpProcessor does not support custom serializers
715 * TINKERPOP-1584 Add gryo serializers to support types covered in GraphSON
716 * TINKERPOP-1588 Added Terminal Steps section to the docs
717 * TINKERPOP-1589 Re-Introduce CloseableIterator
718 * TINKERPOP-1590 Create TinkerWorkerMemory and Partitioned Vertices
719 * TINKERPOP-1600 Consistent use of base 64 encoded bytes for SASL negotiation
720 * TINKERPOP-1602 Support SSL client certificate authentication
721 * TINKERPOP-1606 Refactor GroupStep to not have the reduction traversal included in its BiOperator.
722 * TINKERPOP-1610 Deprecate gremlin-groovy-test provider based tests
723 * TINKERPOP-1617 Create a SingleIterationStrategy which will do its best to rewrite OLAP traversals to not message pass.
724
725 [[release-3-2-3]]
726 === TinkerPop 3.2.3 (Release Date: October 17, 2016)
727
728 This release also includes changes from <<release-3-1-5, 3.1.5>>.
729
730 * Restructured Gremlin-Python's GraphSON I/O package to make it easier for users to register serializers/deserializers. (*breaking*)
731 * Fixed a bug with `TraversalOpProcessor` that was returning a final result prior to committing the transaction.
732 * Fixed a bug in `ConnectiveStrategy` where infix and/or was not correctly reasoning on `choose()` `HasNextStep` injections.
733 * Increased performance of `CredentialGraph` authentication.
734 * Removed Java 8 stream usage from `TraversalHelper` for performance reasons.
735 * Fixed a bug in `RepeatStep` where `emit().as('x')` wasn't adding the step labels to the emit-traverser.
736 * Added `GraphComputing.atMaster(boolean)` to allow steps to know whether they are executing at master or distributed at workers.
737 * Fixed a bug in OLAP where `DedupGlobalStep` wasn't de-duping local master traversers.
738 * Added `HasContainerHolder.removeHasContainer()`-method with default `UnsupportedOperationException` implementation.
739 * `TraversalSource.withComputer()` is simplified to add a `VertexProgramStrategy`. Easier for language variants.
740 * Fixed a `Set`, `List`, `Map` bug in the various `Translators` where such collections were not being internally translated.
741 * Fixed a `Bytecode` bug where nested structures (map, list, set) were not being analyzed for bindings and bytecode conversions.
742 * Fixed a `String` bug in `GroovyTranslator` and `PythonTranslator` where if the string has double-quotes it now uses """ """.
743 * Added a default `TraversalStrategy.getConfiguration()` which returns the configuration needed to construct the strategy.
744 * `Computer` instances can be created with `Computer.create(Configuration)` and accessed via `Computer.getConf()`.
745 * Every `TraversalStrategy` can be created via a `Configuration` and a static `MyStrategy.create(Configuration)`.
746 * Added language-agnostic `TraversalStrategy` support in `Bytecode`.
747 * Added `PartitionStrategy.Builder.readPartitions()` and deprecated `PartitionStrategy.Builder.addPartition()`.
748 * A new version of `LazyBarrierStrategy` has been created and added to the default strategies.
749 * `FilterRankStrategy` now propagates labels "right" over non-`Scoping` filters.
750 * Fixed a bug in `ConnectiveP` where nested equivalent connectives should be inlined.
751 * Fixed a bug in `IncidentToAdjacentStrategy` where `TreeStep` traversals were allowed.
752 * Fixed a end-step label bug in `MatchPredicateStrategy`.
753 * Fixed a bug in `MatchPredicateStrategy` where inlined traversals did not have strategies applied to it.
754 * Fixed a bug in `RepeatUnrollStrategy` where inlined traversal did not have strategies applied to it.
755 * Fixed padding of prompt in Gremlin Console when the number of lines went beyond a single digit.
756 * Fixed GraphSON 2.0 namespace for `TinkerGraph` to be "tinker" instead of "gremlin".
757 * Dropped serialization support in GraphSON 2.0 for `Calendar`, `TimeZone`, and `Timestamp`.
758 * Added `TraversalHelper.copyLabels()` for copying (or moving) labels form one step to another.
759 * Added `TraversalHelper.applySingleLevelStrategies()` which will apply a subset of strategies but not walk the child tree.
760 * Added the concept that hidden labels using during traversal compilation are removed at the end during `StandardVerificationStrategy`. (*breaking*)
761 * Added `InlineFilterStrategy` which will determine if various `TraversalParent` children are filters and if so, inline them.
762 * Removed `IdentityRemovalStrategy` from the default listing as its not worth the clock cycles.
763 * Removed the "!" symbol in `NotStep.toString()` as it is confusing and the `NotStep`-name is sufficient.
764 * Fixed a bug in `TraversalVertexProgram` (OLAP) around ordering and connectives (i.e. `and()` and `or()`).
765 * Added `AbstractGremlinProcessTest.checkOrderedResults()` to make testing ordered results easier.
766 * `AbstractLambdaTraversal` now supports a `bypassTraversal` where it is possible for strategies to redefine such lambda traversals.
767 * Added an internal utility `ClassFilterStep` which determines if the traverser object's class is an instance of the provided class.
768 * `ConnectiveStep` extends `FilterStep` and thus, is more appropriately categorized in the step hierarchy.
769 * `PropertyMapStep` supports a provided traversal for accessing the properties of the element. (*breaking*)
770 * `SubgraphStrategy` now supports vertex property filtering.
771 * Fixed a bug in Gremlin-Python `P` where predicates reversed the order of the predicates.
772 * Added tests to `DedupTest` for the `dedup(Scope, String...)` overload.
773 * Added more detailed reference documentation for IO formats.
774 * Fixed a bug in serialization of `Lambda` instances in GraphSON, which prevented their use in remote traversals.
775 * Fixed a naming bug in Gremlin-Python where `P._and` and `P._or` should be `P.and_` and `P.or_`. (*breaking*)
776 * `where()` predicate-based steps now support `by()`-modulation.
777 * Added Gryo serialization for `Bytecode`.
778 * Moved utility-based serializers to `UtilSerializers` for Gryo - these classes were private and hence this change is non-breaking.
779 * `TraversalRing` returns a `null` if it does not contain traversals (previously `IdentityTraversal`).
780 * Deprecated `Graph.Exceptions.elementNotFoundException()` as it was not used in the code base outside of the test suite.
781 * Fixed a `JavaTranslator` bug where `Bytecode` instructions were being mutated during translation.
782 * Added `Path` to Gremlin-Python with respective GraphSON 2.0 deserializer.
783 * `Traversal` and `TraversalSource` now implement `AutoCloseable`.
784 * Added "keep-alive" functionality to the Java driver, which will send a heartbeat to the server when normal request activity on a connection stops for a period of time.
785 * Renamed the `empty.result.indicator` preference to `result.indicator.null` in Gremlin Console
786 * If `result.indicator.null` is set to an empty string, then no "result line" is printed in Gremlin Console.
787 * Deprecated `reconnectInitialDelay` on the Java driver.
788 * Added some validations to `Cluster` instance building.
789 * Produced better errors in `readGraph` of `GryoReader` and `GraphSONReader` if a `Vertex` cannot be found in the cache on edge loading.
790 * VertexPrograms can now declare traverser requirements, e.g. to have access to the path when used with `.program()`.
791 * New build options for `gremlin-python` where `-DglvPython` is no longer required.
792 * Added missing `InetAddress` to GraphSON extension module.
793 * Added new recipe for "Pagination".
794 * Added new recipe for "Recommendation".
795 * Added functionality to Gremlin-Server REST endpoint to forward Exception Messages and Class in HTTP Response
796 * Gremlin Server `TraversalOpProcessor` now returns confirmation upon `Op` `close`.
797 * Added `close` method Java driver and Python driver `DriverRemoteTraversalSideEffects`.
798
799 ==== Bugs
800
801 * TINKERPOP-1423 IncidentToAdjacentStrategy should be disabled for tree steps
802 * TINKERPOP-1440 g:Path needs a GraphSON deserializer in Gremlin-Python
803 * TINKERPOP-1457 Groovy Lambdas for remote traversals not serializable
804 * TINKERPOP-1458 Gremlin Server doesn't return confirmation upon Traversal OpProcessor "close" op
805 * TINKERPOP-1466 PeerPressureTest has been failing recently
806 * TINKERPOP-1472 RepeatUnrollStrategy does not semi-compile inlined repeat traversal
807 * TINKERPOP-1476 TinkerGraph does not get typed with the right type name in GraphSON
808 * TINKERPOP-1495 Global list deduplication doesn't work in OLAP
809 * TINKERPOP-1500 and/or infix and choose() do not work correctly.
810 * TINKERPOP-1511 Remote client addV, V()
811
812 ==== Improvements
813
814 * TINKERPOP-790 Implement AutoCloseable on TraversalSource
815 * TINKERPOP-944 Deprecate Graph.Exceptions.elementNotFound
816 * TINKERPOP-1189 SimpleAuthenticator over HttpChannelizer makes Gremlin Server pretty slow and consumes more CPU
817 * TINKERPOP-1249 Gremlin driver to periodically issue ping / heartbeat to gremlin server
818 * TINKERPOP-1280 VertexPrograms should declare traverser requirements
819 * TINKERPOP-1330 by()-modulation for where()
820 * TINKERPOP-1409 Make the "null" return in the gremlin console into something more understandable  *(breaking)*
821 * TINKERPOP-1431 Documentation generation requires tests to execute on gremlin-python
822 * TINKERPOP-1437 Add tests for dedup(Scope) in DedupTest
823 * TINKERPOP-1444 Benchmark bytecode->Traversal creation and implement GremlinServer cache if necessary.
824 * TINKERPOP-1448 gremlin-python should be Python 2/3 compatible
825 * TINKERPOP-1449 Streamline gremlin-python build
826 * TINKERPOP-1455 Provide String-based withStrategy()/withoutStrategy() for language variant usage
827 * TINKERPOP-1456 Support SubgraphStrategy.vertexProperties().
828 * TINKERPOP-1460 Deprecate reconnectInitialDelay in Java driver
829 * TINKERPOP-1464 Gryo Serialization for Bytecode
830 * TINKERPOP-1469 Get rid of Stream-usage in TraversalHelper
831 * TINKERPOP-1470 InlineFilterStrategy should try and P.or() has() children in OrSteps.
832 * TINKERPOP-1486 Improve API of RemoteConnection
833 * TINKERPOP-1487 Reference Documentation for IO
834 * TINKERPOP-1488 Make LazyBarrierStrategy part of the default TraversalStrategies *(breaking)*
835 * TINKERPOP-1492 RemoteStrategy or the RemoteConnection should append a lazy barrier().
836 * TINKERPOP-1423 IncidentToAdjacentStrategy should be disabled for tree steps
837 * TINKERPOP-1440 g:Path needs a GraphSON deserializer in Gremlin-Python
838 * TINKERPOP-1457 Groovy Lambdas for remote traversals not serializable
839 * TINKERPOP-1458 Gremlin Server doesn't return confirmation upon Traversal OpProcessor "close" op
840 * TINKERPOP-1466 PeerPressureTest has been failing recently
841 * TINKERPOP-1472 RepeatUnrollStrategy does not semi-compile inlined repeat traversal
842 * TINKERPOP-1495 Global list deduplication doesn't work in OLAP
843 * TINKERPOP-1500 and/or infix and choose() do not work correctly.
844 * TINKERPOP-1511 Remote client addV, V()
845
846 [[release-3-2-2]]
847 === TinkerPop 3.2.2 (Release Date: September 6, 2016)
848
849 This release also includes changes from <<release-3-1-4, 3.1.4>>.
850
851 * Included GraphSON as a default serializer (in addition to Gryo, which was already present) in Gremlin Server if none are defined.
852 * Added `gremlin-python` package as a Gremlin language variant in Python.
853 * Added `Bytecode` which specifies the instructions and arguments used to construct a traversal.
854 * Created an experimental GraphSON representation of `Bytecode` that will be considered unstable until 3.3.0.
855 * Added `Translator` which allows from the translation of `Bytecode` into some other form (e.g. script, `Traversal`, etc.).
856 * Added `JavaTranslator`, `GroovyTranslator`, `PythonTranslator`, and `JythonTranslator` for translating `Bytecode` accordingly.
857 * Added `TranslationStrategy` to `gremlin-test` so translators can be tested against the process test suite.
858 * Added `Traversal.Admin.nextTraverser()` to get the next result in bulk-form (w/ default implementation).
859 * Added `TraversalSource.getAnonymousTraversalClass()` (w/ default implementation).
860 * Added `GremlinScriptEngine` interface which specifies a `eval(Bytecode, Bindings)` method.
861 * Deprecated `RemoteGraph` in favor of `TraversalSource.withRemote()` as it is more technically correct to tie a remote traversal to the `TraversalSource` than a `Graph` instance.
862 * `GremlinGroovyScriptEngine` implements `GremlinScriptEngine`.
863 * Added `GremlinJythonScriptEngine` which implements `GremlinScriptEngine`.
864 * Removed support for submitting a Java serialized `Traversal` to Gremlin Server.
865 * Removed a largely internal feature that supported automatic unrolling of traversers in the Gremlin Driver.
866 * Made it possible to directly initialize `OpProcessor` implementations with server `Settings`.
867 * Included GraphSON as a default serializer (in addition to Gryo, which was already present) in Gremlin Server if none are defined
868 * Introduced GraphSON 2.0.
869 * Deprecated `embedTypes` on the builder for `GraphSONMapper`.
870 * Bumped to Netty 4.0.40.final.
871 * Defaulted the `gremlinPool` setting in Gremlin Server to be zero, which will instructs it to use `Runtime.availableProcessors()` for that settings.
872 * Changed scope of log4j dependencies so that they would only be used in tests and the binary distributions of Gremlin Console and Server.
873 * Deprecated `Io.Builder.registry()` in favor of the newly introduced `Io.Builder.onMapper()`.
874 * Added new recipe for "Traversal Induced Values".
875 * Fixed a potential leak of a `ReferenceCounted` resource in Gremlin Server.
876 * Added class registrations for `Map.Entry` implementations to `GryoMapper`.
877 * Added methods to retrieve `Cluster` settings in `gremlin-driver`.
878 * Fixed a severe bug in `SubgraphStrategy`.
879 * Deprecated `SubgraphStrategy.Builder.vertexCriterion()/edgeCriterion()` in favor of `vertices()/edges()`.
880 * Fixed a small bug in `StandardVerificationStrategy` that caused verification to fail when `withPath` was used in conjunction with `ProfileStep`.
881 * Added color preferences
882 * Added input, result prompt preferences
883 * Added multi-line indicator in Gremlin Console
884
885 ==== Bugs
886
887 * TINKERPOP-810 store not visible
888 * TINKERPOP-1151 slf4j-log4j12 / log4j is only required for testing *(breaking)*
889 * TINKERPOP-1383 publish-docs.sh might publish to current too early
890 * TINKERPOP-1390 IdentityRemoveStrategyTest fails randomly
891 * TINKERPOP-1400 SubgraphStrategy introduces infinite recursion if filter has Vertex/Edge steps.
892 * TINKERPOP-1405 profile() doesn't like withPath()
893
894 ==== Improvements
895
896 * TINKERPOP-1037 Gremlin shell output coloring
897 * TINKERPOP-1226 Gremlin Console should :clear automagically after "Display stack trace."
898 * TINKERPOP-1230 Serialising lambdas for RemoteGraph
899 * TINKERPOP-1274 GraphSON Version 2.0
900 * TINKERPOP-1278 Implement Gremlin-Python and general purpose language variant test infrastructure
901 * TINKERPOP-1285 Gremline console does not differentiate between multi-line and single-line input
902 * TINKERPOP-1334 Provide a way to pull gremlin.driver.Cluster connection settings.
903 * TINKERPOP-1347 RemoteConnection needs to provide TraversalSideEffects. *(breaking)*
904 * TINKERPOP-1373 Default gremlinPool to number of cores
905 * TINKERPOP-1386 Bump to Netty 4.0.40.Final
906 * TINKERPOP-1392 Remove support for java serialized Traversal *(breaking)*
907 * TINKERPOP-1394 Fix links in Recipes doc
908 * TINKERPOP-1396 Traversal Induced Values Recipe
909 * TINKERPOP-1402 Impossible for graph implementations to provide a class resolver for Gryo IO
910 * TINKERPOP-1407 Default serializers for Gremlin Server
911 * TINKERPOP-1425 Use trailing underscores in gremlin-python
912
913 [[release-3-2-1]]
914 === TinkerPop 3.2.1 (Release Date: July 18, 2016)
915
916 This release also includes changes from <<release-3-1-3, 3.1.3>>.
917
918 * `PathProcessor` steps now have the ability (if configured through a strategy) to drop `Traverser` path segments.
919 * `MatchStep` in OLTP has a lazy barrier to increase the probability of bulking.
920 * Added `PathRetractionStrategy` which will remove labeled path segments that will no longer be referenced.
921 * Added `Path.retract()` to support retracting paths based on labels.
922 * Optimized `ImmutablePath` and `MutablePath` equality code removing significant unnecessary object creation code.
923 * Bumped to Groovy 2.4.7.
924 * Added `RepeatUnrollStrategy` to linearize a `repeat()`-traversal if loop amount is known at compile time.
925 * Fixed a bug in `BranchStep` around child integration during `clone()`.
926 * Fixed a bug in `AbstractStep` around label set cloning.
927 * Added `TraversalStrategyPerformanceTest` for verifying the performance gains of optimization-based traversal strategies.
928 * `TraversalExplanation.prettyPrint()` exists which provides word wrapping and GremlinConsole is smart to use console width to control `toString()`.
929 * `TraversalOpProcessor` (`RemoteConnection`) uses `HaltedTraverserStrategy` metadata to determine detachment procedure prior to returning results.
930 * Allow DFS paths in `HADOOP_GREMLIN_LIBS`.
931 * Added a safer serializer infrastructure for use with `SparkGraphComputer` that uses `KryoSerializer` and the new `GryoRegistrator`.
932 * Added `HaltedTraverserStrategy` to allow users to get back different element detachments in OLAP.
933 * Fixed a `NullPointerException` bug around nested `group()`-steps in OLAP.
934 * Fixed a severe bug around halted traversers in a multi-job OLAP traversal chain.
935 * Ensure a separation of `GraphComputer` and `VertexProgram` configurations in `SparkGraphComputer` and `GiraphGraphComputer`.
936 * `PeerPressureVertexProgram` now supports dynamic initial vote strength calculations.
937 * Added `EmptyMemory` for ease of use when no memory exists.
938 * Updated `VertexComputing.generateProgram()` API to include `Memory`. *(breaking)*
939 * `ImmutablePath.TailPath` is now serializable like `ImmutablePath`.
940 * Added `ConfigurationCompilerProvider` which allows fine-grained control of some of the internal `GremlinGroovyScriptEngine` settings at the Groovy compilation level.
941 * Intoduced the `application/vnd.gremlin-v1.0+gryo-lite` serialization type to Gremlin Server which users "reference" elements rather than "detached".
942 * `GryoMapper` allows overrides of existing serializers on calls to `addCustom` on the builder.
943 * Added a traversal style guide to the recipes cookbook.
944 * Fixed a bug in master-traversal traverser propagation.
945 * Added useful methods for custom `VertexPrograms` to be used with `program()`-step.
946 * Increased the test coverage around traverser propagation within a multi-job OLAP traversal.
947 * Added tests to validate the status of a transaction immediately following calls to close.
948 * Added tests to ensure that threaded transactions cannot be re-used.
949 * `GraphFilter` helper methods are now more intelligent when determining edge direction/label legality.
950 * Added `GraphFilterStrategy` to automatically construct `GraphFilters` via traversal introspection in OLAP.
951 * Updated the Gephi Plugin to support Gephi 0.9.x.
952 * Increased the testing and scope of `TraversalHelper.isLocalStarGraph()`.
953 * Changed signature of `get_g_VXlistXv1_v2_v3XX_name` and `get_g_VXlistX1_2_3XX_name` of `VertexTest` to take arguments for the `Traversal` to be constructed by extending classes.
954 * Added `VertexProgramInterceptor` interface as a general pattern for `GraphComputer` providers to use for bypassing `GraphComputer` semantics where appropriate.
955 * Added `SparkStarBarrierInterceptor` that uses Spark DSL for local star graph traversals that end with a `ReducingBarrierStep`.
956 * Added `SparkInterceptorStrategy` which identifies which interceptor to use (if any) given the submitted `VertexProgram`.
957 * Added `SparkSingleIterationStrategy` that does not partition nor cache the graph RDD if the traversal does not message pass.
958 * Added more helper methods to `TraversalHelper` for handling scoped traversal children.
959 * Deprecated all "performance" tests based on "JUnit Benchmarks".
960 * `SparkGraphComputer` no longer shuffles empty views or empty outgoing messages in order to save time and space.
961 * `TraversalVertexProgram` no longer maintains empty halted traverser properties in order to save space.
962 * Added `List<P<V>>` constructors to `ConnectiveP`, `AndP`, and `OrP` for ease of use.
963 * Added support for interactive (`-i`) and execute (`-e`) modes for Gremlin Console.
964 * Displayed line numbers for script execution failures of `-e` and `-i`.
965 * Improved messaging around script execution errors in Gremlin Console.
966 * Added "help" support to Gremlin Console with the `-h` flag.
967 * Added options to better control verbosity of Gremlin Console output with `-Q`, `-V` and `-D`.
968 * Deprecated the `ScriptExecutor` - the `-e` option to `gremlin.sh` is now handled by `Console`.
969 * `Traversal` now allows cancellation with `Thread.interrupt()`.
970 * Added a Gremlin language variant tutorial teaching people how to embed Gremlin in a host programming language.
971
972 ==== Bugs
973
974 * TINKERPOP-1281 Memory.HALTED_TRAVERSER transience is not sound.
975 * TINKERPOP-1305 HALTED_TRAVERSERS hold wrong information
976 * TINKERPOP-1307 NPE with OLTP nested group() in an OLAP group() traversal
977 * TINKERPOP-1323 ComputerVerificationStrategy fails for nested match() steps
978 * TINKERPOP-1341 UnshadedKryoAdapter fails to deserialize StarGraph when SparkConf sets spark.rdd.compress=true whereas GryoSerializer works
979 * TINKERPOP-1348 TraversalInterruptionTest success dependent on iteration order
980
981 ==== Improvements
982
983 * TINKERPOP-818 Consider a P.type()
984 * TINKERPOP-946 Traversal respecting Thread.interrupt()
985 * TINKERPOP-947 Enforce semantics of threaded transactions as manual *(breaking)*
986 * TINKERPOP-1059 Add test to ensure transaction opening happens at read/write and not on close *(breaking)*
987 * TINKERPOP-1071 Enhance pre-processor output
988 * TINKERPOP-1091 Get KryoSerializer to work natively. *(breaking)*
989 * TINKERPOP-1120 If there is no view nor messages, don't create empty views/messages in SparkExecutor
990 * TINKERPOP-1144 Improve ScriptElementFactory
991 * TINKERPOP-1155 gremlin.sh -e doesn't log line numbers for errors
992 * TINKERPOP-1156 gremlin.sh could use a help text
993 * TINKERPOP-1157 gremlin.sh should allow you to execute a script and go interactive on error or completion
994 * TINKERPOP-1232 Write a tutorial demonstrating the 3 ways to write a Gremlin language variant.
995 * TINKERPOP-1254 Support dropping traverser path information when it is no longer needed.
996 * TINKERPOP-1268 Improve script execution options for console *(breaking)*
997 * TINKERPOP-1273 Deprecate old performance tests
998 * TINKERPOP-1276 Deprecate serializedResponseTimeout
999 * TINKERPOP-1279 Add Iterable<V> parameter constructor to ConnectiveP subclasses
1000 * TINKERPOP-1282 Add more compliance tests around how memory and vertex compute keys are propagated in chained OLAP.
1001 * TINKERPOP-1286 Add Recipes documentation
1002 * TINKERPOP-1288 Support gremlin.spark.skipPartitioning configuration.
1003 * TINKERPOP-1290 Create VertexProgramInterceptor as a pattern for GraphComputer strategies.
1004 * TINKERPOP-1293 Implement GraphFilterStrategy as a default registration for GraphComputer
1005 * TINKERPOP-1294 Deprecate use of junit-benchmarks
1006 * TINKERPOP-1297 Gephi plugin on Gephi 0.9.x  *(breaking)*
1007 * TINKERPOP-1299 Refactor TraversalVertexProgram to make it easier to understand.
1008 * TINKERPOP-1308 Serialize to "reference" for Gremlin Server
1009 * TINKERPOP-1310 Allow OLAP to return properties as Detached
1010 * TINKERPOP-1321 Loosen coupling between TinkerPop serialization logic and shaded Kryo
1011 * TINKERPOP-1322 Provide fine-grained control of CompilerConfiguration
1012 * TINKERPOP-1328 Provide [gremlin-python] as an code executor in docs
1013 * TINKERPOP-1331 HADOOP_GREMLIN_LIBS can only point to local file system
1014 * TINKERPOP-1332 Improve .explain() Dialogue
1015 * TINKERPOP-1338 Bump to Groovy 2.4.7
1016 * TINKERPOP-1349 RepeatUnrollStrategy should unroll loops while maintaining equivalent semantics.
1017 * TINKERPOP-1355 Design HasContainer for extension
1018
1019 [[release-3-2-0-incubating]]
1020 === TinkerPop 3.2.0 (Release Date: April 8, 2016)
1021
1022 This release also includes changes from <<release-3-1-2-incubating, 3.1.2-incubating>>.
1023
1024 * Bumped to Neo4j 2.3.3.
1025 * Renamed variable `local` to `fs` in `HadoopGremlinPlugin` to avoid a naming conflict with `Scope.local`. *(breaking)*
1026 * Added `GraphTraversal.optional()` which will use the inner traversal if it returns results, else it won't.
1027 * `GroupStep` and `GroupSideEffectStep` make use of mid-traversal reducers to limit memory consumption in OLAP.
1028 * Added `GraphTraversal.program(VertexProgram)` to allow arbitrary user vertex programs in OLAP.
1029 * Added `GraphTraversal.project()` for creating a `Map<String,E>` given the current traverser and an arbitrary number of `by()`-modulators.
1030 * `HADOOP_GREMLIN_LIBS` can now reference a directory in HDFS and will be used if the directory does not exist locally.
1031 * Added `gremlin-benchmark` module with JMH benchmarking base classes that can be used for further benchmark development.
1032 * `TraversalStrategies.GlobalCache` supports both `Graph` and `GraphComputer` strategy registrations.
1033 * `select("a","b").by("name").by("age")`-style traversals now work in OLAP with new `PathProcessorStrategy`.
1034 * `DedupGlobalStep` can now handle star-bound `by()`-modulators and scoped keys on `GraphComputer`.
1035 * Added `Computer` which is a builder for `GraphComputers` that is serializable.
1036 * `PersistedOutputRDD` now implements `PersistResultGraphAware` and thus, no more unneeded warnings when using it.
1037 * Renamed `StandardTraversalMetrics` to `DefaultTraversalMetrics` given the `DefaultXXX`-convention throughout. *(breaking)*
1038 * Bumped to Apache Hadoop 2.7.2.
1039 * Fixed a bug around profiling and nested traversals.
1040 * Added `gremlin.hadoop.defaultGraphComputer` so users can use `graph.compute()` with `HadoopGraph`.
1041 * Added `gremlin.hadoop.graphReader` and `gremlin.hadoop.graphWriter` which can handled `XXXFormats` and `XXXRDDs`.
1042 * Deprecated `gremlin.hadoop.graphInputFormat`, `gremlin.hadoop.graphOutputFormat`, `gremlin.spark.graphInputRDD`, and `gremlin.spark.graphOutputRDD`.
1043 * If no configuration is provided to `HadoopPools` it uses the default configuration to create a pool once and only once per JVM.
1044 * Implemented `RemoteGraph`, `RemoteConnection`, and `RemoteStrategy`.
1045 * Added validation to `GryoMapper` Kryo identifiers before construction to prevent accidental duplicates.
1046 * Added `GraphStep.addIds()` which is useful for `HasContainer` "fold ins."
1047 * Added a static `GraphStep.processHashContainerIds()` helper for handling id-based `HasContainers`.
1048 * `GraphStep` implementations should have `g.V().hasId(x)` and `g.V(x)` compile equivalently. *(breaking)*
1049 * Optimized `ExpandableStepIterator` with simpler logic and increased the likelihood of bulking.
1050 * Optimized `TraverserRequirement` calculations.
1051 * `Step.addStart()` and `Step.addStarts()` now take `Traverser.Admin<S>` and `Traverser.Admin<S>`, respectively. *(breaking)*
1052 * `Step.processNextStart()` and `Step.next()` now return `Traverser.Admin<E>`. *(breaking)*
1053 * `Traversal.addTraverserRequirement()` method removed. *(breaking)*
1054 * Fixed a `hashCode()` bug in `OrderGlobalStep` and `OrderLocalStep`.
1055 * Added `OrderLimitStrategy` which will ensure that partitions are limited before being merged in OLAP.
1056 * `ComparatorHolder` now separates the traversal from the comparator. *(breaking)*
1057 * Bumped to Apache Spark 1.6.1.
1058 * If no Spark serializer is provided then `GryoSerializer` is the default, not `JavaSerializer`.
1059 * Added `Operator.sumLong` as a optimized binary operator intended to be used by `Memory` reducers that know they are dealing with longs.
1060 * Traversers from `ComputerResultStep` are no longer attached. Attaching is only used in TinkerPop's test suite via `System.getProperties()`.
1061 * Fixed a `hashCode()`/`equals()` bug in `MessageScope`.
1062 * Fixed a severe `Traversal` cloning issue that caused inconsistent `TraversalSideEffects`.
1063 * `TraversalSideEffects` remain consistent and usable across multiple chained OLAP jobs.
1064 * Added `MemoryTraversalSideEffects` which wraps `Memory` in a `TraversalSideEffects` for use in OLAP.
1065 * `TraversalSideEffects` are now fully functional in OLAP save that an accurate global view is possible at the start of an iteration (not during).
1066 * Updated the `TraversalSideEffects` API to support registered reducers and updated `get()`-semantics. *(breaking)*
1067 * Split existing `profile()` into `ProfileStep` and `ProfileSideEffectStep`.
1068 * The `profile()`-step acts like a reducing barrier and emits `TraversalMetrics` without the need for `cap()`. *(breaking)*
1069 * Added `LocalBarrier` interface to allow traversers to remain distributed during an iteration so as to reduce cluster traffic.
1070 * Added `NoOpBarrierStep` as a `LocalBarrier` implementation of `LambdaCollectingBarrierStep(noOp)`.
1071 * `AggregateStep` implements `LocalBarrier` and thus, doesn't needlessly communicate its barrier traversers.
1072 * Fixed an OLAP-based `Barrier` synchronization bug.
1073 * Fixed a semantic bug in `BranchStep` (and inheriting steps) where barriers reacted locally. *(breaking)*
1074 * Added `MemoryComputeKey` for specification of `Memory` keys in `VertexProgram`. *(breaking)*
1075 * Added `VertexComputeKey` for specification of vertex compute properties in `VertexProgram`. *(breaking)*
1076 * Added `and`, `or`, and `addAll` to `Operator`.
1077 * `Memory` API changed to support setting and adding values for reduction. *(breaking)*
1078 * `Memory` keys can be marked as broadcast and only those values are sent to workers on each iterator.
1079 * `Memory` keys can be marked transient and thus deleted at the end of the OLAP job.
1080 * Vertex compute keys can be marked transient and thus deleted at the end of the OLAP job.
1081 * `VertexProgram` API changed to support `MemoryComputeKey` and `VertexComputeKey`. *(breaking)*
1082 * `TraversalVertexProgram` able to execute OLAP and OLTP traversal sections dynamically within the same job.
1083 * Removed `FinalGet` interface as all post processing of reductions should be handled by the reducing step explicitly. *(breaking)*
1084 * Simplified all `SupplyingBarrierStep` implementations as they no longer require `MapReduce` in OLAP.
1085 * Simplified all `CollectingBarrierStep` implementations as they no longer require `MapReduce` in OLAP.
1086 * Simplified all `ReducingBarrierStep` implementations as they no longer require `MapReduce` in OLAP.
1087 * All steps in OLAP that used `MapReduce` now use `Memory` to do their reductions which expands the list of legal traversals.
1088 * `GroupStep` simplified with `GroupHelper.GroupMap` no longer being needed. Related to the removal of `FinalGet`.
1089 * OLAP side-effects that are no longer generated by `MapReduce` are simply stored in `ComputerResult.Memory` w/ no disk persistence needed. *(breaking)*
1090 * Added `Generate` step interface which states that there could be a final generating phase to a side-effect or reduction (e.g. `GroupStep`).
1091 * `Barrier` step interface is now the means by which non-parallel steps communicate with their counterparts in OLAP.
1092 * Added `MemoryComputing` step interface which states that the step uses `MemoryComputeKeys` for its computation in OLAP.
1093 * Added `PeerPressureVertexProgramStep` and `GraphTraversal.peerPressure()`.
1094 * Added `PureTraversal` for handling pure and compiled versions of a `Traversal`. Useful in OLAP.
1095 * Added `ScriptTraversal` which allows for delayed compilation of script-based `Traversals`.
1096 * Simplified `VertexProgram` implementations with a `PureTraversal`-model and deprecated `ConfigurationTraversal`.
1097 * Simplified script-based `Traversals` via `ScriptTraversal` and deprecated `TraversalScriptFunction` and `TraversalScriptHelper`.
1098 * Added `TimesModulating` interface which allows the `Step` to decide how a `times()`-modulation should be handled.
1099 * Added `ByModulating` interface which allows the `Step` to decide how a `by()`-modulation should be handled. *(breaking)*
1100 * Simplified the `by()`-modulation patterns of `OrderGlobalStep` and `OrderLocalStep`.
1101 * Added `GraphComputerTest.shouldSupportPreExistingComputeKeys()` to ensure existing compute keys are "revived." *(breaking)*
1102 * Added `GraphComputerTest.shouldSupportJobChaining()` to ensure OLAP jobs can be linearly chained. *(breaking)*
1103 * Fixed a bug in both `SparkGraphComputer` and `GiraphGraphComputer` regarding source data access in job chains.
1104 * Expanded job chaining test coverage for `GraphComputer` providers.
1105 * Added `TraversalHelper.onGraphComputer(traversal)`.
1106 * `MapReduce.map()` no longer has a default implementation. This method must be implemented. *(breaking)*
1107 * `TraversalVertexProgram` can work without a `GraphStep` start.
1108 * Added `PageRankVertexProgramStep` and `GraphTraversal.pageRank()`.
1109 * Added `TraversalVertexProgramStep` to support OLAP traversal job chaining.
1110 * Added `VertexProgramStrategy` which compiles multiple OLAP jobs into a single traversal.
1111 * Simplified the comparator model in `OrderGlobalStep` and `OrderLocalStep`.
1112 * Refactored `TraversalSource` model to allow fluent-method construction of `TraversalSources`.
1113 * Deprecated the concept of a `TraversalSource.Builder`.
1114 * Removed the concept of a `TraversalEngine`. All `Traversal` modulations are now mediated by `TraversalStrategies`. *(breaking)*
1115 * Added `SideEffectStrategy` for registering sideEffects in a spawned `Traversal`.
1116 * Added `SackStrategy` for registering a sack for a spawned `Traversal`.
1117 * Added `RequirementsStrategy` and `RequirementsStep` for adding dynamic `TraverserRequirements` to a `Traversal`.
1118 * Removed `EngineDependentStrategy`.
1119 * Renamed step interface `EngineDependent` to `GraphComputing` with method `onGraphComputer()`. *(breaking)*
1120 * Cleaned up various `TraversalStrategy` tests now that `TraversalEngine` no longer exists.
1121 * Added `GraphFilter` to support filtering out vertices and edges that won't be touched by an OLAP job.
1122 * Added `GraphComputer.vertices()` and `GraphComputer.edges()` for `GraphFilter` construction. *(breaking)*
1123 * `SparkGraphComputer`, `GiraphGraphComputer`, and `TinkerGraphComputer` all support `GraphFilter`.
1124 * Added `GraphComputerTest.shouldSupportGraphFilter()` which verifies all filtered graphs have the same topology.
1125 * Added `GraphFilterAware` interface to `hadoop-gremlin/` which tells the OLAP engine that the `InputFormat` handles filtering.
1126 * `GryoInputFormat` and `ScriptInputFormat` implement `GraphFilterAware`.
1127 * Added `GraphFilterInputFormat` which handles graph filtering for `InputFormats` that are not `GraphFilterAware`.
1128 * Fixed a bug in `TraversalHelper.isLocalStarGraph()` which allowed certain illegal traversals to pass.
1129 * Added `TraversalHelper.isLocalProperties()` to verify that the traversal does not touch incident edges.
1130 * `GraphReader` I/O interface now has `Optional<Vertex> readGraph(InputStream, GraphFilter)`. Default `UnsupportedOperationException`.
1131 * `GryoReader` does not materialize edges that will be filtered out and this greatly reduces GC and load times.
1132 * Created custom `Serializers` for `SparkGraphComputer` message-passing classes which reduce graph sizes significantly.
1133
1134 ==== Bugs
1135
1136 * TINKERPOP-951 Barrier steps provide unexpected results in Gremlin OLAP
1137 * TINKERPOP-1057 GroupSideEffectStep doesn't use provided maps
1138 * TINKERPOP-1103 Two objects fighting for local variable name in Gremlin Console *(breaking)*
1139 * TINKERPOP-1149 TraversalXXXSteps Aren't Providing SideEffects
1140 * TINKERPOP-1181 select(Column) should not use a LambdaMapStep
1141 * TINKERPOP-1188 Semantics of BarrierSteps in TraversalParent global traversals is wrong. *(breaking)*
1142 * TINKERPOP-1194 explain() seems broken
1143 * TINKERPOP-1217 Repeated Logging of "The HadoopPools has not been initialized, using the default pool"
1144
1145 ==== Improvements
1146
1147 * TINKERPOP-570 [Proposal] Provide support for OLAP to OLTP to OLAP to OLTP
1148 * TINKERPOP-575 Implement RemoteGraph
1149 * TINKERPOP-813 [Proposal] Make the Gremlin Graph Traversal Machine and Instruction Set Explicit
1150 * TINKERPOP-872 Remove GroupCountStep in favor of new Reduce-based GroupStep
1151 * TINKERPOP-890 Remove the concept of branch/ package. *(breaking)*
1152 * TINKERPOP-958 Improve usability of .profile() step.
1153 * TINKERPOP-962 Provide "vertex query" selectivity when importing data in OLAP. *(breaking)*
1154 * TINKERPOP-968 Add first class support for an optional traversal
1155 * TINKERPOP-971 TraversalSource should be fluent like GraphComputer *(breaking)*
1156 * TINKERPOP-1016 Replace junit-benchmarks with JMH
1157 * TINKERPOP-1021 Deprecate Order.valueIncr, Order.valueDecr, Order.keyIncr, and Order.keyDecr *(breaking)*
1158 * TINKERPOP-1032 Clean up the conf/hadoop configurations
1159 * TINKERPOP-1034 Bump to support Spark 1.5.2
1160 * TINKERPOP-1069 Support Spark 1.6.0
1161 * TINKERPOP-1082 INPUT_RDD and INPUT_FORMAT are bad, we should just have one key.
1162 * TINKERPOP-1112 Create GryoSerializers for the Spark Payload classes.
1163 * TINKERPOP-1121 FileSystemStorage needs to be smart about /.
1164 * TINKERPOP-1132 Messenger.receiveMessages() Iterator should .remove().
1165 * TINKERPOP-1140 TraversalVertexProgramStep in support of OLAP/OLTP conversions.
1166 * TINKERPOP-1153 Add ByModulating and TimesModulating interfaces.
1167 * TINKERPOP-1154 Create a ScriptTraversal which is Serializable and auto-compiles.
1168 * TINKERPOP-1162 Add VertexProgram.getTransientComputeKeys() for removing scratch-data. *(breaking)*
1169 * TINKERPOP-1163 GraphComputer's can have TraversalStrategies.
1170 * TINKERPOP-1164 ReducingBarriersSteps should use ComputerMemory, not MapReduce.
1171 * TINKERPOP-1166 Add Memory.reduce() as option to Memory implementations. *(breaking)*
1172 * TINKERPOP-1173 If no Serializer is provided in Configuration, use GryoSerializer by default (Spark)
1173 * TINKERPOP-1180 Add more optimized binary operators to Operator.
1174 * TINKERPOP-1192 TraversalSideEffects should support registered reducers (binary operators).
1175 * TINKERPOP-1193 Add a LocalBarrier interface.
1176 * TINKERPOP-1199 Use "MicroMetrics" as the mutator of the TraversalMetrics.
1177 * TINKERPOP-1206 ExpandableIterator can take a full TraverserSet at once -- Barriers.
1178 * TINKERPOP-1209 ComparatorHolder should returns a Pair<Traversal,Comparator>. *(breaking)*
1179 * TINKERPOP-1210 Provide an OrderLimitStep as an optimization.
1180 * TINKERPOP-1219 Create a test case that ensures the provider's compilation of g.V(x) and g.V().hasId(x) is identical *(breaking)*
1181 * TINKERPOP-1222 Allow default GraphComputer configuration
1182 * TINKERPOP-1223 Allow jars in gremlin.distributedJars to be read from HDFS
1183 * TINKERPOP-1225 Do a "rolling reduce" for GroupXXXStep in OLAP.
1184 * TINKERPOP-1227 Add Metrics for the TraversalOpProcessor
1185 * TINKERPOP-1234 program() step that takes arbitrary vertex programs
1186 * TINKERPOP-1236 SelectDenormalizationStrategy for select().by(starGraph) in OLAP.
1187 * TINKERPOP-1237 ProjectMap: For the Love of Die Faterland
1188 * TINKERPOP-1238 Re-use Client instances in RemoteGraph tests
1189
1190 == TinkerPop 3.1.0 (A 187 On The Undercover Gremlinz)
1191
1192 image::https://raw.githubusercontent.com/apache/tinkerpop/master/docs/static/images/gremlin-gangster.png[width=185]
1193
1194 [[release-3-1-8]]
1195 === TinkerPop 3.1.8 (Release Date: August 21, 2017)
1196
1197 * Fixed a `MessageScope` bug in `TinkerGraphComputer`.
1198 * Fixed a bug in `BigDecimal` divisions in `NumberHelper` that potentially threw an `ArithmeticException`.
1199 * Non-deserializable exceptions no longer added to ScriptRecordReader IOExceptions.
1200
1201 ==== Bugs
1202
1203 * TINKERPOP-1519 TinkerGraphComputer doesn't handle multiple MessageScopes in single iteration
1204 * TINKERPOP-1736 Sack step evaluated by Groovy interprets numbers in an unexpected way
1205 * TINKERPOP-1754 Spark can not deserialise some ScriptRecordReader parse exceptions
1206
1207 [[release-3-1-7]]
1208 === TinkerPop 3.1.7 (Release Date: June 12, 2017)
1209
1210 * Configured Modern and The Crew graphs to work with a integer `IdManager` when `TinkerFactory.createXXX()` is called.
1211 * Added XSLT transform option to convert TinkerPop 2.x GraphML to 3.x GraphML.
1212 * Added validation to `StarVertexProperty`.
1213 * Bumped to Jackson 2.8.7.
1214 * Fixed `EventStrategy` so that newly added properties trigger events with the name of the key that was added.
1215 * Drop use of jitpack for the jbcrypt artifact - using the official one in Maven Central.
1216 * Bumped to Groovy 2.4.11.
1217
1218 ==== Improvements
1219
1220 * TINKERPOP-1504 MutationListener doesn't provide property key on property additions
1221 * TINKERPOP-1608 TP2-to-TP3 GraphML XSLT
1222 * TINKERPOP-1633 Use org.mindrot:jbcrypt v0.4
1223 * TINKERPOP-1645 Bump to Groovy 2.4.9
1224 * TINKERPOP-1654 Upgrade to jackson-databind 2.8.6+ in gremlin-shaded
1225 * TINKERPOP-1659 Docker build should use maven settings.xml
1226 * TINKERPOP-1664 StarVertexProperty#property should throw an NPE if the value is null
1227
1228 [[release-3-1-6]]
1229 === TinkerPop 3.1.6 (Release Date: February 3, 2017)
1230
1231 * Fixed bug in `IncidentToAdjacentStrategy`, it was missing some invalidating steps.
1232 * Returned a confirmation on session close from Gremlin Server.
1233 * Use non-default port for running tests on Gremlin Server.
1234 * Fully shutdown metrics services in Gremlin Server on shutdown.
1235 * Deprecated `tryRandomCommit()` in `AbstractGremlinTest` - the annotation was never added in 3.1.1, and was only deprecated via javadoc.
1236 * Minor fixes to various test feature requirements in `gremlin-test`.
1237 * Allow developers to pass options to `docker run` with TINKERPOP_DOCKER_OPTS environment variable
1238
1239 ==== Bugs
1240
1241 * TINKERPOP-1493 Groovy project doesn't build on Windows
1242 * TINKERPOP-1545 IncidentToAdjacentStrategy is buggy
1243
1244 ==== Improvements
1245
1246 * TINKERPOP-1538 Gremlin Server spawned by test suites should use a different port
1247 * TINKERPOP-1544 Return a confirmation of session close
1248 * TINKERPOP-1556 Allow Hadoop to run on IPv6 systems
1249 * TINKERPOP-1557 Improve docker build time with this one weird trick!
1250 * TINKERPOP-1598 Bump to Grovy 2.4.8
1251
1252 [[release-3-1-5]]
1253 === TinkerPop 3.1.5 (Release Date: October 17, 2016)
1254
1255 * Improved handling of `Cluster.close()` and `Client.close()` to prevent the methods from hanging.
1256 * Fixed a bug in `NotStep` where child requirements were not being analyzed.
1257 * Fixed output redirection and potential memory leak in `GremlinGroovyScriptEngine`.
1258 * Corrected naming of `g_withPath_V_asXaX_out_out_mapXa_name_it_nameX` and `g_withPath_V_asXaX_out_mapXa_nameX` in `MapTest`.
1259 * Improved session cleanup when a close is triggered by the client.
1260 * Removed the `appveyor.yml` file as the AppVeyor build is no longer enabled by Apache Infrastructure.
1261 * Fixed TinkerGraph which was not saving on `close()` if the path only consisted of the file name.
1262 * Fixed a bug in `RangeByIsCountStrategy` which didn't use the `NotStep` properly.
1263
1264 ==== Bugs
1265
1266 * TINKERPOP-1158 gremlin.sh -v emits log4j initialization errors
1267 * TINKERPOP-1391 issue with where filter
1268 * TINKERPOP-1442 Killing session should make better attempt to cleanup
1269 * TINKERPOP-1451 TinkerGraph persistence cannot handle a single file name as the graph location
1270 * TINKERPOP-1467 Improve close() operations on the Java driver
1271 * TINKERPOP-1478 Propogate ScriptEngine fixes from groovy to GremlinGroovyScriptEngine
1272 * TINKERPOP-1512 gremlin-server-classic.yaml is broken
1273
1274 ==== Improvements
1275
1276 * TINKERPOP-927 bin/publish-docs.sh should only upload diffs.
1277 * TINKERPOP-1264 Improve BLVP docs
1278 * TINKERPOP-1477 Make DependencyGrabberTest an integration test
1279
1280 [[release-3-1-4]]
1281 === TinkerPop 3.1.4 (Release Date: September 6, 2016)
1282
1283 * Improved the error provided by a client-side session if no hosts were available.
1284 * Fixed a bug in `PropertiesTest` which assumed long id values.
1285 * Fixed a bug in `StarGraph` around self-edges.
1286 * Fixed a potential leak of a `ReferenceCounted` resource in Gremlin Server.
1287 * Renamed distributions to make the prefix "apache-tinkerpop-" as opposed to just "apache-".
1288 * Fixed a problem (previously thought resolved on 3.1.3) causing Gremlin Server to lock up when parallel requests were submitted on the same session if those parallel requests included a script that blocked indefinitely.
1289 * Fixed bug in `TailGlobalStep` where excess bulk was not accounted for correctly.
1290
1291 ==== Bugs
1292
1293 * TINKERPOP-1350 Server locks when submitting parallel requests on session
1294 * TINKERPOP-1375 Possible ByteBuf leak for certain transactional scenarios
1295 * TINKERPOP-1377 Closing a remote in "console mode" has bad message
1296 * TINKERPOP-1379 unaccounted excess in TailGlobalStep
1297 * TINKERPOP-1397 StarVertex self edge has buggy interaction with graph filters
1298 * TINKERPOP-1419 Wrong exception when a SessionedClient is initialized with no available host
1299
1300 ==== Improvements
1301
1302 * TINKERPOP-989 Default documentation should be reference/index.html
1303 * TINKERPOP-1376 Rename TinkerPop artifacts
1304 * TINKERPOP-1413 PropertiesTest#g_V_hasXageX_propertiesXnameX assumes that ids are longs
1305 * TINKERPOP-1416 Write Gremlin Server log files somewhere during doc generation
1306 * TINKERPOP-1418 CoreTraversalTests depend on missing functionality
1307
1308 [[release-3-1-3]]
1309 === TinkerPop 3.1.3 (Release Date: July 18, 2016)
1310
1311 * Fixed bug in `SubgraphStep` where features were not being checked properly prior to reading meta-properties.
1312 * Ensured calls to `Result.hasNext()` were idempotent.
1313 * Avoid hamcrest conflict by using mockito-core instead of mockito-all dependency in `gremlin-test`.
1314 * Fixed bug in `GremlinExecutor` causing Gremlin Server to lock up when parallel requests were submitted on the same session if those parallel requests included a script that blocked indefinitely.
1315 * Changed `GremlinExecutor` timeout scheduling so that the timer would not start until a time closer to the actual start of script evaluation.
1316 * Fixed bug in `SubgraphStrategy` where step labels were not being propogated properly to new steps injected by the strategy.
1317 * Fix incorrect test `FeatureRequirement` annotations.
1318 * Defaulted to `Edge.DEFAULT` if no edge label was supplied in GraphML.
1319 * Fixed bug in `IoGraphTest` causing IllegalArgumentException: URI is not hierarchical error for external graph implementations.
1320 * Fixed bug in `GremlinGroovyScriptEngineFileSandboxTest` resource loading
1321 * Improved `TinkerGraph` performance when iterating vertices and edges.
1322 * Fixed a bug where timeout functions provided to the `GremlinExecutor` were not executing in the same thread as the script evaluation.
1323 * Fixed a bug in the driver where many parallel requests over a session would sometimes force a connection to close and replace itself.
1324 * Graph providers should no longer rely on the test suite to validate that hyphens work for property keys.
1325 * Optimized a few special cases in `RangeByIsCountStrategy`.
1326 * Added more "invalid" variable bindings to the list used by Gremlin Server to validate incoming bindings on requests.
1327 * Fixed a bug where the `ConnectionPool` in the driver would not grow with certain configuration options.
1328 * Fixed a bug where pauses in Gremlin Server writing to an overtaxed client would generate unexpected `FastNoSuchElementException` errors.
1329 * Named the thread pool used by Gremlin Server sessions: "gremlin-server-session-$n".
1330 * Fixed a bug in `BulkSet.equals()` which made itself apparent when using `store()` and `aggregate()` with labeled `cap()`.
1331 * Fixed a bug where `Result.one()` could potentially block indefinitely under certain circumstances.
1332 * Ensured that all asserts of vertex and edge counts were being applied properly in the test suite.
1333 * Fixed bug in `gremlin-driver` where certain channel-level errors would not allow the driver to reconnect.
1334 * `SubgraphStep` now consults the parent graph features to determine cardinality of a property.
1335 * Use of `Ctrl-C` in Gremlin Console now triggers closing of open remotes.
1336 * Bumped SLF4J to 1.7.21 as previous versions suffered from a memory leak.
1337 * Fixed a bug in `Neo4jGraphStepStrategy` where it wasn't defined properly as a `ProviderOptimizationStrategy`.
1338 * Renamed `AndTest.get_g_V_andXhasXage_gt_27X__outE_count_gt_2X_name` to `get_g_V_andXhasXage_gt_27X__outE_count_gte_2X_name` to match the traversal being tested.
1339 * Fixed a self-loop bug in `StarGraph`.
1340 * Added configuration option for disabling `:remote` timeout with `:remote config timeout none`.
1341 * Added `init-tp-spark.sh` to Gremlin Console binary distribution.
1342 * Fixed bug where use of `:x` in a Gremlin Console initialization script would generate a stack trace.
1343 * Added configuration options to Gremlin Driver and Server to override the SSL configuration with an `SslContext`.
1344 * Added driver configuration settings for SSL: `keyCertChainFile`, `keyFile` and `keyPassword`.
1345 * Fixed bug where transaction managed sessions were not properly rolling back transactions for exceptions encountered during script evaluation.
1346 * Fixed bug in `:uninstall` command if the default `/ext` directory was not used.
1347 * Added support to Gremlin Driver to allow either plain text or GSSAPI SASL authentication allowing the client to pass the SASL mechanism in the request.
1348 * Improved dryRun functionality for the docs processor. It's now possible to dry run (or full run) only specific files.
1349 * Added precompile of `ScriptInputFormat` scripts to `ScriptRecordReader` to improve performance.
1350
1351 ==== Bugs
1352
1353 * TINKERPOP-906 Install plugin always fails after first unresolved dependency
1354 * TINKERPOP-1088 Preserve Cardinality in Subgraph
1355 * TINKERPOP-1092 Gremlin Console init script with :x throws exception
1356 * TINKERPOP-1139 [Neo4JGraph] GraphTraversal with SubgraphStrategy removes addLabelStep (as("b"))
1357 * TINKERPOP-1196 Calls to Result.one() might block indefinitely
1358 * TINKERPOP-1215 Labeled a SideEffectCapStep cause problems.
1359 * TINKERPOP-1242 ScriptEngineTest randomly hangs indefinately.
1360 * TINKERPOP-1257 Bad SackTest variable use.
1361 * TINKERPOP-1265 Managed Session Eval Exceptions Rollback
1362 * TINKERPOP-1272 Gremlin Console distribution needs bin/init-tp-spark.sh
1363 * TINKERPOP-1284 StarGraph does not handle self-loops correctly.
1364 * TINKERPOP-1300 Many asserts around vertex/edge counts on graphs not applied
1365 * TINKERPOP-1317 IoGraphTest throws error: URI is not hierarchical
1366 * TINKERPOP-1318 java.lang.NoSuchMethodError: org/hamcrest/Matcher.describeMismatch
1367 * TINKERPOP-1319 several FeatureRequirement annotations are incorrect in gremlin-test
1368 * TINKERPOP-1320 GremlinGroovyScriptEngineFileSandboxTest throws error: URI is not hierarchical
1369 * TINKERPOP-1324 Better error for invalid args to addV()
1370 * TINKERPOP-1350 Server locks when submitting parallel requests on session
1371 * TINKERPOP-1351 Number of connections going beyond the pool max size
1372 * TINKERPOP-1352 Connection Pool doesn't always grow
1373 * TINKERPOP-1359 Exception thrown when calling subgraph() on Neo4jGraph
1374 * TINKERPOP-1360 intermittent error in spark-gremlin integration test
1375
1376 ==== Improvements
1377
1378 * TINKERPOP-939 Neo4jGraph should support HighAvailability (Neo4jHA).
1379 * TINKERPOP-1003 Setting up latest/current links for bins and docs.
1380 * TINKERPOP-1020 Provide --dryRun selectivity for "half publishing" docs.
1381 * TINKERPOP-1063 TinkerGraph performance enhancements
1382 * TINKERPOP-1229 More Descriptive Messaging for :remote console
1383 * TINKERPOP-1260 Log for validate-distribution.sh
1384 * TINKERPOP-1263 Pass SASL mechanism name through with initial SASL response
1385 * TINKERPOP-1267 Configure Console for no timeout on remote requests
1386 * TINKERPOP-1269 More SSL settings for driver
1387 * TINKERPOP-1295 Precompile ScriptInputFormat scripts once during initialization of ScriptRecordReader
1388 * TINKERPOP-1301 Provide Javadoc for ScriptInput/OutputFormat's
1389 * TINKERPOP-1302 Ctrl-C should kill open remotes in Console
1390 * TINKERPOP-1312 .count().is(0) is not properly optimized
1391 * TINKERPOP-1314 Improve error detection in docs preprocessor
1392 * TINKERPOP-1354 Include all static enum imports in request validation for bindings *(breaking)*
1393
1394 [[release-3-1-2-incubating]]
1395 === TinkerPop 3.1.2 (Release Date: April 8, 2016)
1396
1397 * Fixed two `NullPointerException`-potential situations in `ObjectWritable`.
1398 * Provided Docker script that allows the execution of several build tasks within a Docker container.
1399 * Added a per-request `scriptEvaluationTimeout` option to the Gremlin Server protocol.
1400 * Changed `DriverRemoteAcceptor` to send scripts as multi-line.
1401 * Fixed a bug in `gremlin-driver` where connections were not returning to the pool after many consecutive errors.
1402 * Fixed a bug where `tree()` did not serialize into GraphSON.
1403 * Bumped to SLF4j 1.7.19.
1404 * Bumped to Apache Hadoop 2.7.2.
1405 * Fixed a bug in `gremlin-driver` where a really fast call to get a `Future` to wait for a result might not register an error raised from the server.
1406 * Fixed a severe bug where `LP_O_OB_P_S_SE_SL_Traverser` was not registered with `GryoMapper`.
1407 * The future from `GremlinExecutor.eval()` is completed after the entire evaluation lifecyle is completed.
1408 * Spark `Memory` uses `collect().iterator()` instead of `toLocalIterator()` to reduce noise in Spark UI.
1409 * Added the `:remote console` option which flips the Gremlin Console into a remote-only mode where all script evaluation is routed to the currently configured remote, which removes the need to use the `:>` command.
1410 * Added `allowRemoteConsole()` to the `RemoteAcceptor` interface.
1411 * The `:remote` for `tinkerpop.server` now includes an option to establish the connection as a "session".
1412 * Provided an implementation for calls to `SessionedClient.alias()`, which formerly threw an `UnsupportedOperationException`.
1413 * Bumped to commons-collections 3.2.2.
1414 * Fixed a bug where `OrderGlobalStep` and `OrderLocalStep` were not incorporating their children's traverser requirements.
1415 * Fixed a compilation bug in `TraversalExplanation`.
1416 * Fixed bug where a session explicitly closed was being closed again by session expiration.
1417 * Improved the recovery options for `gremlin-driver` after failed requests to Gremlin Server.
1418 * Added `maxWaitForSessionClose` to the settings for `gremlin-driver`.
1419 * Bumped to Netty 4.0.34.Final.
1420 * Added "interpreter mode" for the `ScriptEngine` and Gremlin Server which allows variables defined with `def` or a type to be recognized as "global".
1421 * Bumped to Apache Groovy 2.4.6.
1422 * Added the `gremlin-archetype-server` archetype that demonstrates
1423 * Added the `gremlin-archetype-tinkergraph` archetype that demonstrates a basic project that uses TinkerGraph.
1424 * Added `gremlin-archetype` module to house TinkerPop "examples".
1425 * Fixed a condition where `ConnectionPool` initialization in the driver would present a `NullPointerException` on initialization if there were errors constructing the pool in full.
1426 * Fixed a bug in the round-robin load balancing strategy in the driver would waste requests potentially sending messages to dead hosts.
1427 * Added new Provider Documentation book - content for this book was extracted from the reference documentation.
1428 * Fixed a bug where multiple "close" requests were being sent by the driver on `Client.close()`.
1429 * Fixed an `Property` attach bug that shows up in serialization-based `GraphComputer` implementations.
1430 * Fixed a pom.xml bug where Gremlin Console/Server were not pulling the latest Neo4j 2.3.2.
1431 * Fixed bug in "round robin" load balancing in `gremlin-driver` where requests were wrongly being sent to the same host.
1432 * Prevented the spawning of unneeded reconnect tasks in `gremlin-driver` when a host goes offline.
1433 * Fixed bug preventing `gremlin-driver` from reconnecting to Gremlin Server when it was restarted.
1434 * Better handled errors that occurred on commits and serialization in Gremlin Server to first break the result iteration loop and to ensure commit errors were reported to the client.
1435 * Added GraphSON serializers for the `java.time.*` classes.
1436 * Improved the logging of the Gremlin Server REST endpoint as it pertained to script execution failures.
1437 * `TraversalExplanation` is now `Serializable` and compatible with GraphSON and Gryo serialization.
1438 * Fixed a problem with global bindings in Gremlin Server which weren't properly designed to handle concurrent modification.
1439 * Deprecated `ScriptElementFactory` and made the local `StarGraph` globally available for `ScriptInputFormat`'s `parse()` method.
1440 * Improved reusability of unique test directory creation in `/target` for `AbstractGraphProvider`, which was formerly only available to Neo4j, by adding `makeTestDirectory()`.
1441 * Optimized memory-usage in `TraversalVertexProgram`.
1442 * `Graph` instances are not merely "closed" at the end of tests, they are "cleared" via `GraphProvider.clear()`, which should in turn cleans up old data for an implementation.
1443 * Expanded the Gremlin Server protocol to allow for transaction management on in-session requests and updated the `gremlin-driver` to take advantage of that.
1444 * Greatly reduced the amount of objects required in OLAP for the `ReducingBarrierStep` steps.
1445 * Improved messages for the different distinct "timeouts" that a user can encounter with Gremlin Server.
1446
1447 ==== Bugs
1448
1449 * TINKERPOP-1041 StructureStandardTestSuite has file I/O issues on Windows
1450 * TINKERPOP-1105 SparkGraphComputer / Null Pointer Exceptions for properties traversals
1451 * TINKERPOP-1106 Errors on commit in Gremlin Server don't register as exception on driver
1452 * TINKERPOP-1125 RoundRobin load balancing always uses the second Host when size = 2
1453 * TINKERPOP-1126 A single Host spawns many reconnect tasks
1454 * TINKERPOP-1127 client fails to reconnect to restarted server
1455 * TINKERPOP-1146 IoTest are not clearing the db after the test run
1456 * TINKERPOP-1148 ConcurrentModificationException with bindings in Gremlin Server
1457 * TINKERPOP-1150 Update pom file dependencies to work with Neo4j 2.3.2
1458 * TINKERPOP-1159 Client sends multiple session close messages per host
1459 * TINKERPOP-1168 Switch plugins in docs preprocessor
1460 * TINKERPOP-1172 Reconnect to Gremlin Server previously marked as dead
1461 * TINKERPOP-1175 Anonymous traversals can't be explained
1462 * TINKERPOP-1184 Sessions not being closed properly
1463 * TINKERPOP-1216 OrderStep or O_Traverser is broken
1464 * TINKERPOP-1239 Excessive continual failure for requests can cause TimeoutException in driver
1465 * TINKERPOP-1245 Gremlin shell starts incorrectly on OS X due to awk difference
1466 * TINKERPOP-1251 NPE in ObjectWritable.toString
1467 * TINKERPOP-1252 Failed Neo4j transaction can leave Neo4jTransaction in inconsistent state
1468
1469 ==== Improvements
1470
1471 * TINKERPOP-732 gremlin-server GraphSON serializer issue with tree()
1472 * TINKERPOP-916 Develop a better "simple" driver for testing and example purposes
1473 * TINKERPOP-937 Extract the implementations sections of the primary documentation to its own book
1474 * TINKERPOP-956 Connection errors tend to force a complete close of the channel
1475 * TINKERPOP-1039 Enable auto-commit for session'd requests.
1476 * TINKERPOP-1068 Bump to support jbcrypt-0.4m.jar
1477 * TINKERPOP-1080 Bump Netty version - 4.0.34.Final
1478 * TINKERPOP-1085 Establish TinkerPop "example" projects
1479 * TINKERPOP-1096 Support aliasing for sessions in Gremlin Server
1480 * TINKERPOP-1097 Gremlin Console supporting sessions
1481 * TINKERPOP-1107 Provide a way to support global variables with sandboxing enabled
1482 * TINKERPOP-1109 Make Gremlin Console better suited for system level installs
1483 * TINKERPOP-1131 TraversalVertexProgram traverser management is inefficient memory-wise.
1484 * TINKERPOP-1135 Improve GraphSON representation of java.time.* classes
1485 * TINKERPOP-1137 Deprecate ScriptElementFactory and make star graph globally available
1486 * TINKERPOP-1138 Improve messaging on server timeouts
1487 * TINKERPOP-1147 Add serialization for TraversalExplanation
1488 * TINKERPOP-1160 Add timeout configuration for time to wait for connection close
1489 * TINKERPOP-1165 Tooling Support: Compile with -parameters
1490 * TINKERPOP-1176 Bump Groovy version - 2.4.6
1491 * TINKERPOP-1177 Improve documentation around Spark's storage levels
1492 * TINKERPOP-1197 Document Gremlin Server available metrics
1493 * TINKERPOP-1198 Bump commons-collections to 3.2.2
1494 * TINKERPOP-1213 missing docs for has(label, key, value)
1495 * TINKERPOP-1218 Usage of toLocalIterator Produces large amount of Spark Jobs
1496
1497 [[release-3-1-1-incubating]]
1498 === TinkerPop 3.1.1 (Release Date: February 8, 2016)
1499
1500 * Made `GryoRecordReader` more robust to 0 byte record splits.
1501 * Fixed a constructor/serialization bug in `LP_O_OB_S_SE_SL_Traverser`.
1502 * Added a lazy iterator, memory safe implementation of MapReduce to `SparkGraphComputer`.
1503 * Added `MapReduce.combine()` support to `SparkGraphComputer`.
1504 * Bumped to Neo4j 2.3.2.
1505 * Fixed Java comparator contract issue around `Order.shuffle`.
1506 * Optimized a very inefficient implementation of `SampleLocalStep`.
1507 * Reduced the complexity and execution time of all `AbstractLambdaTraversal` instances.
1508 * `DefaultTraversal` has a well defined `hashCode()` and `equals()`.
1509 * Added serializers to Gryo for `java.time` related classes.
1510 * Integrated `NumberHelper` in `SackFunctions`.
1511 * Deprecated `VertexPropertyFeatures.supportsAddProperty()` which effectively was a duplicate of `VertexFeatures.supportsMetaProperties`.
1512 * The Spark persistence `StorageLevel` can now be set for both job graphs and `PersistedOutputRDD` data.
1513 * Added to the list of "invalid binding keys" allowed by Gremlin Server to cover the private fields of `T` which get exposed in the `ScriptEngine` on static imports.
1514 * Added `BulkDumperVertexProgram` that allows to dump a whole graph in any of the supported IO formats (GraphSON, Gryo, Script).
1515 * Fixed a bug around duration calculations of `cap()`-step during profiling.
1516 * It is possible to completely avoid using HDFS with Spark if `PersistedInputRDD` and `PersistedOutpuRDD` are leveraged.
1517 * `InputRDD` and `OutputRDD` can now process both graphs and memory (i.e. sideEffects).
1518 * Removed Groovy specific meta-programming overloads for handling Hadoop `FileSystem` (instead, its all accessible via `FileSystemStorage`).
1519 * Added `FileSystemStorage` and `SparkContextStorage` which both implement the new `Storage` API.
1520 * Added `Storage` to the gremlin-core io-package which providers can implement to allow conventional access to data sources (e.g. `ls()`, `rm()`, `cp()`, etc.).
1521 * Bumped to Spark 1.5.2.
1522 * Bumped to Groovy 2.4.5.
1523 * Added `--noClean` option in `bin/process-docs.sh` to prevent the script from cleaning Grapes and HDFS.
1524 * Execute the `LifeCycle.beforeEval()` in the same thread that `eval()` is executed in for `GremlinExecutor`.
1525 * Improved error handling of Gremlin Console initialization scripts to better separate errors in initialization script I/O versus execution of the script itself.
1526 * Fixed a bug in `Graph.OptOut` when trying to opt-out of certain test cases with the `method` property set to "*".
1527 * Added another `BulkLoader` implementation (`OneTimeBulkLoader`) that doesn't store temporary properties in the target graph.
1528 * Added option to allow for a custom `ClassResolver` to be assigned to a `GryoMapper` instance.
1529 * Fixed a `SparkGraphComputer` sorting bug in MapReduce that occurred when there was more than one partition.
1530 * Added `strictTransactionManagement` to the Gremlin Server settings to indicate that the `aliases` parameter must be passed on requests and that transaction management will be scoped to the graphs provided in that argument.
1531 * Fixed a `NullPointerException` bug in `PeerPressureVertexProgram` that occurred when an adjacency traversal was not provided.
1532 * Standardized "test data directories" across all tests as generated by `TestHelper`.
1533 * Fixed a bug in Gremlin Server where error messages were not always being passed back in the `statusMessage` field of the `ResponseMessage`.
1534 * Added validation for parameter `bindings` to ensure that keys were `String` values.
1535 * Improved Transaction Management consistency in Gremlin Server.
1536 * Added `FileSandboxExtension` which takes a configuration file to white list methods and classes that can be used in `ScriptEngine` execution.
1537 * Deprecated `SandboxExtension` and `SimpleSandboxExtension` in favor of `AbstractSandboxExtension` which provides better abstractions for those writing sandboxes.
1538 * Fixed a long standing "view merge" issue requiring `reduceByKey()` on input data to Spark. It is no longer required.
1539 * Added `Spark` static object to allow "file system" control of persisted RDDs in Spark.
1540 * Added a Spark "job server" to ensure that persisted RDDs are not garbage collected by Spark.
1541 * Improved logging control during builds with Maven.
1542 * Fixed settings that weren't being passed to the Gremlin Driver `Cluster` through configuration file.
1543 * `Column` now implements `Function`. The modulator `by(valueDecr)` can be replaced by `by(values,decr)` and thus, projection and order are separated.
1544 * Added `InputRDDFormat` which wraps an `InputRDD` to make it accessible to Hadoop and not just Spark.
1545 * Added `AbstractSparkTest` which handles closing `SparkContext` instances between tests now that we support persisted contexts.
1546 * Fixed a serialization bug in `GryoSerializer` that made it difficult for graph providers to yield `InputRDDs` for `SparkGraphComputer`.
1547 * `SparkGraphComputer` is now tested against Gryo, GraphSON, and `InputRDD` data sources.
1548 * `HadoopElementIterator` (for Hadoop-Gremlin OLTP) now works for any `InputFormat`, not just `FileInputFormats`.
1549 * Added `Traverser.Admin.getTags()` which are used to mark branches in a traversal (useful in `match()` and related future steps).
1550 * Fixed the `Future` model for `GiraphGraphComputer` and `SparkGraphComputer` so that class loaders are preserved.
1551 * Added support for arbitrary vertex ID types in `BulkLoaderVertexProgram`.
1552 * Deprecated `credentialsDbLocation` from `SimpleAuthenticator` in Gremlin Server.
1553 * `TinkerGraph` has "native" serialization in GraphSON, which enables it to be a return value from Gremlin Server.
1554 * Improved the ability to embed Gremlin Server by providing a way to get the `ServerGremlinExecutor` and improve reusability of `AbstractEvalOpProcessor` and related classes.
1555 * Added `Authenticator.newSaslNegotiator(InetAddress)` and deprecated the zero-arg version of that method.
1556 * `ProfileStep` is now available off of `Traversal` via `profile()`. To be consistent with `Traversal.explain()`.
1557 * If no comparator is provided to `order()`, `Order.incr` is assumed (previously, an exception occurred).
1558 * Fixed various Gremlin-Groovy tests that assumed `toString()`-able ids.
1559 * Split TinkerPop documentation into different directories.
1560 * Added `explain()`-step which yields a `TraversalExplanation` with a pretty `toString()` detailing the compilation process.
1561 * Fixed a traversal strategy ordering bug in `AdjacentToIncidentStrategy` and `IncidentToAdjacentStrategy`.
1562 * Made a number of changes to improve traversal startup and execution performance.
1563 * Added support for 'gremlin.tinkergraph.graphLocation' to accept a fully qualified class name that implements `Io.Builder` interface.
1564
1565 ==== Bugs
1566
1567 * TINKERPOP-763 IsStep broken when profiling is enabled.
1568 * TINKERPOP-972 Cluster::close does not shut down its executor
1569 * TINKERPOP-973 BLVP shouldn't clear configuration properties
1570 * TINKERPOP-976 Fail earlier if invalid version is supplied in validate-distribution.sh
1571 * TINKERPOP-977 Dead link to traversal javadocs
1572 * TINKERPOP-979 ComputerVerificationStrategy not picking up Order local traversal
1573 * TINKERPOP-985 shouldPersistDataOnClose makes incorrect feature check
1574 * TINKERPOP-990 Mixed types in VertexPropertyTest
1575 * TINKERPOP-993 cyclicPath is not(simplePath)
1576 * TINKERPOP-997 FeatureRequirementSet.SIMPLE should not require multi-property *(breaking)*
1577 * TINKERPOP-1000 GremlinGroovyScriptEngineOverGraphTest failures
1578 * TINKERPOP-1001 SugarLoaderPerformanceTest contains hardcoded vertex ids
1579 * TINKERPOP-1002 Should rollback transaction after catching on close
1580 * TINKERPOP-1006 Random error during builds: shouldReloadClassLoaderWhileDoingEvalInSeparateThread()
1581 * TINKERPOP-1011 HadoopGraph can't re-attach when the InputFormat is not a FileInputFormat
1582 * TINKERPOP-1012 BulkLoaderVertexProgram shouldn't assume vertex IDs of type Long
1583 * TINKERPOP-1025 Solve SparkContext Persistence Issues with BulkLoaderVertexProgram
1584 * TINKERPOP-1027 Merge view prior to writing graphRDD to output format/rdd
1585 * TINKERPOP-1036 Support self-looping edges in IO
1586 * TINKERPOP-1052 @Graph.OptOut causes Exception during Suite setup
1587 * TINKERPOP-1060 LambdaRestrictionStrategy too restrictive
1588 * TINKERPOP-1075 Profile duration of cap step seems broken.
1589 * TINKERPOP-1083 Traversal needs a hashCode() and equals() definition.
1590 * TINKERPOP-1089 Order.shuffle implementation is too fragile
1591 * TINKERPOP-1119 LP_O_OB_S_SE_SL_Traverser doesn't have a protected constructor().
1592
1593 ==== Improvements
1594
1595 * TINKERPOP-320 BulkDumperVertexProgram
1596 * TINKERPOP-379 MessageScope.Local.setStaticMessage(M msg)
1597 * TINKERPOP-824 Do we need runtime BigDecimal in more places?
1598 * TINKERPOP-859 Provide a more general way to set log levels in plugins
1599 * TINKERPOP-860 Bindings applied to the PluginAcceptor should appear to Gremlin Server
1600 * TINKERPOP-886 Allow any GraphReader/Writer to be persistence engine for TinkerGraph
1601 * TINKERPOP-891 Re-examine Sandboxing Abstractions
1602 * TINKERPOP-912 Improve the ability to embed Gremlin Server with Channelizer injection
1603 * TINKERPOP-928 Use directories to separate different books
1604 * TINKERPOP-930 Tie Alias to Transaction Manager in Gremlin Server
1605 * TINKERPOP-938 Add a "clear SNAPSHOT jars" section to the process-docs.sh.
1606 * TINKERPOP-941 Improve error message for wrong order().by() arguments
1607 * TINKERPOP-943 Warn if Gremlin Server is running prior to generating docs
1608 * TINKERPOP-945 Exceptions should allow me to include root cause if/when available
1609 * TINKERPOP-952 Include Cardinality.list example in VertexProperty section of main docs.
1610 * TINKERPOP-954 Consistent test directory usage
1611 * TINKERPOP-957 Improve speed of addV()
1612 * TINKERPOP-964 Test XXXGraphComputer on a Hadoop2 cluster (non-pseudocluster).
1613 * TINKERPOP-970 ProfileStep should be off Traversal, not GraphTraversal
1614 * TINKERPOP-978 Native TinkerGraph Serializers for GraphSON
1615 * TINKERPOP-981 Deprecate support for credentialsDbLocation in Gremlin Server Config
1616 * TINKERPOP-982 valuesDecr, valuesIncr, keysDecr, and valuesDecr is lame.
1617 * TINKERPOP-983 Provide a way to track open Graph instances in tests
1618 * TINKERPOP-984 Use GraphProvider for id conversion in Groovy Environment test suite
1619 * TINKERPOP-987 Use tinkerpop.apache.org URL in all documentation and homepage
1620 * TINKERPOP-988 SparkGraphComputer.submit shouldn't use ForkJoinPool.commonPool
1621 * TINKERPOP-992 Better support for schema driven Graphs in IO related tests
1622 * TINKERPOP-994 Driver using deprecated Rebindings Still
1623 * TINKERPOP-995 Add Authenticator.newSaslNegotiator(InetAddress)
1624 * TINKERPOP-996 Please delete old releases from mirroring system
1625 * TINKERPOP-998 Deprecate VertexPropertyFeatures.FEATURE_ADD_PROPERTY
1626 * TINKERPOP-1009 Add a CAUTION to documentation about HadoopGraph and getting back elements
1627 * TINKERPOP-1013 Traverser tags as a safer way of using path labels
1628 * TINKERPOP-1018 Allow setting for maxContentLength to be set from yaml in driver
1629 * TINKERPOP-1019 Convert println in test to SLF4j
1630 * TINKERPOP-1022 Automatically warm up ops handlers
1631 * TINKERPOP-1023 Add a spark variable in SparkGremlinPlugin like we do hdfs for HadoopGremlinPlugin
1632 * TINKERPOP-1026 BVLP should store vertex IDs as String
1633 * TINKERPOP-1033 Store sideEffects as a persisted RDD
1634 * TINKERPOP-1035 Better Consistency in Gremlin Server Transaction Management
1635 * TINKERPOP-1045 Client-Side Hangs when attempting to access a HashMap with Keys of type Integer
1636 * TINKERPOP-1047 TinkerGraph GraphSON storage format broken
1637 * TINKERPOP-1051 Add note in best practice docs about gremlin server heap setting
1638 * TINKERPOP-1055 Gremlin Console FileNotFoundException can be misleading
1639 * TINKERPOP-1062 Make LifeCycle beforeEval execute in same thread as eval operation
1640 * TINKERPOP-1064 Allow a ClassResolver to be added to GryoMapper construction
1641 * TINKERPOP-1065 Fix some typos and clarify some wording in the TinkerPop documentation
1642 * TINKERPOP-1066 Add ioRegistries configuration to GraphSON MessageSerializer
1643 * TINKERPOP-1067 Update Groovy to 2.4.5
1644 * TINKERPOP-1072 Allow the user to set persistence options using StorageLevel.valueOf()
1645 * TINKERPOP-1073 HadoopGraph toString() is weird for Spark PersitedRDD data.
1646 * TINKERPOP-1086 Include gryo serializers for java.time related classes
1647 * TINKERPOP-1087 Add has()/order() to FilterRankStrategy
1648 * TINKERPOP-1093 Add Spark init.sh script and update dev documentation.
1649 * TINKERPOP-1100 Look deeply into adding combine()-support in Spark MapReduce.
1650 * TINKERPOP-1117 InputFormatRDD.readGraphRDD requires a valid gremlin.hadoop.inputLocation, breaking InputFormats (Cassandra, HBase) that don't need one
1651
1652 [[release-3-1-0-incubating]]
1653 === TinkerPop 3.1.0 (Release Date: November 16, 2015)
1654
1655 This release also includes changes from <<release-3-0-1-incubating, 3.0.1-incubating>> and <<release-3-0-2-incubating, 3.0.2-incubating>>.
1656
1657 * Fixed bug in Gryo and GraphSON (with embedded types) serialization for serialization of results returned from `Map.entrySet()`.
1658 * `Transaction` settings for `onReadWrite` and `onClose` are now `ThreadLocal` in nature of standard transactions.
1659 * Optimized `BulkLoaderVertexProgram`. It now uses `EventStrategy` to monitor what the underlying `BulkLoader` implementation does (e.g. whether it creates a new vertex or returns an existing).
1660 * Integrated `NumberHelper` in `SumStep`, `MinStep`, `MaxStep` and `MeanStep` (local and global step variants).
1661 * Gremlin Console remoting to Gremlin Server now supports a configuration option for assigning aliases.
1662 * `CountMatchAlgorithm`, in OLAP, now biases traversal selection towards those traversals that start at the current traverser location to reduce message passing.
1663 * Fixed a file stream bug in Hadoop OLTP that showed up if the streamed file was more than 2G of data.
1664 * Added the ability to set thread local properties in `SparkGraphComputer` when using a persistent context.
1665 * Bumped to Neo4j 2.3.0.
1666 * Deprecated "rebindings" as an argument to Gremlin Server and replaced it with "aliases".
1667 * Added `PersistedInputRDD` and `PersistedOutputRDD` which enables `SparkGraphComputer` to store the graph RDD in the context between jobs (no HDFS serialization required).
1668 * Renamed the `public static String` configuration variable names of TinkerGraph (deprecated old variables).
1669 * Added `GraphComputer.configure(key,value)` to allow engine-specific configurations.
1670 * `GraphStep` is no longer in the `sideEffect`-package and is now in `map`-package (breaking change).
1671 * Added support for mid-traversal `V()`-steps (`GraphStep` semantics updated).
1672 * Fixed `Number` handling in `Operator` enums. Prior this change a lot of operations on mixed `Number` types returned a wrong result (wrong data type).
1673 * Fixed a bug in Gremlin Server/Driver serializer where empty buffers were getting returned in certain cases.
1674 * Renamed `ConjunctionX` to `ConnectiveX` because "conjunction" is assumed "and" (disjunction "or"), where "connective" is the parent concept.
1675 * Removed `PathIdentityStep` as it was a hack that is now solved by `Traversal.Admin.addTraverserRequirement()`.
1676 * Added `Traversal.Admin.addTraverserRequirement()` to allow a traversal strategy or source to add requirements (not only step determined anymore).
1677 * Added `TraverserRequirement.ONE_BULK` to state the traverser does not handle bulk.
1678 * Added `GraphTraversalSource.withBulk(boolean)` to enabled users to compute only using `bulk=1`.
1679 * Gremlin Server supports Netty native transport on linux.
1680 * Removed the need for `GFunction` (etc.) closure wrappers in Gremlin-Groovy as `as Function` can be used to convert closures accordingly.
1681 * Added `SelectColumnStep` (`select(keys)` and `select(values)`). Deprecated `mapKeys()` and `mapValues()`.
1682 * Renamed `gremlin.hadoop.graphInputRDD` and `gremlin.hadoop.graphOutputRDD` to `gremlin.spark.graphInputRDD` and `gremlin.spark.graphOutputRDD`, respectively.
1683 * Fixed a bug in `FoldStep` around bulking. This could be a breaking change, but it is the correct semantics.
1684 * Previous `group()`-behavior steps are accessible via the deprecated `groupV3d0()`-steps.
1685 * `GroupStep` and `GroupSideEffectStep` now do lazy reductions to reduce memory footprint. Breaking change for `group()` semantics.
1686 * Added `GroupStepHelper` with various static methods and classes that are used by both `GroupStep` and `GroupSideEffectStep`.
1687 * Added `BarrierStep` interface with `processAllStarts()` method which process all starts up to yielding the barrier result.
1688 * Fixed a severe threading issue in `TinkerGraphComputer`.
1689 * The location of the jars in HDFS is now `hadoop-gremlin-x.y.z-libs` to ensure multiple TinkerPop versions don't clash.
1690 * `GiraphGraphComputer` will only upload the jars to HDFS if it doesn't already exist (to help speed up startup time).
1691 * `GiraphGraphComputer.workers()` is smart about using threads and machines to load balance TinkerPop workers across cluster.
1692 * `GraphComputer.workers(int)` allows the user to programmatically set the number of workers to spawn.
1693 * Added `GryoSerializer` as the new recommended Spark `Serializer`. Handles `Graph` and `GryoMapper` registries.
1694 * `GryoPool` now makes use of `GryoPool.Builder` for its construction.
1695 * Bumped to Apache Hadoop 2.7.1.
1696 * Bumped to Apache Giraph 1.1.0.
1697 * Bumped to Apache Spark 1.5.1.
1698 * Split Hadoop-Gremlin apart such there is now `hadoop-gremlin`, `spark-gremlin`, and `giraph-gremlin` (and respective `GremlinPlugins`).
1699 * Added `LambdaCollectingBarrierStep` which generalizes `NoOpBarrierStep` and allows for `barrier(normSack)`-type operations.
1700 * Fixed bugs in the Gremlin Server's NIO protocol both on the server and driver side.
1701 * Added `Path.popEquals(Pop,Object)` to check for path equality based on `Pop` (useful for `TraverserRequirement.LABELED_PATH`).
1702 * Added `Operator.assign` to allow setting a direct value.
1703 * `Operator` is now a `BinaryOperator<Object>` with appropriate typecasting for respective number operators.
1704 * Simplified `SackValueStep` so it now supports both `sack(function)` and sack(function).by()`. Deprecated `sack(function,string)`.
1705 * Added `Parameters` object to allow for the parameters of a step to be retrieved at runtime via a traversal.
1706 * Redesigned (though backwards compatible) `AddEdgeStep`, `AddVertexStep`, and `AddPropertyStep` (and respective `GraphTraversal` API).
1707 * Added `GraphTraversalSource.inject()` so users can spawn a traverser with non-graph objects.
1708 * `GraphStep` can now take a single argument `Collection` which is either elements or element ids (i.e. `g.V([1,2,3])` is supported now).
1709 * Added `LoopsStep` to make the loop counter accessible within `repeat()`, `until()` and `emit()`.
1710 * Gephi Plugin no longer requires manual insert of `store` steps to visualize a traversal.
1711 * Added a `TinkerIoRegistry` that registers a custom serializer for Gryo that will serialize an entire `TinkerGraph` instance.
1712 * Added configuration options to Gephi Plugin for setting the size of nodes visualized.
1713 * Replaced `DedupBijectionStrategy` with the more effective `FilterRankingStrategy`.
1714 * `ComputerAwareSteps` must not only handle step ids, but also step labels.
1715 * Renamed `B_O_P_SE_SL_Traverser` to `B_LP_O_P_SE_SL_Traverser` as it now supports `TraverserRequirement.LABELED_PATH`.
1716 * Added `B_LP_O_S_SE_SL_Traverser` in support of `TraverserRequirement.LABELED_PATH`.
1717 * Added `TraverserRequirement.LABELED_PATH` which only generates path data for steps that are labeled (greatly increases the likelihood of bulking).
1718 * Fixed a bug in `Path` usage that required an API update: `Path.addLabel()` is now `Path.extend(Set<String>)` and `Traverser.addLabels(Set<String>)`.
1719 * Made `Path` iterable, so that it can be `unfold()`'ed and used by local steps like `min(local)`, `max(local)`, etc.
1720 * `WhereTraversalStep` and `WherePredicateStep` are now the only "special" `Scoping` steps after `MatchStartStep` in `match()`.
1721
1722 ==== Bugs
1723
1724 * TINKERPOP-774 order / dedup issues
1725 * TINKERPOP-799 [Proposal] with()-modulator for stream level variable binding.
1726 * TINKERPOP-801 groupCount() fails for vertices (elements?) (using Spark)
1727 * TINKERPOP-811 AddPropertyStepTest fails "all of a sudden"
1728 * TINKERPOP-823 addV() broken for multi-value properties
1729 * TINKERPOP-843 Misspecified HADOOP_GREMLIN_LIBS generates NullPointerException
1730 * TINKERPOP-857 Add GraphComputer.config(key,value)
1731 * TINKERPOP-895 Use "as BinaryOperator" and remove GBinaryOperator
1732 * TINKERPOP-903 Fix empty buffer return upon buffer capacity exceeded
1733 * TINKERPOP-910 In session transaction opened from sessionless request
1734 * TINKERPOP-918 ComputerVerificationStrategy is too restrictive
1735 * TINKERPOP-926 Renamed TinkerGraph public statics to common pattern used for other statics.
1736 * TINKERPOP-948 AbstractGremlinProcessTest.checkMap not asserted in GroupTest
1737 * TINKERPOP-953 Artifact equality is not evaluating properly
1738 * TINKERPOP-955 HashMap$Node not serializable
1739
1740 ==== Improvements
1741
1742 * TINKERPOP-297 Ensure Consistent Behavior Over Deleted Elements *(breaking)*
1743 * TINKERPOP-333 Support VertexProperty in PartitionStrategy
1744 * TINKERPOP-391 More fluency in GraphComputer for parameterization.
1745 * TINKERPOP-616 Use Spark 1.3.0 in Hadoop-Gremlin.
1746 * TINKERPOP-624 Passing Detached/Referenced to Graph.vertices/edge()
1747 * TINKERPOP-680 Configurable Channelizer for Gremlin Driver
1748 * TINKERPOP-728 Improve Remote Graph Object Treatment in Console
1749 * TINKERPOP-756 Provide a strict parsing option for GraphMLReader
1750 * TINKERPOP-760 Make loop counter accessible within repeat()
1751 * TINKERPOP-762 Allow mid-traversal V() (and E())
1752 * TINKERPOP-765 Decompose AbstractTransaction for different transactional contexts *(breaking)*
1753 * TINKERPOP-767 Path should play well with "local" steps.
1754 * TINKERPOP-768 MatchStep in OLAP should be smart about current vertex.
1755 * TINKERPOP-769 Make the introduction of the TP3 docs story better.
1756 * TINKERPOP-772 TraverserRequirement.LABELED_PATH
1757 * TINKERPOP-796 Support merge binary operator for Gremlin sacks *(breaking)*
1758 * TINKERPOP-798 [Proposal] Rename mapKeys()/mapValues() to select(keys) and select(values).
1759 * TINKERPOP-802 Provide sack(object) so that the sack can be directly set.
1760 * TINKERPOP-803 A better solution to g.V(someCollection.toArray())
1761 * TINKERPOP-805 Enforce AutoCloseable Semantics on Transaction *(breaking)*
1762 * TINKERPOP-821 Improve testing around TraversalHelper around recursive methods
1763 * TINKERPOP-825 [Proposal] SetBulkStep (sideEffectStep)
1764 * TINKERPOP-826 OneToManyBarrierStrategy
1765 * TINKERPOP-827 Add a console session to the PageRank section of the docs.
1766 * TINKERPOP-829 TinkerGraphComputer should support the user specified thread/worker count.
1767 * TINKERPOP-835 Shade Jackson Dependencies *(breaking)*
1768 * TINKERPOP-836 Support Hadoop2 in place of Hadoop1
1769 * TINKERPOP-850 Reduce Graph.addVertex overload ambiguity *(breaking)*
1770 * TINKERPOP-851 GroupCountStep needs a by() for the count.
1771 * TINKERPOP-861 Solve "The Number Problem" for Operator (and follow on operators)
1772 * TINKERPOP-863 [Proposal] Turn off bulking -- or is there something more general? (hope not).
1773 * TINKERPOP-866 GroupStep and Traversal-Based Reductions *(breaking)*
1774 * TINKERPOP-868 Allow Spark Gremlin Computer to Reuse Spark Contexts
1775 * TINKERPOP-874 Rename Gremlin-Spark properties using gremlin.spark prefix. *(breaking)*
1776 * TINKERPOP-876 Rename VendorOptimizationStrategy XXXOptimizationStrategy *(breaking)*
1777 * TINKERPOP-879 Remove deprecated promoteBindings from GremlinExecutor *(breaking)*
1778 * TINKERPOP-885 Change Transaction.onReadWrite() to be a ThreadLocal setting *(breaking)*
1779 * TINKERPOP-888 GraphTraversal.property overloads *(breaking)*
1780 * TINKERPOP-896 Simplify the {{withSack}} methods of {{GraphTraversalSource}}. *(breaking)*
1781 * TINKERPOP-897 Remove deprecated GSupplier, GFunction, GConsumer, etc. methods. *(breaking)*
1782 * TINKERPOP-898 Rename ConjuctionP and ConjuctionStep to ConnectiveP and ConnectiveStep *(breaking)*
1783 * TINKERPOP-899 Bump to the latest version of Neo4j.
1784 * TINKERPOP-900 Provide by(object) which compiles to by(constant(object))
1785 * TINKERPOP-901 Option for use of Netty epoll on Linux to reduce GC pressure
1786 * TINKERPOP-904 BulkLoaderVertexProgram optimizations
1787 * TINKERPOP-905 Harden time oriented tests in ResultQueueTest
1788 * TINKERPOP-907 getters for RepeatStep.untilTraversal and RepeatStep.emitTraversal
1789 * TINKERPOP-908 Use line breaks in documentation
1790 * TINKERPOP-909 Improve steps that handle numeric data
1791 * TINKERPOP-911 Allow setting Thread Specific Spark JobGroup/Custom Properties based on hadoop conf
1792 * TINKERPOP-913 Rename Gremlin Server arguments rebinding to alias
1793 * TINKERPOP-914 DriverRemoteAcceptor in Gremlin Console supports aliases
1794 * TINKERPOP-917 Add HadoopGraph.open(String)
1795 * TINKERPOP-922 Add a book for Developer Documentation
1796 * TINKERPOP-923 Add a book for Tutorials
1797 * TINKERPOP-925 Use persisted SparkContext to persist an RDD across Spark jobs.
1798 * TINKERPOP-931 Make it possible to extend the core OpProcessor implementations
1799 * TINKERPOP-933 Improve release process to get files named properly
1800 * TINKERPOP-935 Add missing "close" operation to the session opProcessor docs
1801
1802 == TinkerPop 3.0.0 (A Gremlin Rāga in 7/16 Time)
1803
1804 image::https://raw.githubusercontent.com/apache/tinkerpop/master/docs/static/images/gremlin-hindu.png[width=225]
1805
1806 [[release-3-0-2-incubating]]
1807 === TinkerPop 3.0.2 (Release Date: October 19, 2015)
1808
1809 * Cleaned up `ext/` directory when plugin installation fails for `gremlin-server` and `gremlin-console`.
1810 * Fixed issues in `gremlin-server` when configured for HTTP basic authentication.
1811 * Made `BulkLoaderVertexProgram` work for any persistent TP3-supporting graph (input and output).
1812 * `TreeSideEffectStep` now implements `PathProcessor` which fixed a `ComputerVerificationStrategy` issue.
1813 * Added a shell script that verifies source and binary distributions.
1814 * Fixed a bulk related bug in `GroupStep` when used on `GraphComputer` (OLAP).
1815 * Gremlin Server binary distribution now packages `tinkergraph-gremlin` and `gremlin-groovy` as plugins to be consistent with Gremlin Console's packaging.
1816 * The `RepeatStep` clauses (`until()`,`emit()`,`repeat()`) can only be set at most one time in order to prevent user confusion.
1817 * Fixed a `clone()` bug in `RepeatStep`, `TreeStep`, `GroupCountStep`, `GroupStep`, and `TraversalRing`.
1818 * Fixed a thread context bug in `TinkerGraphComputer`.
1819 * Fixed issues with the `gremlin-driver` related to hanging connections in certain conditions.
1820 * TinkerGraph now has an option for persistence where the data is saved on `close()` and, if present, loaded on `open()`.
1821 * Added an overload for `GremlinExecutor.eval()` that takes a `Lifecycle` object to override some default settings from `GremlinExecutor.Builder`.
1822 * Improved session closing for transactional graphs during shutdown of Gremlin Server.
1823 * Fixed id parameter used in tests for `GroovyStoreTest` and `GroovyRepeatTest` to not be treated as an embedded string.
1824 * `GraphStep` will convert any `Vertex` or `Edge` ids to their id `Object` prior to submission to `GraphComputer` (OLAP).
1825
1826 ==== Bugs
1827
1828 * TINKERPOP-814 ConnectionPool can fill with dead Connections
1829 * TINKERPOP-816 Gryo deserialization of error response with null message causes NPE and protocol desync
1830 * TINKERPOP-817 Gryo serialization of large responses fails and causes protocol desync
1831 * TINKERPOP-840 TreeTest Is not being ignored via ComputerVerificationStrategy
1832 * TINKERPOP-849 gremlin-server doesn't close sessions on 'close' opcode
1833 * TINKERPOP-855 sasl authentication type error due to Json format
1834 * TINKERPOP-865 Errors with HTTP REST basic auth
1835 * TINKERPOP-867 TinkerGraphProvider does not initialize temp dir
1836 * TINKERPOP-870 Rebound client requires a connection to occur on the underlying client.
1837 * TINKERPOP-877 Driver hangs if SSL enabled on server but not on client
1838
1839 ==== Improvements
1840
1841 * TINKERPOP-828 TinkerGraph can supportPersistence(), should we allow it.
1842 * TINKERPOP-830 process-docs.sh introduces extra white space dependent on console width
1843 * TINKERPOP-839 Docs should have a ${version.number} under the logo.
1844 * TINKERPOP-852 A shell script that validates the distribution artifacts at release time
1845 * TINKERPOP-853 TinkerPop Logo in JavaDoc index.html
1846 * TINKERPOP-858 Cleanup after failed :install
1847
1848 [[release-3-0-1-incubating]]
1849 === TinkerPop 3.0.1 (Release Date: September 2, 2015)
1850
1851 * `Compare` now uses `BigDecimal` internally to ensure that precision is not lost on standard number comparisons.
1852 * Renamed `ComputerVerificationStrategy` to `VerificationStrategy` so all the verification strategies can use it.
1853 * Added `StandardVerificationStrategy` that throws exceptions for illegal traversal patterns on the standard engine (which extends to `GraphComputer`).
1854 * Added `GraphFeatures.supportsConcurrentAccess()` to allows `Graph` implementations to signify if multiple instances can access the same data.
1855 * Clarified semantics of `Transaction.close()` in unit tests - now refers only to closing the current transaction in the current thread.
1856 * `Neo4jGraph` no longer uses `OptOut` on `TransactionTest.shouldRollbackOnCloseWhenConfigured` (formerly `shouldRollbackOnShutdownWhenConfigured`)
1857 * Gremlin Server initialization scripts can now return a `Map` of values that will become global bindings for the server.
1858 * Introduced the `--dryRun` option to the document generation process which ignores actual script execution in the Gremlin Console.
1859 * Fixed bug in `EventStrategy` around property changed events when calling `property` without cardinality or meta-property values.
1860 * Improved support for the `Accept` header for REST-based requests in Gremlin Server.
1861 * `GraphFactory` now allows specification of the class to use to instantiate the `Graph` through the `GraphFactoryClass` annotation.
1862 * Added `wrapAdjacencyList` and `unwrapAdjacencyList` options to `GraphSONWriter` and `GraphSONReader` respectively, thus allowing valid JSON to be written/read if the user desires.
1863 * Added Gremlin Server/Driver authentication support via SASL.
1864 * Added Basic HTTP authentication support for REST in Gremlin Server.
1865 * Added Gremlin Server plugin to help with "credential graph" management (used in conjunction with authentication features of Gremlin Server).
1866 * Added "secure" Gremlin Server/Driver example configuration files.
1867 * Adjusted configuration for javadoc generation to eliminate error messages.
1868 * Removed "reserved" graph concept names from tests (e.g. "label", "edge", "value") to support the convention of avoiding these strings for property names.
1869 * Introduced `GraphProvider.Descriptor` which annotates a `GraphProvider` implementation to describe what `GraphComputer` implementation will be used.
1870 * Modified `OptOut` to include a `computers` attribute which allows the `Graph` to opt-out of computer-based tests for specific computation engines.
1871 * Added a `SandboxExtension` that can be plugged into `TypeCheckedCustomizerProvider` and `CompileStaticCustomizerProvider` to control classes and methods that can be used in the `GremlinGroovyScriptEngine`.
1872 * Added a number of new `ImportCustomizerProvider` implementations such as, `TimedInterruptCustomizerProvider`, `TypeCheckedCustomizerProvider` and others.
1873 * Refactored `GremlinGroovyScriptEngine` to make more general use of `ImportCustomizerProvider` implementations.
1874 * Removed `SecurityCustomizerProvider` class and the "sandbox" configuration on the `ScriptEngines` class - this was an experimental feature and not meant for public use.
1875 * Removed dependency on `groovy-sandbox` from the `gremlin-groovy` module.
1876
1877 ==== Bugs
1878
1879 * TINKERPOP-770 Exception while AddPropertyStep tries to detach vertex property
1880 * TINKERPOP-780 Use of fold() in repeat()
1881 * TINKERPOP-782 map(Traversal) should declare requirements of child
1882 * TINKERPOP-785 Gremlin Server Not Properly Reporting Port Conflict
1883 * TINKERPOP-792 select at start of match traversal on Map can fail
1884 * TINKERPOP-794 IncidentToAdjecentStrategy malfunction
1885 * TINKERPOP-804 Failed installing neo4j-gremlin extension on Windows 7
1886 * TINKERPOP-822 Neo4j GraphStep with element arguments ignores has  *(breaking)*
1887
1888 ==== Improvements
1889
1890 * TINKERPOP-576 Gremlin Server Authentication
1891 * TINKERPOP-582 Remove Groovy Sandbox Dependency
1892 * TINKERPOP-610 General graph concept names in test schema
1893 * TINKERPOP-656 IoRegistry Chaining
1894 * TINKERPOP-690 Be able to OPT_OUT for Standard, but not Computer *(breaking)*
1895 * TINKERPOP-699 GraphSON writeGraph not producing valid json object
1896 * TINKERPOP-750 Compare should not have special case for Number
1897 * TINKERPOP-752 Make Gremlin Server Better Respect ACCEPT
1898 * TINKERPOP-764 Unify semantics of Transaction.close() in tests and documentation *(breaking)*
1899 * TINKERPOP-771 IoRegistry Instantiation With GryoPool
1900 * TINKERPOP-778 Support GraphFactory location via annotation.
1901 * TINKERPOP-791 Document rules for committers
1902 * TINKERPOP-797 order() seems to only like List? *(breaking)*
1903 * TINKERPOP-808 TraversalComparator.comparator needs a getter
1904
1905 === TinkerPop 3.0.0 (Release Date: July 9, 2015)
1906
1907 * Modified the `GremlinExecutor` to catch `Throwable` as opposed to `Exception` so as to properly handle `Error` based exceptions.
1908 * Modified the `GremlinGroovyScriptEngine` compilation configuration to prevent inappropriate script evaluation timeouts on standalone functions.
1909 * Added a custom configuration for "timed interrupt" in the `ScriptEngines` instantiation of the `GremlinGroovyScriptEngine`.
1910 * Added `mapKeys()` (`MapKeyStep`) and `mapValues()` (`MapValueStep`) to get the keys and values of a map, respectively.
1911 * `select()` no longer supports empty arguments. The user must specify the keys they are selecting.
1912 * `MatchStep` and `match()` no longer have a "start label" parameter -- it is computed if the incoming traverser does not have requisite labels.
1913 * Turned transactional testing back on in Gremlin Server using Neo4j.
1914 * Renamed `Transaction.create()` to `Transaction.createThreadedTx()`.
1915 * Added `TraversalParent.removeGlobalChild()` and `TraversalParent.removeLocalChild()`.
1916 * Added a `clear` option to the Gephi Plugin to empty the Gephi workspace.
1917 * Refactored `ResultSet` and related classes to stop polling for results.
1918 * `AbstractStep` now guarantees that bulk-less and null-valued traversers are never propagated.
1919 * Added `dedup(string...)` which allows for the deduplication of a stream based on unique scope values.
1920 * Fixed multiple bugs in the Gephi Plugin related to refactoring of traversal side-effects.
1921 * Split `WhereStep` into `WherePredicateStep` and `WhereTraversalStep` to simplify internals.
1922 * Prevent the driver from attempting to reconnect on a dead host if the `Cluster.close()` method has been called.
1923 * Renamed the "deactivate" option on `:plugin` command to "unuse" to be symmetric with the "use" option.
1924 * Added `Traversal.toStream()` to turn the `Traversal<S,E>` into a `Stream<E>`.
1925 * Added `Scoping.Variable` enum of `START` and `END` which allows the `Scoping` step to specify where its bindings are.
1926 * `ComputerVerificationStrategy` is smart about not allowing `WhereXXXStep` with a start-variable to run in OLAP as it selects the value from the path.
1927 * Rewrote `MatchStep` where it now works on `GraphComputer`, solves more patterns, provides plugable execution plans, supports nested AND/OR, `not()`-patterns, etc.
1928 * Renamed `Graphs` in Gremlin Server to `GraphManager`.
1929 * Fixed bug in Gremlin Driver where client-side serialization errors would not bubble up properly.
1930 * Fixed problem in Gremlin Server to ensure that a final `SUCCESS` or `NO_CONTENT` message assured that the transaction was successful in sessionless requests.
1931 * Arrow keys for cycling through command history now work in Gremlin Console when being used on Windows.
1932 * Added `NotStep` and `not(traversal)` for not'ing a traversal (integrates like `ConjunctionStep`).
1933 * Removed `TraversalP`. Traversals and `P`-predicates are completely separate concepts.
1934 * `has(key,traversal)` is now an alias for `filter(__.values(key).traversal)` using `TraversalFilterStep`.
1935 * Simplified `SubgraphStrategy` by using `TraversalFilterStep` instead of the more complex `WhereStep`.
1936 * Added `TraversalMapStep`, `TraversalFlatMapStep`, `TraversalFilterStep`, and `TraversalSideEffectStep` which all leverage an internal traversal.
1937 * Added `Path.get(pop,label)` as default helpers in `Path`.
1938 * Added `Pop.first`, `Pop.last`, and `Pop.all` as enums for getting single items from a collection or a list of said items.
1939 * Changed `GremlinServer.start()` to return a `CompletableFuture` that contains the constructed `ServerGremlinExecutor`.
1940 * Restructured `IoTest` breaking it up into smaller and more logically grouped test cases.
1941 * Gremlin Server `Settings` now has sensible defaults thus allowing the server to be started with no additional configuration.
1942 * Fixed garbled characters in Gremlin Console that notably showed up in `:help`
1943 * Replaced dependency on `groovy-all` with individual Groovy dependencies as needed.
1944 * Bumped `org.gperfutils:gbench` to the `0.4.3` and a version explicitly compatible with Groovy 2.4.x.
1945 * Renamed `KeyStep` to `PropertyKeyStep` to be consistent with `PropertyValueStep`.
1946 * Added `Gremlin-Lib-Paths` to modify paths in plugin `lib` directory.
1947 * Modified the capabilities of `Gremlin-Plugin-Paths` to delete paths that have no value on the right-hand-side of the equals sign.
1948 * The REST API in Gremlin Server now requires parameters to be defined with a "bindings." prefix.
1949 * Modified the REST API in Gremlin Server to accept rebindings.
1950 * Added `rebindings` optional argument to sessionless requests to allow global bindings to be rebound as needed.
1951 * Added `LazyBarrierStrategy` which "stalls" a traversal of a particular form in order to gain a bulking optimization.
1952 * `CollectingBarrierStep` supports `maxBarrierSize` for "lazy barrier," memory conservation.
1953 * `Scoping` now has `getScopeKeys()` to get the keys desired by the scoping step.
1954 * Refactored SSL support in the Gremlin Server/Driver.
1955 * Factored out `ServerGremlinExecutor` which contains the core elements of server-side script execution in Gremlin Server.
1956 * Bumped to netty 4.0.28.Final.
1957 * Refactored the `Mutating` interface and introduce `CallbackRegistry` interface around `EventStrategy`.
1958 * Changed `onReadWrite` and `onClose` of `AbstractTransaction` to be synchronized.
1959 * Added `LabelP` to support index lookups and `has()` filtering on `Neo4jGraph` multi-label vertices.
1960 * `AddEdgeStep` is now a `Scoping` step.
1961 * Added a fully defined set of `Graph.Feature` implementations to `EmptyGraph`.
1962 * Dropped dependency on `org.json:json` - used existing Jackson dependency.
1963 * Added back neo4j-gremlin as the licensing of the Neo4j API is now Apache2.
1964 * Added `willAllowId` method to features related to vertices, edges and vertex properties to test if an identifier can be use when `supportsUserSuppliedIds` is `true`.
1965 * Fixed a bug in `GraphTraversal.choose(predicate,trueTraversal,falseTraversal)`.
1966 * Removed `MapTraversal`, `MapTraverserTraversal`, `FilterTraversal`, and `FilterTraverserTraversal` as these are simply `__.map(function)` and `__.filter(predicate)`.
1967 * Include `hadoop-gremlin` Hadoop configuration sample files in Gremlin Console distribution.
1968 * Iteration of results in Gremlin Server occur in the same thread as evaluation and prior to transaction close.
1969 * TinkerGraphComputer now supports every `ResultGraph`/`Persist` combination.
1970 * `GraphComputerTest` extended with validation of the semantics of all `ResultGraph`/`Persist` combinations.
1971 * GiraphGraphComputer no longer requires an extra iteration and MapReduce job to derive the full `Memory` result.
1972 * SparkGraphComputer now supports `InputRDD` and `OutputRDD` to allow vendors/users to use a `SparkContext` to read/write the graph adjacency list.
1973 * Added `Scoping.getScopeValue()` method so all "selecting" steps use the same pattern for map, path, and sideEffect data retrieval.
1974
1975 === TinkerPop 3.0.0.M9 (Release Date: May 26, 2015)
1976
1977 * Removed `GraphComputer.isolation()` as all implementations use standard BSP.
1978 * Added a Gremlin Server `LifeCycleHook` to ensure that certain scripts execute once at startup and once at shutdown.
1979 * `has(key)` and `hasNot(key)` are now aliases for `where(values(key))` and `where(not(values(key)))`, respectively.
1980 * TinkerGraph classes are now final to restrict user and vendor extension.
1981 * Added `TraversalStrategy.VendorOptimization` to ensure that all TinkerPop optimizations execute first on the known TinkerPop steps.
1982 * Added `TailGlobalStep` and `TailLocalStep` (`tail()`) which gets objects from the end of the traversal stream.
1983 * `AndStep` and `OrStep` are now simply markers where `WhereStep(a.and(b).and(c)...and(z))` is the compilation.
1984 * Moved `Compare`, `Contains`, `Order`, `Operator`, and `P` to `process/traversal` from `structure/` as they are process-based objects.
1985 * `HasContainer` now uses `P` predicate as helper methods and tests are more thorough on `P`.
1986 * Changed Gremlin Server integration/performance tests to be runnable from within the `gremlin-server` directory or from the project root.
1987 * Moved the string methods of `TraversalHelper` to `StringFactory`.
1988 * Renamed JSON-related serializers for Gremlin Server to be more consistent with GraphSON naming.
1989 * Removed `HasTraversalStep` in favor of new `P.traversal` model with `HasStep`.
1990 * Fixed bug in `WsGremlinTextRequestDecoder` where custom serializers from graphs were not being used.
1991 * Added `AndP` which allows for the `and()`-ing of `P` predicates.
1992 * `Order.opposite()` is now `reversed()` as that is a `Comparator` interface method with the same semantics.
1993 * `Compare/Contains/P.opposite()` are now `negate()` as that is a `BiPredicate` interface method with the same semantics.
1994 * `has(traversal)` is replaced by `where(traversal)` and `has(key,traversal)`. `HasXXX` is always with respects to an element property.
1995 * Added `TraversalScriptHelper` with static methods for dynamically creating a `Traversal` from a JSR 223 `ScriptEngine`.
1996 * Changed `SubgraphStrategy` to take `Traversal` rather than `Predicate` for filtering.
1997 * Improved `SubgraphStrategy` to only modify the `Traversal` if filtering was required.
1998 * Improved logging of errors in the `HttpGremlinEndpointHandler` to include a stracktrace if one was present.
1999 * Moved `AbstractGremlinSuite.GraphProviderClass` to `org.apache.tinkerpop.gremlin.GraphProviderClass`.
2000 * Simplified the Gremlin-Groovy test suite where there is now no distinction between `STANDARD` and `COMPUTER` tests.
2001 * `VertexProgram` and `MapReduce` now add a `Graph` parameter to `loadState(Graph, Configuration)`.
2002 * Added `ScopingStrategy` which auto-scopes `select()` and `where()` so the language looks clean.
2003 * Added `Scoping` as a marker interface to state that a step desires a particular `Scope`.
2004 * `SelectStep`, `SelectOneStep`, and `WhereStep` support both `Scope.local` and `Scope.global` for `Map<String,Object>` or `Path` analysis, respectively.
2005 * Fixed a bug in the `TraversalStrategies` sort algorithm.
2006 * Removed numerous unused static utility methods in `TraversalHelper`.
2007 * TinkerGraph process suite tests are now running with and without strategies in place.
2008 * Added `IncidentToAdjacentStrategy` which rewrites `outE().inV()`, `inE().outV()` and `bothE().otherV()` to `out()`, `in()` and `both()` respectively.
2009 * Renamed `ComparatorHolderRemovalStrategy` to `OrderGlobalRemovalStrategy` as it now only applies to `OrderGlobalStep`.
2010 * Anonymous traversal no longer have `EmptyGraph` as their graph, but instead use `Optional<Graph>.isPresent() == false`.
2011 * Added `Traversal.Admin.setGraph(Graph)` as strategies that need reference to the graph, need it across all nested traversals.
2012 * `AbstractLambdaTraversal` is now smart about `TraversalParent` and `TraversalStrategies`.
2013 * Fixed bug in `GraphML` reader that was not allowing `<edge>` elements to come before `<node>` elements as allowable by the GraphML specification.
2014 * Added `VertexFeature.getCardinality`.
2015 * Added `AdjacentToIncidentStrategy` which rewrites `out().count()` to `outE().count()` (and similar such patterns).
2016 * `GryoPool` now takes a `Configuration` object which allows setting the size of the pool and the `IoRegistry` instance.
2017 * Added `PersistResultGraphAware` interface which is used by `OutputFormats` to specify persistence possibilities for a Hadoop `GraphComputer`.
2018 * `ElementIdStrategy` now allows the identifier property to be set directly (and not only by specifying `T.id`).
2019 * Added sample configuration files for registering a `TraversalStrategy` in Gremlin Server.
2020 * Added response status code for `NO_CONTENT` to represent output for a successful script execution without a result (e.g. an empty `Iterator`).
2021 * Removed the notion of a "terminator" message from the Gremlin Server protocol - new response status code for `PARTIAL_CONTENT`.
2022 * `Path` and `Step` labels are ordered by the order in which the respective `addLabel()` calls were made.
2023 * A `Step` now has a `Set<String>` of labels. Updated `as()` to take a var args of labels.
2024 * Dropped `BatchGraph` from the code base - it will be replaced by bulk loader functionality over OLAP.
2025 * `TraversalSideEffects` now implements `Optional` semantics. Less code as Java8 provides the helper methods.
2026 * `TraversalScriptSupplier` now takes an `Object` var args for setting `ScriptEngine` bindings if needed.
2027 * `Compare` is now more lenient on `Number`-types.
2028 * Removed `Compare.inside` and `Compare.outside` as they are not primitive comparators and should be composed from primitives.
2029 * Introduced `P` (predicate) for cleaner looking `is()`, `has()`, and `where()` calls -- e.g. `has('age',eq(32))`.
2030 * `GraphTraversalSource` is now the location for `withXXX()` operations. No longer do they exist at `GraphTraversal`.
2031 * All `Traverser` objects now extend from `AbstractTraverser` or a child that ultimately extends from `AbstractTraverser`.
2032 * OLTP `select()` now returns a list for traversals with duplicate labels (as this was a unintended side-effect of `SparsePath`).
2033 * Removed the `SparsePath` optimization as it led to numerous corner-case inconsistencies.
2034 * `VertexWritable` serializes and deserializes the `StarGraph` object -- no more intermediate `DetachedXXX` objects.
2035 * Gremlin Server better supports the settings for the high and low watermark that will slow writes to clients that are lagging.
2036 * Added `GraphReader.readObject()` and `GraphWriter.writeObject` abstractions for those implementations that can support them.
2037 * Altered `GraphWriter.writeVertices()` method to take an `Iterator` of vertices rather than a `Traversal`.
2038 * GraphSON format for output from `GraphWriter.writeVertex`, `GraphWriter.writeVertices`, and `GraphWriter.writeGraph` have all changed now that they use `StarGraph` serialization.
2039 * Gryo format for output from `GraphWriter.writeVertex`, `GraphWriter.writeVertices`, and `GraphWriter.writeGraph` have all changed now that they use `StarGraph` serialization.
2040 * Added read and write methods to `GraphReader` and `GraphWriter` for `Property` and `VertexProperty`.
2041 * Reduced object creation in GraphSON during serialization.
2042 * Moved `T` tokens to the `structure/` package as its more general than `process/`.
2043 * `Attachable.attach()` now takes a `Method` to determine whether to attach via `GET`, `CREATE`, or `GET_OR_CREATE`.
2044 * Decreased size of Gremlin Server `RequestMessage` and `ResponseMessage` serialization payloads and reduced object creation.
2045 * `Graph.empty()` no longer required with the introduction of `ShellGraph` which is a placeholder for a graph class and computer.
2046 * `VertexProperty.Cardinality` default is now vendor chosen. If the vendor has not preference, they should use `Cardinality.single`.
2047 * `Messenger.receiveMessages()` no longer takes a `MessageScope` and thus, consistent behavior between message-passing and message-pulling systems.
2048 * Changed the `gremlin.tests` environment variable for test filtering to the more standard convention of `GREMLIN_TESTS` and made it work for all test suites.
2049 * Removed `back()`-step as `select()`-step provides the same behavior with more intelligent optimizations and `by()`-modulation.
2050 * Removed `Graph.Helper` method annotation and related infrastructure in tests.
2051 * Modified header of Gryo to be 16 bytes instead of 32 (and removed the version stamp).
2052 * Removed the concept of handling version in Gryo via the builder as it wasn't really accomplishing the capability of ensuring backward compatibility.
2053 * Moved `Exceptions.propertyRemovalNotSupported` from `Element` to `Property` for consistency.
2054 * Provided a method for Gremlin Server to bind `TraversalSource` objects for use in scripts.
2055 * Modified the reference implementation for dealing with "custom" identifier serialization in GraphSON - See `IoTest.CustomId` for the example.
2056 * Modified `g.vertices/edges` and related methods and tests to support non-type specific querying (e.g. `g.V(1)` and `g.V(1L)` should both return the same result now).
2057 * `TinkerGraph` supports an `IdManager` which helps enforce identifier types and improve flexibility in terms of how it will respond to queries around identifiers.
2058 * `DetachedXXX` now uses the standard `structure/` exceptions for unsupported operations.
2059 * Added private constructors to all `Exceptions` inner classes in the respective `structure/` interfaces.
2060 * Re-introduced `ReferenceXXX` to ensure a smaller data footprint in OLAP situation (`DetachedXXX` uses too much data).
2061 * `Attachable` now has a set of static exception messages in an `Exceptions` inner class.
2062 * Added `StarGraph` which is a heap efficient representation of a vertex and its incident edges (useful for `GraphComputer` implementations).
2063 * `TraverserSet` uses a `FastNoSuchElementException` on `remove()` for increased performance.
2064 * Add `Profiling` interface to enable vendors to receive a `Step's MutableMetrics`.
2065
2066 === TinkerPop 3.0.0.M8 (Release Date: April 6, 2015)
2067
2068 * Removed Neo4j-Gremlin from this distribution due to GPL licensing. Working with Neo4j team to reintroduce by M9.
2069 * Altered structure of plugin directories for Gremlin Server and Gremlin Console to allow for the full `lib` directory with all dependencies and the lighter `plugin` directory which contains filtered dependencies given the path.
2070 * Improved `OptOut` to allow for exclusion of a group of tests by specifying a base test class.
2071 * `GraphComputerTest` is now Java8 specific and much easier to extend with new test cases.
2072 * Merged the `gremlin-algorithm` module into `gremlin-test`.
2073 * Removed `LambdaVertexProgram` and `LambdaMapReduce` as it will be one less thing to maintain.
2074 * Gremlin Console accepts a `max-iteration` configuration via the standard `:set` command to limit result iteration.
2075 * `Vertex.property()` default behavior is now `Cardinality.single`.
2076 * Added `ElementIdStrategy` as a `TraversalStrategy`.
2077 * Introduce `AbstractTransaction` to simplify implementation of standard transactional features for vendors.
2078 * Added `EventStrategy` to generate `Graph` modification events to listeners.
2079 * Added test to enforce return of an empty `Property` on `VertexProperty.property(k)` if no meta properties exist.
2080 * Added methods to registered transaction completion listeners on `Transaction` and provided a default implementation.
2081 * Fixed bug in Neo4j where return of an empty meta property was returning a `NullPointerException`.
2082 * Refactored step API -- the TinkerPop3 steps are the foundation for any domain specific language (including graph).
2083 * `MapReduce` now has `workerStart(Stage)` and `workerEnd(Stage)` methods with analagous semantics to `VertexProgram`.
2084 * Hadoop-Gremlin `ObjectWritable` now leverages Kryo for data serialization.
2085 * `GiraphGraphComputer` supports arbitrary objects as the vertex id -- previously, only long ids were supported.
2086 * Added `VertexProgramPool` to support thread safe pooling of vertex programs for graph computers that provide threaded workers.
2087 * Added `GryoPool` to support thread safe pooling of Gryo readers and writers.
2088 * Added `TraversalSource` which contextualizes a traversal to a graph, DSL, execution engine, and runtime strategies.
2089 * Added `AddVertexStep` (`addV`), `AddPropertyStep` (`property`), and changed `AddEdgeStep` to a map-step instead of a sideEffect-step.
2090 * Added `compile` method to `GremlinExecutor` and related classes.
2091 * Fixed bug in Gremlin Server that was generating extra response messages on script evaluation errors.
2092 * Changed the `Memory` API to not return the mutated value on `or`, `and`, `incr` as it is too difficult to implement faithfully in a distributed system.
2093 * Added `SparkGraphComputer` to Hadoop-Gremlin which uses Apache Spark as the underlying computing engine.
2094 * Renamed "Gremlin Kryo" to "Gryo".
2095 * Refactored `TinkerWorkerPool` to use `ExecutorService` so as to reuse threads when executing graph computer functions.
2096 * Removed `Reducing.Reducer` and `ReducingStrategy`. Previous `Reducing` classes are now `MapReducer` classes.
2097 * Refactored the "process" test suite to allow for better test configuration with respect to different `TraversalEngine` implementations.
2098 * Added `hasNot(traversal)` which is a faster way of doing `has(traversal.count().is(0L))`.
2099 * `TraversalStrategy.apply(traversal)` is the new method signature as the `TraversalEngine` can be retrieved from the `Traversal`.
2100 * `TraversalEngine` is now an interface and provided to the traversal by the graph. `Graph` methods added to set the desired traversal engine to use.
2101 * Added `count(local)`, `sum(local)`, `max(local)`, `min(local)`, `mean(local)`, `dedup(local)`, `sample(local)` and `range(local)` for operating on the local object (e.g. collection, map, etc.).
2102 * `TraversalComparator` exists which allows for `order().by(outE().count(),decr)`.
2103 * Added Apache Rat plugin to detect the proper inclusion of license headers in files.
2104 * A `Traversal` now respects thread interruption during iteration, throwing a `TraversalInterruptionException` if it encounters interruption on the current thread.
2105 * Apache refactoring: `com.tinkerpop` -> `org.apache.tinkerpop`.
2106 * `Traversal` is now `Serializable` and with most queries no longer needing lambdas, Gremlin-Java works over the wire.
2107 * Added `VertexProperty.Cardinality` with `list`, `set`, and `single`. No more `Vertex.singleProperty()` method.
2108 * Added `RangeByIsCountStrategy` that adds a `RangeStep` in front of `.count().is(<predicate>, <value>)` to minimize the amount of fetched elements.
2109 * Added `CoalesceStep` / `coalesce()` that emits the first traversal which emits at least one element.
2110 * Added more syntactic sugar tricks to the Gremlin sugar plugin -- `&`, `|`, `select from`, `gt`, etc.
2111 * `Traversal.Admin` is consistent internal to steps, traversals, strategies, etc. For the user, `Traversal` is all they see.
2112 * `TraversalHolder` is now called `TraversalParent` with the child/parent terminology used throughout.
2113 * Added `GroovyEnvironmentPerformanceSuite`.
2114 * Provided more robust shutdown capabilities for the thread pools used in `GremlinExecutor`.
2115 * A massive `process/` package reorganization -- class names are still the same, just in new packages.
2116 * Bumped `neo4j-graph` to Neo4j 2.1.6.
2117 * Bumped to Groovy 2.4.1.
2118 * Added a new "performance" test suite for Gremlin Process.
2119 * Steps now only operate with traversals -- no more lambdas. Lambda->`Traversal` conversion utilities added.
2120 * `SideEffectStep` always requires a `Consumer`. Steps that were consumer-less simply extends `AbstractStep`.
2121 * Simplified the `Neo4jGraph` implementation by now allowing `cypher()` mid-traversal. Only available via `g.cypher()`.
2122 * Moved `clock()` out of the Utility plugin. It is now available to both Groovy and Java.
2123 * Changed the `OptOut` annotation to allow for ignoring an entire test case using a wildcard.
2124 * Added `AndStep` and `OrStep` filters to support arbitrary conjunction of traversals.
2125 * `__` is now a class with static `GraphTraversal` methods and thus `repeat(out())` is possible.
2126 * Added `IsStep` / `.is()` that supports filtering scalar values.
2127 * `Neo4jGraph` and `TinkerGraph` no longer create new `Feature` instances on each feature check.
2128 * Added `Compare.inside` and `Compare.outside` for testing ranges. Removed `between()` as now its `has('age',inside,[10,30])`.
2129 * `GraphTraversal.has()` no longer requires the element type to be cast in the traversal definition.
2130 * Fixed a `ConcurrentModificationException` bug in TinkerGraph that occurred when doing full vertex/edge scans and removing elements along the way.
2131 * Added `Scope.local` and `Scope.global` in support of `OrderLocalStep` and `OrderGlobalStep` via `order(scope)`.
2132 * Added `Order.keyIncr`, `Order.keyDecr`, `Order.valueIncr`, and `Order.valueDecr` in support of `Map` sorting.
2133 * Added `Order.shuffle` and removed `shuffle()` in favor of `order().by(shuffle)`.
2134 * Changed `Order implements Comparator<Comparable>` to `Order implements Comparator<Object>` as its now generalized to multiple types of objects.
2135 * The `maxContentLength` setting in Gremlin Server is now respected by the HTTP/REST Gremlin endpoint.
2136 * Fixed resource leak in the HTTP/REST Gremlin endpoint of Gremlin Server.
2137 * Refactored Gremlin Server `start` and `stop` functions to return `CompletableFuture`.
2138 * HTTP REST error response JSON objects from Gremlin Server should no longer have issues with control characters, line feeds, etc.
2139 * Added `MeanStep`, `mean()`, and `MeanNumber` for calculating number averages in a traversal.
2140 * Greatly simplified all the traversal `MapReduce` implementations due to the introduction of `VertexTraversalSideEffects`.
2141 * Added `VertexTraversalSideEffects` as a cheap, static way to get a sideEffect-view of a vertex in OLAP.
2142 * Added `TraversalHelper.isLocalStarGraph()` which determines if a traversal is contained within the local star graph.
2143 * Added `TraversalVerificationStrategy` to verify if the traversal can be executed on respective engine.
2144 * Refactored `GraphTraversal.cap()` to `GraphTraversal.cap(String...)` to support multi-sideEffect grabs.
2145 * Added GraphSON serialization for `Path`.
2146 * Added `Traversal.Admin.getTraverserRequirements()` and removed `TraversalHelper.getTraverserRequirements(Traversal)`.
2147 * `Traversal.equals()` is no longer computed by determining if the objects returned are equal.
2148 * Altered messaging in Gremlin Console when using a remote that is not yet activated.
2149 * Fixed potential for deadlock in Gremlin Driver when waiting for results from the server.
2150 * Added the `useMapperFromGraph` serializer option to the Gremlin Server configuration file to allow auto-registration of serialization classes.
2151 * Refactored Netty pipeline structure to not have a second "Gremlin" executor group and instead used a standard `ExecutorService`.
2152 * Refactored the `GremlinExecutor` to take an optional transformation function so as to allow manipulation of results from `eval` in the same thread of execution.
2153 * Fixed issue with the `HttpGremlinEndpointHandler` where requests were getting blocked when `keep-alive` was on.
2154 * Added `MinStep` and `MaxStep` with respective `min()` and `max()`.
2155 * `CountStep` and `SumStep` now extend `ReducingBarrierStep` and no longer are sideEffect steps.
2156 * `SideEffectCapStep` now extends `SupplyingBarrier` and is much simpler than before.
2157 * Added `SupplyingBarrier` which simply drains the traversal and emits the value of a provided supplier.
2158 * Added `TraversalLambda` which implements function, predicate, and consumer over a provided traversal.
2159 * Any non-core `Step` that takes a function or predicate can now take a traversal which maps to `traversal.next()` (function) and `traversal.hasNext()` (predicate).
2160 * `CollectingBarrierStep` is no longer abstract and added `GraphTraversal.barrier()` which is analogous to `fold().unfold()`, though cheaper.
2161 * Added `TraversalOptionHolder` for branching steps to index works with corresponding `GraphTraversal.option()`.
2162 * `BranchStep` is now a proper generalization of `UnionStep` and `ChooseStep`.
2163 * `SubgraphStep` has changed in support of in-traversal filtering and removing the need for path-based traversers.
2164 * Added `HasTraversalStep` which takes an anonymous traversal to determine whether or not to filter the current object.
2165 * Added `Traversal.Admin.getStartStep()` and `Traversal.Admin.getEndStep()`. Removed `TraversalHelper.getStart()` and `TraversalHelper.getEnd()`.
2166 * Refactored `profile()` to use injected steps. `ProfileStep` can now be used without any special JVM command line parameters.
2167 * Added `ReducingBarrierStep` which acts like `CollectingBarrierStep` but operates on a seed with a bi-function.
2168 * Added a preprocessor for AsciiDocs. Documentation code examples are executed and the results are dynamically inserted into the doc file.
2169 * `LocalStep` traversal is treated as a branch, not an isolated traversal. Moreover, moved `LocalStep` to `branch/`.
2170 * Traversal strategies are now applied when the `TraversalVertexProgram` state is loaded, not when submitted. Less error prone as it guarantees strategy application.
2171 * Reworked `TraversalHolder` where there are "local traversals" and "global traversals". Local traversals are not subject to OLAP message passing.
2172 * Fixed a bug in `DedupStep` that made itself apparent in `DedupOptimizerStrategy`.
2173 * Added `RepeatStep.RepeatEndStep` in order to reduce the complexity of the code on OLAP when the predicates are not at the start of `RepeatStep`.
2174
2175 === TinkerPop 3.0.0.M7 (Release Date: January 19, 2015)
2176
2177 * Added `SideEffectRegistrar` interface and `SideEffectRegistrationStrategy` for allowing steps to register sideEffects at strategy application time.
2178 * Renamed `Traverser.Admin.setFuture()` and `Traverser.Admin.getFuture()` to `setStepId()` and `getStepId()`, respectively.
2179 * Added `TraversalMatrix` for random access to steps in a traversal by their step id. Used by `TraversalVertexProgram`.
2180 * Added unique identifies to `Step` that are not the user provided labels. `Step.getLabel()` now returns an `Optional<String>`.
2181 * Removed `UnionLinearStrategy`, `ChooseLinearStrategy`, and `RepeatLinearStrategy` as nested traversals are now natively supported in OLAP.
2182 * Fixed `Neo4jGraph` around manual transaction behavior on `commit` and `rollback` such that they would throw exceptions if a transaction was not open.
2183 * Redesigned the hidden step labeling mechanism so its consistent across a cluster, easier for rewrite strategies, and will enable nested OLAP traversals.
2184 * `Traverser.incrLoops()` now takes a string step label to enable nested looping constructs (i.e. loop stacks).
2185 * Added `Traversal.tryNext()` which returns an `Optional`, where the provided default method should be sufficient for all vendors.
2186 * Removed `PathConsumer` in favor of `TraverserRequirement.PATH`-model via `Step.getRequirements()`.
2187 * `Step.getRequirements()` returns a `Set<TraverserRequirement>` which is what is required of the `Traverser` by the `Step`.
2188 * `Traverser` now extends `Cloneable` and `Traverser.clone()` is used to good effect in `Traverser.split()`.
2189 * Added `AbstractTraverser` for which all traversers extend.
2190 * Moved `Traversal.SideEffects` to `TraversalSideEffects` as sideEffects are not necessarily tied to the traversal.
2191 * Removed `Graph.of()` for generating anonymous graph traversals -- replaced by `__`-model.
2192 * Removed `Graph` being stored in `Traversal.SideEffects`. Too dangerous when moving between OLTP and OLAP and its limited uses were worked around easily.
2193 * No need for `DefaultXXXGraphTraversal` unless the vendor is extending with new methods (e.g. `DefaultNeo4jGraphTraversal`).
2194 * Reworked `TraversalStrategies` such that the are "emanating object class"-dependant, not `Traversal` dependent.
2195 * Moved `Traverser.sideEffects()` to `Traverser.asAdmin().getSideEffects()`. Users should use `Traverser.sideEffects(key)` and `Traverser.sideEffects(key,value)`.
2196 * Added `SerializationTest` to the `StructureStandardSuite` in `gremlin-test` which validates serialization at a lower level than `IoTest`.
2197 * Removed `IntervalStep` and renamed `interval()` to `between()` which is simply an alias to a `has().has()` chain.
2198 * Added `__` static interface which allows for `__.out().out()`-style construction of anonymous traversals (instead of `g.of()`).
2199 * The only `GraphTraversal` steps that operate on `Traverser` are the base lambdas and `repeat()` (i.e. `emit()` and `until()`).
2200 * Removed dependency on the `reflections` library in `gremlin-test` which removed the default implementation of `GraphProvider.getImplementations()` - vendors now need to implement this method themselves.
2201 * Relaxed the `<S>` typing requirement for anonymous traversals when applied to `choose()`, `repeat()`, `union()`, etc.
2202 * Removed `LoopStep` and `UntilStep` in favor of the new `RepeatStep` model of looping in Gremlin3.
2203 * `BranchStep` is now exposed in `GraphTraversal` via `branch(function)`.
2204 * `UnionStep` now implements `TraversalHolder`.
2205 * Added `RepeatStep` as the new looping construct supporting do/while, while/do, and emit semantics.
2206 * Moved `Traversal.sideEffects()` to `Traversal.Admin.getSideEffects()` as `cap()` should be used to access the sideEffect data of a traversal.
2207 * Renamed vendor `XXXTraversal` to `XXXGraphTraversal` (interface) and `XXXGraphTraversal` to `DefaultXXXGraphTraversal` (implementation class).
2208 * Modified packaging for console plugins to be more consistent by moving them to the `com.tinkerpop.gremlin.console.groovy.plugin` namespace.
2209 * Removed all TinkerPop specific dependencies to Guava to avoid user version conflicts.
2210 * Added support for `-e` (script file execution) and `-v` (version display) options on `gremlin.sh`.
2211 * GraphSON supports the assignment of multiple custom serialization modules.
2212 * `Traverser.get(stepLabel/sideEffectKey)` no longer exists. There now exists: `Traverser.path(stepLabel)` and `Traverser.sideEffects(sideEffectKey)`.
2213 * `SimpleTraverser` now supports "path" but in a very loose, global cache way. Added `SparsePath` as a `Map`-backed `Path` implementation.
2214 * Provided Neo4j multi-label support in Neo4j-Gremlin. Added three `Neo4jVertex`-specific methods: `addLabel()`, `removeLabel()`, `labels()`.
2215 * Bumped to Groovy 2.3.9.
2216 * Added `Graph.Io` interface which allows for simplified helper methods for end users and a way for vendors to override `GraphReader` and `GraphWriter` initial construction when custom serializers are needed.
2217 * Removed methods from `GraphProvider` related to customizing serializers in `IoTest` from the test suite as the new `Graph.Io` interface now serves that purpose.
2218 * Added `Neo4jGraph.checkElementsInTransaction(boolean)` which will (or not) verify whether elements retrieved via Neo4j global graph operations are transactionally consistent.
2219 * Added `ScriptInputFormat` and `ScriptOutputFormat` to Hadoop-Gremlin for reading and writing a file according to an arbitrary parsing script.
2220 * Added `TimeLimitStep.getTimedOut()` to determine if the step timed out or there were no more objects to process.
2221 * `Graph.System` is now `Graph.Hidden` with "hidden" being the vendor namespace and the key prefix being `~`.
2222 * Much better `toString()` handling in `Step` and `Traversal`.
2223 * `ComparatorHolder<V>` interface returns a `List<Comparator<V>>` instead of a `Comparator<V>[]`.
2224 * `T` now implements `Function<Element,Object>`.
2225 * Added `ElementValueComparator` and `ElementFunctionComparator` in support of vendor introspection on `ComparatorHolder`-steps.
2226 * Renamed `Comparing` marker interface to `ComparatorHolder`.
2227 * `FunctionHolder` interface provides vendor introspection via `ElementValueFunction`.
2228 * Removed `OrderByStep` as it is now just `order()` with a `by()`-based comparator.
2229 * Added `SampleStep` (`sample()`) to allow for sampling the set of previous objects. Useful for doing random walks with `local()`.
2230 * Renamed `random()` to `coin()` to better express that the filter is a random coin toss.
2231 * Added `by()`-projection to modulate the meaning of post-processing steps like `aggregate()`, `groupCount()`, `path()`, `order()`, etc.
2232 * Removed the `Strategy` interface and gave `StrategyGraph` direct access to the `GraphStrategy`.
2233 * Added `Graph.strategy()` to help instantiate `StrategyGraph` instances.
2234 * Modified the signature of all `GraphStrategy` methods to include an parameter that contains a reference to the "composing strategy".
2235 * `PartitionStrategy` hides the specified partition key from view when iterating properties, keys, etc.
2236 * Change construction of `GraphStrategy` implementations to be consistent with singleton instances and builder pattern.
2237 * Added `Graph.Helper` annotation to "protected" certain default interface methods from implementation by vendors.
2238 * Transaction retry functions now work with "manual" transactions.
2239 * Improved error messaging when importing "legacy" GraphSON that was not generated with "extended" properties.
2240 * Renamed "iterator" related methods in the `GraphStrategy` interface to be consistent with the method names they represent.
2241 * `PropertyMapStep` (`valueMap()`) now takes a boolean to state if the tokens of the element are desired along with its properties.
2242 * `HadoopGraph` now connected to the `StructureProcessSuite`.
2243 * `HadoopGraph` no longer supports `Graph.Variables` as they were in-memory. A persistence mechanism can be introduced in the future.
2244 * Hidden properties removed in favor of using `GraphStrategy` for such features.
2245 * `Edge.iterators().vertexIterator(BOTH)` now guarantees `OUT` then `IN` vertex iterator order.
2246 * `Graph.v(Object)` and `Graph.e(Object)` no longer exist. Instead, use `Graph.V(Object... ids)` and `Graph.E(Object... ids)`.
2247 * Added `Graph.Iterators` to allow access to vertex and edge iterators based on element ids and bypassing `GraphTraversal`.
2248 * Renamed `GraphStrategy` implementations to be less verbose - removed the word "Graph" from their names (e.g. `IdGraphStrategy` simply changed to `IdStrategy`).
2249 * Removed `Step.NO_OBJECT` as the problem is solves can be solved with proper use of `flatMap` and `EmptyTraverser`.
2250 * `Path` is now part of `GraphSerializer` and thus, not specific to a particular implementation of `Path`.
2251 * Added messaging to show files being downloaded when using the Gremlin Server "install" command.
2252 * Added test name and class arguments to the `GraphProvider.loadGraphWith` method.
2253 * Merged `ReferencedXXX` and `DetachedXXX` so that all migration of graph element data is via `DetachedXXX`.
2254 * Added `StaticVertexProgram` and `StaticMapReduce` which simply return `this` on `clone()`.
2255 * `VertexProgram` and `MapReduce` now implement `Cloneable` and is used for fast copying across workers within the same machine.
2256 * Added `TraversalHolder` interface which extends `PathConsumer` to determine recursively if nested traversals require path calculations turned on.
2257 * Reworked how a `TraverserGenerator` is retrieved and utilized.
2258 * Added `Traversal.toBulkSet()` to make getting resultant data more efficiently for traversals with repeated data.
2259 * Provided a helper `LocalStep.isLocalStarGraph()` so `GraphComputer` implementers know the requisite data boundaries.
2260 * Created `Traversal.Admin` to hide administrative methods. Added `Traversal.asAdmin()` to get at `Traversal.Admin`.
2261 * Fixed up all `Step` cloning operations realizing that Java8 lambdas are always bound to the calling class (no delegates).
2262 * Usage of `:remote close` without configured remotes shows a reasonable message rather than a stack trace.
2263 * Provided `LocalStep` to signify that the internal traversal is locally bound to the incoming object.
2264 * Failed script evaluation in Gremlin Server now triggers the cancel of the process attempting to timeout the script if it were to run too long.
2265 * Greatly increased the speed of `ScriptEngineLambda` by making use of a static `ScriptEngine` cache.
2266 * Fixed a general bug in all sideEffect using steps where the sideEffect should be accessed via the `Traverser` not `Traversal`.
2267 * `GremlinPlugin` interface no longer has the `additionalDependencies` method - those dependencies are now defined by an entry in the manifest file for the jar called `Gremlin-Plugin-Dependencies`.
2268 * Added `TinkerWorkerPool` which is used for resource efficient threading in `TinkerGraphComputer`.
2269 * `MapReduce.createMapReduce(Configuration)` now exists and serves the same purpose as `VertexProgram.createVertexProgram(Configuration)`.
2270 * Enabled SessionOps to be extended. Added eval handler hook.
2271 * Setting a property with an unsupported data type throw `IllegalArgumentException` instead of `UnsupportedOperationException` as the operation is supported, but the argument is not.
2272
2273 === TinkerPop 3.0.0.M6 (Release Date: December 2, 2014)
2274
2275 * `javatuples.Pair` avoided on `MapReduce` API in favor of a new `KeyValue` class.
2276 * Renamed `Gremlin-Plugin` manifest entry for plugins to `Gremlin-Plugin-Paths`.
2277 * Added `Gremlin-Plugin-Dependencies` manifest entry to list other dependencies that should be retrieved with a plugin jar.
2278 * `Memory.Admin.asImmutable()` yields an immutable representation of the GraphComputer `Memory`.
2279 * Fixed host selection in `gremlin-driver` by properly accounting for all hosts being marked unavailable at the instantiation of a `Client`.
2280 * Removed Giraph-Gremlin in favor of new Hadoop-Gremlin with `GiraphGraphComputer` support. Future support for `MapReduceGraphComputer`.
2281 * Greatly simplified the `InputFormat` and `OutputFormat` model for working with Giraph (and Hadoop).
2282 * Added a serializer for `Property` for GraphSON correcting format of serialization of a single `Property` on an `Edge`.
2283 * Fixed bug in Gremlin Console that prevented assignments to empty `List` objects.
2284 * Added `VertexProgram.getMessageScopes()` to allow vendors to know which `MessageScopes` at a particular `Memory` state.
2285 * Reduced the number of methods in `MessageScope.Local` as its up to vendors to inspect provided incident `Traversal` accordingly.
2286 * Renamed `MessagesType` to `MessageScope` to make it less ambiguous regarding the class of the messages being sent.
2287 * Changed the message type of `TraversalVertexProgram` to `TraverserSet` to support message combining.
2288 * Added `VertexProgram.getMessageCombiner()` to support the combining of messages in route to a vertex.
2289 * Reduced object creation in `TraversalVertexProgram` around vertex-local traversal sideEffects.
2290 * Renamed `Traverser.Admin.makeChild()` and `Traverser.Admin.makeSibling()` to `Traverser.Admin.split()` to correspond with `merge()`.
2291 * Added `Traverser.Admin.merge(Traverser)` method so that the merging algorithm is with the `Traverser`.
2292 * Added `Operator` enum that contains sack-helpful `BinaryOperators`: sum, minus, mult, div, max, min, etc.
2293 * Added `GraphTraversal.withSack()` and renamed `trackPaths()` and `with()` to `withPath()` and `withSideEffect()`, respectively.
2294 * Added the "Gremlin Sacks" feature to allow a `Traverser` to carry local information along its walk.
2295 * GraphSON format no longer makes use of `hiddens` JSON key. Its all just `properties`.
2296 * Added `DoubleIterator` to make vendor implementations of `Edge.iterators().vertexIterator()` efficient.
2297 * `PropertiesStep` is smart about hiddens vs. properties.
2298 * `Element.iterators().hiddenProperties()` no longer exists. For vendors, simply provide an iterator of properties.
2299 * `GIRAPH_GREMLIN_LIBS` supports colon separated directories for loading jars from multiple paths.
2300 * Introduced method to control the location of dependencies dynamically loaded to the Gremlin Console as part of the `:install` command.
2301 * Fixed problem with the Neo4j Gremlin Plugin not loading properly after Gremlin Console restart.
2302 * Removed the "use" configuration from Gremlin Server.
2303 * Moved `SugarGremlinPlugin` from `gremlin-console` to `gremlin-groovy` so that it could be shared with Gremlin Server.
2304 * Fixed bug in serialization of `null` results returned to the Gremlin Console when serializing to strings.
2305 * Moved the `GremlinPlugin` for `TinkerGraph` to `tinkergraph-gremlin` module (it is no longer in `gremlin-console`).
2306 * Added a `plugin-info.txt` file to Gremlin Console `/ext/{module}` subdirectories to identify the module that was originally requested.
2307 * Gremlin Server now allows for the explicit configuration of plugin activation.
2308 * Refactored `GremlinPlugin` and `AbstractGremlinPlugin` to better account for plugins that run on the server and those that run in the console.
2309 * Added a `plugins` configuration to Gremlin Server to control the plugins that are enabled on initialization.
2310 * Added a builder option to `GremlinExecutor` to control the plugins that are enabled on initialization.
2311 * Added `RemoteException` for usage with `RemoteAcceptor` implementations for the Gremlin Console so as to better standardize their development.
2312 * Standardized all text being written to the Gremlin Console using starting upper case letter.
2313 * Prevented error in the Console when `:submit` is called but no remotes were configured.
2314 * Provided a way to clean the `grapes` directory as part of a standard build with `mvn clean install`.
2315
2316 === TinkerPop 3.0.0.M5 (Release Date: November 7, 2014)
2317
2318 * Removed `PropertyFilterIterator` as using Java8 streams was just as efficient for the use case.
2319 * Renamed `KryoWritable` to `GremlinWritable` as it is not necessarily Kryo that is the serialization mechanism.
2320 * Fixed an input split bug in Giraph that was making it so that splits were not always at vertex boundaries.
2321 * Fixed a combiner bug in `GirapGraphComputer`. Combiners were always calling `MapReduce.reduce()`, not `MapReduce.combine()`.
2322 * Greatly simplified `SubgraphStrategy` by removing requirements for `Traversal` introspection.
2323 * `StrategyWrappedGraph` mimics vendor use of `GraphStep` and `GraphTraversal` and no longer requires dynamic strategy application.
2324 * `TraversalStrategies` make use of a dependency tree sorting algorithm to ensure proper sorts prior to application.
2325 * `TraversalStrategies` are now immutable and are bound to the `Traversal` class.
2326 * Fixed bug in Gephi Plugin that prevented it from communicating with the Gephi Streaming Server.
2327 * Renamed `MessageType.XXX.to()` to `MessageType.XXX.of()` so it makes sense in both the sending and receiving context.
2328 * Improved messaging with respect to tests that are ignored due to features to make it clear that those tests are not in error.
2329 * Relaxed exception consistency checks in the test suite to only check that a thrown exception from an implementation extends the expected exception class (but no longer validates that it is the exact class or that the message text).
2330 * `VertexProgram` now has `workerIterationStart()` and `workerIterationEnd()` to allow developers to control vertex split static data structures.
2331 * `TraversalVertexProgram` startup time greatly reduced due to being smart about `loadState()` behavior.
2332 * Gremlin Server sessions now allow serialization of results that were part of an open transaction.
2333 * Refactor `OpProcessors` implementations in Gremlin Server for better reusability.
2334 * `Vertex.iterators()` no longer have a `branchFactor`. This is now at the query language level with `localLimit()`.
2335 * Added `limit(long)` and `localLimit(int,int)` which simply call the range equivalents with 0 as the low.
2336 * Added `LocalRangeStep` which supports ranging the edges and properties of an element -- `localRange(int,int)`.
2337 * `GraphTraversal.value(String)` no longer exists. Instead, use `GraphTraversal.values(String)`.
2338 * `HiddenXXXStep` and `ValueXXXStep` no longer exist. `PropertyXXXStep` takes a `PropertyType` to denote value and hidden access.
2339 * Added `PropertyType` to the structure-package which provide markers for denoting property types (vs. property classes).
2340 * Renamed `setWorkingDirectory` to `workingDirectory` in the `KryoReader` builder.
2341 * `Path.get(String)` returns the object if only one object is referenced by label, else it returns a `List` of referenced objects.
2342 * Added overload to `GremlinKryo` to allow a serializer to be configured as a `Function<Kryo,Serializer>` to allow better flexibility in serializer creation.
2343 * Added method to `GraphProvider` to allow implementers to provide a mechanism to convert GraphSON serialized identifiers back to custom identifiers as needed.
2344 * Added methods to `GraphProvider` so that implementers could specify a custom built `GremlinKryo` class and/or `SimpleModule` class in case their implementation had custom classes to be serialized.
2345 * Added `Traversal.forEachRemaining(class,consumer)` for those traversals whose end type is different from declared due to strategy rewriting.
2346 * Removed `Traversal.forEach()` as traversal implements `Iterator` and users should use `forEachRemaining()`.
2347 * `RangeStep` now has an inclusive low and an exclusive high -- a change from Gremlin2.
2348 * `DriverGremlinPlugin` returns raw results with driver results available via the `result` variable.
2349 * Removed test enforcement of `private` constructor for a `Graph` instance.
2350 * `RemoteAcceptor` now supports `@` prefixed lines that will grab the script string from the Gremlin Console shell.
2351 * Modified the signature of `Property.element()` to simply return `Element`
2352 * Added `Reducing` marker and `ReducingStrategy` which supports reduction-functions as a final step in Gremlin OLAP (e.g. `fold()`).
2353 * Once strategies are `complete()`, no more steps can be added to a `Traversal`.
2354 * Renamed `Traversal.strategies()` to `Traversal.getStrategies()` as it is not a "query language"-method.
2355 * Added test to enforce that a `label` on a `VertexProperty` is always set to the key of the owning property.
2356 * Fixed bug with multi-property removal in `Neo4jGraph`.
2357 * Bumped to Neo4j 2.1.5.
2358 * Used standard `UUIDSerializer` from the `kryo-serializers` library for serialization of `UUID` objects.
2359 * Changed GraphSON serialization to only use `iterators()` - there were still remnants of `Traversal` usage from previous refactoring.
2360 * Added overload for `detach` method to allow for the `Element` to be detached as a "reference" only (i.e. without properties).
2361 * Renamed `Item` in `gremlin-driver` to `Result`.
2362 * Renamed `strategy` to `getStrategy` in `StrategyWrappedGraph`.
2363 * Renamed `baseGraph` to `getBaseGraph` in `Neo4jGraph`.
2364 * `Neo4jGraph` now returns an empty property `Vertex.property(k)` when the key is non-existent (a problem only visible when meta/multi property configuration was turned off).
2365 * `Traversal.Strategies.apply()` now takes a `TraversalEngine`. Greatly simplifies strategy application for `STANDARD` or `COMPUTER`.
2366 * Renamed `IdentityReductionStrategy` to `IdentityRemovalStrategy` for reasons of clarity.
2367 * Added `ComparingRemovalStrategy` that removes `Comparing`-marked steps unless they are the end step of the traversal.
2368 * `OrderStep` now works in OLAP, but only makes sense as a traversal end step.
2369 * `MapReduce` API extended to include `getMapKeySort()` and `getReduceKeySort()` to sort outputs accordingly.
2370 * Renamed `TraversalResultMapReduce` to `TraverserMapReduce`. Shorter and makes more sense.
2371 * Improved build automation to package javadocs and asciidoc documentation in the distribution files.
2372 * Improved build automation with a script to automatically bump release versions in the various files that needed it such as the `pom.xml` files.
2373 * The identifier on `VertexProperty` is now read properly to those graphs that can support identifier assignment.
2374 * `GraphSONReader.readGraph()` now properly reads vertex properties.
2375 * Removed `Neo4jGraph.getCypher()` as users should use `Neo4jGraph.cypher()` and get back TinkerPop3 graph objects.
2376 * `GiraphGraph.variables().getConfiguration()` is now replaced by `GiraphGraph.configuration()`.
2377 * Added `Graph.configuration()` which returns the `Configuration` object of `Graph.open()`.
2378 * Removed `TraverserTracker` as now there is only a `TraverserSet` for all halted traversers. A nice simplification of `TraversalVertexProgram`.
2379 * Renamed `Traverser.isDone()` to `Traverser.isHalted()` and `DONE` to `HALT`. Consistent with automata terminology.
2380 * Removed `PathTraverserExecutor` and `SimpleTraverserExecutor` as a single `TraverserExecutor` correctly executes both types of traversers.
2381 * `TraversalVertexProgram` does "reflexive message passing" to reduce the total number of iterations required to execute a traversal.
2382 * `MapReduce` no-argument constructors are private and thus, only for reflection and `loadState()` usage.
2383 * MapReducers for `TraversalVertexProgram` are now smart about `with()` declared data structures.
2384 * Updated `Traversal.SideEffects` to use "registered suppliers" and it now works accordingly in both OLTP and OLAP environments.
2385 * Increased the speed of `FlatMapStep` by approximately 1.5x.
2386
2387 === TinkerPop 3.0.0.M4 (Release Date: October 21, 2014)
2388
2389 * Added features for `VertexProperty` user supplied ids and related data types.
2390 * Removed `SideEffectCap` marker interface as there is only one `SideEffectCapStep` and thus, `instanceof` is sufficient.
2391 * `Path.getObjects()`/`Path.getLabels()` renamed to `Path.objects()`/`Path.labels()` to be in line with "query language" naming convention.
2392 * Greatly simplified `GiraphInternalVertex` due to `Element.graph()` -- 1/2 the memory footprint and reduced construction time.
2393 * Renamed `Property.getElement()` to `Property.element()` given the "query language" naming convention.
2394 * `Element.graph()` added which returns the `Graph` that the element is contained within.
2395 * Added tests for greater consistency around iterating hidden properties.
2396 * Simplified `TraversalVertexProgram` where only a single `TraverserTracker` exists for both path- and simple-traversers.
2397 * Fixed a major bug where `Arrays.binarySearch` was being used on an unsorted array in TinkerGraph and Neo4jGraph.
2398 * Changed `ComputerResult.getXXX()` to `graph()` and `memory()` to be consistent with "query language" naming convention.
2399 * `Traverser.getXXX()` changed to `loops()`, `bulk()`, `path()`, `sideEffects()` to be consistent with "query language" naming convention.
2400 * Optimization to reduce the number of empty lists created due to no step class existing for respective `TraversalStrategy.apply()`.
2401 * Added `CapTraversal` as a marker interface for the `cap()` method.
2402 * Added `union()` with GraphComputer `UnionLinearStrategy`.
2403 * `TimeLimitStep` was moved to `filter/` package. It was a mistake that it was in `sideEffect/`.
2404 * Provided the configuration for generating both a "full" and "core" set of javadocs, where "full" represents all classes in all projects and "core" is the "user" subset.
2405 * Validated bindings passed to Gremlin Server to ensure that they do not match the most common statically imported values.
2406 * If no script engine name is provided to a `LambdaHolder` it is assumed to be Gremlin-Groovy.
2407 * `MapEmitter` and `ReduceEmitter` have an `emit(value)` default method where the key is the `MapReduce.NullObject` singleton.
2408 * `Traverser.Admin` now implements `Attachable` as the `Traversal.SideEffects` can be generated from the `Vertex`.
2409 * Made a solid effort to ensure that all TinkerPop keys are `Graph.System` to leave `Graph.Key` for users.
2410 * The `Graph.System` prefix is now `^` instead of `%&%`. Simpler and easier on the `toString()`-eyes.
2411 * Added `Traversal.SideEffects.ifPresent(Consumer)` as a default helper method.
2412 * Added `profile()`-step which provides detailed information about the performance of each step in a traversal.
2413 * No more `CountCapStep` and `CountStep`, there is only `CountStep` and it is elegant.
2414 * Created a `AbstractTraversalStrategy` with good `toString()`, `hasCode()`, and `equals()` implementations.
2415 * Added `CountTraversal` as a marker-interface stating that the `Traversal` has a `count() -> Long` method.
2416 * `Traversal` no longer has any step methods as its not required for DSL implementers to have "core steps."
2417 * Added "linearization" strategy for `ChooseStep` so it is executed correctly on GraphComputer.
2418 * Added ``GraphTraversalStrategyRegistry` which has respective global strategies to make turning on/off strategies easier.
2419 * Added a generic `BranchStep` to be used for re-writing "meta-steps" for execution on GraphComputer.
2420 * Moved `JumpStep`, `UntilStep`, and `ChooseStep` to a new `branch/` package.
2421 * Added test cases to the Structure Suite to enforce consistent operations of reading properties after removal of their owning `Element`.
2422 * GraphSON format change for full `Graph` serialization - Graph variables are now serialized with the key "variables" as opposed to "properties".
2423 * Relaxed `Graph.toString()` test requirements for implementers.
2424 * Made the `toString` operations in `GraphStrategy` consistent.
2425 * Added `VertexFeatures.supportsRemoveProperty`.
2426 * Added `VertexPropertyFeatures.supportsRemoveProperty`.
2427 * Added `EdgeFeatures.supportsRemoveProperty`.
2428 * Added `VertexFeatures.supportsRemoveVertices`.
2429 * Added `EdgeFeatures.supportsRemoveEdges`.
2430 * Vendors should now get a clear error when mis-spelling something in an `@OptOut` (or more likely if a test name changes) and it now works all the test suites.
2431 * All plugins now have a default prefix of "tinkerpop." as a namespace.
2432 * `GraphComputer` now executes a `Set<MapReduce>` and `hashCode()`/`equals()` were implemented for existing `MapReduce` implementations.
2433 * Changed `Contains.in/notin` to `Contains.within/without` as `in` is a reserved term in most languages (including Java and Groovy).
2434 * Added helper methods for loading data into collections in `TraversalHelper`.
2435 * Core `Traversal` methods are smart about bulking -- e.g. `iterate()`, `fill()`, `remove()`, etc.
2436 * `GroupByStep` and `GroupByMapReduce` leverage `BulkSet` as the default group data structure.
2437 * `Element.Iterator` has renamed methods so implementers can do `MyElement implements Element, Element.Iterators`.
2438 * Renamed `MessageType.Global` and `MessageType.Local` creators from `of()` to `to()` as it makes more sense to send messages `to()`.
2439 * With `Traverser.get/setBulk()` there is no need for a `TraverserMessage`. The `Traverser` is now the message in `TraversalVertexProgram`.
2440 * Provided static `make()` methods for constructing `Path` implementations.
2441 * Provided a more space/time efficient algorithm for `Path.isSimple()`.
2442 * The `JumpStep` GraphComputer algorithm `Queue` is now a `TraverserSet`.
2443 * `AggregateStep` and `StoreStep` now use `BulkSet` as their default backing `Collection` (much more space/time efficient).
2444 * Added `BulkSet` which is like `TraverserSet` but for arbitrary objects (i.e. a weighted set).
2445 * `UnrollJumpStrategy` is no longer a default strategy as it is less efficient with the inclusion of `TraverserSet`.
2446 * Introduced `TraverserSet` with bulk updating capabilities. Like OLAP, OLTP looping is now linear space/time complexity.
2447 * TinkerGraph's MapReduce framework is now thread safe with a parallel execution implementation.
2448 * Added a default `Traverser.asAdmin()` method as a typecast convenience to `Traverser.Admin`.
2449 * Renamed `Traverser.System` to `Traverser.Admin` as to not cause `java.lang.System` reference issues.
2450 * Renamed `Memory.Administrative` to `Memory.Admin` to make it shorter and consistent with `Traverser.Admin`.
2451 * Fixed a TinkerGraph bug around user supplied vertex property ids.
2452 * Most `Step` classes are now defined as `public final class` to prevent inheritance.
2453 * `ShuffleStep` now extends `BarrierStep` which enables semantically correct step-sideEffects.
2454 * Leveraged `Traverser.getBulk()` consistently throughout all steps.
2455
2456 === TinkerPop 3.0.0.M3 (Release Date: October 6, 2014)
2457
2458 * All `Step` fields are now `private`/`protected` with respective getters as currently needed and will be added to as needed.
2459 * Gremlin Server no longer has the `traverse` operation as lambdas aren't really serialized.
2460 * `Path` is now an interface with `ImmutablePath` and `MutablePath` as implementations (2x speedup on path calculations).
2461 * `Traverser` now implements `Comparable`. If the underlying object doesn't implement `Comparable`, then a runtime exception.
2462 * Added abstract `BarrierStep` which greatly simplifies implementing barriers like `AggregateStep`, `OrderStep`, etc.
2463 * `SelectStep` is now intelligent about when to trigger path computations based on label selectors and barriers.
2464 * `T` no longer has `eq`, `neq`, `lt`, `in`, etc. Renamed all respective enums and with `static import`, good in console (e.g. `Compare.eq`).
2465 * Added `Order` enum which provides `Order.decr` and `Order.incr`.
2466 * `Traverser.loops` and `Jump.loops` are now shorts (`32767` max-loops is probably sufficient for 99.9999% of use cases).
2467 * `Traverser.bulk` exists which is how many instances does the traverser represent. For use in grouping with bulk computations.
2468 * Greatly simplified sideEffect steps where there is no distinction between OLAP vs. OLTP (from the `Step` perspective).
2469 * Removed the need for `Bulkable` and `VertexCentric` marker interfaces in process API.
2470 * Renamed configuration parameters in Giraph-Gremlin to be consistent with a `giraph.gremlin`-prefix.
2471 * Made it possible to pass a `ScriptEngine` name and string script in `TraversalVertexProgram` and `LambdaVertexProgram`.
2472 * Made `TinkerGraph` a plugin for the Console as it is no longer a direct dependency in `gremlin-groovy`.
2473 * Added features for supporting the addition of properties via `Element.property(String,Object)`.
2474 * `GiraphGraph` OLTP tested against Gremlin-Java8 and Gremlin-Groovy -- OLAP tested against Gremlin-Groovy.
2475 * `Neo4jGraph` is now tested against both Gremlin-Java8 and Gremlin-Groovy.
2476 * Renamed the test cases in `ProcessTestSuite` to be consistent with other Gremlin language variants.
2477 * Added a `gremlin-groovy-test` suite that can be used to validate implementations against the Groovy variant of Gremlin.
2478 * `TinkerGraph` is no longer serializable, use a `GraphReader`/`GraphWriter` to serialize the graph data.
2479 * Removed `implements Serializable` on numerous classes to ensure safety and proper usage of utilities for cloning.
2480 * `Traversal` now implements `Cloneable` as this is the means that inter-JVM threads are able to get sibling `Traversals`.
2481 * Created "integration" test for `Neo4jGraph` that runs the test suite with multi/meta property features turned off.
2482 * Added `GraphStrategy` methods for `VertexProperty`.
2483 * Converted the `id` data type from string to integer in the Grateful Dead sample data.
2484 * Removed all notions of serializable lambdas as this is a misconception and should not be part of TinkerPop.
2485 * Greatly simplified `TraversalVertexProgram` with three arguments: a `Traversal<Supplier>`, `Class<Traversal<Supplier>>`, or a script string with `ScriptEngine` name.
2486 * Added `TraversalScript` interface with `GroovyTraversalScript` as an instance. To be used by OLAP engines and any language variant (e.g. gremlin-scala, gremlin-js, etc.).
2487 * `UntilStep` now leverages `UnrollJumpStrategy` accordingly.
2488 * Fixed a bug where the `toString()` of `Traversal` was being hijacked by `SugarGremlinPlugin`.
2489 * Fixed compilation bug in `UntilStep` that is realized when used in multi-machine OLAP.
2490 * Simplified `Enumerator` and implementations for `MatchStep`.
2491
2492 === TinkerPop 3.0.0.M2 (Release Date: September 23, 2014)
2493
2494 * Added an exhaust `InnerJoinEnumerator` fix in `MatchStep` to get all solutions correctly.
2495 * `Neo4jGraph` can be configured to allow or disallow meta- and multi-properties.
2496 * Added `until()`-step as a simpler way to express while-do looping which compiles down to a `jump()`-step equivalent.
2497 * Added "The Crew" (`CREW`) toy graph which contains multi-properties, meta-properties, graph variables, hiddens, etc.
2498 * If the Giraph job fails, then the subsequent `MapReduce` jobs will not execute.
2499 * Added `Graph.System` class which generates keys prefixed with `%&%` which is considered the vendor namespace and not allowed by users.
2500 * Added `ReferencedVertex` (etc. for all graph object types) for lightweight message passing of graph object ids.
2501 * `T.*` now has `label`, `id`, `key`, `value` and no longer are these `String` representations reserved in TinkerPop.
2502 * `Traverser` now has a transient reference to `Traversal.SideEffects`.
2503 * "Detached" classes are now tested by the standard test suite.
2504 * Compartmentalized `Traverser` interface so there is now a `Traverser.System` sub-interface with methods that users shouldn't call.
2505 * Added `OrderByStep` which orders `Elements` according to the value of a provided key.
2506 * 2x speed increase on steps that rely heavily on `ExpandableStepIterator` with massive memory footprint reduction as well.
2507 * Added `VertexProperty<V>` as the property type for vertices -- provides multi-properties and properties on properties for vertices.
2508 * Changed `VertexProgram` such that `getElementComputeKeys()` is simply a `Set<String>`.
2509 * Significant changes to the format of the `ResponseMessage` for Gremlin Server - these changes break existing clients.
2510 * Close any open transactions on any configured `Graph` when a session in Gremlin Server is killed.
2511 * Grateful Dead Graph now uses vertex labels instead of "type" properties.
2512 * There is now a `GraphComputerStrategy` and `EngineDependent` marker interface to allow steps to decide their algorithm depending if they are OLAP or OLTP.
2513 * A labeled step now stores its current traverser value in `Traversal.SideEffects` (no longer can sideEffectKeys and step labels be the same).
2514 * `GraphFactory` support for opening a `Graph` with multiple `GraphStrategy` instances - if there are multiple strategies they are wrapped in order via `SequenceGraphStrategy`.
2515 * The result type for result termination messages returned from Gremlin Server is now set to "no content".
2516 * The `maxContentLength` setting for Gremlin Driver now blocks incoming frames that are too large.
2517 * After initialization scripts are executed in Gremlin Server, the `Graph` instances are re-bound back to their global references, thus allowing `GraphStrategy` initialization or even dynamic `Graph` creation through scripts.
2518 * Added "Modern" graph back which is basically the "Classic" graph with double values for the "weight" property on edges and non-default vertex labels.
2519 * `Traversal.addStep()` is now hard typed so type casting isn't required and traversal APIs look clean.
2520 * Changed the hidden key prefix from `%$%` to `~` in `Graph.Key.hide()`.
2521 * Added `has(label,key,predicate,value)` to allow for `has('person','name','marko')`. Various overloaded methods provided.
2522 * Update to traversal API where if a `SFunction<S,?>` was required, but can process a `Traverser<S>`, then the function is `SFunction<Traverser<S>,?>`.
2523 * Added `WhereStep` as a way to further constrain `select()` and `match()`.
2524 * Extensive work on `GiraphMemory` and its interaction with Giraph aggregators.
2525 * If the input path of a `GiraphGraphComputer` does not exist, failure happens prior to job submission.
2526 * `SugarPlugin` now has all inefficient methods and Gremlin-Groovy proper is only efficient Groovy techniques.
2527 * Prevented concurrency problems by only modifying bindings within the same thread of execution in the `GremlinExecutor`.
2528 * Calls to `use` on the `DependencyManager` now return the list of `GremlinPlugin` instances to initialize instead of just initializing them automatically because it causes problems with `ScriptEngine` setup if a plugin requires a script to be evaluated and a required dependency is not yet loaded.
2529 * `Traversal.SideEffects` has `getGraph()`, `setGraph()`, and `removeGraph()` default helpers.
2530 * `Traversal.Memory` -> `Traversal.SideEffects` and `GraphComputer.SideEffects` -> `GraphComputer.Memory`.
2531 * `StrategyWrappedVertex` and `StrategyWrappedEdge` properly wrap `Element` objects returned from non-traversal based methods.
2532 * Gremlin-Server now sends a single write with status 200 for Object and empty response messages.
2533 * `GremlinGroovyScriptEngine` allows imports to re-import dependencies added via "use".
2534 * Changed order in which the `GremlinExecutor` is initialized such that dependency loading via "use" are handled first which fixes problems with starting Gremlin Server with `gremlin-server-neo4j.yaml`.
2535 * Corrected issues with the "branch factor" related traversals under `SubgraphStrategy`.  This change also altered the semantics of the `SubgraphStrategy` a bit as it became more restrictive around `Edge` inclusion (requires both vertices to be in the subgraph).
2536 * The Gephi Plugin now visualizes traversals and has numerous configuration options.
2537 * Added more specific features around the types of "identifiers" a graph can support.
2538 * Added a new test graph called `MODERN` that is copy of the `CLASSIC` graph, but represents floats as doubles.  This graph will be the default graph for testing going forward.
2539 * Fix bug in `Neo4jGraph` that was not processing multiple vertex labels properly when doing a `has()` step with `IN`.
2540 * Changed semantics of `@LoadGraphWith` in gremlin-test to only refer to the ability of a test implementation to process the data types of the test graph (not to actually load it).
2541 * `StartStep` is a `SideEffect` as it is a process to get data into the stream (like a keyboard) and more efficient as such.
2542 * Greatly simplified the implementations of `Map`, `FlatMap`, `Filter`, and `SideEffect`.
2543 * `Path` data structure changed to an ordered list of objects with each associated to a `Set<String>` of as-labels.
2544 * All sideEffect-based steps no longer extend `FilterStep` with predicate equal true, but a more efficient `SideEffectStep`.
2545 * `TreeStep` now has `TreeMapReduce` for executing on `GraphComputer`.
2546 * `Neo4jTraversal.cypher()` is fluent throughout.
2547 * Reverted back to TP2 model of `as()` referring to step names, not variable names of sideEffects.
2548 * Updated `AddEdge`-step to support property key/value pairs for appending to newly created edges.
2549 * Renamed `Graph.getFeatures()` to `Graph.features()` to be consistent with other API methods.
2550 * `Vertex` and `Edge` now implement all `GraphTraversal` methods to ensure consistency throughout stack.
2551 * `Neo4jTraversal` is auto-generated from `Neo4jTraversalStub` with technique generalizable to other vendors.
2552 * Added test suite to ensure that all traversals are of the same type: `g.V`, `g.E`, `g.of()`, `v.identity()`, `e.identity()`, v-, e-methods.
2553 * Giraph HDFS helpers now support `hdfs.mkdir(string)` and `local.mkdir(string)`
2554 * Added `@OptIn` and `@OptOut` for implementers to specify on their `Graph` implementations for test compliance information.
2555 * `GraphComputer` `Memory` now immutable after computation is complete.
2556 * Dependency grabbing for plugins filter out slf4j logging dependencies so as to avoid multiple bindings with the standard TinkerPop distributions.
2557 * Fixed `GiraphMemory` to be fully consistent with GraphComputer specification.
2558 * Removed fatJar assembly from Giraph-Graph as it is no longed needed with distributed cache model.
2559 * Reworked `GiraphRemoteAcceptor` to provide a `result` variable back to the console with `ComputerResult`.
2560 * `VertexProgram` is no longer `Serializable` (use `loadState` and `storeState` for wire-propagation).
2561 * Moved `GiraphGraph.getOutputGraph()` to `GiraphHelper`.
2562 * Changed `GIRAPH_GREMLIN_HOME` to `GIRAPH_GREMLIN_LIB` to reference directory where jars are to be loaded.
2563 * Updated README with release instructions.
2564
2565 TinkerPop 3.0.0.M1 (Release Date: August 12, 2014)
2566 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2567
2568 * First official release of TinkerPop3 and thus, no changes.