Skip to content

CosmosDb provider packages transition (ExRam.Gremlinq 13 to 14)

If you use CosmosDb provider packages today, move to the paid private feed path now to stay unblocked.

In this document:

  1. ExRam.Gremlinq means the open-source GitHub project and its freely available NuGet.org packages.
  2. Gremlinq.Extensions means packages distributed via the paid private NuGet feed that you can access with a valid license from purchasing any Gremlinq.Extensions product.

Affected packages:

  1. ExRam.Gremlinq.Providers.CosmosDb
  2. ExRam.Gremlinq.Providers.CosmosDb.AspNet

What is changing?

  1. OSS line (ExRam.Gremlinq on NuGet.org), version 13.8.2: ExRam.Gremlinq.Providers.CosmosDb and ExRam.Gremlinq.Providers.CosmosDb.AspNet are marked as obsolete.
  2. Commercial line (Gremlinq.Extensions private feed), version 13.9.0+: the same package names are available without the obsoletion marker.
  3. OSS line (ExRam.Gremlinq on NuGet.org), version 14: those CosmosDb provider packages are removed.
  4. Commercial line (Gremlinq.Extensions private feed), version 14: CosmosDb provider support remains but packages are renamed to Gremlinq.Extensions.Providers.CosmosDb and Gremlinq.Extensions.Providers.CosmosDb.AspNet.

How do I continue on v13 without warnings?

  1. Purchase any Gremlinq.Extensions product: Gremlinq.Extensions offerings.
    A cost-effective and high-value entry point is Gremlinq.Extensions.Diagnostics, especially for CosmosDb users who benefit from CosmosDb-specific diagnostics.
  2. Configure the paid private NuGet feed using your license key.
    After purchase, you will receive feed setup instructions and the credentials/license information required to access the private packages.
  3. Upgrade your relevant package references to version 13.9.0 or newer and consume the CosmosDb provider packages from the private feed.

For v13, package naming is retained (ExRam.Gremlinq.Providers.CosmosDb and ExRam.Gremlinq.Providers.CosmosDb.AspNet) to keep migration smooth.

Preparing for v14

Plan for a package rename when moving to Gremlinq.Extensions 14. If you move on v13 first, you can do this transition in two clear steps:

  1. Move your paid-feed package references to version 13.9.0+ now (same package names as OSS v13).
  2. When upgrading to v14, switch package references to Gremlinq.Extensions.Providers.CosmosDb resp Gremlinq.Extensions.Providers.CosmosDb.AspNet.