Starting with the v275 release, this file will contain a record of the major changes and updates made in each release.
This will be the first release of work related to the Second Edition ( main branch ) work. The original First Edition work can still be found on the v1 branch .
- Changes to the site layout and toolchain
- Structural changes to the book
- Coverage of JanusGraph moved to its own chapter.
- Reworked the introduction to the chapters adjacent to the JanusGraph one.
- Removed specific mentions of early TinkerPop versions. The Second Edition will focus on Gremlin as it is today (after many years of evolution).
This will be the final release of work related to the First Edition ( v1 branch ). Moving forward new work will focus on the Second Edition ( main branch ) work.
Here is a link to the Git diffs between this release and the prior one.
- Moved the supported TinkerPop version up to 3.5.2. Issue #228
- Added a section describing the changes added as part of the TinkerPop 3.6.0 release.
- Upated all sections to remove any use of
Order.decr
andOrder.incr
except where explicitly discussing their removal from Gremlin as of 3.5.0 in favor ofOrder.asc
andOrder.desc
. Issue #228 - Added a new section "Comparing properties to the value of a sack". Issue #163
- Added a new section "Using
index
to reverse a list" Issue #220 - Expanded the section introducing
choose
withoption
to explain thatoption
can now take a predicate. Issue #173 - Added a new section "A warning that the '
path
' and 'as
' steps can also be memory intensive". - Renamed and re-worked the section "A warning that path finding can be memory and CPU intensive"
- Added a section showing how to create a standard deviation in a single query. Issue #174
- Added additional examples to the "Looking for the journey requiring the most stops" section and promoted that section by one level. #182
- Added a new section "Quickly finding the hardest to get to airports". Issue #182.
- Added additional examples to the coverage of
flatMap
Issue #183 - Removed an example that used
addOutE
as the step has since been deprectated and removed from TinkerPop completely. #199 - Promoted the section "Using latitude, longitude and geographical region in queries" one level.
- Improved the wording that introduces the section
- Improved the wording at the end of the section.
- Added a sub-section that calculates Great Circle distances using the
math
step and the Haversine formula. #169
- Updated the various Gremlin console help text graphics to the 3.4.10 level. Issue #215
- Added some text to emphasize the evolution of Apache TinkerPop usage from graphs being largely local or directly connected to being remotely connected via Gremlin Server.
- Added to the Terminology section to include edges.
- Added the
Pick
Enum to the enum and class tables. Issue #173 - Merged reader PRs #154, #160, #197, #198, #200, #205, #209, #210, #213,#224
- Updated warning about label indexing to reflect the current state of graph DBs better. Issue #186
- Improved grammar and fixed a few typos. Issues #164, #180, #204
- Renamed HTML and PDF files to PracticalGremlin.
- The prior Gremlin-Graph-Guide names will still work to avoid breaking bookmarks.
- Sample code updates
- Updated all samples to use
Order.asc
andOrder.desc
Issue #228 - Added
RemoteTests.cs
containing a set of .Net examples. - Added
quick-btree2.groovy
which adds a few more nodes to the treee than inquick-btree.groovy
. - Added
RemoteWriteText.java
which shows how to turn traversals and GraphSON back into text queries. - Fixed a compile error in TinkerGraphTest.java caused by a change to the
valueMap
return type. Issue #181 - Fixed two compile errors in RemoteClient.java caused by a change to the
valueMap
return type. Issue #181 - Added a new sample
go-basic.go
that provides examples of using the new Gremlin Go client
- Updated all samples to use
- Sample data updates
- Added a SQL version of the air routes data to a new
SQL
sub folder undersample-data
. Issue #214 - Added an RDF version of the air routes data to a new
RDF
sub folder undersample-data
. Issue #232 - Updated the air-route data sets with new airports and routes. Issues #229, #242
- Added a new script make-cypher.rb that can create the Cypher clauses needed to create the air-routes graph using Cypher or openCypher enabled databases. Also added air-routes.cypher containing the output from running the script.
- Added a SQL version of the air routes data to a new
Here is a link to the Git diffs between this release and the prior one.
The examples in this release have been tested against Apache TinkerPop at the 3.4.1, 3.4.2, 3.4.3 and 3.4.4 levels. As always I am very grateful for the feedback by e-mail, issue and PR. This release resolves a few minor issues and adds a significant amount new content. Please check the commit log for finer grained details of all changes. Here is a list of the major improvements in this release.
- Added a new section comparing
sack
tounion
andproject
when adding values. - Added a new section "Does any route exist between two airports?"
- Added an example showing how
sack
can be used to count flight segments (hops). - Made the discussion of
path
modulated usingfrom
andto
its own section. - Added a new section "Returning selected parts of a path"
- Added a new section "Finding routes that go via a specific airport"
- Expanded the section that introduces the
choose
step. - Added a new section "Pattern matching using a
where
step". - Added a new section "Calculating the
sum
of a collection" - Added a new section "Using the
math
step with collections" - Added a new section "Limiting the results at each depth" when using
repeat
steps. - Added a new section "Finding the longest route from each airport".
- Began adding coverage of TinkerPop 3.4.x features. Issue #115 and #108
- Added a mention of TinkerPop 3.4 in the Introduction.
- Added a section covering the new text predicates such as
contains
andstartingWith
. - Added a section describing the new
index
step. - Added a new section "An alternative to
valueMap
- introducingelementMap
". - Added coverage of nested and named
repeat
steps. - Added
nested-repeat.groovy
to thesample-code
folder. - Added coverage of the new features for
min
andmax
steps. - Added
load-air-routes-graph-34.groovy
using the newg.io()
syntax to thesample-data
folder. - Expanded existing
valueMap
coverage and added new sections covering the newunfold
-by
,with
andWithOptions
features.
- Added a small section showing how to use a
by
modulator with themath
step. - Made the coverage of Gremlin Server its own chapter. Issue #131.
- Added more examples to the coverage of colleactions and 'local' scope.
- Added a note at the start of Chapter 3 that mutation steps like
addV
are covered in Chapter 4. - Added several additional tip boxes containing links pointing to the official TinkerPop docs and/or source code.
- Added a section on using a TinkerGraph containing the air-route data with Gremlin Server . Issue #118
- Added the required config files to the
sample-data
folder. Issue #118
- Added the required config files to the
- Updated and expanded the Further Reading chapter
- Added a small section with a pointer to the latest sample data.
- Added
bootstrap-console.py
to thesample-code
folder. - Added
glv-client.js
showing a simple Node.js Gremlin GLV client to thesample-code
folder. Issues #107 #122 - Added
glv-client2.py
showing additional Python examples using a Gremlin GLV client to thesample-code
folder. - Added samples showing use of TinkerPop strategies from Java and Python to the
sample-code
folder. Issue #11:RemoteSubgraphStrategy.java
RemoteReadOnlyStrategy.java
RemotePartitionStrategy.java
strategies.py
- Added a sample showing use of text predicates and bulk sets
RemoteBulkSetTest.java
- Added a sample showing how to limit the results at each depth of a
repeat
traversal.restricted-repeat.groovy
- Cleaned up some wording.
- Uploaded latest data sets and demo apps to the
sample-data
anddemo
folders.- The latest data set adds 90 additional airports and 6,830 additional routes to the original
air-routes.graphml
data set.
- The latest data set adds 90 additional airports and 6,830 additional routes to the original
Here is a link to the Git diffs between this release and the prior one.
The examples in this release have been tested against Apache TinkerPop at the 3.3.3 and 3.3.4 levels. As always I am very grateful for the feedback by e-mail, issue and PR. This release resolves a number of issues and adds quite a bit of new content. Please check the commit log for finer grained details of all changes. Here is a list of the major improvements in this release.
- Added a new section called "Seven degrees of separation".
- Added a new section on finding the longest routes.
- Added a section presenting a case study of copying one vertex from another.
- Added a section on finding isolated networks within the graph.
- Expanded the section that discusses using
coalesce
as a way to doupsert
type operations - Added to the section that introduces the
emit
step. - Added a section covering the new
Order.asc
andOrder.desc
enumerations. Issue #127. - Added a section on finding airports with no routes.
- Added a small section showing
math
being used to convert feet to meters. - Added examples of the
math
step'ssignum
operator. - Added examples of using
project
to feedmath
. - Added more examples to the section introducing the
inject
step. - Added a warning that not all Graph DBs accept lambdas (in-line code).
- Added additional notes and tips and made wording improvements.
- Added to the section on the Gremlin Server and using a remotely connected Gremlin Console.
- Added another example to the section that introduces the
identity
step. - Added coverage of the
start
,stop
andstatus
keywords that can be used to control a Gremlin Server. - Added two new samples -
basic-client.py
andglv-client.py
- that show how to connect to Gremlin Server using thegremlinpython
library. - Added a sample called
quick-social2.groovy
that creates a social graph useful for testing. Intended to be run from the Gremlin console. - Uploaded updated versions of the air-routes data and corresponding demo apps.
- Added CSV versions of the air-routes data set. Issue #75
- Resolved several issues.
Here is a link to the Git diffs between this release and the prior one.
The examples in this release have been tested against Apache TinkerPop at the 3.3.2 and 3.3.3 levels. They have also been tested against JanusGraph 0.2 (where appropriate) which supports TinkerPop at the 3.2.6 level. As always I am very grateful for the feedback buy e-mail, issue and PR. This release resolves a number of open issues. Please check the commit log for finer grained details of all changes. Here is a list of the major improvements in this release.
- Broke out the discussion of simulating
startsWith
into its own section. - Added to the discussion of
cyclicPath
. - Added text to explain the "__." notation the first time it appears #112.
- Expanded the section that introduces the
path
step #97, #98, #99. - Added text to better introduce the concept of a
modulator
#99 . - Added text to introduce the phrase
anonymous traversal
#98 - Expanded the section covering the
cyclicPath
step. - Expanded the discussion of randomly walking a graph. #105
- Added coverage of the
Direction
Enum. #114 - Expanded and improved the
Calculating vertex degree
section. - Added the
Cardinality
enum to the tables in section 6.1.5 #110. - Miscellaneous minor wording updates and corrections.
- Resolved lots of issues.
- Sample code and data improvements.
- Updated air-routes sample data (475 new routes, 2 new airports).
- Updated demo apps to reflect the latest data updates.
Here is a link to the Git diffs between this release and the prior one.
The examples in this release have been tested against Apache TinkerPop at the 3.3.1, 3.3.2 and at the newly released 3.3.3 level. They have also been tested against JanusGraph 0.2 (where appropriate) which supports TinkerPop at the 3.2.6 level.
Major new features in this release
- Significantly expanded and improved the
subgraph
section. - Added examples to the
where
by
section. - Added more examples of
select
keywordslast
,first
andmixed
. - Added to the section that discusses the
union
step. - Improved the section dedicated to the
match
step. - Improved coverage of text comparison predicates.
- Improved the
Working with IDs
section. - Added examples to the
introducing Path
section. - Added a new section covering use of
withRemote
with a Gremlin Server. - Expanded coverage of custom ID values.
- Added a new section showing an example of a
path
step used inside agroupCount
step. - Added a new section showing how to deduce a graph's schema.
- Added more examples to Chapter 5.
- Corrected output in Section 3.3.1 to reflect correct version of air-routes. Issue #87.
- Expanded coverage of the results from a
Gremlin Server
. - Sample code and data improvements
- Added new script
regression.groovy
to check that the book examples work with the most recent Tinkerpop versions. - Added new sample
add-aircraft.Groovy
. - Added new sample data
aircraft.csv
. - Added new sample
RemoteClient.java
- Added new sample
ListAirports.java
. - Expanded
CreateGraph.java
sample. - Moved
edges.csv
tosample-data
folder. - Provided updated versions of the air-routes data and demo apps (1895 new routes, 21 new airports).
- Added new script
- Miscellaneous issues resolved and other more minor corrections.
Here is a link to the Git diffs between this release and the prior one.
This release has been tested against Apache TinkerPop at the 3.3.1 level and JanusGraph 0.2 which supports TinkerPop at the 3.2.6 level.
Major new features in this release
- Added additional background and context to the introduction chapter.
- Added a new section on measuring query performance.
- Added coverage of the new
math
step. Issue #21. - Added a new Java sample that demonstrates the
math
step (StdDev.java). - Added coverage of the
optional
step. Issue #40. - Improved introduction to the
select
step. - Expanded the "Using 'where' to filter things out of a result" section and the following section that introduces the 'where' and 'by' pattern.
- Expanded the section that introduces the
union
step. - Added dedicated introduction sections for the
identity
andconstant
steps. Issue #43. - Added coverage of TinkerGraph indexing.
- Added to the
collections
section. - Added a new
OLTP vs OLAP
section. - Added to the
Gremlin Server
section. - Improved coverage of
cyclicPath
- Improved coverage of
flatMap
- Improved coverage of
repeat
andemit
. - Added coverage of
toSet
in section 3. - Expanded the
vertex degree
section. - Updated the
valueMap
section. - Added examples of using
from
andto
withpath
. - Added example of empty
by
modulator topath
section. - Added a section showing how
inject
can supply ID values toaddV
. - Added a section to introduce the
dedup
step in Section 3. - Expanded the "Basic statistical and numerical operations" section.
- Added coverage of dynamically adding labels using
addV
andaddE
- issue #22. - Added an example of nested
group
steps in section 5. - Improved existing text and examples in section 5.
- Added more examples to section 5
- Improved coverage of
indexed
andwithIndex
. - Moved
indexed
andwithIndex
material up to Section 3 (from 5). - Examples in section 5 now all based on the same air routes graph v0.77 (some used to reflect an older version).
- Added a new Java sample GroupCounts.java
- Added a new Java sample that explores the
sample
step (Iterate.java). - Expanded the section in chapter 4 that introduces GraphML and Graphson.
- Added coverage of GraphSONMapper to the expanded GraphML/GraphSON section. Issue #51
- Added to the
JanusGraph GeoSpatial
section and moved the section up a hierarchy level. - Added a new sample that demonstrates geospatial queries (janus-geoshape.groovy).
- Improved source highlighting for MOBI and EPUB versions.
- Added more examples in various places.
- General housekeeping and tightening up of some wording.
- Added a gitignore file. PR #39
This is a fairly substantial update. Lots of new material added to the book and to the sample-code folder.
Here is a link to the Git diffs between v277 and the prior v276 release
Major new features in this release.
- Wrote the first draft of the
Gremlin Server
section. - Added examples of the JSON that is returned from different Gremlin Server queries.
- Added a new section dedicated to discussing steps that generate
collections
and how to operate on them. - Added a new section dedicated to the
sack
step. - Added additional coverage of the
local
step and scope in general. - Added some focused coverage of
reducing barrier
steps. - Added coverage of the new
skip
step. - Added to the JanusGraph
cardinality
section. - Added to the JanusGraph
transactions
section. - Added to the JanusGraph
geospatial API
section. - Significantly added to the using Gremlin from Java sections.
- Added detailed coverage of Classses and Enums that you need to include when writing a Java or Groovy app that are hidden from you when using the Gremlin Console.
- Added to the using Gremlin from Groovy sections.
- Added coverage of JanusGraph storage options.
- Added a new section showing how to use Cassandra from a Docker Container with JanusGraph.
- Added a sample that shows how to load the air routes graph into JanusGraph backed by Cassandra.
- Added several new Java and Groovy samples to the sample-code folder.
- Added a new Ruby sample that can connect to a Gremlin Server
- Improved some existing sample apps.
- Enabled icons for tips and notes boxes.
- Did quite a bit of cleaning up of the text overall and corrected some mistakes and typos.
Here is a link to the Git diffs between v276 and the prior v275 release
Major features in this Release
- Renamed the book to "Practical Gremlin".
- Added Tip boxes pointing to relevant samples throughout the book.
- Added to the section on the
where
step. - Improved section on boolean steps.
- Added more Java samples to the sample-code folder.
- Significantly improved coverage of the
repeat
step. - Expanded coverage of working with properties.
- Added coverage of the
explain
step. - Removed use of deprecated
addV
form. - Added introductory text to make GitHub material easier to find.
- Cleanup and fixing of typos.
Major features in this release
- Added a new section pointing to where the samples are located.
- Added to latitude/longitude section.
- Added to and improved Section 5 (Misc queries)
- Expanded JanusGraph indexing section.
- Added new samples to sample-code folder.
- Improved several existing samples in the sample-code folder.
- Switched to Asciidoctor-PDF to generate PDF output.
- Some general tidy up and other improvements.
The initial manuscript and sample programs were uploaded on Oct 4th 2017. To track changes since then but before the v275 release please refer to the commit history.