gem_metadata 0.1.0

data/features/support/env.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+=begin
+Copyright Alexander E. Fischer <aef@godobject.net>, 2016
+
+This file is part of GemMetadata.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require 'rspec/collection_matchers'
+require 'temporary_directory'
+
+World(GodObject::TemporaryDirectory::Helper.new(name_prefix: 'gem_metadata_cucumber'))
+
+After do
+  ensure_absence_of_temporary_directory
+end

data/features/support/gem_dependencies.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+=begin
+Copyright Alexander E. Fischer <aef@godobject.net>, 2016
+
+This file is part of GemMetadata.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+module GemDependencies
+  def gem_dependencies
+    @gem_dependencies ||= []
+  end
+
+  def create_gem_dependency(name:, gemspec_content: gemspec_for(gem_name: name))
+    gem_directory = temporary_directory / name
+    gem_directory.mkdir
+
+    gemspec_file = gem_directory / "#{name}.gemspec"
+    gemspec_file.write(gemspec_content)
+
+    gem_dependencies << name
+
+    gem_directory
+  end
+
+  def gemspec_for(gem_name:, additional_content: nil)
+    <<-GEMSPEC
+Gem::Specification.new do |gem|
+  gem.name = '#{gem_name}'
+  gem.version = '1.0.0'
+
+  gem.summary = 'This serves as an example for a gem.'
+  gem.description = 'This serves as an example for a gem.'
+
+  gem.authors = %w{somebody}
+  gem.email = %w{somebody@example.org}
+  gem.homepage = 'http://example.org'
+
+  #{additional_content}
+end
+    GEMSPEC
+  end
+end
+
+World(GemDependencies)

data/features/support/project.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+=begin
+Copyright Alexander E. Fischer <aef@godobject.net>, 2016
+
+This file is part of GemMetadata.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+module Project
+  def project_root_directory
+    @project_root_directory ||= Pathname.new(__dir__) / '..' / '..'
+  end
+end
+
+World(Project)

data/features/support/separate_environment_evaluation.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+=begin
+Copyright Alexander E. Fischer <aef@godobject.net>, 2016
+
+This file is part of GemMetadata.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+module SeparateEnvironmentEvaluation
+  class ExecutionResult
+    attr_reader :return_value, :console_output
+
+    def initialize(process_status: $CHILD_STATUS, console_output:)
+      @process_status = process_status
+      @console_output = console_output
+    end
+
+    def success?
+      @process_status.success?
+    end
+  end
+
+  class ObjectExecutionResult < ExecutionResult
+    def object_output
+      fail "Execution failed" unless success?
+
+      Marshal.load(@console_output)
+    end
+  end
+
+  def evaluation_result
+    @evaluation_result ||= @execution_result.object_output
+  end
+
+  def write_code_as_function_into_file(code)
+    code_file = temporary_directory / 'code.rb'
+    code_file.write(<<~CODE)
+      def code_to_execute
+        #{code}
+      end
+    CODE
+
+    code_file
+  end
+
+  def evaluate_in_separate_environment(command)
+    output = execute_in_separate_environment(command)
+
+    @execution_result = ObjectExecutionResult.new(console_output: output)
+  end
+end
+
+World(SeparateEnvironmentEvaluation)

data/features/support/separate_environment_execution.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+=begin
+Copyright Alexander E. Fischer <aef@godobject.net>, 2016
+
+This file is part of GemMetadata.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require 'English'
+
+module SeparateEnvironmentExecution
+  def execute_in_separate_environment(command)
+    Bundler.with_clean_env do
+      Dir.chdir(temporary_directory) do
+        @output = `#{command}`
+      end
+    end
+  end
+
+  def create_gemfile(include_gems: [])
+    gemfile = temporary_directory / 'Gemfile'
+
+    gemfile.open('w') do |io|
+      io.puts(%(gem 'gem_metadata', path: '#{project_root_directory}'))
+
+      include_gems.each do |gem_name|
+        io.puts(%(gem '#{gem_name}', path: '#{gem_name}'))
+      end
+    end
+
+    gemfile
+  end
+end
+
+World(SeparateEnvironmentExecution)

