Skip to content

2026

Gremlinq.Extensions 14.2.1

Gremlinq.Extensions 14.2.1 is built against ExRam.Gremlinq 14.2.1. See the ExRam.Gremlinq 14.2.1 release notes for what changed there, among it a connection pool that keeps the requests of a session on one connection. (#318)

Fixes

  • The in-memory provider now runs every query as one transaction, like Gremlin Server 3.8.2 with TinkerTransactionGraph and like Neptune. A query that fails at run time takes back all its writes; before, the writes made before the failure stayed in the graph. (#311)
  • A transaction now ends its server session with a close request after the commit or rollback, instead of leaving it open until the server's timeout. Rollback and close run without the caller's cancellation token, so a cancelled transaction is still rolled back, and a failing rollback or close no longer hides the exception of the continuation. The query source of a transaction throws an InvalidOperationException once the transaction has ended, and transactions do not nest. (#313)

Maintenance

  • Every extension package now carries a README of its own. Before, every package except Transactions packed the README of ExRam.Gremlinq. (#317)

Full changelog: https://github.com/Gremlinq/Gremlinq.Extensions/compare/14.2.0...14.2.1

ExRam.Gremlinq 14.2.1

Fixes

  • The connection pool now keeps every request of a Gremlin Server session on the connection of its first request, close request included. Before, overlapping requests of one session were spread over the pool's connections, and a session whose connection was dropped silently started anew under the same id; now every later request of such a session throws an InvalidOperationException naming it, before anything is sent. Sessionless requests are unchanged. (#2598)
  • A branch that ends in Fail() no longer lowers the projection of Coalesce, Union and Choose, just like a branch that ends in Discard(). Before, the usual assertion Coalesce(__ => __.Where(…), __ => __.Fail(…)) projected to Empty, so a following Property(…) lost its cardinality single and the result lost its vertex projection. Choose now also skips a branch that ends in Discard(). (#2601)
  • Coalesce leaves out every branch after its first identity branch, since those branches never run. Before, they were still sent to the server and could lower the projection of the query. The coalesce step itself stays, as it adds an entry to the path of a traverser. (#2604)

Full changelog: https://github.com/Gremlinq/ExRam.Gremlinq/compare/14.2.0...14.2.1

Gremlinq.Extensions 14.2.0

Gremlinq.Extensions 14.2.0 is built against ExRam.Gremlinq 14.2.0. See the ExRam.Gremlinq 14.2.0 release notes for what changed there, TinkerPop 3.8 support above all. (#306)

Features

TinkerPop 3.8 in System.Text.Json

The System.Text.Json support in Gremlinq.Extensions.Support.SystemTextJson follows the server compatibility range that ExRam.Gremlinq 14.2.0 introduces, and writes and reads the same forms as Newtonsoft.

  • Gremlinq.Extensions now depends on Gremlin.Net 3.8.2, through ExRam.Gremlinq. The requests, the answers and the public API stay the same. (#288)
  • A gx:OffsetDateTime, which a TinkerPop 3.8 server answers asDate() and dateAdd() with, is now read as a DateTimeOffset that keeps its offset. Before, it was moved to UTC or stayed a string. (#291)
  • For a server compatibility range from 3.8 on, a DateTimeOffset is written as gx:OffsetDateTime instead of g:Date. (#293)
  • For a range from 3.8 on, a gx:Byte is read as an sbyte, as Gremlin.Net 3.8 reads it. Below 3.8, and for a range that spans both, it stays a byte. (#292)
  • For a range from 3.8 on, strategies and strategy types are written as Gremlin.Net 3.8 writes them. Gremlin Server 3.8.2 cannot read the 3.7 form. (#298)
  • UseCosmosDb sets the server compatibility range to TinkerPop 3.4.13, the version CosmosDb understands, before a configured range is applied. No query changes. (#294)

Deserialization

  • A g:Map or a plain object is now built into any dictionary class with a public parameterless constructor, such as SortedDictionary<,>, SortedList<,> or a class derived from Dictionary<,>, keys as they were typed. (#247)
  • A ReadOnlyDictionary<,> and a class that implements IDictionary<,> twice are now built, as Newtonsoft builds them. (#252)
  • A class that implements IReadOnlyDictionary<,> but no IDictionary<,> is built again. 14.1.2 declined it. (#257)
  • A dictionary is also built through a constructor that takes an IReadOnlyDictionary<,>, where only a constructor taking IDictionary<,> counted before. (#259)
  • A value requested as a generic interface of a scalar type, such as IEquatable<int> or INumber<int>, is now read as that scalar type instead of being declined. (#251)

Fixes

  • System.Text.Json no longer throws for input it cannot read, such as a number too large for the requested int or a null value for a Property<string>. It declines the value. A type of your own that derives from Property<T> is read like Property<T>, and a VertexProperty<T> gets its key. (#239)
  • A dictionary keeps a null value when its value type can hold one, from a g:Map as from a plain object. It is a real null, never a JsonElement. (#240)
  • A typed value such as a g:Int32 is no longer read as a dictionary of its @type and @value. A collection of key-value pairs gets the same answer as a Dictionary<string, object>, and a vertex read into a dictionary gives its properties. (#241)

Performance

  • Typed g:Tree values are read faster: the tree converter reads them itself, without a detour through the typed-value converter per level. (#260)

Full changelog: https://github.com/Gremlinq/Gremlinq.Extensions/compare/14.1.2...14.2.0

ExRam.Gremlinq 14.2.0

Features

TinkerPop 3.8

  • Gremlinq can now be told which TinkerPop versions the server understands: IGremlinQueryEnvironment.ServerCompatibilityRange holds that range. Its first user is the step that filters out everything: for a range from 3.8 on, Gremlinq sends discard(), the name TinkerPop 3.8 gave none(). Discard() is new, None() is obsolete. Without configuration nothing changes. (#2561)
  • The range is configured on a provider configurator with the same name and shape as on the environment, ConfigureServerCompatibilityRange(Func<VersionRange, VersionRange>). The transformation is given the range set before it, the provider's default included, so it can also change one end of it. (#2573)
  • A Neptune user names the engine version with WithEngineVersion(...) and gets the TinkerPop versions AWS documents for it: 3.7.1 for engines 1.3.2.0 up to 1.4.x, 3.8.0 to 3.8.1 for 1.5.x. NeptuneEngineVersions names the known engines. (#2572)
  • Both can be set from IConfiguration: Gremlinq:ServerCompatibilityRange:Lowest and :Highest for every provider set up through the AspNet packages, Gremlinq:Neptune:EngineVersion for Neptune. (#2579)
  • Gremlinq now depends on Gremlin.Net 3.8.2. It sends the same requests as before, so TinkerPop 3.7 servers keep working. (#2559)
  • TinkerPop 3.8 removed has(key, traversal); a 3.8 server accepts it, but it never matches. For a range from 3.8 on, Where(x => x.Prop, continuation) and a member compared with a step label now send the where() filter a 3.7 server executes for it. (#2564)
  • AggregateLocal sends local(aggregate(x)) to servers from 3.8 on, since TinkerPop 3.8 removed aggregate(local, x). (#2565)
  • TinkerPop 3.8 lets a traverser that no choose() option matches, or whose choice traversal yields nothing, pass through unchanged. For a range from 3.8 on, Choose adds the two options that keep the semantics of 3.7: the first is filtered, the second fails. (#2566)
  • From TinkerPop 3.8 on, limit(local, 1), tail(local, 1) and range(local, n, n + 1) return a list themselves, so a server from 3.8 on gets the plain step instead of the map(unfold().limit(1).fold()) workaround, even with WorkaroundRangeInconsistencies set. (#2567)
  • A gx:OffsetDateTime, which a 3.8 server answers for asDate() and dateAdd(), is now read as a DateTimeOffset that keeps its offset. Before, the offset was lost or an object got a string. (#2569)
  • For a range from 3.8 on, a DateTimeOffset is written as gx:OffsetDateTime instead of g:Date. (#2571)
  • Bytes are read and written by the range. TinkerPop's Byte is signed, so from 3.8 on an sbyte is written as gx:Byte, a byte as a bare number, and a gx:Byte is read as an sbyte. (#2570)
  • For a range from 3.8 on, strategies and strategy types are written as Gremlin.Net 3.8 writes them. Gremlin Server 3.8.2 cannot read the 3.7 form. (#2575)

Deserialization

  • A g:Map is now built into any dictionary class with a public parameterless constructor, such as SortedDictionary<,> or SortedList<,>, keys as they were typed. (#2511)
  • A dictionary is also built through a constructor that takes an IReadOnlyDictionary<,>, where only a constructor taking IDictionary<,> counted before. (#2526)
  • A value requested as a generic interface of a scalar type, such as IEquatable<int> or INumber<int>, is now read as that scalar type instead of being declined. (#2518)

Fixes

  • Newtonsoft no longer throws for input it cannot read, such as a number too large for the requested byte or a null for an int. It declines the value, or leaves out only the part it cannot read. A type of your own that derives from Property<T> is read like Property<T>. (#2505)
  • A dictionary keeps a null value when its value type can hold one, from a g:Map as from a plain object. It is a real null, never a JValue. (#2506)
  • A typed value such as a g:Int32 is no longer read as a dictionary of its @type and @value. Only a g:Map is a map, and a collection of key-value pairs gets the same answer as a Dictionary<string, object>. (#2507)
  • A g:Map whose keys are not names keeps its entries when requested as the non-generic IDictionary, ICollection or IEnumerable. (#2508)
  • A g:List requested as an ImmutableArray<T> now holds its items instead of coming back uninitialized. A generic collection interface of object gets a List<object>, so an IList<object> takes Add and Remove. (#2512)
  • A number is read as an enum only where it fits the enum's underlying type. Before, it was cut to that size and became another value. true and false are no enum values any more, and a ulong enum can hold its largest value. (#2513)
  • A dictionary without a public parameterless constructor, such as an ImmutableSortedDictionary<int, string> or a ReadOnlyDictionary<int, string>, keeps all entries of a g:Map whose keys are not names. (#2520)
  • The same holds for a class that implements IReadOnlyDictionary<,> but no IDictionary<,>. (#2524)
  • A where() on a scalar no longer drops its is() step when an IPFactory returns P.Without(...) with values. (#2582)
  • A converter reached through two nested defer calls now gets the whole converter chain as its recurse transformer, so a recurse call from there no longer skips the converters registered after that point. (#2585)
  • GraphModel.FromBaseTypes now says which type is the vertex base type and which the edge base type when it rejects base types in each other's hierarchy. (#2583)

Performance

  • Typed g:Tree values are read faster: the tree converter reads them itself, without a detour through the typed-value converter per level. (#2527)
  • Serializing a query takes about a third less time: the converter chain is found in two thirds of the time, and the serializer looks an instruction's expansion up once instead of twice. (#2586)
  • Serializing a query that writes properties, projects a tuple or has a collection predicate allocates less. (#2587)
  • Building a query allocates less and takes less time: a continuation creates its anonymous query only when it runs one, and the label projections of a continuation that added no label are not merged. (#2588)
  • A constant that is an expression, as x.Age > age + 1 or ids[0], is read in about a microsecond instead of a hundred: it is read directly or interpreted instead of being compiled into a method that runs once. (#2589)
  • On the request path, a request is serialized before the connection's send lock is taken, the Task.Yield() per response is gone, the MetaResponse<T> decision is made once per result type, and a default cancellation token no longer links a token source. (#2590)
  • A received WebSocket message costs one pooled object instead of an owner per doubling and a Task per receive, and the send and the receive of a request run as pooled ValueTasks. (#2591)

Maintenance

  • The docs of Diff say that the result is in the unit the server uses: seconds up to TinkerPop 3.7, milliseconds from 3.8 on. (#2568)

Full changelog: https://github.com/Gremlinq/ExRam.Gremlinq/compare/14.1.2...14.2.0

Gremlinq.Extensions 14.1.2

Gremlinq.Extensions 14.1.2 is built against ExRam.Gremlinq 14.1.2. See the ExRam.Gremlinq 14.1.2 release notes for what changed there. (#236)

Fixes

All but the last entry concern the System.Text.Json support in Gremlinq.Extensions.Support.SystemTextJson.

  • A value the requested type cannot read now makes the System.Text.Json converter decline instead of throwing, so one unreadable item no longer fails the whole result set. T, Direction, Merge and the other Gremlin.Net enumerations are now deserialized, and a gx:BigInteger no longer comes back as zero. (#193)
  • A value of a Gremlin enumeration that Gremlin.Net has no name for, such as a newer server's new value, is now read as a value of that enumeration. (#212)
  • A null in a result array is now kept instead of being dropped. (#198)
  • A null in a g:BulkSet is now kept, together with its bulk, instead of being dropped. (#199)
  • A g:BulkSet with an odd number of entries no longer throws an IndexOutOfRangeException. The well-formed pairs are read. (#201)
  • A g:BulkSet can now be read into any generic collection, such as List<T>, ISet<T> or ImmutableList<T>. It used to throw an InvalidCastException. (#202)
  • A g:BulkSet can now be read into ArrayList, Queue, Stack, ICollection and IList. It used to throw an InvalidCastException. (#204)
  • A g:BulkSet whose type name arrives in another case, such as G:BULKSET, is now read as a bulk set. (#200)
  • A g:Map whose type name arrives in another case, such as G:MAP, is now read into a dictionary (#203) and into an object (#205).
  • An elementMap() of a vertex with a label the model does not know keeps its id and label when it is read as an object. (#206)
  • A g:Map keyed by something other than strings, such as ints, keeps its entries when it is read as an object. It now comes back as a Dictionary<object, object>. (#207)
  • A map or object with a key that appears twice is now read, the last occurrence counting, instead of failing the whole result set with an ArgumentException. (#216)
  • When a name appears twice with different case, such as age and Age, the last one now fills the member, as with Newtonsoft.Json. (#210)
  • GraphSON's own member names (key, value, id, label, properties, bulk) are now matched exactly. A map of your own with members named Key and Value is no longer mistaken for a property. (#208)
  • A g:T counts as a T only when its value is exactly id, key, label or value. (#209)
  • A JSON null requested as a string is no longer read as an empty string. A null string property now stays null. (#214)
  • A .NET enum stored as the name of one of its values, such as "Female", is now read. It used to be left unset without any error. (#215)
  • A scalar is now read from everything Newtonsoft.Json reads it from, such as a bool from 1 or an int from 3.0. Such members used to silently keep their default. (#217)
  • A value requested as a base type or an interface, such as IComparable or the non-generic IEnumerable, now comes back as it does with Newtonsoft.Json. It used to come back empty, as a raw JsonElement or as a different kind of collection. (#218)
  • Coalesce(...) with a single sub-query no longer changes what that sub-query returns, in the CosmosDb provider too. Map(...) and Project(...).By(...) also leave out steps that change nothing. (#213)

Performance

  • The System.Text.Json support now reads GraphSON arrays in linear instead of quadratic time. A 1000-entry g:BulkSet now takes 0.33 ms instead of 12.3 ms. (#221)

Full changelog: https://github.com/Gremlinq/Gremlinq.Extensions/compare/14.1.1...14.1.2

ExRam.Gremlinq 14.1.2

Fixes

  • A value the requested type cannot read, such as "not a date" asked for as a DateTime, is now skipped like any other unconvertible item instead of failing the whole result set. (#2438)
  • A deserialization converter that throws no longer leaves a query waiting forever. The query now fails with the converter's exception, and the pool builds a fresh client for the next one. (#2439)
  • Direction, Merge, T and Gremlin.Net's other EnumWrapper types are now deserialized, where they used to fail or come back as the bare string. (#2440)
  • A value of a Gremlin enumeration that Gremlin.Net has no name for, such as a newer server's new value, is now read as a value of that enumeration instead of being lost. (#2470)
  • GraphSON arrays now deserialize into ArrayList, Queue and Stack, with their items converted like those of every other collection. (#2444)
  • A g:Map requested as an IImmutableDictionary<,> or ImmutableDictionary<,> no longer comes back empty. Building a Dictionary<,> from a map also allocates less. (#2445)
  • A g:Map keyed by something other than strings, such as ints, keeps its entries when requested as an object. It now comes back as a Dictionary<object, object>. (#2459)
  • A g:Map with a key that appears twice is now read, the last occurrence counting, instead of failing the whole result set with an ArgumentException. (#2480)
  • Traversers are now expanded into every collection type, such as ImmutableList<T>, ISet<T> or Queue<T>, where a bulked result used to throw. (#2447)
  • A g:BulkSet read into anything other than an array, such as a List<int>, now expands its bulks instead of returning the counts mixed in with the values. (#2453)
  • A null in a result array is now kept instead of being dropped, so the script and bytecode paths finally return the same results. (#2448)
  • A null in a g:BulkSet is now kept, together with its bulk, instead of being dropped. (#2449)
  • A value/bulk pair in a g:BulkSet whose bulk cannot be read is now skipped, instead of the value being emitted once. (#2451)
  • A g:BulkSet with an odd number of entries no longer throws an ArgumentOutOfRangeException. The well-formed pairs are read and the dangling element is skipped. (#2452)
  • A traverser is now only recognised when its envelope is spelled @type and @value, as every other typed value already was. Server output is unaffected. (#2460)
  • GraphSON's own member names (key, value, id, label, properties, bulk) are now matched exactly. A map of your own with members named Key and Value is no longer mistaken for a property. (#2466)
  • A g:T whose value is not exactly id, key, label or value no longer makes deserialization throw. (#2467)
  • Coalesce(...) with a single sub-query no longer changes what that sub-query returns. Coalesce(__ => __.Out<WorksFor>().Limit(1)) used to return one vertex in total instead of up to one per incoming element; it is now emitted as a flatMap(...). (#2474)
  • Named step labels no longer change the names of generated step labels, so the text of a query no longer depends on how many named labels come before. (#2497)

Performance

  • Map(...) and Project(...).By(...) no longer emit a trailing limit(1), since both only take the first result anyway. (#2473)
  • Project(...).By(...) no longer emits a map() that wraps the whole by() traversal. (#2475)
  • Slicing a Traversal no longer recounts the write steps of the slice, so cutting a read-only traversal no longer costs as much as it is long. (#2472)

Full changelog: https://github.com/Gremlinq/ExRam.Gremlinq/compare/14.1.1...14.1.2

ExRam.Gremlinq 14.1.1

Changes

  • Stop and Dispose Testcontainers container through executor/client-factory disposal (#2417)
  • Handle concurrent dispose/creation during container creation (#2416)
  • Consolidate dependencies (#2413)
  • Update TestContainers (#2412)
  • Save allocation of a separate StepLabel identity (#2411)
  • Enable GitHub Actions Test reporting through Microsoft.Testing.Platform (#2409)
  • Switch NuGet.org publishing to Trusted Publishing (OIDC) (#2408)

ExRam.Gremlinq 14.1.0

Changes

  • Cache empty VStep and EStep (#2400)
  • Reuse underlying list in Traversal instead of creating a new one in every case (#2398)
  • Optimize FastImmutableList.Push (#2397, #2399)