graphql-sources 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f88238e75afcee4b41463d85c77e4ec70a89afffe18baf5bdaa5a780e153335f
-  data.tar.gz: eb3a39814d97bf3c06c6ea996cd50dcff262a170b5700edd4019f98c2ff80cad
+  metadata.gz: c950f4402666974cd24dd441f3b51caac7d337429518753e6886cecc9d9a46dd
+  data.tar.gz: 88194279dc3f9ea1f3a1e47349cc5620b7cf550badbe6c0720fa35fcbf20a340
 SHA512:
-  metadata.gz: 968c6e5955b5f936c040d862219b890137fed330047670ffda3c7b79ecab1531f976696729e24fb50257acacfff6141296071d84d395e27bedfe757cde5f6f5f
-  data.tar.gz: 6ec3329d4de24ca2fe71f7c339fa4e6e9d569e4ef6e940f4b1174b2707e8641a72857c4ae1cb30ad53b436a53875616d6a4d254586619d2ebf76bf8a9dc26707
+  metadata.gz: 4f63d94f097e6c72665be2086ee3736ba11c87ceb41935afcfcefb1fbb4b64d9b0fe71f93eea66bdc0ddb8f4846e637b320e6f1117631d2a6522638869fc2df2
+  data.tar.gz: 620fe9b524a7a0af4a67dbdfcc1f558f419977c25116830b3c46c42ed32f1fc86b1eba92c6a857c5ffc4d8814781cc989dca5b78519eefe6e04ef0b08f0c6b6a

data/README.md

@@ -78,6 +78,46 @@ 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::ActiveStorageHasOneAttached, :photos)
+      .load(object)
+  end
+end
+```
+
 ### Loading Counts
 
 ```ruby
@@ -111,6 +151,12 @@ WHERE "likes"."post_id" IN (1, 2, 3, ...)
 GROUP BY "likes"."post_id"
 ```
 
+## Status
+
+[![CircleCI](https://circleci.com/gh/ksylvest/graphql-sources.svg?style=svg)](https://circleci.com/gh/ksylvest/rhino)
+[![Maintainability](https://api.codeclimate.com/v1/badges/bc301cb72712637e67dd/maintainability)](https://codeclimate.com/github/ksylvest/graphql-sources/maintainability)
+[![Test Coverage](https://api.codeclimate.com/v1/badges/bc301cb72712637e67dd/test_coverage)](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).

data/lib/graphql/sources/active_storage_base.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module GraphQL
+  module Sources
+    # An abstract class for interacting with active storage.
+    class ActiveStorageBase < GraphQL::Dataloader::Source
+      # @param name [String] the association name
+      def initialize(name)
+        super()
+        @name = name
+      end
+
+      protected
+
+      # @param records [Array<ActiveRecord::Base>] a collection of records to load attachments for
+      # @return [Array<ActiveStorage::Attachment>] the associated attachments with preloaded blobs
+      def attachments(records:)
+        ActiveStorage::Attachment
+          .preload(:blob)
+          .where(record: records)
+          .where(name: @name)
+          .order(:id)
+      end
+    end
+  end
+end

data/lib/graphql/sources/active_storage_has_many_attached.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative './active_storage_base'
+
+module GraphQL
+  module Sources
+    # A class for loading `has_many_attached` style associations.
+    #
+    #   class User
+    #     has_many_attached :photos
+    #   end
+    #
+    #   class UserType < GraphQL::Schema::Object
+    #     field :photos, [AttachedType], null: false
+    #
+    #     def photos
+    #       dataloader
+    #         .with(GraphQL::Sources::ActiveStorageHasManyAttached, :photos)
+    #         .load(object)
+    #     end
+    #   end
+    #
+    # The resulting SQL query is:
+    #
+    #     SELECT "active_storage_attachments".*
+    #     FROM "active_storage_attachments"
+    #     WHERE "active_storage_attachments"."name" = 'photos'
+    #       AND "active_storage_attachments"."record_type" = 'User'
+    #       AND "active_storage_attachments"."record_id" IN (...)
+    class ActiveStorageHasManyAttached < ActiveStorageBase
+      def fetch(records)
+        attachments = attachments(records: records).load_async
+        dataloader.yield
+
+        map = attachments.group_by { |attachment| [attachment.record_type, attachment.record_id] }
+        records.map { |record| map[[record.class.name, record.id]] || [] }
+      end
+    end
+  end
+end

data/lib/graphql/sources/active_storage_has_one_attached.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative './active_storage_base'
+
+module GraphQL
+  module Sources
+    # A class for loading `has_one_attached` style associations.
+    #
+    #   class User
+    #     has_one_attached :photo
+    #   end
+    #
+    #   class UserType < GraphQL::Schema::Object
+    #     field :avatar, AttachedType, null: false
+    #
+    #     def avatar
+    #       dataloader
+    #         .with(GraphQL::Sources::ActiveStorageHasOneAttached, :avatar)
+    #         .load(object)
+    #     end
+    #   end
+    #
+    # The resulting SQL query is:
+    #
+    #     SELECT "active_storage_attachments".*
+    #     FROM "active_storage_attachments"
+    #     WHERE "active_storage_attachments"."name" = 'avatar'
+    #       AND "active_storage_attachments"."record_type" = 'User'
+    #       AND "active_storage_attachments"."record_id" IN (...)
+    class ActiveStorageHasOneAttached < ActiveStorageBase
+      def fetch(records)
+        attachments = attachments(records: records).load_async
+        dataloader.yield
+
+        map = attachments.index_by { |attachment| [attachment.record_type, attachment.record_id] }
+        records.map { |record| map[[record.class.name, record.id]] }
+      end
+    end
+  end
+end

data/lib/graphql/sources/version.rb

@@ -2,6 +2,6 @@
 
 module GraphQL
   module Sources
-    VERSION = '0.3.0'
+    VERSION = '0.4.0'
   end
 end

data/lib/graphql/sources.rb

@@ -5,6 +5,8 @@ require 'graphql'
 require_relative './sources/active_record_count'
 require_relative './sources/active_record_collection'
 require_relative './sources/active_record_object'
+require_relative './sources/active_storage_has_many_attached'
+require_relative './sources/active_storage_has_one_attached'
 
 module GraphQL
   # A collection of common GraphQL dataloader classes.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: graphql-sources
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Kevin Sylvestre
@@ -150,6 +150,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Common loaders for various database or cache operations.
 email:
 - kevin@ksylvest.com
@@ -165,6 +179,9 @@ files:
 - lib/graphql/sources/active_record_collection.rb
 - lib/graphql/sources/active_record_count.rb
 - lib/graphql/sources/active_record_object.rb
+- lib/graphql/sources/active_storage_base.rb
+- lib/graphql/sources/active_storage_has_many_attached.rb
+- lib/graphql/sources/active_storage_has_one_attached.rb
 - lib/graphql/sources/version.rb
 homepage: https://github.com/ksylvest/graphql-sources
 licenses: