artemis 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac727e89f6d2c0845b888ea9eeb526bf2607689fa268c9f815b9af3c25c83d72
-  data.tar.gz: 1cb2c9c3de64e95b729f579dfb4a8bd93a07d6ac4732647bf7aa94a360a6624a
+  metadata.gz: 0b5fc48841d80c3f0ebd0cc161938caf1044b09ce300bb55822df3ae1323aed2
+  data.tar.gz: e42427484c1786929c66a2f8a7650cb2e631230155f92c92e5d36406a20a41b0
 SHA512:
-  metadata.gz: 041b006e10af9271e6cb024f2acfdc1597969ad44ccf371235a12f95c2464afac66110967db926ece6df3c46c3161b3b3f54436ea276b0362234c27f13e5933e
-  data.tar.gz: 0daaea8bebcbf4ea6c9225781f591b4cd069aa6517dacb09043500b29357c1140d4169ed00e55046003702489addbfea60ef7703bc607692186ef61c7d94c0ac
+  metadata.gz: 1b0625a78d265426de79dc77ace3f0ff2336e75a914b37b4179356ec3f0c69c2beda8658e1b0cabf914221aea92e6fb86c6510075b6ab9c9c0e9f04cb1c37368
+  data.tar.gz: f80b1e917bfaac00586704ab09a3893f7d879b02a62b5693816f1c7977fed64233585b7e0d17ab8ae7877efdab2a5efc951eab4928f9120d90a41c9895cd0c93

data/.travis.yml

@@ -6,12 +6,12 @@ sudo:   false
 before_install: gem install bundler -v 1.16.1
 
 rvm:
-  - 2.5.1
-  - 2.4.4
-  - 2.3.7
-  # - 2.2.10
+  - 2.6.0
+  - 2.5.3
+  - 2.4.5
+  - 2.3.8
   - ruby-head
-  # - jruby-9.2.0.0
+  # - jruby-9.2.3.0
   # - jruby-head
 
 gemfile:
@@ -24,13 +24,11 @@ gemfile:
 matrix:
   allow_failures:
     - rvm: ruby-head
-    # - rvm: jruby-9.2.0.0
+    # - rvm: jruby-9.2.3.0
     # - rvm: jruby-head
     - gemfile: gemfiles/rails_edge.gemfile
   exclude:
-    - rvm: 2.3.7
+    - rvm: 2.4.5
+      gemfile: gemfiles/rails_edge.gemfile
+    - rvm: 2.3.8
       gemfile: gemfiles/rails_edge.gemfile
-    # - rvm: 2.2.10
-      # gemfile: gemfiles/rails_52.gemfile
-    # - rvm: 2.2.10
-      # gemfile: gemfiles/rails_edge.gemfile

data/CHANGELOG.md

@@ -1,11 +1,20 @@
 ## Unreleased
 
  * Add a new entry here