data/gem_metadata.gemspec

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+=begin
+Copyright Alexander E. Fischer <aef@godobject.net>, 2016
+
+This file is part of GemMetadata.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require 'English'
+require_relative 'lib/god_object/gem_metadata/version'
+
+Gem::Specification.new do |gem|
+  gem.name    = 'gem_metadata'
+  gem.version = GodObject::GemMetadata::VERSION.dup
+  gem.authors = ['Alexander E. Fischer']
+  gem.email   = ['aef@godobject.net']
+  gem.description = <<-DESCRIPTION
+GemMetadata is a Ruby library that allows to filter and access gems by custom
+metadata keys that their specifications contain.
+  DESCRIPTION
+  gem.summary  = 'Filter and access gems depending on metadata they contain'
+  gem.homepage = 'https://www.godobject.net/'
+  gem.license  = 'ISC'
+  gem.has_rdoc = 'yard'
+  gem.extra_rdoc_files  = %w(HISTORY.md LICENSE.md)
+  gem.rubyforge_project = nil
+
+  `git ls-files 2> /dev/null`
+
+  if $CHILD_STATUS.success?
+    gem.files         = `git ls-files`.split($OUTPUT_RECORD_SEPARATOR)
+  else
+    gem.files         = `ls -1`.split($OUTPUT_RECORD_SEPARATOR)
+  end
+
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = %w(lib)
+
+  gem.required_ruby_version = '>= 2.3.0'
+
+  gem.add_development_dependency('rake')
+  gem.add_development_dependency('bundler')
+  gem.add_development_dependency('rspec', '~> 3.5')
+  gem.add_development_dependency('rspec-collection_matchers', '~> 1.1')
+  gem.add_development_dependency('cucumber', '~> 2.4')
+  gem.add_development_dependency('temporary_directory', '= 0.1.0')
+  gem.add_development_dependency('simplecov')
+  gem.add_development_dependency('pry')
+  gem.add_development_dependency('yard')
+  gem.add_development_dependency('kramdown')
+end

data/lib/gem_metadata.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+=begin
+Copyright Alexander E. Fischer <aef@godobject.net>, 2016
+
+This file is part of GemMetadata.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require_relative 'god_object/gem_metadata'

data/lib/god_object/gem_metadata.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+=begin
+Copyright Alexander E. Fischer <aef@godobject.net>, 2016
+
+This file is part of GemMetadata.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+module GodObject
+  module GemMetadata
+  end
+end
+
+require_relative 'gem_metadata/version'
+require_relative 'gem_metadata/service'

data/lib/god_object/gem_metadata/service.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+=begin
+Copyright Alexander E. Fischer <aef@godobject.net>, 2016
+
+This file is part of GemMetadata.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+module GodObject::GemMetadata
+  class Service
+    def initialize(gems: ::Gem.loaded_specs.values)
+      @gems = gems
+    end
+
+    def find_gems_providing(metadata_key)
+      @gems.select { |gem| gem.metadata.key?(metadata_key) }
+    end
+  end
+end

data/lib/god_object/gem_metadata/version.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+=begin
+Copyright Alexander E. Fischer <aef@godobject.net>, 2016
+
+This file is part of GemMetadata.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+module GodObject
+  module GemMetadata
+
+    # The currently loaded version.
+    #
+    # Using Semantic Versioning (2.0.0) rules
+    # @see http://semver.org/spec/v2.0.0.html
+    VERSION = '0.1.0'
+
+  end
+end

data/spec/god_object/gem_metadata/service_spec.rb

