/graphqld

A vibe.d library to handle the GraphQL Protocol written in the D Programming Language

Primary LanguageDGNU Lesser General Public License v3.0LGPL-3.0

GraphqlD: A graphql implementation for the D Programming language

CI

Graphql is a query language for apis. Given a query like for the schema in folder test.

{
  shipsselection(ids:[44,45]) {
    id
    commander {
      name
    }
  }
}

You get back json that looks like:

{
  "error": [],
  "data": {
    "shipsselection": [
      {
        "id": 44,
        "commander": {
          "name": "Kathryn Janeway"
        }
      },
      {
        "id": 45,
        "commander": {
          "name": "Jonathan Archer"
        }
      }
    ]
  }
}

Graphiql type-ahead works, this makes schema introspection a lot nicer.

Features

This graphql implementation is based on June 2018 spec.

Operation Execution

  • Scalars
  • Objects
  • Lists of objects/interfaces
  • Interfaces
  • Unions
  • Arguments
  • Variables
  • Fragments
  • Directives
    • Include
    • Skip
    • [?] Custom (Requires changing the graphqld source)
  • Enumerations
  • Input Objects
  • Mutations
  • Subscriptions (This needs vibe.d websocket integration)
  • Async execution (when used with vibe.d blocking resolver are async by default)

Validation

  • Arguments of correct type
  • Default values of correct type
  • Fields on correct type
  • Fragments on composite types
  • Known argument names
  • Executable Definition
  • Known directives
  • Known fragment names
  • Known type names
  • Lone anonymous operations
  • No fragment cycles
  • No undefined variables
  • No unused fragments
  • No unused variables
  • Overlapping fields can be merged (this is done during execution)
  • Possible fragment spreads
  • Provide non-null arguments
  • Scalar leafs
  • Unique argument names
  • Unique directives per location
  • Unique fragment names
  • Unique input field names
  • Unique operation names
  • Unique variable names
  • Variables are input types (this is actually a strange requirement)
  • Variables in allowed position
  • Single root field

Schema Introspection

  • __typename
  • __type
    • name
    • kind
    • description
    • fields
    • interfaces
    • possibleTypes
    • enumValues
    • inputFields
    • ofType
  • __schema
    • types
    • queryType
    • mutationType
    • subscriptionType
    • directives

Comfort Features

  • Query AST cache
  • Json to resolver argument extractor
  • SQL query generation from AST
  • Custom Leaf types (e.g. GQLDCustomLeaf!(std.datetime.DateTime))

Thank you to graphql-dot for the excelent list of features

Documentation

The Documentation is still WIP, please have a look at the vibe.d project in the test folder. This file gives a good overview on how to use graphqld with vibe.d.

Contributing

PRs are always welcome!

About Kaleidic Associates

We are a boutique consultancy that advises a small number of hedge fund clients. We are not accepting new clients currently, but if you are interested in working either remotely or locally in London or Hong Kong, and if you are a talented hacker with a moral compass who aspires to excellence then feel free to drop me a line: laeeth at kaleidic.io

We work with our partner Symmetry Investments, and some background on the firm can be found here:

http://symmetryinvestments.com/about-us/