GraphQL+

Defining a successor to GraphQL

Dotnet Parser, Merging Verifier and Modeller

GraphQL+ is a .NET implementation of a parser, merging verifier, and modeller for GraphQL+ schemas and queries.

Tech stack

• C# with modern language features enabled
• Source projects target .NET Standard 2.0
• Test projects target .NET 10.0 and 9.0
• Nullable reference types are enabled
• File-scoped namespaces are preferred

Test stack

• xUnit v3
• AutoFixture with AutoData
• NSubstitute
• Shouldly
• Verify

Build and validation

dotnet restore
dotnet build
./test.ps1
./test.ps1 -ClassTests
./test.ps1 -Framework "10.0"
./format.ps1
./coverage.ps1

format.ps1 runs Dprint for files, then dotnet format whitespace, dotnet format style, and dotnet format analyzers.

Dotnet Packages

• AutoFixture nuget
• Fluid nuget
• PolySharp nuget
• Shouldly nuget
• Verify nuget
  • Verify.SourceGenerators nuget
• XUnit v3 nuget
  • XUnit SkippableFact nuget
• YamlDotNet nuget

Dotnet local tools

• Coverage nuget
• Report Generator nuget

Dotnet Global tools

Various scripts presume these dotnet tools are installed globally:

• Live Reload Server nuget

Development

For repository-wide coding style, see Style-Guide.md.

For development conventions including testing standards, see Conventions.md.

For agent workflow guidance, see AGENTS.md.

Other references

• Liquid

• Pico Css jsDelivr

• Mermaid jsDelivr

• Source Generators

  • Creating a Source Generator
  • Incremental Roslyn Source Generators
  • Source Generators in 2024

  Link checker (local files)

  A small PowerShell script is provided to verify that all local links reachable from test/Html/index.html exist on disk.

  Usage (from repo root):

  powershell -NoProfile -ExecutionPolicy Bypass -File .\check-links.ps1 \
    -Entry test/Html/index.html -Root test/Html -Verbose

  The script:

  • follows only local links (ignores http(s):, mailto:, tel:, data: and protocol-relative // links)
  • recurses only into HTML files under test/Html
  • ignores fragment-only links (e.g. #anchor) and does not validate in-page anchors
  • returns exit code 1 when broken links are found (suitable for CI)

  Example GitHub Actions job snippet:

  - name: Check out repository
    uses: actions/checkout@v4
  
  - name: Check local HTML links
    run: pwsh -NoProfile -NonInteractive -ExecutionPolicy Bypass -File ./check-links.ps1 -Entry test/Html/index.html -Root test/Html