apollo-federation 1.1.4.beta.1 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: daf6d773f974fc148d5b0b512a26c9f93e0ab439326531a02bfed864d7fa6cb2
-  data.tar.gz: 3b1ff037218ae14fe2aee7557166bc1ab0fe9b91ba52f256d53e17bc63abea0e
+  metadata.gz: 8a8a1aec191839f10fc35c1184f6d8c8a1a307dff82ba96a159ef5e140260ba0
+  data.tar.gz: fb9ae5a4a02e97973d4a107050f8190a9f22dbe90ca26017ce7d528f80440965
 SHA512:
-  metadata.gz: '083988b5151aed2b559b1f3eeb7760df2ada9fddacba4385c3fed34b5087a6daf1913b73e77eb2c600e1eccb6a4d29e593071f3ccf2a834f6abf88cb7fe100cf'
-  data.tar.gz: c6af4542c73ccf7fffcc06e58a0a8c73b71439dd2a78565611e582cabfe48ca60799df011ebcfde75ab6c811142636dcb30b5486a0bfb3eea3f642f191d2e728
+  metadata.gz: 3f920513b88d57be072ed9348b9ebea3054c16c9c137f38b30174e6d5d4c768a35f781c7129546f37603563e123486df3782fb51c1fb96cde65a8fa464b8cb5d
+  data.tar.gz: 18de702e8ddc5b0173369cd8b106a95c7d14ff929d31f91fc3ae7c758fcecd1ab3c0f4e9425d712b3c07e7dbad70c6407d60f0dcd6448cc6708d453490e49cc2

data/CHANGELOG.md

@@ -1,3 +1,34 @@
+## [2.0.1](https://github.com/Gusto/apollo-federation-ruby/compare/v2.0.0...v2.0.1) (2022-01-27)
+
+
+### Bug Fixes
+
+* Update to latest Ruby 2.6 image ([#167](https://github.com/Gusto/apollo-federation-ruby/issues/167)) ([f57d523](https://github.com/Gusto/apollo-federation-ruby/commit/f57d523c36274d5f729bc724ab0f86474f7c0f73))
+
+# [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)
+
+
+### Bug Fixes
+
+* pass context as a Hash to GraphQL::Schema.federation_sdl ([c13a94e](https://github.com/Gusto/apollo-federation-ruby/commit/c13a94e6487471b47f05907bd4f83c03fa7e6af7))
+
+## [1.1.4](https://github.com/Gusto/apollo-federation-ruby/compare/v1.1.3...v1.1.4) (2020-09-25)
+
+
+### Bug Fixes
+
+* **tracing:** properly handle parsing and validation errors ([#102](https://github.com/Gusto/apollo-federation-ruby/issues/102)) ([a1c2a41](https://github.com/Gusto/apollo-federation-ruby/commit/a1c2a41d3d01f06364d439cdcc273f4678fed7bd)), closes [#101](https://github.com/Gusto/apollo-federation-ruby/issues/101) [#101](https://github.com/Gusto/apollo-federation-ruby/issues/101)
+
 ## [1.1.4-beta.1](https://github.com/Gusto/apollo-federation-ruby/compare/v1.1.3...v1.1.4-beta.1) (2020-09-21)
 
 

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/service_field.rb

@@ -19,7 +19,7 @@ module ApolloFederation
 
     def _service
       schema_class = context.schema.is_a?(GraphQL::Schema) ? context.schema.class : context.schema
-      { sdl: schema_class.federation_sdl(context: context) }
+      { sdl: schema_class.federation_sdl(context: context.to_h) }
     end
   end
 end

data/lib/apollo-federation/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ApolloFederation
-  VERSION = '1.1.4.beta.1'
+  VERSION = '2.0.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: apollo-federation
 version: !ruby/object:Gem::Version
-  version: 1.1.4.beta.1
+  version: 2.0.1
 platform: ruby
 authors:
 - Noa Elad
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-21 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.19'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.7'
+        version: '3.19'
 - !ruby/object:Gem::Dependency
   name: actionpack
   requirement: !ruby/object:Gem::Requirement
@@ -230,11 +230,11 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.2.32
 signing_key: 
 specification_version: 4
 summary: A Ruby implementation of Apollo Federation