ZeroQL |

Features

How to setup

# create console appdotnet new console -o QLClient# go to project foldercd QLClient# create manifest file to track nuget toolsdotnet new tool-manifest# add ZeroQL.CLI nuget tooldotnet tool install ZeroQL.CLI# or 'dotnet tool restore' once you pulled the existing repository# add ZeroQL nuget packagedotnet add package ZeroQL# fetch graphql schema from server(creates schema.graphql file)dotnet zeroql schema pull --url http://localhost:10000/graphql# to create ZeroQL config file: ./config.zeroql.jsondotnet zeroql config init# build the project to initiate the ZeroQL client generation with options specified inside config.zeroql.jsondotnet build

Config

{"$schema":"https://raw.githubusercontent.com/byme8/ZeroQL/main/schema.verified.json","graphql":"./schema.graphql","namespace":"ZeroQL.Client","clientName":"ZeroQLClient"}

<ItemGroup>    <ZeroQLConfigInclude="you.custom.config.name.json"/></ItemGroup>

<PropertyGroup>   <ZeroQLOnBuildTriggerEnabled>False</ZeroQLOnBuildTriggerEnabled></PropertyGroup>

How to use

schema {query:Queriesmutation:Mutation}typeQueries {me:User!user(id:Int!):User}typeMutation {addUser(firstName:String!,lastName:String!):User!addUserProfileImage(userId:Int!file:Upload!):Int!}typeUser {id:Int!firstName:String!lastName:String!role:Role!}typeRole {id:Int!name:String!}

query {me {idfirstNamelastName } }

GraphQL lambda syntax

varhttpClient=newHttpClient();httpClient.BaseAddress=newUri("http://localhost:10000/graphql");varclient=newTestServerGraphQLClient(httpClient);varresponse=awaitclient.Query(o=>o.Me(o=>new{o.Id,o.FirstName,o.LastName}));Console.WriteLine($"GraphQL:{response.Query}");// GraphQL: query { me { id firstName lastName } }Console.WriteLine($"{response.Data.Id}:{response.Data.FirstName}{response.Data.LastName}");// 1: Jon Smith

varuserId=1;varresponse=awaitclient.Query(o=>o.User(userId, o=>newUser(o.Id,o.FirstName,o.LastName)));Console.WriteLine($"GraphQL:{response.Query}");// GraphQL: query ($id: Int!) { user(id: $id) { id firstName lastName } }Console.WriteLine($"{response.Data.Id}:{response.Data.FirstName}{response.Data.LastName}");// 1: Jon Smith

publicTask<User>GetUser(intuserId){varresponse=awaitclient.Query(o=>o.User(userId, o=>newUser(o.Id,o.FirstName,o.LastName)));returnresponse.Data;}

publicintUserId{get;set;}publicTask<User>GetUser(){varresponse=awaitclient.Query(o=>o.User(UserId, o=>newUser(o.Id,o.FirstName,o.LastName)));// ZeroQL will report a compilation error herereturnresponse.Data;}

varvariables=new{Id=1};varresponse=awaitclient.Query(variables,static(i,o)=>o.User(i.Id, o=>newUser(o.Id,o.FirstName,o.LastName)));

varvariables=new{Id=1};varresponse=awaitclient.Query(variables,static(i,o)=>o.User(i.Id,            o=>new{o.Id,o.FirstName,o.LastName,Role=o.Role(role=>role.Name)}));Console.WriteLine($"GraphQL:{response.Query}");// GraphQL: query GetUserWithRole($id: Int!) { user(id: $id) { id firstName lastName role { name }  } }Console.WriteLine($"{response.Data.Id}:{response.Data.FirstName}{response.Data.LastName}, Role:{response.Data.Role}");// 1: Jon Smith, Role: Admin

GraphQL request syntax

// define a requestpublicrecordGetUserQuery(intId):GraphQL<Queries,UserModel?>{publicoverrideUserModel?Execute(Queriesquery)=>query.User(Id, o=>newUserModel(o.Id,o.FirstName,o.LastName));}// execute a requestvarresponse=awaitclient.Execute(newGetUserQuery(variables.FriendId));Console.WriteLine(response.Query);// query GetUserQuery($id: Int!) { user(id: $id) { id firstName lastName } }Console.WriteLine(response.Data);// UserModel { Id = 2, FirstName = Ben, LastName = Smith }

Benchmarks

[Benchmark]publicasyncTask<string>Raw(){varrawQuery=$$"""        {            "variables": { "id":{{id}} },            "query": "query GetUser($id: Int!){ user(id: $id) { id firstName lastName } }"        }""";varresponse=awaithttpClient.PostAsync("",newStringContent(rawQuery,Encoding.UTF8,"application/json"));varresponseJson=awaitresponse.Content.ReadAsStreamAsync();varqlResponse=JsonSerializer.Deserialize<JsonObject>(responseJson,options);returnqlResponse!["data"]!["user"]!["firstName"]!.GetValue<string>();}[Benchmark]publicasyncTask<string>StrawberryShake(){// query GetUser($id: Int!) {//   user(id: $id) {//       id//       firstName//       lastName//   }// }varfirstname=awaitstrawberryShake.GetUser.ExecuteAsync(id);returnfirstname.Data!.User!.FirstName;}[Benchmark]publicasyncTask<string>ZeroQLLambdaWithoutClosure(){varvariables=new{Id=id};varfirstname=awaitzeroQLClient.Query(variables,static(i,q)=>q.User(i.Id, o=>new{o.Id,o.FirstName,o.LastName}));returnfirstname.Data!.FirstName;}[Benchmark]publicasyncTask<string>ZeroQLLambdaWithClosure(){varid=this.id;varfirstname=awaitzeroQLClient.Query( q=>q.User(id, o=>new{o.Id,o.FirstName,o.LastName}));returnfirstname.Data!.FirstName;}[Benchmark]publicasyncTask<string>ZeroQLRequest(){varfirstname=awaitzeroQLClient.Execute(newGetUserQuery(id));returnfirstname.Data!.FirstName;}// ..publicrecordGetUserQuery(intid):GraphQL<Query,User?>{publicoverrideUser?Execute(Queryquery)=>query.User(id, o=>newUser(o.Id,o.FirstName,o.LastName));}

BenchmarkDotNet v0.15.8, macOS Tahoe 26.1 (25B78) [Darwin 25.1.0]Apple M3 Max, 1 CPU, 14 logical and 14 physical cores.NET SDK 10.0.100  [Host]     : .NET 10.0.0 (10.0.0, 10.0.25.52411), Arm64 RyuJIT armv8.0-a  DefaultJob : .NET 10.0.0 (10.0.0, 10.0.25.52411), Arm64 RyuJIT armv8.0-a

Credits