apollo-federation 1.1.5 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c257933d713beb9810af1a42d58a20ad693fa9c37b826bd8e78c45ede30eede6
-  data.tar.gz: 38226cd1a90d90cb92275768f5f012ee7e018fd80e5fd1fe78f02431aa235a1c
+  metadata.gz: 9ec8b363ade4047069cbbf7774e3fc88b93c4e9b61ae8ca0e5baf60e6ca0f488
+  data.tar.gz: 73866b38229feea6644ed23ce2ac9adad4cf9c2fb760f4426e519ec317afc256
 SHA512:
-  metadata.gz: b733f8f8f9cdcfc36484e0132d5cb515fa47b208e9ab54a60086b7a1f7b37a3cc4477dcee8e36092de99e5be2169e04be232f33142eb1bc7a8830f13e7c4fb66
-  data.tar.gz: 98da906cc451cc60d91acc35226e24dbcc97d2259af4267552c01ace5a2c4b4452edb979496b1ea94c5131d9ba11bbe76d17bea41ff00fbae5281d24318acf08
+  metadata.gz: 03d6d4e2dcc6243ca7e05c40225b0b3c8516d777ef2c9ba37516ab0fde3dd8a0c61e7872526be323a47e7c1ce908fe490547bb66ad300985e04dbd047879fa5e
+  data.tar.gz: 924c9aae3668493d09559173a7d073aaf751fffad84df0958a6de9e4e4bfcebd984e4ba77cb5e06d8a1add6760271c075574f46c91e5f7c38f68bdb274f4e1be

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+# [2.0.0](https://github.com/Gusto/apollo-federation-ruby/compare/v1.1.5...v2.0.0) (2022-01-27)
+
+
+* Remove beta disclaimer (#165) ([29da3de](https://github.com/Gusto/apollo-federation-ruby/commit/29da3deb0163c38d5d08f084e5e8dc67d8454358)), closes [#165](https://github.com/Gusto/apollo-federation-ruby/issues/165)
+
+
+### BREAKING CHANGES
+
+* GraphQL 1.9.x support removed
+
 ## [1.1.5](https://github.com/Gusto/apollo-federation-ruby/compare/v1.1.4...v1.1.5) (2020-10-29)
 
 

data/README.md

@@ -1,13 +1,9 @@
 # apollo-federation
 
-[![CircleCI](https://circleci.com/gh/Gusto/apollo-federation-ruby/tree/master.svg?style=svg)](https://circleci.com/gh/Gusto/apollo-federation-ruby/tree/master)
+[![CircleCI](https://circleci.com/gh/Gusto/apollo-federation-ruby/tree/main.svg?style=svg)](https://circleci.com/gh/Gusto/apollo-federation-ruby/tree/main)
 
 This gem extends the [GraphQL Ruby](http://graphql-ruby.org/) gem to add support for creating an [Apollo Federation](https://www.apollographql.com/docs/apollo-server/federation/introduction/) schema.
 
-## DISCLAIMER
-
-This gem is still in a beta stage and may have some bugs or incompatibilities. See the [Known Issues and Limitations](#known-issues-and-limitations) below. If you run into any problems, please [file an issue](https://github.com/Gusto/apollo-federation-ruby/issues).
-
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -85,12 +81,12 @@ Start the gateway:
 
 This will start up the gateway and serve it at http://localhost:5000.
 
-
 ## Usage
 
 The API is designed to mimic the API of [Apollo's federation library](https://www.apollographql.com/docs/apollo-server/federation/introduction/). It's best to read and understand the way federation works, in general, before attempting to use this library.
 
 ### Extending a type
+
 [Apollo documentation](https://www.apollographql.com/docs/apollo-server/federation/core-concepts/#extending-external-types)
 
 Call `extend_type` within your class definition:
@@ -102,6 +98,7 @@ end
 ```
 
 ### The `@key` directive
+
 [Apollo documentation](https://www.apollographql.com/docs/apollo-server/federation/core-concepts/#entities-and-keys)
 
 Call `key` within your class definition:
@@ -113,6 +110,7 @@ end
 ```
 
 ### The `@external` directive
+
 [Apollo documentation](https://www.apollographql.com/docs/apollo-server/federation/core-concepts/#referencing-external-types)
 
 Pass the `external: true` option to your field definition:
@@ -124,6 +122,7 @@ end
 ```
 
 ### The `@requires` directive
+
 [Apollo documentation](https://www.apollographql.com/docs/apollo-server/federation/advanced-features/#computed-fields)
 
 Pass the `requires:` option to your field definition:
@@ -137,6 +136,7 @@ end
 ```
 
 ### The `@provides` directive
+
 [Apollo documentation](https://www.apollographql.com/docs/apollo-server/federation/advanced-features/#using-denormalized-data)
 
 Pass the `provides:` option to your field definition:
@@ -148,6 +148,7 @@ end
 ```
 
 ### Reference resolvers
+
 [Apollo documentation](https://www.apollographql.com/docs/apollo-server/api/apollo-federation/#__resolvereference)
 
 Define a `resolve_reference` class method on your object. The method will be passed the reference from another service and the context for the query.
@@ -166,20 +167,108 @@ To support [federated tracing](https://www.apollographql.com/docs/apollo-server/
 
 1. Add `use ApolloFederation::Tracing` to your schema class.
 2. Change your controller to add `tracing_enabled: true` to the execution context based on the presence of the "include trace" header:
-    ```ruby
-    def execute
-      # ...
-      context = {
-        tracing_enabled: ApolloFederation::Tracing.should_add_traces(headers)
-      }
-      # ...
+   ```ruby
+   def execute
+     # ...
+     context = {
+       tracing_enabled: ApolloFederation::Tracing.should_add_traces(headers)
+     }
+     # ...
+   end
+   ```
+
+## Exporting the Federated SDL
+
+When using tools like [rover](https://www.apollographql.com/docs/rover/) for schema validation, etc., add a Rake task that prints the Federated SDL to a file:
+
+```rb
+namespace :graphql do
+  namespace :federation do
+    task :dump do
+      File.write("schema.graphql", MySchema.federation_sdl)
     end
-    ```
+  end
+end
+```
+
+Example validation check with Rover and Apollo Studio:
+
+```sh
+bin/rake graphql:federation:dump
+rover subgraph check mygraph@current --name mysubgraph --schema schema.graphql
+```
+
+## Testing the federated schema
+
+This library does not include any testing helpers currently. A federated service receives subgraph queries from the Apollo Gateway via the `_entities` field and that can be tested in a request spec.
+
+With Apollo Gateway setup to hit your service locally or by using existing query logs, you can retrieve the generated `_entities` queries.
+
+For example, if you have a blog service that exposes posts by a given author, the query received by the service might look like this.
+
+```graphql
+query($representations: [_Any!]!) {
+  _entities(representations: $representations) {
+    ... on BlogPost {
+      id
+      title
+      body
+    }
+  }
+}
+```
+
+Where `$representations` is an array of entity references from the gateway.
+
+```JSON
+{
+  "representations": [
+    {
+      "__typename": "BlogPost",
+      "id": 1
+    },
+    {
+      "__typename": "BlogPost",
+      "id": 2
+    }
+  ]
+}
+```
+
+Using RSpec as an example, a request spec for this query.
+
+```ruby
+it "resolves the blog post entities" do
+  blog_post = BlogPost.create!(attributes)
+
+  query = <<~GRAPHQL
+    query($representations: [_Any!]!) {
+      _entities(representations: $representations) {
+        ... on BlogPost {
+          id
+          title
+          body
+        }
+      }
+    }
+  GRAPHQL
+
+  variables = { representations: [{ __typename: "BlogPost", id: blog_post.id }] }
+
+  result = Schema.execute(query, variables: variables)
+
+  expect(result.dig("data", "_entities", 0, "id")).to eq(blog_post.id)
+end
+```
+
+See discussion at [#74](https://github.com/Gusto/apollo-federation-ruby/issues/74) and an [internal spec that resolves \_entities](https://github.com/Gusto/apollo-federation-ruby/blob/1d3baf4f8efcd02e7bf5bc7e3fee5b4fb963cd25/spec/apollo-federation/entities_field_spec.rb#L164) for more details.
 
 ## Known Issues and Limitations
- - Only works with class-based schemas, the legacy `.define` API will not be supported
- - Does not add directives to the output of `Schema.to_definition`. Since `graphql-ruby` doesn't natively support schema directives, the directives will only be visible to the [Apollo Gateway](https://www.apollographql.com/docs/apollo-server/api/apollo-gateway/) through the `Query._service` field (see the [Apollo Federation specification](https://www.apollographql.com/docs/apollo-server/federation/federation-spec/))
+
+- Only works with class-based schemas, the legacy `.define` API will not be supported
+- Does not add directives to the output of `Schema.to_definition`. Since `graphql-ruby` doesn't natively support schema directives, the directives will only be visible to the [Apollo Gateway](https://www.apollographql.com/docs/apollo-server/api/apollo-gateway/) through the `Query._service` field (see the [Apollo Federation specification](https://www.apollographql.com/docs/apollo-server/federation/federation-spec/)) or via [`Schema#federation_sdl`](https://github.com/Gusto/apollo-federation-ruby/blob/1d3baf4f8efcd02e7bf5bc7e3fee5b4fb963cd25/lib/apollo-federation/schema.rb#L19) as explained above.
 
 ## Maintainers
- * [Rylan Collins](https://github.com/rylanc)
- * [Noa Elad](https://github.com/noaelad)
+
+- [Rylan Collins](https://github.com/rylanc)
+- [Noa Elad](https://github.com/noaelad)

data/lib/apollo-federation/schema.rb

@@ -8,11 +8,7 @@ require 'apollo-federation/federated_document_from_schema_definition.rb'
 module ApolloFederation
   module Schema
     def self.included(klass)
-      if Gem::Version.new(GraphQL::VERSION) >= Gem::Version.new('1.10.0')
-        klass.extend(OneTenMethods)
-      else
-        klass.extend(OneNineMethods)
-      end
+      klass.extend(CommonMethods)
     end
 
     module CommonMethods
@@ -21,53 +17,6 @@ module ApolloFederation
         GraphQL::Language::Printer.new.print(document_from_schema.document)
       end
 
-      private
-
-      def federation_query(query_obj)
-        # Build the new query object with the '_service' field
-        if query_obj.nil?
-          base = GraphQL::Schema::Object
-        elsif Gem::Version.new(GraphQL::VERSION) >= Gem::Version.new('1.10.0')
-          base = query_obj
-        else
-          base = query_obj.metadata[:type_class]
-        end
-
-        klass = Class.new(base) do
-          # TODO: Maybe the name should inherit from the original Query name
-          # Or MAYBE we should just modify the original class?
-          graphql_name 'Query'
-
-          include EntitiesField
-          include ServiceField
-        end
-
-        klass.define_service_field
-        klass
-      end
-    end
-
-    # TODO: Remove these once we drop support for graphql 1.9
-    module OneNineMethods
-      include CommonMethods
-
-      def to_graphql
-        orig_defn = super
-        @query_object = federation_query(query)
-
-        possible_entities = orig_defn.types.values.select do |type|
-          !type.introspection? && !type.default_scalar? && type.is_a?(GraphQL::ObjectType) &&
-            type.metadata[:federation_directives]&.any? { |directive| directive[:name] == 'key' }
-        end
-        @query_object.define_entities_field(possible_entities)
-
-        super
-      end
-    end
-
-    module OneTenMethods
-      include CommonMethods
-
       def query(new_query_object = nil)
         if new_query_object
           @orig_query_object = new_query_object
@@ -100,6 +49,29 @@ module ApolloFederation
             type.federation_directives&.any? { |directive| directive[:name] == 'key' }
         end
       end
+
+      def federation_query(query_obj)
+        # Build the new query object with the '_service' field
+        if query_obj.nil?
+          base = GraphQL::Schema::Object
+        elsif Gem::Version.new(GraphQL::VERSION) >= Gem::Version.new('1.10.0')
+          base = query_obj
+        else
+          base = query_obj.metadata[:type_class]
+        end
+
+        klass = Class.new(base) do
+          # TODO: Maybe the name should inherit from the original Query name
+          # Or MAYBE we should just modify the original class?
+          graphql_name 'Query'
+
+          include EntitiesField
+          include ServiceField
+        end
+
+        klass.define_service_field
+        klass
+      end
     end
   end
 end

data/lib/apollo-federation/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ApolloFederation
-  VERSION = '1.1.5'
+  VERSION = '2.0.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: apollo-federation
 version: !ruby/object:Gem::Version
-  version: 1.1.5
+  version: 2.0.0
 platform: ruby
 authors:
 - Noa Elad
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-10-29 00:00:00.000000000 Z
+date: 2022-01-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: graphql
@@ -17,28 +17,28 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.9.8
+        version: 1.10.14
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.9.8
+        version: 1.10.14
 - !ruby/object:Gem::Dependency
   name: google-protobuf
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.7'
+        version: 3.13.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.7'
+        version: 3.13.0
 - !ruby/object:Gem::Dependency
   name: actionpack
   requirement: !ruby/object:Gem::Requirement
@@ -234,7 +234,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.3.1
 signing_key: 
 specification_version: 4
 summary: A Ruby implementation of Apollo Federation