farscape 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: aaaa9b7314cc73ef0fd43a9de2e7f17f78999636
-  data.tar.gz: ff6f62f5301162b952821b23a80be847fac1627e
+  metadata.gz: 42ff32e415677a4ca1cb6419518d7cbf78a6df1c
+  data.tar.gz: 2f7d3081526f4e913c7b4d66f35378db2212de31
 SHA512:
-  metadata.gz: 401dc3a255241d08565bc7067e6933b8450e48a97b87af028011e5600a41db720570731059486269daf4e95200c0f283cd5068666c90ff702699fa7de7e2022a
-  data.tar.gz: dbf7b5362bc58a66771ba67b8f8b822a17947eafc92ee5ca043019c3d2a76eb9907272919790b5dc23980e940f35f170e83f72724965509d19d20d2baf5ef5ef
+  metadata.gz: a45910ae4df9afafafa01805c07de5948c5a912367f5ee184b870d26167b75710d2c49055cd34d08fbaae804be542c683fc42c41d409e30007bfc44343b1fcd0
+  data.tar.gz: 8ee0a64cefcad9ecfc1e4c50c7f295031467b84846920baf1baffa1a3391dda3fead82eeda67144c78511cf41a8f922caf44c4a49fade8ad1a1fd395dd8324b5

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+# 1.3.0
+* Add discover method and configuration to the Farscape agent.
+
 # 1.2.0
 * Add support for templated URIs and POST requests
 

data/Gemfile.lock

@@ -1,14 +1,5 @@
 GIT
-  remote: git@github.com:mdsol/representors.git
-  revision: 958dc778d62897f09dd0200f3690f96cb5265b98
-  branch: 0-0-stable
-  specs:
-    representors (0.0.3)
-      addressable (~> 2.3)
-      rake
-
-GIT
-  remote: https://www.github.com/mdsol-share/crichton.git
+  remote: https://github.com/mdsol-share/crichton.git
   revision: 63c74ce781a41538454b81fd8c44dc36117aa92b
   branch: develop
   specs:
@@ -24,7 +15,7 @@ GIT
       rake
 
 GIT
-  remote: https://www.github.com/mdsol/moya.git
+  remote: https://github.com/mdsol/moya.git
   revision: 6e8b324dee6335e5d56d320ba0a605b6ebae8574
   branch: develop
   specs:
@@ -40,13 +31,12 @@ GIT
 PATH
   remote: .
   specs:
-    farscape (1.0.1)
+    farscape (1.3.0)
       activesupport
-      addressable (~> 2.3.0)
-      dice_bag
-      faraday (~> 0.8.8)
-      faraday_middleware (~> 0.9)
+      addressable (~> 2.3)
+      faraday (~> 0.9)
       rake
+      representors (~> 0.0.5)
 
 GEM
   remote: https://rubygems.org/
@@ -77,47 +67,41 @@ GEM
       minitest (~> 5.1)
       thread_safe (~> 0.1)
       tzinfo (~> 1.1)
-    activeuuid (0.6.0)
+    activeuuid (0.6.1)
       activerecord (>= 3.1)
       uuidtools
-    addressable (2.3.7)
+    addressable (2.3.8)
     arel (5.0.1.20140414130214)
-    awesome_print (1.1.0)
     builder (3.2.2)
-    coderay (1.1.0)
+    byebug (9.0.5)
     colorize (0.6.0)
-    crack (0.4.2)
+    concurrent-ruby (1.0.2)
+    crack (0.4.3)
       safe_yaml (~> 1.0.0)
-    dice_bag (0.8.0)
+    dice_bag (0.9.0)
       rake
     diff-lcs (1.2.5)
     diffy (3.0.7)
     docile (1.1.5)
     erubis (2.7.0)
-    faraday (0.8.9)
-      multipart-post (~> 1.2.0)
-    faraday_middleware (0.9.1)
-      faraday (>= 0.7.4, < 0.10)
-    hike (1.2.3)
+    faraday (0.9.2)
+      multipart-post (>= 1.2, < 3)
+    hashdiff (0.3.0)
     i18n (0.7.0)
