QueryByShape.GraphQLClient 1.0.15

QueryByShape

QueryByShape autogenerates GraphQL queries at build-time based on the "shape" of your result type. The current / first implementation is an extension to the GraphQL.Client (.NET).

Usage

GraphQLResponse<StarWarsFilms> filmsResponse = await client.SendQueryByAsync<StarWarsFilms>(variables);
StarWarsFilms films = filmsResponse?.Data;

Goals

• Infer / generate a GraphQL Query based on the shape of a result type
• Composing objects vs gql queries
• Performance - generate queries at build time

v1 Features

• Queries
• Variables
• Arguments
• Aliasing
• Inline Fragments
• JsonIgore (System.Text.Json)
• JsonPropertyName (System.Text.Json)

Installation

dotnet add package QueryByShape.GraphQLClient

Limitations

• Requires .NET 8 or higher
• Only supports System.Text.Json / GraphQL.Client.Serializer.SystemTextJson
• Queries must be partial
• Queries must define variables / arguments ahead of time
• Dictionaries are not supprted

Example Queries

Most samples are written for the Star Wars GraphQL API

Query Options - C#

using QueryByShape;

namespace StarWars
{
    // Fields are excluded by default
    [Query(OperationName="SimpleIsh", IncludeFields=true)]
    public partial class SimpleQuery : IGeneratedQuery
    {
        public CountModel AllPeople { get; set; }
    }

    public class CountModel
    {
        public int TotalCount; 
    }
}

GraphQL Output

query SimpleIsh {
  allPeople {
    totalCount
  }
}

Variables and Arguments - C#

using QueryByShape;
using System.Collections.Generic;

namespace StarWars
{
    [Query]
    [Variable("$id", "ID!")]
    public partial class VariablesAndArgumentsQuery : IGeneratedQuery
    {
        [Argument("id", "$id")]
        public PersonModel Person { get; set; }
    }

    public class PersonModel
    {
        public string Id { get; set; }
        public string Name { get; set; }
        public HomeworldNameModel Homeworld { get; set; }
    }

    public class HomeworldNameModel
    {
        public string Name { get; set; }
    }
}

GraphQL Output </td>

query VariablesAndArgumentsQuery($id: ID!) {
  person (id: $id) {
     id
     name
     homeworld {
      name
    } 
  }
}

Aliasing - C#

using QueryByShape;
using System.Collections.Generic;

namespace StarWars
{
    [Query]
    [Variable("$newHopeId", "ID!")]
    [Variable("$empireId", "ID!")]
    public partial class AliasQuery : IGeneratedQuery
    {
        [Argument("id", "$newHopeId")]
        [AliasOf("film")]
        public FilmDirectorModel NewHope { get; set; }

        [Argument("id", "$empireId")]
        [AliasOf("film")]
        public FilmDirectorModel Empire { get; set; }
    }

    public class FilmDirectorModel
    {
        public string Director { get; set; }
    }
}

GraphQL Output

query ExampleQuery ($newHopeId: ID!, $empireId: ID!) {
  newHope: film (id: $newHopeId ) {
    director
  }
  empire: film (id: $empireId ) {
    director
  }
}

Inline Fragments - C# (not from SWAPI)

using QueryByShape;
using System.Collections.Generic;

namespace StarWars
{
    [Query]
    [Variable("$ep")]
    public partial class InlineFragmentQuery : IGeneratedQuery
    {
        [Argument("episode", "$ep")]
        public HeroModel Hero { get; set; }
    }

    public class HeroModel
    {
        [On("Droid")]
        public string PrimaryFunction { get; set; }

        [On("Human")]
        public string height { get; set; }

    }
}

GraphQL Output

query InlineFragment($ep: Episode!) {
  hero(episode: $ep) {
    name
    ... on Droid {
      primaryFunction
    }
    ... on Human {
      height
    }
  }
} 

Supported System.Text.Json Attributes - C#

using QueryByShape;
using System.Collections.Generic;
using System.Text.Json.Serialization;

namespace StarWars
{
    [Query]
    [Variable("$id", "ID!")]
    public partial class SystemTextJsonAttributesQuery : IGeneratedQuery
    {
        [Argument("id", "$id")]
        public PersonHeightModel Person { get; set; }
    }

    public class PersonHeightModel
    {
        public string Id { get; set; }
        [JsonIgnore]
        public Guid TempId { get; set; }
        [JsonPropertyName("name")]
        public string PersonName { get; set; }
        public int Height  { get; set; }
    }
}

GraphQL Output </td>

query SystemTextJsonAttributes($id: ID!) {
  person (id: $id) {
     id
     name 
     height
  }
}