LinQL 0.3.0

LinQL

LINQ-like access to GraphQL endpoints in .Net

Supported Operations

• Queries
• Mutations
• Input Types
• Arguments
• Interfaces/Unions

Coming soon

• Subscriptions
• Auto-generating client via introspection
• Custom Scalars

Getting Started

1. Install the Nuget package

dotnet add package LinQL

2. Create a Graph and a RootType

public class StarWarsGraph : Graph
{
    public StarWarsGraph(IGraphQLConnection connection, IQueryTranslator queryTranslator)
        : base(connection, queryTranslator)
    {
    }

    public StarWarsQueries Query => this.RootType<StarWarsQueries>();
}

[OperationType]
public class StarWarsQueries : RootType<StarWarsQueries>
{
    public Film Film { get; set; }

    [GraphQLOperation, GraphQLField(Name = "film")]
    public Film GetFilm(string id) => this.Film;
}

public class Film
{
    [GraphQLField(Name = "ID")]
    public string? Id { get; set; }

    [GraphQLField(Name = "episodeID")]
    public int EpisodeId { get; set; }

    public string? Title { get; set; }
}

3. Add a graph client to DI

public void ConfigureServices(IServiceCollection services)
{
    services.AddGraphQLClient<StarWarsGraph>()
            .WithHttpConnection(c => c.BaseAddress = new Uri("https://swapi-graphql.netlify.app/.netlify/functions/index"))
}

Underneath, WithHttpConnection is just setting up IHttpClientFactory so anything you can configure with that, you can configure here; authentication headers, middleware etc.

4. Write queries!

public class StarWarsClient
{
    private readonly StarWarsGraph graph;

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

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

For more help check out the docs

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.