graphql-sources 1.4.0 → 1.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b83f8f866fbc38f5645d8887f0de9952e56126bdd0a48b0e2d5bca5099b4b110
-  data.tar.gz: bba362e0571ae8a9abdb344a6d17cb4894fac92a5d8f67ac7f556e0a336d6459
+  metadata.gz: 91917cfffbb3f024443e890da6294499029638a4673e9ef96d1b061117356016
+  data.tar.gz: 5f27027876a07800b499a9cd22832707e0b2fdb74778896d3b8b53693ce3df17
 SHA512:
-  metadata.gz: 696372d3f88a6db7d223c26ec3a27c77138a4473d03dc4285c8904f79271d2f044762133af5e7fa88c475c4ae2b035a66a4fa4caab699004b7dd2103ae9ce63a
-  data.tar.gz: 9f7014bd5a85a5c6f89e55da33f989f4939caf00411876d024f93cafa5b115e412668aa3cd8bb80a6cc168d4c9ababdc4484c340e1b772f8ed2a721ba2492c5a
+  metadata.gz: 61889bbe42856b8d18e11bf3cd0dbb3f8eeea81e979f97b79f5f8334083636514637746db0d064caa2e4db45eaefbfe3af842361f0f03c436f59f3f70a40bdc0
+  data.tar.gz: 932074f604d8490897ef8868e0f8562e04c715a3c0e89f670682f245644b25513743146c8e22d2ca35fbe969f79035485269a12c31914fbe69c6f19419beb39d

data/Gemfile

@@ -7,3 +7,4 @@ gemspec
 gem 'rake'
 gem 'rspec'
 gem 'rubocop'
+gem 'yard'

data/README.md

@@ -21,6 +21,50 @@ end
 
 ## Usage
 
