Repository is archived
No release in over 3 years
Low commit activity in last 3 years
Eager load Active Record relationships in your GraphQL queries
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

>= 5.0.0
 Project Readme

Graphql::EagerLoader

Eager-load your Active Record associations automagically.

Usage

Call this method like this:

Graphql::EagerLoader::LookaheadLoader.call(Project, lookahead)

Here's a full example with 'graphql' field:

field :projects, Types::ProjectType.connection_type, null: true, extras: [:lookahead]
def projects(lookahead:)
  Graphql::EagerLoader::LookaheadLoader.call(Project, lookahead).all # or: .where(published: true)
end

This method allows you to add additional functionality while eager loading app's models. For example you can do stuff like (notice the location of .all below):

field :projects, Types::ProjectType.connection_type, null: true, extras: [:lookahead]
def projects(lookahead:)
  Graphql::EagerLoader::LookaheadLoader.call(Project, lookahead) do |eager_loaded_model, associations|
    associations.values.each do |association|
      if association.instance_of?(ActiveRecord::Reflection::HasManyReflection)
        eager_loaded_model = eager_loaded_model.merge(association.klass.where(published: true))
      end
    end
    eager_loaded_model
  end.all
end

Installation

gem 'graphql-eager_loader'

And then execute:

$ bundle install

Contributing

Contributions welcome!

Special Thanks

Thank you to @colinjfw for the great GraphQL-Api gem that inspired this.

Thank you to @rmosolgo for the incredible GraphQL gem.

License

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