Flowthru.Extensions.GQL 0.26.0-preview.112

This is a prerelease version of Flowthru.Extensions.GQL.

dotnet add package Flowthru.Extensions.GQL --version 0.26.0-preview.112

NuGet\Install-Package Flowthru.Extensions.GQL -Version 0.26.0-preview.112

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Flowthru.Extensions.GQL" Version="0.26.0-preview.112" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Flowthru.Extensions.GQL" Version="0.26.0-preview.112" />
                    

                            Directory.Packages.props

<PackageReference Include="Flowthru.Extensions.GQL" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Flowthru.Extensions.GQL --version 0.26.0-preview.112

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Flowthru.Extensions.GQL, 0.26.0-preview.112"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package Flowthru.Extensions.GQL@0.26.0-preview.112

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=Flowthru.Extensions.GQL&version=0.26.0-preview.112&prerelease
                    

                            Install as a Cake Addin

#tool nuget:?package=Flowthru.Extensions.GQL&version=0.26.0-preview.112&prerelease
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Flowthru.Extensions.GQL

Read and write Flowthru Catalog Items against a GraphQL API through a StrawberryShake client. Declare an Item from a query operation and a projection (result -> rows), and a Flow loads typed rows from the API the same way it loads them from a file. Single-item, collection, paginated (Relay cursor or offset), and deferred query handles are all supported, and a single item can be made read/write by supplying a mutation delegate.

Mental model

This bridges a StrawberryShake client into the Catalog. Bring everything StrawberryShake gives you — generated operation types, an IOperationResult<TResult> per query, your .graphql documents. The extension brings no client of its own: you wire your StrawberryShake client in DI as usual and pass its operation delegates to the Item. An Item is a named handle on a query — the load executes the operation and the selectData projection pulls your rows out of the result envelope. Use GqlDeferred when a step should decide when to fire the network call (it materialises via .ToList()).

Install

dotnet add package Flowthru.Extensions.GQL

Wire your StrawberryShake client in DI, then declare a GQL-backed Item from its operations:

// Host wiring — your generated StrawberryShake client, configured as usual.
services
    .AddSpaceflightsClient()
    .ConfigureHttpClient(c => c.BaseAddress = new Uri("https://api.example.com/graphql"));

// In the Catalog — a deferred query handle; the consuming step calls .ToList()
// to fire the GetCompanies operation against the server.
public IItem<GqlQuery<IGetCompaniesResult, IGetCompanies_Companies>> Companies =>
    CreateItem(() => Item.Of<GqlQuery<IGetCompaniesResult, IGetCompanies_Companies>>("GQLCompanies")
        .GqlDeferred(
            queryFunc: ct => _client.GetCompanies.ExecuteAsync(ct),
            selectData: r => r.Companies)
        .AllowEmpty()
        .Build());

UseGql() is the opt-in scheduler gate for rate-limited endpoints — pair it with WithGqlConcurrency(...) to cap concurrent calls to an endpoint when running at Parallelism > 1.

Product	Compatible and additional computed target framework versions.
.NET	net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- Flowthru.Core (>= 0.26.0-preview.112)
- Microsoft.Extensions.Configuration (>= 10.0.4)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.4)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.4)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.4)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.4)
- Microsoft.Extensions.Options (>= 10.0.4)
- StrawberryShake.Core (>= 15.1.14)

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.