You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[](https://krlawrence.github.io/graph/)
6
+
[](https://krlawrence.github.io/graph/Practical-Gremlin.pdf)
7
+
5
8
## Welcome!
6
9
7
10
This repository is the home for the source materials, sample code and examples for the book "Practical Gremlin - An Apache TinkerPop Tutorial". This is also the home for the `air-routes` dataset referenced throughout the book and samples.
8
11
9
12
### Quick Start - the latest version
10
13
11
-
Preview releases for the second edition, which covers TinkerPop 3.8.0, are published as HTML automatically as they are authored and can be found [here and HTML](https://krlawrence.github.io/graph/) and [here as PDF](https://krlawrence.github.io/graph/Practical-Gremlin.pdf). It should be noted when reading this revision of the book that it is still a draft version and under significant modification, so you can expect volatile changes.
14
+
The second edition, which covers TinkerPop 3.8.0, is published automatically as changes are authored and can be found [here and HTML](https://krlawrence.github.io/graph/) and [here as PDF](https://krlawrence.github.io/graph/Practical-Gremlin.pdf). As with the first edition, Practical Gremlin is considered a living book and may receive frequent updates.
12
15
13
-
The first edition, covering versions prior to 3.8.0, is still available, but no longer updated. The final publication of that version can be found at [Revision 283](https://github.com/krlawrence/graph/releases/tag/v283-tp-3.5.2). You will find the standard formats this book is published in, including PDF, HTML, MOBI, EPUB and XML (Docbook). The [releases](https://github.com/krlawrence/graph/releases) section will continue to offer access to all of these formats as snapshots for ongoing reference. The PDF version is currently the "official" version. It has a better table of contents, page numbers, and some better formatting.
16
+
The first edition, covering versions prior to 3.8.0, is still available, but no longer updated. The final publication of that version can be found at [Revision 283](https://github.com/krlawrence/graph/releases/tag/v283-tp-3.5.2). You will find the standard formats this book is published in, including PDF, HTML, MOBI, EPUB and XML (Docbook). The [releases](https://github.com/krlawrence/graph/releases) section will continue to offer access to all of these formats as snapshots for ongoing reference. A published archived versionof this edition can be found [here](https://krlawrence.github.io/graph/first-edition/).
14
17
15
18
### LATEST NEWS
16
19
20
+
-[Feb-26-2026] Published an archived HTML version of the first edition to https://krlawrence.github.io/graph/first-edition/
17
21
-[Jan-12-2026] Published the final version of the first edition, which is the version that has been generally available https://kelvinlawrence.net/book/Gremlin-Graph-Guide.html, as this link is expected to become unavailable once the second edition is made official.
18
22
-[Dec-17-2025] Auto-published the PDF version of book via GitHub Actions as changes arrive to the 'main' branch.
19
23
-[Oct-22-2025] Generated 1.0 of the air-routes dataset.
@@ -22,15 +26,15 @@ The first edition, covering versions prior to 3.8.0, is still available, but no
22
26
23
27
### Work has ~~begun~~ completed on the second edition!
24
28
25
-
January 1st 2026
29
+
#### January 1st 2026
26
30
27
31
Considering that the decision to work on a second edition started September 23, 2023, it has taken some time to reach completion of that work. Some of this delay was due to the unexpected introduction of the 3.8.0 release, which ultimately became the version this edition targets. The 3.8.0 release did not occur until November 12, 2025 and it therefore only made sense to finalize the second edition after that release became official.
28
32
29
33
Using 3.8.0 as a base for the second edition made a lot of sense because it means that this edition will have long relevance, as the expectation in TinkerPop is that Gremlin semantics will not change between the 3.8.0 and 4.0.0 releases. That said, the expectation is that the second edition will continue to be updated, just as was the case with the first. There are still many topics that were not covered, but the writing had to stop at some point and the end of 2025 seemed like a good a time as any to go pencils down.
30
34
31
35
We hope you enjoy the second edition of Practical Gremlin!
32
36
33
-
September 23rd 2023
37
+
#### September 23rd 2023
34
38
35
39
Ever since I began working on Practical Gremlin, I've viewed it as a living book, and have tried to keep up with new features and changes taking place at Apache TinkerPop, updating the manuscript as TinkerPop and Gremlin evolve. However, and this is great to see, the rate and pace at which new features are appearing in Gremlin has steadily increased over the years. This has made it hard to keep up in a "living book" fashion. Moreover, some material currently in Practical Gremlin discusses features and limitations in the language that have since either been improved or deprecated. It's really time to start work on a second edition. I'm excited to announce that [Stephen Mallette](https://stephen.genoprime.com/) has graciously offered to help with this task. We have created a [V1](https://github.com/krlawrence/graph/tree/v1) branch which archives the first edition progress. Work for the second edition will simply occur on the default branch. Many of the new Gremlin features that need adding to the manuscript are captured in a [tracking issue](https://github.com/krlawrence/graph/issues/115) and there is also a [planning board](https://github.com/krlawrence/graph/projects/2#) that will continue to be used as a way to organize the work ahead. I'm really looking forward to the collaboration with Stephen, and to the production of a fully up-to-date second edition of Practical Gremlin. Please keep an eye on the latest news section here for more updates.
36
40
@@ -133,7 +137,8 @@ may be added and the layout further refined.
133
137
134
138
---
135
139
136
-
**NEWS ARCHIVE**
140
+
## News Archive
141
+
137
142
[Sep-22-2023] Added a script to the sample-data folder for producing Cypher versions of the air-routes data.
138
143
[Aug-29-2022] Updated versions of the sample data and corresponding demo apps have been uploaded.
139
144
[May-04-2022] The latest preview draft of revision 283 (TP 3.5.1) is now available in HTML and PDF versions. See [change history](https://github.com/krlawrence/graph/blob/main/ChangeHistory.md) for details.
0 commit comments