Stardust

GraphQL APIs in Rails made easy

Building on top of the fantastic graphql-ruby gem, Stardust allows you to focus on business logic

- app
  - graph
    - mutations
    - queries
    - types

Usage

Stardust uses define_ hooks to automatically build out the graph by crawling through the graph directory inside your application.

Mutations and Queries are called through the resolve method. Any arguments are passed in as named arguments to the function.

Mutation

Mutations are used to define

Stardust::GraphQL.define_mutation :add_item do

 description "Add a new item"
 null false

 argument :name, :string, required: true

 field :item, :item, null: true
 field :success, :boolean, null: false

 def resolve(name:)
   {
     success: true,
     item: {
       id: 4,
       name: name
     }
   }
 end

end

Query

Stardust::GraphQL.define_query :items do

  def items
    [
      {
        id: 1,
        name: "foo"
      },
      {
        id: 2,
        name: "bar"
      },
      {
        id: 3,
        name: "baz"
      }
    ].freeze
  end

  description "Get a list of items"
  type [:item]
  null false

  def resolve
    items
  end

end

Type

Stardust::GraphQL.define_types do

  object :item do
    description "An example item"
    field :id, :id, null: false
    field :name, :string, null: false
  end

end

Installation

Add this line to your application's Gemfile:

gem 'stardust_rails', require: 'stardust'

And then execute:

$ bundle

Or install it yourself as:

$ gem install stardust_rails

Mount the engine:

# config/routes.rb
Rails.application.routes.draw do
  ...
  mount Stardust::Engine, at: "/"
  ...
end

Generate your first type, query or mutation:

$ rails g stardust:example
$ rails g stardust:type foo
$ rails g stardust:query foos
$ rails g stardust:mutation bar

View GraphiQL here: http://localhost:3000/graphiql

Contributing

Contribution directions go here.

License

The gem is available as open source under the terms of the MIT License.