graphql-remote_loader 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8f7f2b1ab4cf983200d1c98e42324a2965677466
-  data.tar.gz: 6cd70f26a9b81d8be0899e519300fbdb30a3fb53
+  metadata.gz: 373c88fb1ed204a41f90ca7d23968d4c29a62df9
+  data.tar.gz: b535426a4ac97d8ce0bd0fd0ab1a76d6a292f3bb
 SHA512:
-  metadata.gz: 1b5dbdc65a0fbcad465a567793044d4eb7cdb9b3728f44b6339ea956a00b46d97ca1cd499433e74847c78d3bde420cd7d60558990c6b97082934aea294e15886
-  data.tar.gz: 8b796e95b900b6afbab007932bd41b9841f32d7284724e709d01108be5abf785affa9a547bbb5fda81520efc2431936081ff52360e4c4d1be7a21cd8befd9ccd
+  metadata.gz: edee071404cb25b0d65f9bd7247f91f088d0b9b1a87dbb2082d14e137848b7150f47c66a5fda0ca8bab45c76eaafd33e0a7f8b0bc4cc0d2e499370db6a8e5da1
+  data.tar.gz: 2586f4f3b17e2dc6cc4f99cbd83b23575f78389bbbefac08e620a5919f642fcb2e7332036544c8b1f7c643f49c67a3d482772c00cd3c2a72d64576676fd62159

data/README.md

@@ -6,14 +6,30 @@ Performant, batched GraphQL queries from within the resolvers of a [`graphql-rub
 
 ## Snippet
 
+For default error handling(null if errors) and no post-processing:
+
 ```ruby
-  field :login, String, null: false, description: "The currently authenticated GitHub user's login."
+field :login, String, null: true, description: "The currently authenticated GitHub user's login."
+
+def login
+  GitHubLoader.load_value("viewer", "login")
+end
+```
 
-  def login
-    GitHubLoader.load("viewer { login }").then do |results|
-      results["viewer"]["login"]
+If you need error handling, post-processing, or complex queries:
+
+```ruby
+field :login, String, null: false, description: "The currently authenticated GitHub user's login."
+
+def login
+  GitHubLoader.load("viewer { login }").then do |results|
+    if results["errors"].present?
+      ""
+    else
+      results["data"]["viewer"]["login"].upcase
     end
   end
+end
 ```
 
 ## Full example

data/lib/graphql/remote_loader/loader.rb

@@ -20,6 +20,18 @@ module GraphQL
         self.for.load([query, prime])
       end
 
+      # Loads the value, then if the query was successful, fulfills promise with
+      # the leaf value instead of the full results hash.
+      #
+      # If errors are present, returns nil.
+      def self.load_value(*path)
+        load(query_from_path(path)).then do |results|
+          next nil if results["errors"] && !results["errors"].empty?
+
+          value_from_hash(results["data"])
+        end
+      end
+
       def self.reset_index
         @index = nil
       end
@@ -123,6 +135,29 @@ module GraphQL
         tr("-", "_").
         downcase
       end
+
+      def self.query_from_path(path)
+        if path.length == 1
+          path.first
+        else
+          "#{path.first} { #{query_from_path(path[1..-1])} }"
+        end
+      end
+
+      # Input is a hash where all nested hashes have only one key.
+      #
+      # Output is the leaf at the end of the hash.
+      #
+      # e.g. {foo: {bar: 5}} => 5
+      def self.value_from_hash(hash_or_value)
+        case hash_or_value
+        when Hash
+          # {foo: {bar: 5}}.first[1] => {bar: 5}
+          value_from_hash(hash_or_value.first[1])
+        else
+          hash_or_value
+        end
+      end
     end
   end
 end

data/lib/graphql/remote_loader/version.rb

@@ -1,5 +1,5 @@
 module GraphQL
   module RemoteLoader
-    VERSION = "1.0.0"
+    VERSION = "1.0.1"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: graphql-remote_loader
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Nathaniel Woodthorpe
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-06-19 00:00:00.000000000 Z
+date: 2018-07-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: graphql