@@ -0,0 +1,238 @@
+# frozen_string_literal: true
+=begin
+Copyright Alexander E. Fischer <aef@godobject.net>, 2016
+
+This file is part of GemMetadata.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+module GodObject::GemMetadata
+
+  describe Service do
+    shared_context 'only one gem was provided at construction' do
+      let(:constructor_arguments) { [gems: gems] }
+      let(:gems) { [gem_specification] }
+      let(:gem_specification) { instance_spy(::Gem::Specification, :specification, name: gem_name).as_null_object }
+      let(:gem_name) { 'some_gem' }
+    end
+
+    shared_context 'two gems were provided at construction' do
+      let(:constructor_arguments) { [gems: gems] }
+      let(:gems) { [first_gem_specification, second_gem_specification] }
+      let(:first_gem_specification) { instance_spy(::Gem::Specification, :first_specification, name: first_gem_name).as_null_object }
+      let(:first_gem_name) { 'some_gem' }
+
+      let(:second_gem_specification) { instance_spy(::Gem::Specification, :second_specification, name: second_gem_name).as_null_object }
+      let(:second_gem_name) { 'other_gem' }
+    end
+
+    let(:service) { described_class.new(*constructor_arguments) }
+
+    describe '.new' do
+      subject(:method_call) { described_class.new(*arguments) }
+
+      context 'when called without any arguments' do
+        let(:arguments) { [] }
+
+        before(:example) { allow(::Gem).to receive(:loaded_specs).and_return({}) }
+
+        it 'acquires the currently loaded gems from Rubygems' do
+          expect(::Gem).to receive(:loaded_specs)
+
+          method_call
+        end
+
+        it { is_expected.to be_an described_class }
+      end
+
+      context 'when called with gems' do
+        include_context 'two gems were provided at construction'
+
+        let(:arguments) { [gems: gems] }
+
+        it { is_expected.to be_an described_class }
+      end
+    end
+
+    describe '#find_gems_providing' do
+      subject(:method_call) { service.find_gems_providing(*arguments) }
+
+      context 'when called without any arguments' do
+        include_context 'only one gem was provided at construction'
+
+        let(:arguments) { [] }
+
+        specify { expect { method_call }.to raise_error ArgumentError, /wrong number of arguments/ }
+      end
+
+      context 'when called with a metadata key' do
+        let(:arguments) { [metadata_key] }
+        let(:metadata_key) { 'some key' }
+
+        context 'in case only one gem that does not contain metadata was provided at construction' do
+          include_context 'only one gem was provided at construction'
+
+          let(:metadata) { {} }
+
+          before(:example) do
+            allow(gem_specification).to receive(:metadata).and_return(metadata)
+          end
+
+          it 'requests the metadata from the gem specification' do
+            method_call
+
+            expect(gem_specification).to have_received(:metadata).with(no_args)
+          end
+
+          it { is_expected.to eq [] }
+        end
+
+        context 'in case only one gem that does contain non-matching metadata was provided at construction' do
+          include_context 'only one gem was provided at construction'
+
+          let(:metadata) do
+            { 'other key' => '' }
+          end
+
+          before(:example) do
+            allow(gem_specification).to receive(:metadata).and_return(metadata)
+          end
+
+          it 'requests the metadata from the gem specification' do
+            method_call
+
+            expect(gem_specification).to have_received(:metadata).with(no_args)
+          end
+
+          it { is_expected.to eq [] }
+        end
+
+        context 'in case only one gem that does contain matching metadata was provided at construction' do
+          include_context 'only one gem was provided at construction'
+
+          let(:metadata) do
+            { metadata_key => '' }
+          end
+
+          before(:example) do
+            allow(gem_specification).to receive(:metadata).and_return(metadata)
+          end
+
+          it 'requests the metadata from the gem specification' do
+            method_call
+
+            expect(gem_specification).to have_received(:metadata).with(no_args)
+          end
+
+          it { is_expected.to be_an Array }
+          it { is_expected.to have(1).item }
+
+          describe 'first item' do
+            subject(:item) { method_call[0] }
+
+            it 'is the gem specification' do
+              expect(item).to be gem_specification
+            end
+          end
+        end
+
+        context 'in case one gem containg metadata and one without were provided at construction' do
+          include_context 'two gems were provided at construction'
+
+          let(:first_metadata) { {} }
+          let(:second_metadata) do
+            { metadata_key => '' }
+          end
+
+          before(:example) do
+            allow(first_gem_specification).to receive(:metadata).and_return(first_metadata)
+            allow(second_gem_specification).to receive(:metadata).and_return(second_metadata)
+          end
+
+          it 'requests the metadata from the first gem specification' do
+            method_call
+
+            expect(first_gem_specification).to have_received(:metadata).with(no_args)
+          end
+
+          it 'requests the metadata from the second gem specification' do
+            method_call
+
+            expect(second_gem_specification).to have_received(:metadata).with(no_args)
+          end
+
+          it { is_expected.to be_an Array }
+          it { is_expected.to have(1).item }
+
+          describe 'first item' do
+            subject(:item) { method_call[0] }
+
+            it 'is the second gem specification' do
+              expect(item).to be second_gem_specification
+            end
+          end
+        end
+
+        context 'in case two gems containg matching metadata were provided at construction' do
+          include_context 'two gems were provided at construction'
+
+          let(:first_metadata) do
+            { metadata_key => '' }
+          end
+
+          let(:second_metadata) do
+            { metadata_key => '' }
+          end
+
+          before(:example) do
+            allow(first_gem_specification).to receive(:metadata).and_return(first_metadata)
+            allow(second_gem_specification).to receive(:metadata).and_return(second_metadata)
+          end
+
+          it 'requests the metadata from the first gem specification' do
+            method_call
+
+            expect(first_gem_specification).to have_received(:metadata).with(no_args)
+          end
+
+          it 'requests the metadata from the second gem specification' do
+            method_call
+
+            expect(second_gem_specification).to have_received(:metadata).with(no_args)
+          end
+
+          it { is_expected.to be_an Array }
+          it { is_expected.to have(2).item }
+
+          describe 'first item' do
+            subject(:item) { method_call[0] }
+
+            it 'is the first gem specification' do
+              expect(item).to be first_gem_specification
+            end
+          end
+
+          describe 'second item' do
+            subject(:item) { method_call[1] }
+
+            it 'is the second gem specification' do
+              expect(item).to be second_gem_specification
+            end
+          end
+        end
+      end
+    end
+  end
+
+end