-    json (1.8.2)
+    json (1.8.3)
     launchy (2.4.3)
       addressable (~> 2.3)
-    mail (2.6.3)
-      mime-types (>= 1.16, < 3)
-    method_source (0.8.2)
-    mime-types (2.4.3)
-    mini_portile (0.6.2)
-    minitest (5.5.1)
-    multi_json (1.11.0)
-    multipart-post (1.2.0)
-    nokogiri (1.6.6.2)
-      mini_portile (~> 0.6.0)
-    pry (0.10.1)
-      coderay (~> 1.1.0)
-      method_source (~> 0.8.1)
-      slop (~> 3.4)
-    rack (1.5.2)
+    mail (2.6.4)
+      mime-types (>= 1.16, < 4)
+    mime-types (3.1)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2016.0521)
+    mini_portile2 (2.0.0)
+    minitest (5.9.0)
+    multipart-post (2.0.0)
+    nokogiri (1.6.7.2)
+      mini_portile2 (~> 2.0.0.rc2)
+    rack (1.5.5)
     rack-test (0.6.3)
       rack (>= 1.0)
     rails (4.1.8)
@@ -135,8 +119,11 @@ GEM
       activesupport (= 4.1.8)
       rake (>= 0.8.7)
       thor (>= 0.18.1, < 2.0)
-    rake (0.9.6)
-    redcarpet (3.2.2)
+    rake (11.1.2)
+    redcarpet (3.3.4)
+    representors (0.0.5)
+      addressable (~> 2.3)
+      rake
     rspec (2.99.0)
       rspec-core (~> 2.99.0)
       rspec-expectations (~> 2.99.0)
@@ -146,31 +133,28 @@ GEM
       diff-lcs (>= 1.1.3, < 2.0)
     rspec-mocks (2.99.3)
     safe_yaml (1.0.4)
-    simplecov (0.9.2)
+    simplecov (0.11.2)
       docile (~> 1.1.0)
-      multi_json (~> 1.0)
-      simplecov-html (~> 0.9.0)
-    simplecov-html (0.9.0)
-    slop (3.6.0)
-    sprockets (2.12.3)
-      hike (~> 1.2)
-      multi_json (~> 1.0)
-      rack (~> 1.0)
-      tilt (~> 1.1, != 1.3.0)
-    sprockets-rails (2.2.4)
+      json (~> 1.8)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
+    sprockets (3.6.0)
+      concurrent-ruby (~> 1.0)
+      rack (> 1, < 3)
+    sprockets-rails (2.3.3)
       actionpack (>= 3.0)
       activesupport (>= 3.0)
       sprockets (>= 2.8, < 4.0)
-    sqlite3 (1.3.10)
+    sqlite3 (1.3.11)
     thor (0.19.1)
     thread_safe (0.3.5)
-    tilt (1.4.1)
     tzinfo (1.2.2)
       thread_safe (~> 0.1)
     uuidtools (2.1.5)
-    webmock (1.13.0)
-      addressable (>= 2.2.7)
+    webmock (2.0.3)
+      addressable (>= 2.3.6)
       crack (>= 0.3.2)
+      hashdiff
     yajl-ruby (1.2.1)
     yard (0.8.7.6)
 
@@ -178,15 +162,15 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
-  awesome_print (~> 1.1.0)
+  byebug
   crichton!
   farscape!
   moya!
-  pry
-  rake (~> 0.9)
-  redcarpet
-  representors!
+  redcarpet (~> 3.3)
   rspec (~> 2.14)
-  simplecov (~> 0.7)
-  webmock (~> 1.13.0)
-  yard (~> 0.8.5)
+  simplecov (~> 0.11)
+  webmock (~> 2.0)
+  yard
+
+BUNDLED WITH
+   1.12.5

data/README.md

@@ -15,43 +15,59 @@ a response with a supported Hypermedia media-type and a root that lists availabl
 
 ### A Hypermedia API
 For a interacting with an API (or individual service that supports a list of resources at its root), you enter the