- * [#43](https://github.com/yuki24/artemis/pull/43): Keep persistent connections open for 30 minutes
- * [#42](https://github.com/yuki24/artemis/pull/42): Allow for setting up the test adapter without `url`
- * [#41](https://github.com/yuki24/artemis/pull/41): Add a mutation generator
- * [#40](https://github.com/yuki24/artemis/pull/40): Add a query generator
- * [#39](https://github.com/yuki24/artemis/pull/39): Installer now adds a new service if config/graphql.yml is present
+ * [#48](https://github.com/yuki24/artemis/pull/48): Do not transform keys of query variables [@erikdstock](https://github.com/erikdstock)
+ * [#47](https://github.com/yuki24/artemis/pull/47): Fixes an issue where errors thrown from `config/graphql.yml` get swallowed 
+
+## [v0.2.0: New generators and small improvements](https://github.com/yuki24/artemis/tree/v0.2.0)
+
+_<sup>released at 2018-10-30 02:09:59 UTC</sup>_
+
+#### Features
+
+- [#43](https://github.com/yuki24/artemis/pull/43): Keep persistent connections open for 30 minutes
+- [#42](https://github.com/yuki24/artemis/pull/42): Allow for setting up the test adapter without `url`
+- [#41](https://github.com/yuki24/artemis/pull/41): Add a mutation generator
+- [#40](https://github.com/yuki24/artemis/pull/40): Add a query generator
+- [#39](https://github.com/yuki24/artemis/pull/39): Installer now adds a new service if config/graphql.yml is present
 
 ## [v0.1.0: First release!](https://github.com/yuki24/artemis/tree/v0.1.0)
 

data/README.md

@@ -1,12 +1,35 @@
 # Artemis [![Build Status](https://travis-ci.org/yuki24/artemis.svg?branch=master)](https://travis-ci.org/yuki24/artemis)
 
+Artemis is a GraphQL client that is designed to fit well on Rails.
+
  * **Convention over Configuration**: You'll never have to make trivial decisions or spend time on boring setup. Start
-  making a GraphQL request in literally 30sec.
+  making a GraphQL request in literally 30s.
  * **Performant by default**: You can't do wrong when it comes to performance. All GraphQL files are pre-loaded only
   once in production and it'll never affect runtime performance. Comes with options that enable persistent connections
-   and even HTTP/2.0, the next-gen high-performance protocol.
+   and even HTTP/2, the next-gen high-performance protocol.
+ * **First-class support for testing**: Testing and stubbing GraphQL requests couldn't be simpler. No need to add
+  external dependencies to test well.
+
+<img width="24" height="24" src="https://avatars1.githubusercontent.com/u/541332?s=48&amp;v=4"> Battle-tested at [Artsy](https://www.artsy.net)
+
+## Quick start
+
+You could set up Artemis with just a few commands. See it in action:
 
-<img width="24" height="24" src="https://avatars1.githubusercontent.com/u/541332?s=48&amp;v=4"> Battled-tested at [Artsy](https://www.artsy.net)
+```bash
+$ bundle add artemis
+$ rails g artemis:install artsy https://metaphysics-production.artsy.net/
+$ echo '
+query($id: String!) {
+  artist(id: $id) {
+    name
+    birthday
+   }
+}' > app/operations/artsy/artist.graphql
+$ rails c
+> Artsy.artist(id: "leonardo-da-vinci").data.artist.name     # => "Leonardo da Vinci"
+> Artsy.artist(id: "leonardo-da-vinci").data.artist.birthday # => "1452/04/15"
+```
 
 ## Getting started
 
@@ -85,6 +108,11 @@ Artemis assumes that the files related to GraphQL are organized in a certain way
 │   │   └── artists.graphql
 │   └── artsy.rb
 ├──config/graphql.yml
+├──test/fixtures/graphql
+│   └── artsy
+│       ├── artwork.yml
+│       ├── artist.yml
+│       └── artists.yml
 └──vendor/graphql/schema/artsy.json
 ```
 
@@ -136,7 +164,7 @@ There are four adapter options available. Choose the adapter that best fits on y
 
 | Adapter                | Protocol                 | Keep-alive  | Performance | Dependencies |
 | ---------------------- | ------------------------ | ----------- | ----------- | ------------ |
-| `:curb`                | HTTP/1.1, **HTTP/2.0**   | **Yes**     | **Fastest** | [`curb 0.9.6+`][curb]<br>[`libcurl 7.64.0+`][curl]<br>[`nghttp2 1.0.0+`][nghttp]
+| `:curb`                | HTTP/1.1, **HTTP/2**     | **Yes**     | **Fastest** | [`curb 0.9.6+`][curb]<br>[`libcurl 7.64.0+`][curl]<br>[`nghttp2 1.0.0+`][nghttp]
 | `:net_http` (default)  | HTTP/1.1 only            | No          | Slow        | **None**
 | `:net_http_persistent` | HTTP/1.1 only            | **Yes**     | **Fast**    | [`net-http-persistent 3.0.0+`][nhp]
 | `:test`                | N/A (See Testing)
@@ -152,7 +180,73 @@ Artemis also adds a useful `rake graphql:schema:update` rake task that downloads
 
 ## Testing
 
-**The testing support is incomplete, but there are some examples [available in Artemis' client spec](https://github.com/yuki24/artemis/blob/74095f3acb050e87251439aed5f8b17778ffdd06/spec/client_spec.rb#L36-L54).**
+Given that you have `app/operations/artsy/artist.graphql` and fixture file for the `artist.yml`:
+
+```yml
+# test/fixtures/graphql/artist.yml:
+leonardo_da_vinci:
+  data:
+    artist:
+      name: Leonardo da Vinci
+      birthday: 1452/04/15
+
+yayoi_kusama:
+  data:
+    artist:
+      name: Yayoi Kusama
+      birthday: 1929/03/22
+```
+
+Then you can stub the request with the `stub_graphql` DSL:
+
+```ruby
+stub_graphql(Artsy, :artist, id: "yayoi-kusama").to_return(:yayoi_kusama)
+stub_graphql(Artsy, :artist, id: "leonardo-da-vinci").to_return(:leonardo_da_vinci)
+
+yayoi_kusama = Artsy.artist(id: "yayoi-kusama")
+yayoi_kusama.data.artist.name     # => "Yayoi Kusama"
+yayoi_kusama.data.artist.birthday # => "1452/04/15"
+
+da_vinci = Artsy.artist(id: "leonardo-da-vinci")
+da_vinci.data.artist.name     # => "Leonardo da Vinci"
+da_vinci.data.artist.birthday # => "1452/04/15"
+```
+
+You can also use JSON instead of YAML. See [example fixtures](https://github.com/yuki24/artemis/tree/master/spec/fixtures/responses)
+and [test cases](https://github.com/yuki24/artemis/blob/master/spec/test_helper_spec.rb#L16-L51).
+
+### MiniTest
+
+Setting up the test helper with Artemis is very easy and simple. Just add the following code to the
+`test/test_helper.rb` in your app:
+
+```ruby
+# spec/test_helper.rb
+require 'artemis/test_helper'
+
+class ActiveSupport::TestCase
+  setup do
+    graphql_requests.clear
+    graphql_responses.clear
+  end
+end
+```
+
+### RSpec
+
+Artemis also comes with a script that wires up helper methods on Rspec. Because it is more common to use the `spec/`
+directory to organize spec files in RSpec, the `config.artemis.fixture_path` config needs to point to
+`spec/fixtures/graphql`. Other than that, it is very straightforward to set it up:
+
+```ruby
+# config/application.rb
+config.artemis.fixture_path = 'spec/fixtures/graphql'
+```
+
+```ruby
+# Add this to your spec/rails_helper.rb or spec_helper.rb if you don't have rails_helper.rb
+require 'artemis/rspec'
+```
 
 ## Development
 

data/artemis.gemspec

@@ -16,6 +16,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "activesupport", ">= 4.2.0"
+  spec.add_dependency "graphql", ">= 1.8"
   spec.add_dependency "graphql-client", ">= 0.13.0"
   spec.add_dependency "railties", ">= 4.2.0"
 

data/bin/console

@@ -3,12 +3,10 @@
 require "bundler/setup"
 require "artemis"
 
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
+Artemis::Client.query_paths = [File.join(__dir__, '../spec/fixtures')]
+Artemis::GraphQLEndpoint.register!(:metaphysics, adapter: :test, url: '', schema_path: 'spec/fixtures/metaphysics/schema.json')
+Artemis::GraphQLEndpoint.lookup(:metaphysics).load_schema!
+require_relative '../spec/fixtures/metaphysics'
 
-# (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
-require "irb"
-IRB.start(__FILE__)
+require "pry"
+Pry.start

data/lib/artemis/adapters/test_adapter.rb

@@ -8,6 +8,9 @@ module Artemis
       cattr_accessor :requests
       self.requests = []
 
+      cattr_accessor :responses
+      self.responses = []
+
       Request = Struct.new(:document, :operation_name, :variables, :context)
 
       private_constant :Request
@@ -18,7 +21,11 @@ module Artemis
       def execute(**arguments)
         self.requests << Request.new(*arguments.values_at(:document, :operation_name, :variables, :context))
 
-        {
+        response = responses.detect do |mock|
+          arguments[:operation_name] == mock.operation_name && mock.arguments == :__unspecified__ || arguments[:variables] == mock.arguments
+        end
+
+        response&.data || {
           'data' => { 'test' => 'data' },
           'errors' => [],
           'extensions' => {}

data/lib/artemis/client.rb

@@ -177,6 +177,18 @@ module Artemis
         end
       end
 
+      # Looks up the GraphQL file that matches the given +const_name+ and sets it to a constant.
+      #
+      #   # app/operations/github.rb
+      #   class Github < Artemis::Client
+      #   end
+      #
+      #   defined?(Github::User)      # => nil
+      #   Github.load_constant(:User) # => loads an operation definition from app/operations/github/user.graphql
+      #   defined?(Github::User)      # => 'constant'
+      #
+      #   Github.load_constant(:None) # => nil
+      #
       def load_constant(const_name)
         graphql_file = resolve_graphql_file_path(const_name.to_s.underscore, fragment: true)
 
@@ -195,11 +207,33 @@ module Artemis
 
       private
 
+      # Looks up the GraphQL file that matches the given +const_name+ and sets it to a constant. If the files it not
+      # found it will raise an +NameError+.
+      #
+      #   # app/operations/github.rb
+      #   class Github < Artemis::Client
+      #   end
+      #
+      #   defined?(Github::User) # => nil
+      #   Github::User           # => loads an operation definition from app/operations/github/user.graphql
+      #   defined?(Github::User) # => 'constant'
+      #
+      #   Github::DoesNotExist   # => raises an NameError
+      #
       # @api private
       def const_missing(const_name)
         load_constant(const_name) || super
       end
 
+      # Delegates a class method call to an instance method call, which in turn looks up the GraphQL file that matches
+      # the given +method_name+ and delegates the call to it.
+      #
+      #   # app/operations/github.rb
+      #   class Github < Artemis::Client
+      #   end
+      #
+      #   Github.user # => delegates to Github.new(default_context).user
+      #
       # @api private
       def method_missing(method_name, *arguments, &block)
         if resolve_graphql_file_path(method_name)
@@ -223,6 +257,15 @@ module Artemis
 
     private
 
+    # Delegates a method call to a GraphQL call.
+    #
+    #   # app/operations/github.rb
+    #   class Github < Artemis::Client
+    #   end
+    #
+    #   github = Github.new
+    #   github.user # => delegates to app/operations/github/user.graphql
+    #
     # @api private
     def method_missing(method_name, context: {}, **arguments)
       if self.class.resolve_graphql_file_path(method_name)
@@ -233,11 +276,7 @@ module Artemis
           self.class.load_constant(const_name)
         end
 
-        client.query(
-          self.class.const_get(const_name),
-          variables: arguments.deep_transform_keys {|key| key.to_s.camelize(:lower) },
-          context: context
-        )
+        client.query(self.class.const_get(const_name), variables: arguments, context: context)
       else
         super
       end
@@ -247,21 +286,6 @@ module Artemis
       self.class.resolve_graphql_file_path(method_name) || super
     end
 
-    # @api private
-    def compile_query_method!(method_name)
-      const_name = method_name.to_s.camelize
-
-      self.class.send(:class_eval, <<-RUBY, __FILE__, __LINE__ + 1)
-        def #{method_name}(context: {}, **arguments)
-          client.query(
-            self.class::#{const_name},
-            variables: arguments.deep_transform_keys {|key| key.to_s.camelize(:lower) },
-            context: context
-          )
-        end
-      RUBY
-    end
-
     # Internal collection object that holds references to the callback blocks.
     #
     # @api private

data/lib/artemis/exceptions.rb

@@ -11,6 +11,9 @@ module Artemis
   class GraphQLFileNotFound < Error
   end
 
+  class FixtureNotFound < Error
+  end
+
   class GraphQLError < Error
   end
 

data/lib/artemis/railtie.rb

@@ -2,6 +2,12 @@ require 'active_support/file_update_checker'
 
 module Artemis
   class Railtie < ::Rails::Railtie #:nodoc:
+    config.artemis = ActiveSupport::OrderedOptions.new
+    config.artemis.query_path         = "app/operations"
+    config.artemis.fixture_path       = "test/fixtures/graphql"
+    config.artemis.schema_path        = "vendor/graphql/schema"
+    config.artemis.graphql_extentions = ["graphql"]
+
     initializer 'graphql.client.attach_log_subscriber' do
       if !defined?(GraphQL::Client::LogSubscriber)
         require "graphql/client/log_subscriber"
@@ -10,13 +16,22 @@ module Artemis
     end
 
     initializer 'graphql.client.set_query_paths' do |app|
-      app.paths.add "app/operations"
+      query_path = config.artemis.query_path
+
+      app.paths.add query_path
+
+      Artemis::Client.query_paths = app.paths[query_path].existent
+    end
 
-      Artemis::Client.query_paths = app.paths["app/operations"].existent
+    initializer 'graphql.test_helper' do |app|
+      if !Rails.env.production?
+        require 'artemis/test_helper'
+        Artemis::TestHelper.__graphql_fixture_path__ = app.root.join(config.artemis.fixture_path)
+      end
     end
 
     initializer 'graphql.client.set_reloader', after: 'graphql.client.set_query_paths' do |app|
-      files_to_watch = Artemis::Client.query_paths.map {|path| [path, ["graphql"]] }.to_h
+      files_to_watch = Artemis::Client.query_paths.map {|path| [path, config.artemis.graphql_extentions] }.to_h
 
       app.reloaders << ActiveSupport::FileUpdateChecker.new([], files_to_watch) do
         endpoint_names = app.config_for(:graphql).keys
@@ -29,9 +44,12 @@ module Artemis
     end
 
     initializer 'graphql.client.load_config' do |app|
-      # TODO: Remove the +rescue+ call
-      (app.config_for(:graphql) rescue {}).each do |endpoint_name, options|
-        Artemis::GraphQLEndpoint.register!(endpoint_name, { 'schema_path' => app.root.join("vendor/graphql/schema/#{endpoint_name}.json").to_s }.merge(options))
+      if Pathname.new("#{app.paths["config"].existent.first}/graphql.yml").exist?
+        app.config_for(:graphql).each do |endpoint_name, options|
+          Artemis::GraphQLEndpoint.register!(endpoint_name, {
+            'schema_path' => app.root.join(config.artemis.schema_path, "#{endpoint_name}.json").to_s
+          }.merge(options))
+        end
       end
     end
 

data/lib/artemis/rspec.rb

@@ -0,0 +1,10 @@
+require 'artemis/test_helper'
+
+RSpec.configure do |config|
+  config.include ::Artemis::TestHelper
+
+  config.before :each do
+    graphql_requests.clear
+    graphql_responses.clear
+  end
+end

data/lib/artemis/test_helper.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+require 'erb'
+
+require 'active_support/core_ext/module/attribute_accessors'
+
+require 'artemis/exceptions'
+
+module Artemis
+  # TODO: Write documentation for +TestHelper+
+  module TestHelper
+    cattr_accessor :__graphql_fixture_path__
+
+    # Creates an object that stubs a GraphQL request for the given +service+. No mock response is registered until the
+    # +to_return+ method.
+    #
+    #   # test/fixtures/graphql/metaphysics/artist.yml
+    #   leonardo_da_vinci:
+    #     data:
+    #       artist:
+    #         name: Leonardo da Vinci
+    #         birthday: 1452/04/15
+    #
+    #   # In a test:
+    #   stub_graphql(Metaphysics, :artist).to_return(:leonardo_da_vinci)
+    #
+    #   response = Metaphysics.artist(id: "leonardo-da-vinci")
+    #
+    #   response.data.artist.name     # => "Leonardo da Vinci"
+    #   response.data.artist.birthday # => "1452/04/15"
+    #
+    # Test responses could also be parameterized by specifying the +arguments+ argument for the query name.
+    #
+    #   stub_graphql(Metaphysics, :artist, id: "pablo-picasso").to_return(:pablo_picasso)
+    #   stub_graphql(Metaphysics, :artist, id: "leonardo-da-vinci").to_return(:leonardo_da_vinci)
+    #
+    #   pablo_picasso = Metaphysics.artist(id: "pablo-picasso")
+    #   da_vinci      = Metaphysics.artist(id: "leonardo-da-vinci")
+    #
+    #   pablo_picasso.data.artist.name # => "Pablo Picasso"
+    #   da_vinci.data.artist.name      # => "Leonardo da Vinci"
+    #
+    def stub_graphql(service, query_name, arguments =  :__unspecified__)
+      StubbingDSL.new(service.to_s, graphql_fixtures(query_name), arguments)
+    end
+
+    # Returns out-going GraphQL requests.
+    #
+    def graphql_requests
+      Artemis::Adapters::TestAdapter.requests
+    end
+
+    private
+
+    def graphql_responses #:nodoc:
+      Artemis::Adapters::TestAdapter.responses
+    end
+
+    def graphql_fixture_path #:nodoc:
+      __graphql_fixture_path__ || raise(Artemis::ConfigurationError, "GraphQL fixture path is unset")
+    end
+
+    def graphql_fixtures(query_name) #:nodoc:
+      graphql_fixture_files.detect {|fixture| fixture.name == query_name.to_s } || \
+        raise(Artemis::FixtureNotFound, "Fixture file `#{File.join(graphql_fixture_path, "#{query_name}.{yml,json}")}' not found")
+    end
+
+    def graphql_fixture_files #:nodoc:
+      @graphql_fixture_sets ||= Dir["#{graphql_fixture_path}/{**,*}/*.{yml,json}"]
+                              .select {|file| ::File.file?(file) }
+                              .map    {|file| GraphQLFixture.new(File.basename(file, File.extname(file)), file, read_erb_yaml(file)) }
+    end
+
+    def read_erb_yaml(path) #:nodoc:
+      YAML.load(ERB.new(File.read(path)).result)
+    end
+
+    class StubbingDSL #:nodoc:
+      attr_reader :service_name, :fixture_set, :arguments
+
+      def initialize(service_name, fixture_set, arguments) #:nodoc:
+        @service_name, @fixture_set, @arguments = service_name, fixture_set, arguments
+      end
+
+      def to_return(fixture_key) #:nodoc:
+        fixture = fixture_set.data[fixture_key.to_s] || \
+          raise(Artemis::FixtureNotFound, "Fixture `#{fixture_key}' not found in #{fixture_set.path}")
+
+        Artemis::Adapters::TestAdapter.responses <<
+          TestResponse.new(
+            "#{service_name}__#{fixture_set.name.to_s.camelcase}",
+            arguments.respond_to?(:deep_stringify_keys) ? arguments.deep_stringify_keys : arguments,
+            fixture
+          )
+      end
+    end
+
+    TestResponse      = Struct.new(:operation_name, :arguments, :data) #:nodoc:
+    GraphQLFixture    = Struct.new(:name, :path, :data) #:nodoc
+
+    private_constant :GraphQLFixture, :StubbingDSL, :TestResponse
+  end
+end

data/lib/artemis/version.rb

@@ -1,3 +1,3 @@
 module Artemis
-  VERSION = "0.2.0"
+  VERSION = "0.4.0"
 end

data/spec/fixtures/responses/artist.yml

@@ -0,0 +1,17 @@
+yayoi_kusama:
+  data:
+    artist:
+      name: Yayoi Kusama
+      birthday: 1929/03/22
+
+leonardo_da_vinci:
+  data:
+    artist:
+      name: Leonardo da Vinci
+      birthday: 1452/04/15
+
+yuki:
+  data:
+    artist:
+      name: Yuki Nishijima
+      birthday: <%= Date.today.year %>/01/01

data/spec/fixtures/responses/artwork.json

@@ -0,0 +1,12 @@
+{
+  "the_last_supper": {
+    "data": {
+      "artwork": {
+        "title": "The Last Supper",
+        "artist": {
+          "name": "Leonardo da Vinci"
+        }
+      }
+    }
+  }
+}

data/spec/test_helper_spec.rb

@@ -0,0 +1,64 @@
+require 'artemis/test_helper'
+require 'date'
+
+describe GraphQL::Client do
+  include Artemis::TestHelper
+
+  def graphql_fixture_path
+    File.join(PROJECT_DIR, "spec/fixtures/responses")
+  end
+
+  before do
+    graphql_requests.clear
+    graphql_responses.clear
+  end
+
+  it "can mock a GraphQL request" do
+    stub_graphql(Metaphysics, :artist).to_return(:yayoi_kusama)
+
+    response = Metaphysics.artist(id: "yayoi-kusama")
+
+    expect(response.data.artist.name).to eq("Yayoi Kusama")
+    expect(response.data.artist.birthday).to eq("1929/03/22")
+  end
+
+  it "can mock a GraphQL request with an ERB-enabled fixture" do
+    stub_graphql(Metaphysics, :artist).to_return(:yuki)
+
+    response = Metaphysics.artist(id: "yuki")
+
+    expect(response.data.artist.birthday).to eq("#{Date.today.year}/01/01")
+  end
+
+  it "can mock a GraphQL request with variables using exact match" do
+    stub_graphql(Metaphysics, :artist, id: "yayoi-kusama").to_return(:yayoi_kusama)
+    stub_graphql(Metaphysics, :artist, id: "leonardo-da-vinci").to_return(:leonardo_da_vinci)
+
+    yayoi_kusama = Metaphysics.artist(id: "yayoi-kusama")
+    da_vinci     = Metaphysics.artist(id: "leonardo-da-vinci")
+
+    expect(yayoi_kusama.data.artist.name).to eq("Yayoi Kusama")
+    expect(da_vinci.data.artist.name).to eq("Leonardo da Vinci")
+  end
+
+  it "can mock a GraphQL request with a JSON file" do
+    stub_graphql(Metaphysics, :artwork).to_return(:the_last_supper)
+
+    response = Metaphysics.artwork(id: "leonardo-da-vinci-the-last-supper")
+
+    expect(response.data.artwork.title).to eq("The Last Supper")
+    expect(response.data.artwork.artist.name).to eq("Leonardo da Vinci")
+  end
+
+  it "can mock a GraphQL request for a query that has a query name"
+
+  it "raises an exception if the specified fixture file does not exist" do
+    expect { stub_graphql(Metaphysics, :does_not_exist) }
+      .to raise_error(Artemis::FixtureNotFound, %r|spec/fixtures/responses/does_not_exist.{yml,json}|)
+  end
+
+  it "raises an exception if the specified fixture file exists but fixture key does not exist" do
+    expect { stub_graphql(Metaphysics, :artist).to_return(:does_not_exist) }
+      .to raise_error(Artemis::FixtureNotFound, %r|spec/fixtures/responses/artist.yml|)
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: artemis
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Jon Allured
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-10-30 00:00:00.000000000 Z
+date: 2019-01-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -25,6 +25,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 4.2.0
+- !ruby/object:Gem::Dependency
+  name: graphql
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.8'
 - !ruby/object:Gem::Dependency
   name: graphql-client
   requirement: !ruby/object:Gem::Requirement
@@ -177,6 +191,8 @@ files:
 - lib/artemis/exceptions.rb
 - lib/artemis/graphql_endpoint.rb
 - lib/artemis/railtie.rb
+- lib/artemis/rspec.rb
+- lib/artemis/test_helper.rb
 - lib/artemis/version.rb
 - lib/generators/artemis/install/USAGE
 - lib/generators/artemis/install/install_generator.rb
@@ -200,7 +216,10 @@ files:
 - spec/fixtures/metaphysics/artists.graphql
 - spec/fixtures/metaphysics/artwork.graphql
 - spec/fixtures/metaphysics/schema.json
+- spec/fixtures/responses/artist.yml
+- spec/fixtures/responses/artwork.json
 - spec/spec_helper.rb
+- spec/test_helper_spec.rb
 - tmp/.gitkeep
 homepage: https://github.com/yuki24/artemis
 licenses: