LinQL.GraphQL.Client 0.6.1

LinQL

LINQ-like access to GraphQL endpoints in .Net

Supported Operations

• Queries
• Mutations
• Input Types
• Arguments
• Interfaces/Unions
• Auto-generating types via introspection
• Subscriptions

Coming soon

• Custom Scalars
• Strawberry Shake support

Getting Started using GraphQL.Client

1. Install the Nuget package

dotnet add package LinQL
dotnet add package LinQL.GraphQL.Client

2. Reference a .graphql SDL in your csproj

<ItemGroup>
    <AdditionalFiles Include="StarWars.graphql" LinQLClientNamespace="StarWars.Types" />
</ItemGroup>

3. Write queries!

using GraphQL.Client.Abstractions;
using StarWars.Types; // As defined by LinQLClientNamespace

public class StarWarsClient
{
    private readonly IGraphQLClient graph;

    public StarWarsClient(IGraphQLClient graph) => this.graph = graph;

    public async Task<Film> GetFilmById(string id, CancellationToken cancellationToken)
        => await this.graph.SendAsync((Root x) => x.GetFilm(id), cancellationToken);
}

Getting Started using StrawberryShake

Coming soon...

A range of expressions can be converted as demonstrated by the TranslationProviderTests. If you come accross something that doesn't work, please raise an issue or a pull request with a supporting test.

For more help check out the docs

Troubleshooting

LINQLGEN02: GraphQL file {0} does not have a LinQLClientNamespace attribute. Please add it to the AdditionalFiles element in your csproj file.

This could be related to a Nuget bug where the LinQL.props file has not been imported because it won't follow transitive references. Install the LinQL package individually.