-API and follow your nose using the `enter` method on the agent. This method returns a [Farscape::Representor]() 
-instance with a simple state-machine interface of `attributes` (data) and `transitions` (link/form affordances) for 
+API and follow your nose using the `enter` method on the agent. This method returns a [Farscape::Representor](lib/farscape/representor.rb)
+instance with a simple state-machine interface of `attributes` (data) and `transitions` (link/form affordances) for
 interacting with the resource representations.
 
 ```ruby
-agent = Farscape::Agent.new('http://example.com/my_api')
+agent = Farscape::Agent.instance
 
-resources = agent.enter
+resources = agent.enter('http://example.com/my_api')
 resources.attributes # => { meta: 'data', or: 'other data' }
 resources.transitions.keys # => ['http://example.com/rel/drds', 'http://example.com/rel/leviathans']
 ```
 
 ### A Hypermedia Discovery Service
-For interacting with a discovery service, Farscape supports follow your nose entry to select a registered resource
-or immediately loading a discoverable resource if known to be registered in the service *a priori*.
+For interacting with a discovery service, you can use enter and follow your nose entry to select a registered resource or setup Farscape with a discovery server.
 
 ```ruby
-agent = Farscape::Agent.new('http://example.com/my_discovery_service')
+# Setting discovery service to https://my_discovery_api
+Farscape::Agent.config = { Farscape::Discovery::DISCOVERY_KEY => 'https://my_discovery_api' }
+```
 
-resources = agent.enter
-resources.attributes # => { meta: 'data', or: 'other data' }
-resources.transitions.keys # => ['http://example.com/rel/drds', 'http://example.com/rel/leviathans', 'next', 'last']
+The discovery service must return a document with a list of resource names and their root URLs like:
+
+```json
+{
+  "_links": {
+    "self":  { "href": "https://my_discovery_api" },
+    "boxes": { "href": "https://smallboxesandpoliceboxes.com" },
+    "items": { "href": "https://sonicscrewdriversandotherthings.com/v1/{item}" }
+  }
+}
+```
 
-drds = agent.enter('http://example.com/rel/drds')
-drds.attributes # => { total_count: 25, items: [...] }
-drds.transitions.keys # => ['self', 'search', 'create', 'next', 'last']
+Farscape then can be used directly with resource names. Farscape will already do the heavy-lifting of contacting the discovery service and retrieving the root document of the resource.
 
-agent.enter('http://example.com/rel/unknown_resource') # => raises Farscape::Agent::UnknownEntryPoint
+```ruby
+agent = Farscape::Agent.instance
+boxes = agent.enter('boxes')
+boxes.attributes # => { total_count: 13, items: [...] }
+
+agent.enter('unknownresource') # raises Farscape::Discovery::NotFound
+
+agent.enter('items', [{ items: 'bow-tie' }]) # Allows template variables
 ```
 
+
+
 ## API Interaction
-Entering an API takes you into its application state-machine and, as such, the interface for interacting with that 
-application state is brain dead simple with Farscape. You have data that you read and hypermedia affordances that tell 
+Entering an API takes you into its application state-machine and, as such, the interface for interacting with that
+application state is brain dead simple with Farscape. You have data that you read and hypermedia affordances that tell
 you what you can do next and you can invoke those affordances to do things. That's it.
 
-Farscape recognizes a number of media-types that support runtime knowledge of the underlying REST uniform-interface 
-methods. For these full-featured media-types, the interaction with with resources is as simple as a browser where 
+Farscape recognizes a number of media-types that support runtime knowledge of the underlying REST uniform-interface
+methods. For these full-featured media-types, the interaction with with resources is as simple as a browser where
 implementation of requests is completely abstracted from the user.
 
 The following simple examples highlight interacting with resource state-machines using Farscape.
