Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ajsharp/graphql-rails-generators

Graphql Rails Scaffold™. Automatically generate GraphQL types from your rails models.
https://github.com/ajsharp/graphql-rails-generators

graphql rails ruby-on-rails

Last synced: about 2 months ago
JSON representation

Graphql Rails Scaffold™. Automatically generate GraphQL types from your rails models.

Awesome Lists containing this project

README 

        
# graphql-rails-generators



A few generators to make it easy to integrate your Rails models with [graphql-ruby](https://github.com/rmosolgo/graphql-ruby). I created this because I was wasting too many keystrokes copying my model schema by hand to create graphql types.



This project contains generators that look at your ActiveRecord model schema and generates graphql types for you.



- `gql:model_type Post` - Generate a graphql type for a model

- `gql:input Post` - Generate a graphql input type for a model

- `gql:mutation Update Post` - Generate a graphql mutation class for a model

- `gql:search_object` - A search object based on [SearchObjectGraphQL](https://github.com/RStankov/SearchObjectGraphQL)



## Installation



```

gem 'graphql-rails-generators', group: :development

```



## Requirements



This library only supports ActiveRecord, though it would be fairly trivial to add support for other ORMs.



## Usage



### gql:model_type



Generate a model type from a model.



```

$ rails generate gql:model_type MODEL_CLASS

```



#### Options



- `--name` - customize the file/class name, useful if you don't want the default Type suffix.



#### Example



```ruby

# app/graphql/post_type.rb

module Types

  class PostType < Types::BaseObject

    field :id, GraphQL::Types::ID, null: true

    field :title, String, null: true

    field :body, String, null: true

    field :created_at, GraphQL::Types::ISO8601DateTime, null: true

    field :updated_at, GraphQL::Types::ISO8601DateTime, null: true

  end

end

```



### gql:input MODEL_CLASS



Generate an input type from a model.



```

rails generate gql:input Post

```



#### Options



- `--name` - customize the file/class name, useful if you don't want the default Input suffix.



#### Example



```ruby

# app/graphql/types/post_input.rb

module Types

  module Input

    class PostInput < Types::BaseInputObject

      argument :title, String, required: false

      argument :body, String, required: false

    end

  end

end

```



### gql:mutations MODEL_CLASS



Generate create, update and delete mutations for a model.



```

rails generate gql:mutations Post

```



#### Example



```ruby

# app/graphql/types/post_input.rb

module Types

  module Input

    class PostInput < Types::BaseInputObject

      argument :title, String, required: false

      argument :body, String, required: false

    end

  end

end

```



### gql:mutation MUTATION_PREFIX MODEL_NAME



Generate a mutation class from a model.



A quick note about the mutation generator...



The mutation generator generates something akin to an "upsert" mutation. It takes two arguments: an optional `id` and an optional `attributes`, which is the input type for the model. If you pass an `id`, it will attempt to find the model by the `id` and update it, otherwise it will initialize a new model and attempt to save it.



```

rails generate gql:mutation Update Post

```



#### Example



```ruby

# app/graphql/mutations/update_post.rb

module Mutations

  class UpdatePost < Mutations::BaseMutation

    field :post, Types::PostType, null: true



    argument :attributes, Types::Input::PostInput, required: true

    argument :id, GraphQL::Types::ID, required: false



    def resolve(attributes:, id: nil)

      model = find_or_build_model(id)

      model.attributes = attributes.to_h

      if model.save

        {post: model}

      else

        {errors: model.errors.full_messages}

      end

    end



    def find_or_build_model(id)

      if id

        Post.find(id)

      else

        Post.new

      end

    end

  end

end

```



### gql:search_object MODEL_NAME



Generate a search object from a model using [SearchObjectGraphQL](https://github.com/RStankov/SearchObjectGraphQL)



If you have not yet created a base search resolver:



`rails g gql:model_search_base`



\*_Adds `gem 'search_object_graphql'` to gemfile_



#### Example



```ruby

# app/graphql/resolvers/base_search_resolver.rb

module Resolvers

  class BaseSearchResolver < GraphQL::Schema::Resolver

    require 'search_object'

    require 'search_object/plugin/graphql'

    include SearchObject.module(:graphql)

  end

end

```



Then generate a search object for your model:



`rails g gql:model_search Post`



#### Example



```ruby

# app/graphql/resolvers/post_search.rb

module Resolvers

  class PostSearch < Resolvers::BaseSearchResolver

    type [Types::PostType], null: false

    description "Lists posts"



    scope { Post.all }



    option(:id, type: Int)   { |scope, value| scope.where id: value }

    option(:title, type: String)   { |scope, value| scope.where title: value }

    option(:body, type: Int)   { |scope, value| scope.where rating: value }

    option(:created_at, type: GraphQL::Types::ISO8601DateTime)   { |scope, value| scope.where created_at: value }

    option(:updated_at, type: GraphQL::Types::ISO8601DateTime)   { |scope, value| scope.where updated_at: value }



    def resolve

      []

    end



  end

end

```



This will also insert a search field into the beginning of query_type.rb



```ruby

  #app/graphql/types/query_type.rb

  module Types

  class QueryType < Types::BaseObject

    field :posts, resolver: Resolvers::PostSearch

    ...

```