+### Loading `has_and_belongs_to_many` Associations
+
+```ruby
+class Student
+  has_and_belongs_to_many :courses
+end
+```
+
+```ruby
+class Course
+  has_and_belongs_to_many :students
+end
+```
+
+```ruby
+class StudentType < GraphQL::Schema::Object
+  field :courses, [CourseType], null: false
+
+  # @return [Array<Course>]
+  def courses
+    # SELECT "courses_students".* FROM "courses_students" WHERE "courses_students"."student_id" = IN (...)
+    # SELECT "courses".* FROM "courses" WHERE "courses"."id" IN (...)
+    dataloader
+      .with(GraphQL::Sources::ActiveRecordAssociation, :courses)
+      .load(object)
+  end
+end
+```
+
+```ruby
+class CourseType < GraphQL::Schema::Object
+  field :students, [StudentType], null: false
+
+  # @return [Array<Student>]
+  def students
+    # SELECT "courses_students".\* FROM "courses_students" WHERE "courses_students"."course_id" = IN (...)
+    # SELECT "students".\* FROM "students" WHERE "students"."id" IN (...)
+    dataloader
+      .with(GraphQL::Sources::ActiveRecordAssociation, :students)
+      .load(object)
+  end
+end
+```
+
 ### Loading `belongs_to` Associations
 
 ```ruby

data/lib/graphql/sources/active_record_association.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+module GraphQL
+  module Sources
+    # A class for loading an ActiveRecord association.
+    #
+    # @example `has_and_belongs_to_many`
+    #
+    #   class Student
+    #     has_and_belongs_to_many :courses
+    #   end
+    #
+    #   class Course
+    #     has_and_belongs_to_many :students
+    #   end
+    #
+    #   class StudentType < GraphQL::Schema::Object
+    #     field :courses, [CourseType], null: false
+    #
+    #     # @return [Array<Course>]
+    #     def courses
+    #       # SELECT "courses_students".* FROM "courses_students" WHERE "courses_students"."student_id" = IN (...)
+    #       # SELECT "courses".* FROM "courses" WHERE "courses"."id" IN (...)
+    #       dataloader
+    #         .with(GraphQL::Sources::ActiveRecordAssociation, :courses)
+    #         .load(object)
+    #     end
+    #   end
+    #
+    #   class CourseType < GraphQL::Schema::Object
+    #     field :students, [StudentType], null: false
+    #
+    #     # @return [Array<Student>]
+    #     def students
+    #       # SELECT "courses_students".* FROM "courses_students" WHERE "courses_students"."course_id" = IN (...)
+    #       # SELECT "students".* FROM "students" WHERE "students"."id" IN (...)
+    #       dataloader
+    #         .with(GraphQL::Sources::ActiveRecordAssociation, :students)
+    #         .load(object)
+    #     end
+    #   end
+    #
+    #
+    # @example `has_many` / `belongs_to`
+    #
+    #   class User
+    #     has_many :comments
+    #   end
+    #
+    #   class Comment
+    #     belongs_to :user
+    #   end
+    #
+    #   class UserType < GraphQL::Schema::Object
+    #     field :comments, [CommentType], null: false
+    #
+    #     # @return [Array<Comment>]
+    #     def comments
+    #       # SELECT "comments".* FROM "comments" WHERE "comments"."user_id" = IN (...)
+    #       dataloader
+    #         .with(GraphQL::Sources::ActiveRecordAssociation, :comments)
+    #         .load(object)
+    #     end
+    #   end
+    #
+    #   class CommentType < GraphQL::Schema::Object
+    #     field :user, UserType, null: false
+    #
+    #     # @return [User]
+    #     def user
+    #       # SELECT "users".* FROM "users" WHERE "users"."id" IN (...)
+    #       dataloader
+    #         .with(GraphQL::Sources::ActiveRecordAssociation, :user)
+    #         .load(object)
+    #     end
+    #   end
+    #
+    # @example `has_one` / `belongs_to`
+    #
+    #   class User
+    #     has_one :profile
+    #   end
+    #
+    #   class Profile
+    #     belongs_to :user
+    #   end
+    #
+    #   class UserType < GraphQL::Schema::Object
+    #     field :profile, ProfileType, null: false
+    #
+    #     # @return [Profile]
+    #     def profile
+    #       # SELECT "profiles".* FROM "profiles" WHERE "profiles"."user_id" = IN (...)
+    #       dataloader
+    #         .with(GraphQL::Sources::ActiveRecordAssociation, :profile)
+    #         .load(object)
+    #     end
+    #   end
+    #
+    #   class ProfileType < GraphQL::Schema::Object
+    #     field :user, UserType, null: false
+    #
+    #     # @return [User]
+    #     def user
+    #       # SELECT "users".* FROM "users" WHERE "users"."id" IN (...)
+    #       dataloader
+    #         .with(GraphQL::Sources::ActiveRecordAssociation, :user)
+    #         .load(object)
+    #     end
+    #   end
+    class ActiveRecordAssociation < GraphQL::Dataloader::Source
+      # @param association [Symbol] an association to use for loading (e.g. :user)
+      def initialize(association)
+        super()
+        @association = association
+      end
+
+      # @param records [Array<ActiveRecord::Base>] an array of records
+      def fetch(records)
+        preloader = ActiveRecord::Associations::Preloader.new(records: records, associations: [@association])
+        preloader.call
+
+        records.map { |record| record.association(@association).target }
+      end
+    end
+  end
+end

data/lib/graphql/sources/version.rb

@@ -2,6 +2,6 @@
 
 module GraphQL
   module Sources
-    VERSION = '1.4.0'
+    VERSION = '1.5.1'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: graphql-sources
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.1
 platform: ruby
 authors:
 - Kevin Sylvestre
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-08-02 00:00:00.000000000 Z
+date: 2024-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: graphql
@@ -217,6 +217,7 @@ files:
 - LICENSE
 - README.md
 - lib/graphql/sources.rb
+- lib/graphql/sources/active_record_association.rb
 - lib/graphql/sources/active_record_base.rb
 - lib/graphql/sources/active_record_collection.rb
 - lib/graphql/sources/active_record_count.rb
@@ -234,7 +235,7 @@ metadata:
   homepage_uri: https://github.com/ksylvest/graphql-sources
   source_code_uri: https://github.com/ksylvest/graphql-sources
   changelog_uri: https://github.com/ksylvest/graphql-sources/blob/main/CHANGELOG.md
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -249,8 +250,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 3.5.18
+signing_key: 
 specification_version: 4
 summary: A set of common GraphQL DataLoader sources.
 test_files: []