@@ -128,7 +144,7 @@ new_drd.attributes # => { name: 'Pike' }
 new_drd.transitions.keys # => ['self', 'edit', 'delete', 'deactivate', 'leviathan']
 ```
 
-For more examples and information on using Faraday with media-types that require specifying uniform-interface methods 
+For more examples and information on using Faraday with media-types that require specifying uniform-interface methods
 and other protocol idioms when invoking transitions, see [Using Farscape]().
 
 ## Alternate Interface

data/lib/farscape/agent.rb

@@ -1,16 +1,32 @@
 require 'farscape/representor'
 require 'farscape/clients'
+require 'farscape/discovery'
 
 module Farscape
   class Agent
-    
+
     include BaseAgent
-    
+
     PROTOCOL = :http
 
     attr_reader :media_type
     attr_reader :entry_point
-    
+
+    class << self
+      # Prevents multiple threads from accessing the same agent.
+      def instance
+        Thread.current[:farscape_agent] ||= Agent.new
+      end
+
+      def config
+        @farscape_config || {}
+      end
+
+      def config=(farscape_config)
+        @farscape_config = farscape_config
+      end
+    end
+
     def initialize(entry = nil, media = :hale, safe = false, plugin_hash = {})
       @entry_point = entry
       @media_type = media
@@ -23,10 +39,19 @@ module Farscape
       safe? ? SafeRepresentorAgent : RepresentorAgent
     end
 
-    def enter(entry = entry_point)
-      @entry_point ||= entry
+    # Discovers provided a key and template_variables.
+    # This method is here to be easily overwritten or monkey-patched if needed.
+    def discover_entry_point(key, template_variables = {})
+      Discovery.new.discover(self.class.config, key, template_variables)
+    end
+
+    def enter(entry = entry_point, template_variables = {})
       raise "No Entry Point Provided!" unless entry
-      response = client.invoke(url: entry, headers: get_accept_header(media_type))
+      @entry_point ||= entry
+      unless Addressable::URI.parse(@entry_point).absolute?
+        @entry_point = discover_entry_point(@entry_point, template_variables)
+      end
+      response = client.invoke(url: @entry_point, headers: get_accept_header(media_type))
       find_exception(response)
     end
 
@@ -100,7 +125,7 @@ module Farscape
     end
 
     private
-    
+
     def default_plugin_hash
       {
         plugins: Farscape.plugins.dup,  # A hash of plugins keyed by the plugin name

data/lib/farscape/discovery.rb

@@ -0,0 +1,32 @@
+module Farscape
+  # This class provide discovery capabilities to Farscape.
+  class Discovery
+
+    DISCOVERY_KEY = :discovery_uri
+
+    class NotFound < NameError
+    end
+
+    # This is the simplest type of discovery. We assume that the url we will call will provide us
+    # document with links which keys are the names we want to discover and hrefs are root URLS.
+    # Templated URLs are supported, an exception will be raised if the template does not match the variables.
+    #       {
+    #        "_links": {
+    #          "boxes": { "href": "https://smallboxesandpoliceboxes.com" },
+    #          "items": { "href": "https://sonicscrewdriversandotherthings.com/v1/{item}" }
+    #        }
+    #      }
+    def discover(config, key, url_template_variables)
+      discovery_uri = config[DISCOVERY_KEY]
+      raise NotFound, "No discovery uri setup for Farscape. Discovery of #{key} unavailable" unless discovery_uri
+      raise NotFound, "Discover URL #{discovery_uri} is not a valid URL." unless discovery_uri =~ URI::regexp
+      discovery_document = Farscape::Agent.new(discovery_uri).enter
+      if discovery_document.kind_of?(Faraday::Response) # Parse errors give us a raw Faraday Response
+        raise NotFound, "The discovery document for #{key} is not valid JSON. We got: #{discovery_document.body}"
+      end
+      found = discovery_document.transitions[key.to_s]
+      raise NotFound, "No key '#{key}' found in the response from the discovery service." unless found
+      found.uri(url_template_variables)
+    end
+  end
+end

data/lib/farscape/platform_resources.rb

@@ -0,0 +1,95 @@
+module Farscape
+  class PlatformResources
+    ROOT_ITEMS_KEY = 'items'.freeze
+
+    class NotFound < StandardError; end
+
+    def self.agent
+      @agent ||= Agent.new # This is only done once in the application because is expensive
+      # @agent is global to the application. We dup it so each thread has its own copy
+      Thread.current[:farscape_agent] ||= @agent.dup
+    end
+
+    def self.root_for(resource_name, template_variables = {})
+      rescuing_farscape(resource_name) do
+        Farscape.logger.info("Discovering #{resource_name} providing data >#{template_variables}<")
+        root = agent.discover(resource_name, template_variables)
+        Farscape.logger.info("Accessing the root #{root} for #{resource_name}")
+        agent.instance_variable_set(:@entry_point, root)
+        agent.enter(root)
+      end
+    end
+
+    def self.items_for(resource_name, template_variables = {})
+      root_document = root_for(resource_name, template_variables)
+      attributes = root_document_data(resource_name, root_document)
+      attributes[ROOT_ITEMS_KEY] || []
+    end
+
+    def self.root_document_data(resource_name, root_document)
+      if root_document.respond_to?(:attributes)
+        Farscape.logger.debug("Called #{resource_name} and got #{root_document.attributes[ROOT_ITEMS_KEY]}")
+        root_document.attributes
+      elsif root_document.respond_to?(:body) # Farscape will happily return a Faraday Response when it can not be parsed
+        Farscape.logger.error("The document retrieved for #{resource_name} is not valid JSON. We got: >#{root_document.body}<")
+        {}
+      else
+        Farscape.logger.error("Unknown response trying to access #{resource_name}. We got: >#{root_document}<")
+        {}
+      end
+    rescue StandardError => e
+      log_error("Error accessing the attributes on the root of #{resource_name}", e)
+      {}
+    end
+
+    def self.rescuing_farscape(resource_name)
+      yield
+    rescue Net::ReadTimeout => e
+      log_error("Network read error accessing #{resource_name}", e)
+    rescue Farscape::Exceptions::NotFound => e
+      log_error("Resource not found accessing #{resource_name}", e)
+    rescue Farscape::Exceptions::Forbidden => e
+      log_error("Forbidden access accessing #{resource_name}", e)
+    rescue Farscape::Exceptions::InternalServerError => e
+      log_error("The server responded with an internal server error when accessing #{resource_name}", e)
+    rescue Farscape::Discovery::KeyNotFound => e
+      log_error("The resource #{resource_name} is not registered in our Hypermedia discovery service", e)
+    rescue StandardError => e
+      Farscape.logger.error("Unknown error class '#{e.class}'")
+      log_error("Unknown error accessing #{resource_name}", e)
+    end
+
+    # This is a simple wrapper over Farscape::Agent which provides access to the URL on the enter method.
+    # Recreating the agent is very costly. As it tries to load the plugins and these may be heavy
+    # Specially the discovery service plugin is trying to load a file from disk every single time.
+    # We need to access a variable inside farscape to reuse the agent more than once.
+    # Once Farscape has a version which let us reuse the agent we will delete this helper.
+    class Agent
+      def initialize
+        @agent = Farscape::Agent.new
+      end
+
+      def enter(root)
+        @agent.instance_variable_set(:@entry_point, root)
+        @agent.enter(root)
+      end
+
+      def discover(resource_name, template_variables)
+        if @agent.respond_to?(:discover)
+          @agent.discover(resource_name)
+        else
+          @agent.enter(resource_name)
+        end
+      end
+
+      def method_missing(name, *args, &block)
+        @agent.send(name, *args, &block)
+      end
+    end
+
+    def self.log_error(message, e)
+      Farscape.logger.error("Hippocrates Error, class #{e.class} \n #{message}: '#{e.message}' \n #{e.backtrace.join("\n")}")
+      nil
+    end
+  end
+end

data/lib/farscape/version.rb

@@ -1,6 +1,6 @@
 # Used to prevent the class/module from being loaded more than once
 unless defined?(::Farscape::VERSION)
   module Farscape
-    VERSION = '1.2.0'.freeze
+    VERSION = '1.3.0'.freeze
   end
 end

data/spec/lib/farscape/agent_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe Farscape::Agent do
+  describe '#instance' do
+    it 'returns an Farscape::Agent object' do
+      expect(described_class.instance.class).to eq(described_class)
+    end
+
+    it 'returns the same agent if called twice' do
+      agent1 = described_class.instance
+      expect(described_class.instance).to eq(agent1)
+    end
+  end
+
+  describe '#config' do
+    it 'defaults to an empty hash' do
+      expect(described_class.config).to eq({})
+    end
+
+    it 'can be set' do
+      described_class.config = { me: 'too' }
+      expect(described_class.config).to eq( me: 'too' )
+      described_class.config = nil
+    end
+  end
+end

data/spec/lib/farscape/integration/entry_point_spec.rb

@@ -3,6 +3,42 @@ require 'spec_helper'
 describe Farscape::Agent do
   let(:entry_point) { "http://localhost:#{RAILS_PORT}"}
 
+  describe '#discover' do
+    let(:resource_name) { 'user' }
+    let(:links) do
+      {
+        _links: {
+          resource_name => { href: entry_point }
+        }
+      }
+    end
+    before do
+      described_class.config = { discovery_uri: "https://www.example.com" }
+      stub_request(:any, "https://www.example.com").to_return(body: links.to_json)
+    end
+    after do
+        described_class.config = nil
+    end
+
+    it 'returns a Farscape::Representor from a name' do
+      expect(Farscape::Agent.new(resource_name).enter).to be_a Farscape::RepresentorAgent
+    end
+
+    it 'raises Discovery::NotFound if the name does not exist in the discovery service' do
+      expect{ Farscape::Agent.new('unknown').enter }.to raise_error Farscape::Discovery::NotFound
+    end
+
+    it 'raises Discovery::NotFound if the discovery url is not setup' do
+      described_class.config = nil
+      expect{ Farscape::Agent.new.discover_entry_point(resource_name) }.to raise_error Farscape::Discovery::NotFound
+    end
+
+    it 'raises Discovery::NotFound if the discovery url is not a proper url' do
+      described_class.config = { discovery_uri: "aaaaa" }
+      expect{ Farscape::Agent.new.discover_entry_point(resource_name) }.to raise_error Farscape::Discovery::NotFound
+    end
+  end
+
   describe '#enter' do
     it 'returns a Farscape::Representor' do
       expect(Farscape::Agent.new(entry_point).enter).to be_a Farscape::RepresentorAgent

data/spec/lib/farscape/plugins_spec.rb

@@ -276,7 +276,6 @@ describe Farscape do
         Farscape.register_plugin(name: :Wormlet, type: :discovery, extensions: {Agent: [ServiceCatalogue]})
         expect(Farscape::Agent.new(:moya).enter.transitions.keys).to include("drds")
         expect(Farscape::Agent.new.enter(:moya).transitions.keys).to include("drds")
-        expect { Farscape::Agent.new.omitting(:discovery).enter(:moya).transitions.keys }.to raise_error(NoMethodError)
       end
 
     end

data/spec/spec_helper.rb

@@ -5,6 +5,9 @@ require 'crichton'
 require 'representors'
 require 'moya'
 
+require 'webmock/rspec'
+
+
 RAILS_PORT = 1234
 SPEC_DIR = File.expand_path("..", __FILE__)
 $LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
@@ -12,6 +15,9 @@ require 'farscape'
 
 Dir["#{SPEC_DIR}/support/*.rb"].each { |f| require f }
 
+
+WebMock.disable_net_connect!(allow_localhost: true)
+
 # See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
 RSpec.configure do |config|
   config.treat_symbols_as_metadata_keys_with_true_values = true

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: farscape
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Mark W. Foster
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-05-17 00:00:00.000000000 Z
+date: 2016-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -122,6 +122,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.14'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -171,14 +185,17 @@ files:
 - lib/farscape/client/base_client.rb
 - lib/farscape/client/http_client.rb
 - lib/farscape/clients.rb
+- lib/farscape/discovery.rb
 - lib/farscape/errors.rb
 - lib/farscape/helpers/partially_ordered_list.rb
 - lib/farscape/logger.rb
+- lib/farscape/platform_resources.rb
 - lib/farscape/plugins.rb
 - lib/farscape/representor.rb
 - lib/farscape/transition.rb
 - lib/farscape/version.rb
 - lib/plugins/plugins.rb
+- spec/lib/farscape/agent_spec.rb
 - spec/lib/farscape/cache_spec.rb
 - spec/lib/farscape/integration/entry_point_spec.rb
 - spec/lib/farscape/integration/interface_spec.rb