Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ksylvest/graphql-sources
A collection of common GraphQL sources for working with Ruby on Rails.
https://github.com/ksylvest/graphql-sources
graphql rails ruby
Last synced: about 2 months ago
JSON representation
A collection of common GraphQL sources for working with Ruby on Rails.
- Host: GitHub
- URL: https://github.com/ksylvest/graphql-sources
- Owner: ksylvest
- License: mit
- Created: 2022-07-04T20:21:22.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-02T16:39:04.000Z (about 2 months ago)
- Last Synced: 2024-08-03T04:24:31.769Z (about 2 months ago)
- Topics: graphql, rails, ruby
- Language: Ruby
- Homepage:
- Size: 62.5 KB
- Stars: 22
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# GraphQL::Sources
## Installation
Install the gem and add to the application's Gemfile by executing:
$ bundle add graphql-sources
If bundler is not being used to manage dependencies, install the gem by executing:
$ gem install graphql-sources
The `GraphQL::Dataloader` plugin must be installed in the schema:
```ruby
class AppSchema < GraphQL::Schema
use GraphQL::Dataloader
# ...
end
```
## Usage
### Loading `belongs_to` Associations
```ruby
class Purchase < ActiveRecord::Base
belongs_to :visitor
end
```
```ruby
class Customer < ActiveRecord::Base
has_many :purchases
end
```
```ruby
class PurchaseType < GraphQL::Schema::Object
field :customer, [CustomerType], null: false
def customer
dataloader
.with(GraphQL::Sources::ActiveRecordObject, ::Profile, key: :id)
.load(object.customer_id)
end
end
```
### Loading `has_one` Associations
```ruby
class Profile < ActiveRecord::Base
belongs_to :user
end
```
```ruby
class User < ActiveRecord::Base
has_one :profile
end
```
```ruby
class UserType < GraphQL::Schema::Object
field :profile, [ProfileType], null: false
def profile
dataloader
.with(GraphQL::Sources::ActiveRecordObject, ::Profile, key: :user_id)
.load(object.id)
end
end
```
```sql
SELECT "profiles".*
FROM "profiles"
WHERE "profiles"."user_id" IN (...)
ORDER BY "profiles"."id"
```
### Loading `has_many` Associations
```ruby
class User
has_many :comments
end
```
```ruby
class Comment
belongs_to :user
end
```
```ruby
class UserType < GraphQL::Schema::Object
field :comments, [CommentType], null: false
def comments
dataloader
.with(GraphQL::Sources::ActiveRecordCollection, ::Comment, key: :user_id)
.load(object.id)
end
end
```
```sql
SELECT "comments".*
FROM "comments"
WHERE "comments"."user_id" IN (...)
ORDER BY "comments"."id"
```
### Loading `has_one_attached` Associations
```ruby
class User
has_one_attached :avatar
end
```
```ruby
class UserType < GraphQL::Schema::Object
field :avatar, AttachedType, null: false
def avatar
dataloader
.with(GraphQL::Sources::ActiveStorageHasOneAttached, :avatar)
.load(object)
end
end
```
### Loading `has_many_attached` Associations
```ruby
class User
has_many_attached :photos
end
```
```ruby
class UserType < GraphQL::Schema::Object
field :photos, [AttachedType], null: false
def photos
dataloader
.with(GraphQL::Sources::ActiveStorageHasManyAttached, :photos)
.load(object)
end
end
```
### Loading Counts
```ruby
class Like
belongs_to :post
end
```
```ruby
class Post
has_many :likes
end
```
```ruby
class PostType < GraphQL::Schema::Object
field :likes, Integer, null: false
def likes
dataloader
.with(GraphQL::Sources::ActiveRecordCount, ::Like, key: :post_id)
.load(object.id)
end
end
```
```sql
SELECT "likes"."post_id", COUNT(*)
FROM "likes"
WHERE "likes"."post_id" IN (1, 2, 3, ...)
GROUP BY "likes"."post_id"
```
### Loading Exists
```ruby
class User
has_many :purchases
end
```
```ruby
class Purchase
belongs_to :product
belongs_to :user
end
```
```ruby
class Product
has_many :purchases
end
```
```ruby
class ProductType
field :purchased, Boolean, null: false
def purchased
dataloader
.with(GraphQL::Sources::ActiveRecordExists, ::Purchase.where(user: context.user), key: :product_id)
.load(object.id)
end
end
```
### Loading with `Rails.cache`
```ruby
class UserType < GraphQL::Schema::Object
field :location, String, null: false
def location
dataloader
.with(GraphQL::Sources::RailsCache)
.load(key: "geocode:#{object.latest_ip}", fallback: -> { Geocode.for(object.latest_ip) })
end
end
```
## Status
[](https://circleci.com/gh/ksylvest/graphql-sources)
[](https://codeclimate.com/github/ksylvest/graphql-sources/maintainability)
[](https://codeclimate.com/github/ksylvest/graphql-sources/test_coverage)
## License
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).