NGql.Core 1.1.1

NGql

Schemaless GraphQL client for .NET Core.

Quick Start

dotnet add package NGql.Core

Usage

Core library allows creation of Query and Mutation's. Both have an implicit conversion to string.

Query

var query = new Query("PersonAndFilms")
    .Select(new Query("person")
        .Where("id", "cGVvcGxlOjE=")
        .Select("name")
        .Select(new Query("filmConnection")
            .Select(new Query("films")
                .Select("title")))
    );

the output will be the following

query PersonAndFilms{
    person(id:"cGVvcGxlOjE="){
        name
        filmConnection{
            films{
                title
            }
        }
    }
}

Mutation

var mutation = new Mutation("CreateUser")
                .Select(new Query("createUser")
                    .Where("name", "Name")
                    .Where("password", "Password")
                    .Select("id", "name"))
                .ToString();

the output will be the following

mutation CreateUser{
    createUser(name:"Name", password:"Password"){
        id
        name
    }
}

Variables

Variables allows to reuse existing queries and mutations instead of building them from start every time.

Passing variables

var variable = new Variable("$name", "String");

// pass as constructor parameter
var ctor = new Query("name", variables: variable);

// or as method variable
var fluent = new Query("name", variables: variable).Variable(variable););

the output will be the following

query name($name:String){
    id
}

Getting data from server

You can check QueryTests that uses GraphQL.Client

var graphQLClient = new GraphQLHttpClient("http://swapi.apis.guru/", new NewtonsoftJsonSerializer());

var query = new Query("PersonAndFilms")
    .Select(new Query("person")
        .Where("id", "cGVvcGxlOjE=")
        .Select("name")
        .Select(new Query("filmConnection")
            .Select(new Query("films")
                .Select("title")))
    );

var request = new GraphQLRequest
{
    Query = query
};
var graphQLResponse = await graphQLClient.SendQueryAsync<ResponseType>(request);

var personName = graphQLResponse.Data.Person.Name;