FluentGraphQL 1.0.2

FluentGraphQL

FluentGraphQL is a lightweight, fluent C# library for dynamically building GraphQL queries. It allows developers to construct queries using a clean, chainable syntax—perfect for strongly typed scenarios or custom query generation needs.

✨ Features

• ✅ Fluent API to build queries and mutations
• ✅ Nested field selection with arguments and aliases
• ✅ Inline fragments and directives support (coming soon)
• ✅ Easy integration in .NET applications
• ✅ Lightweight and dependency-free (except System.Text.Json)
• ✅ Built-in performance benchmarks — see results

🤝 Comparison

There is already a great alternative available: graphql-query-builder-dotnet by Charles Devandiere. This project is not meant to discredit or replace it.

FluentGraphQL simply explores a different architectural approach, with a focus on fluent chaining, dynamic nested field construction, and performance fine-tuning. It was born independently and out of curiosity and learning, not competition.

📦 Installation

You can install via NuGet (once published):

dotnet add package FluentGraphQL

🚀 Quick Start

public class Account
{
    public Guid Id { get; set; }
    public string SocietyName { get; set; }
    public Adresse Adresse { get; set; }
    public IEnumerable<Contact> Contacts { get; set; }
}

public class Contact
{
    public Guid Id { get; set; }
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string Email { get; set; }
    public string PhoneNumber { get; set; }
    public IEnumerable<Task> Tasks { get; set; }
}

public class Task
{
    public int Id { get; set; }
    public string Name { get; set; }
    public string Description { get; set; }
    public DateTime StartDate { get; set; }
    public DateTime? DueDate { get; set; }
}

var builder = new FluentGraphQL();

var name = "Paul";
var cities = new string[] { "Paris", "London", "Madrid", "New York" };

builder
    .AddVariable("firstName", GraphQLParameterType.STRING, name)
    .AddVariable("cities", GraphQLParameterType.STRING_ARRAY, cities)
    .AddQuery(new GraphQLQueryObject<Account>("accounts")
        .AddEveryFields()
        .AddCollectionField(
          account => account.Contacts,
          contact => contact
            .AddEveryFields()
            .AddCollectionField(
              c => c.Tasks,
              task => task.AddEveryFields()
            )
        )
        .WithArguments(new
        {
            where = new
            {
                and = new object[]
                {
                    new
                    {
                        city = new
                        {
                            @in = "cities"
                        }
                    },
                    new
                    {
                        contacts = new
                        {
                            firstName = new
                            {
                                eq = "firstName"
                            }
                        }
                    }
                }
            }
        }));

var result = yourapi.Query(builder.Request);

Resulting query:

query ($firstName: String!, $cities: [String]!) {
  accounts(
    where: {
      and: [
        { city: { in: $cities } }
        { contacts: { firstName: { eq: $firstName } } }
      ]
    }
  ) {
    id
    societyName
    contacts {
      id
      firstName
      lastName
      email
      phoneNumber
      tasks {
        id
        name
        description
        startDate
        endDate
      }
    }
  }
}

🧪 Testing

Tests are written with xUnit and cover query generation scenarios. To run:

dotnet test

📄 License

MIT — see the LICENSE file for details.

🙌 Contribution

Feel free to open issues or submit pull requests to improve the library!

FluentGraphQL is maintained by @Nayruuu.