Skip to content

neomatrixcode/Diana.jl

Folders and files

NameName
Last commit message
Last commit date
Jul 19, 2021
May 2, 2021
Feb 25, 2020
May 2, 2021
Jul 7, 2020
Jul 28, 2019
Jul 19, 2021
Jul 19, 2021
Jul 28, 2019
Jul 28, 2019
Jul 28, 2019
Aug 10, 2022
Jan 22, 2022
Jul 28, 2019
Dec 23, 2020
Nov 3, 2017
Jul 20, 2021
Dec 23, 2020

Repository files navigation

Diana.jl

A Julia GraphQL client/server implementation.

DOI

Contributions welcomed!

This repository is an implementation of a GraphQL server, a query language for API created by Facebook. See more complete documentation at http://graphql.org/

Looking for help? Find resources from the community.

Getting Started

An overview of GraphQL in general is available in the README for the Specification for GraphQL.

This package is intended to help you building GraphQL schemas/types fast and easily.

  • Easy to use: Diana.jl helps you use GraphQL in Julia without effort.
  • Data agnostic: Diana.jl supports any type of data source: SQL, NoSQL, etc. The intent is to provide a complete API and make your data available through GraphQL.
  • Make queries: Diana.jl allows queries to graphql schemas.

Installation

Pkg> add Diana
#Release
pkg> add Diana#master
#Development

Examples

Client

query = """
{
  neomatrix{
    nombre
    linkedin
  }
}
"""

r = Queryclient("https://neomatrix.herokuapp.com/graphql",query)
client = GraphQLClient("https://api.graph.cool/simple/v1/movies",auth="Bearer my-jwt-token")

query2 = """
query getMovie(\$title: String!) {
  Movie(title:\$title) {
    releaseDate
    actors {
      name
    }
  }
}
"""
r = client.Query(query2,vars=Dict("title" => "Inception"))

r.Data 
# "{\"data\":{\"Movie\":{\"releaseDate\":\"2010-08-28T20:00:00.000Z\",\"actors\":[{\"name\":\"Leonardo DiCaprio\"},{\"name\":\"Ellen Page\"},{\"name\":\"Tom Hardy\"},{\"name\":\"Joseph Gordon-Levitt\"},{\"name\":\"Marion Cotillard\"}]}}}"

Server

Here is one example for you to get started:

schema = Dict(
"query" => "Query"

,"Query"=> Dict(
    "persona"=>Dict("tipo"=>"Persona")
   ,"neomatrix"=>Dict("tipo"=>"Persona")
   )

,"Persona" => Dict(
    "edad"=>Dict("tipo"=>"Int")
   ,"nombre"=>Dict("tipo"=>"String")
  )

)


 resolvers=Dict(
    "Query"=>Dict(
        "neomatrix" => (root,args,ctx,info)->(return Dict("nombre"=>"josue","edad"=>26))
        ,"persona" => (root,args,ctx,info)->(return Dict("nombre"=>"Diana","edad"=>25))
    )
    ,"Persona"=>Dict(
      "edad" => (root,args,ctx,info)->(return root["edad"])
    )
)

my_schema = Schema(schema, resolvers)

Then Querying Diana.Schema is as simple as:

query= """
{
  neomatrix{
  	nombre
  }
}
"""
result = my_schema.execute(query)
# "{\"data\":{\"neomatrix\":{\"nombre\":\"josue\"}}}"

TODO

  • Client
  • Lexer
  • Parser
  • Query validation
  • Schemas / Types
  • Query execution
    • Arguments
    • Scalar types
    • Multiple forms of resolution
    • Extract variable values
    • Complex types (List, Object, etc)
    • Fragments in queries
    • Directives
  • Mutation execution
  • Subscriptions execution
  • Introspection
  • Depth of the query
  • Middleware

Documentation

Documentation and links to additional resources are available at https://neomatrixcode.gitbook.io/diana/