tylerhunt-relax 0.0.5 → 0.1.1

data/lib/relax/parameter.rb

@@ -0,0 +1,19 @@
+module Relax
+  class Parameter
+    attr_reader :name, :options
+    attr_writer :value
+
+    def initialize(name, options={})
+      @name = name
+      @options = options
+    end
+
+    def value
+      @value || @options[:default]
+    end
+
+    def required?
+      @options[:required]
+    end
+  end
+end

data/lib/relax/performer.rb

@@ -0,0 +1,47 @@
+module Relax
+  class Performer
+    def initialize(method, url, values, credentials)
+      @method = method
+      @url = url
+      @values = values
+      @credentials = credentials
+
+      parse_url_tokens
+    end
+
+    def perform
+      case @method
+        when :delete, :get, :head then RestClient.send(@method, url)
+        when :post, :put then RestClient.send(@method, url, query)
+      end
+    end
+
+    def url
+      url = @url.gsub(/\:[a-z_]+/) do |name|
+        @url_values[name[1..-1].to_sym]
+      end
+
+      uri = URI.parse(url)
+      uri.query = query unless query.nil? || query.empty?
+      uri.userinfo = @credentials.join(':') if @credentials
+      uri.to_s
+    end
+    private :url
+
+    def query
+      @values.collect do |name, value|
+        "#{name}=#{value}" if value
+      end.compact.join('&')
+    end
+    private :query
+
+    def parse_url_tokens
+      @url_values = @url.scan(/(?:\:)([a-z_]+)/).flatten.inject({}) do |values, name|
+        name = name.to_sym
+        values[name] = @values.delete(name) if @values.key?(name)
+        values
+      end
+    end
+    private :parse_url_tokens
+  end
+end

data/lib/relax/service.rb

@@ -1,100 +1,33 @@
-require 'openssl'
-require 'net/https'
-require 'uri'
-require 'date'
-require 'base64'
-require 'erb'
-
 module Relax
-  # Service is the starting point for any REST consumer written with Relax. It
-  # is responsible for setting up the endpoint for the service, and issuing the
-  # HTTP requests for each call made.
-  #
-  # == Extending Service
-  #
-  # When writing consumers, you should start by extending Service by inheriting
-  # from it and calling its constructor with the endpoint for the service.
-  #
-  # === Example
-  #
-  #   class Service < Relax::Service
-  #     ENDPOINT = 'http://example.com/services/rest/'
-  #
-  #     def initialize
-  #       super(ENDPOINT)
-  #     end
-  #   end
-  #
-  # == Calling a Service
-  #
-  # Each call made to the service goes through the #call method of Service,
-  # which takes in a Request object and a Response class. The Request object is
-  # used to generate the query string that will be passed to the endpoint. The
-  # Reponse class is instantiated with the body of the response from the HTTP
-  # request.
-  #
-  # === Example
-  #
-  # This example show how to create a barebones call. This module can be then
-  # included into your Service class.
-  #
-  #   module Search
-  #     class SearchRequest < Relax::Request
-  #     end
-  #
-  #     class SearchResponse < Relax::Response
-  #     end
-  #
-  #     def search(options = {})
-  #       call(SearchRequest.new(options), SearchResponse)
-  #     end
-  #   end
-  #
   class Service
-    attr_reader :endpoint
-
-    # This constructor should be called from your Service with the endpoint URL
-    # for the REST service.
-    def initialize(endpoint)
-      @endpoint = URI::parse(endpoint)
+    def initialize(values={})
+      @values = values
     end
 
-    protected
-
-    # Calls the service using a query built from the Request object passed in
-    # as its first parameter. Once the response comes back from the service,
-    # the body of the response is used to instantiate the response class, and
-    # this response object is returned.
-    def call(request, response_class)
-      uri = @endpoint.clone
-      uri.query = query(request).to_s
-      response = request(uri)
-      puts "Response:\n#{response.body}\n\n" if $DEBUG
-      response_class.new(response.body)
+    def authenticate(*args)
+      @credentials = args
+      self
     end
 
-    private
-
-    def default_query
-      Query.new
-    end
+    class << self
+      include Contextable
 
-    def query(request)
-      Query.new(default_query.merge(request.to_query))
-    end
+      def endpoint(url, options={}, &block)
+        Endpoint.new(self, url, options, &block)
+      end
 
-    def request(uri)
-      puts "Request:\n#{uri.to_s}\n\n" if $DEBUG
-      http = Net::HTTP.new(uri.host, uri.port)
+      def register_action(action) # :nodoc:
+        @actions ||= {}
 
-      if uri.scheme == 'https'
-        http.use_ssl = true
-        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
-      end
+        unless @actions[action.name]
+          @actions[action.name] = action.name
 
-      http.start do |http|
-        request = Net::HTTP::Get.new("#{uri.path}?#{uri.query}")
-        http.request(request)
+          define_method(action.name) do |*args|
+            action.execute(@values, @credentials, *args)
+          end
+        else
+          raise ArgumentError.new("Duplicate action '#{action.name}'.") 
+        end
       end
     end
   end

data/spec/relax/context_spec.rb

@@ -0,0 +1,10 @@
+require File.join(File.dirname(__FILE__), '..', 'spec_helper')
+
+describe Relax::Context do
+  
+  it "utilizes a custom parser for Class parsers" do
+    service = ServiceWithCustomParser.new
+    service.test.should == 'parsed'
+  end
+  
+end

data/spec/relax/endpoint_spec.rb

@@ -0,0 +1,99 @@
+require File.join(File.dirname(__FILE__), '..', 'spec_helper')
+
+describe Relax::Endpoint do
+  it "provides access to the URL" do
+    service = Class.new(Relax::Service)
+    endpoint = service.endpoint("http://api.example.com/") { }
+    endpoint.url.should == "http://api.example.com/"
+  end
+
+  it "allows contextual defaults to be set" do
+    service = Class.new(Relax::Service)
+    endpoint = service.endpoint("http://api.example.com/") { }
+    endpoint.should respond_to(:defaults)
+  end
+
+  describe "actions" do
+    it "should check for required values for service defaults" do
+      service = Class.new(Relax::Service) do
+        defaults { parameter :api_key, :required => true }
+        endpoint("http://api.example.com/") { action(:fetch) { } }
+      end
+
+      proc {
+        service.new.fetch
+      }.should raise_error(ArgumentError, /missing.*api_key/i)
+    end
+
+    it "should check for required values for endpoint defaults" do
+      service = Class.new(Relax::Service) do
+        endpoint("http://api.example.com/") do
+          defaults { parameter :operation, :required => true }
+          action(:fetch) { }
+        end
+      end
+
+      proc {
+        service.new.fetch
+      }.should raise_error(ArgumentError, /missing.*operation/i)
+    end
+
+    it "should check for required values for action parameters" do
+      service = Class.new(Relax::Service) do
+        endpoint("http://api.example.com/") do
+          action(:fetch) { parameter :id, :required => true }
+        end
+      end
+
+      proc {
+        service.new.fetch
+      }.should raise_error(ArgumentError, /missing.*id/i)
+    end
+
+    it "should create required parameters from tokens in the endpoint URL" do
+      service = Class.new(Relax::Service) do
+        endpoint("http://api.example.com/:version/") do
+          action(:fetch) { parameter :id }
+        end
+      end
+
+      proc {
+        service.new.fetch
+      }.should raise_error(ArgumentError, /missing.*version/i)
+    end
+
+    it "should replace parameter tokens in the endpoint URL" do
+      service = Class.new(Relax::Service) do
+        endpoint("http://api.example.com/:version/") do
+          action(:fetch) do
+            parameter :id
+            parser(:xml) { attribute :status }
+          end
+        end
+      end
+
+      FakeWeb.register_uri(:get, 'http://api.example.com/v1/', :string => <<-RESPONSE)
+        <?xml version="1.0" encoding="utf-8" ?>
+        <response status="ok" />
+      RESPONSE
+
+      service.new(:version => 'v1').fetch.should == { :status => 'ok' }
+    end
+  end
+
+  describe ".action" do
+    it "is callable from within an Endpoint" do
+      service = Class.new(Relax::Service)
+      endpoint = service.endpoint("http://api.example.com/") { }
+      endpoint.should respond_to(:action)
+    end
+
+    it "defines an instance method by the same name on the Service" do
+      service = Class.new(Relax::Service)
+      service.new.should_not respond_to(:fetch)
+
+      service.endpoint("http://api.example.com/") { action :fetch }
+      service.new.should respond_to(:fetch)
+    end
+  end
+end

data/spec/relax/integration_spec.rb

@@ -0,0 +1,63 @@
+require File.join(File.dirname(__FILE__), '..', 'spec_helper')
+
+describe "an example service's" do
+  describe "get_photos action" do
+    it "includes :get_photos" do
+      Flickr.new.should respond_to(:get_photos)
+    end
+
+    it "requires an API key" do
+      proc {
+        Flickr.new.get_photos
+      }.should raise_error(ArgumentError, /missing.*api_key/i)
+    end
+
+    it "requires a user ID" do
+      proc {
+        Flickr.new(:api_key => 'secret').get_photos
+      }.should raise_error(ArgumentError, /missing.*user_id/i)
+    end
+
+    it "parses the response" do
+      flickr = Flickr.new(:api_key => 'secret')
+      flickr.get_photos(:user_id => '59532755@N00', :per_page => 3).should == {
+        :status => 'ok',
+        :photos => {
+          :total => '7830',
+          :photo => [
+            { :ispublic => '1', :isfriend => '0', :owner => '59532755@N00', :isfamily => '0', :secret => '2ebe0307e3', :server => '3562', :farm => '4', :id => '3508500178', :title => 'Rich Kilmer'},
+            {:ispublic => '1', :isfriend => '0', :owner => '59532755@N00', :isfamily => '0', :secret => '10b217377b', :server => '3593', :farm => '4', :id => '3508500140', :title => 'Women In Rails'},
+            {:ispublic => '1', :isfriend => '0', :owner => '59532755@N00', :isfamily => '0', :secret => '83bc8fbf71', :server => '3620', :farm => '4', :id => '3507688713', :title => 'Obie Fernandez'}
+          ],
+          :per_page => '3',
+          :pages => '2610',
+          :page => '1'
+        }
+      }
+    end
+  end
+
+  describe "get_user_by_username action" do
+    it "includes :get_user_by_username" do
+      Flickr.new.should respond_to(:get_user_by_username)
+    end
+
+    it "requires an API key" do
+      proc {
+        Flickr.new.get_user_by_username
+      }.should raise_error(ArgumentError, /missing.*api_key/i)
+    end
+
+    it "parses the response" do
+      flickr = Flickr.new(:api_key => 'secret')
+      flickr.get_user_by_username(:username => 'duncandavidson').should == {
+        :user => {
+          :username => 'duncandavidson',
+          :nsid => '59532755@N00',
+          :id => '59532755@N00'
+        },
+        :status => 'ok'
+      }
+    end
+  end
+end

data/spec/relax/service_spec.rb

@@ -0,0 +1,32 @@
+require File.join(File.dirname(__FILE__), '..', 'spec_helper')
+
+describe Relax::Service do
+  it "allows contextual defaults to be set" do
+    Relax::Service.should respond_to(:defaults)
+  end
+
+  describe "#authenticate" do
+    it "is callable from within a Service" do
+      Relax::Service.new.should respond_to(:authenticate)
+    end
+
+    it "returns the service" do
+      service = Relax::Service.new
+      service.authenticate('username', 'password').should == service
+    end
+  end
+
+  describe ".endpoint" do
+    it "is callable from within a Service" do
+      Relax::Service.should respond_to(:endpoint)
+    end
+
+    it "creates a new Endpoint" do
+      Relax::Endpoint.should_receive(:new)
+
+      class Service < Relax::Service
+        endpoint "http://api.example.com/"
+      end
+    end
+  end
+end

data/spec/services/flickr.rb

@@ -0,0 +1,78 @@
+class Flickr < Relax::Service
+  defaults do
+    parameter :api_key, :required => true
+  end
+
+  endpoint "http://api.flickr.com/services/rest" do
+    defaults do
+      parameter :method, :required => true
+    end
+
+    action :get_photos do
+      set :method, "flickr.people.getPublicPhotos"
+      parameter :user_id, :required => true
+      parameter :safe_search
+      parameter :extras
+      parameter :per_page
+      parameter :page
+
+      parser :rsp do
+        element :status, :attribute => :stat
+
+        element :photos do
+          element :page, :attribute => true
+          element :pages, :attribute => true
+          element :per_page, :attribute => :perpage
+          element :total, :attribute => true
+
+          elements :photo do
+            element :id, :attribute => true
+            element :owner, :attribute => true
+            element :secret, :attribute => true
+            element :server, :attribute => true
+            element :farm, :attribute => true
+            element :title, :attribute => true
+            element :ispublic, :attribute => true
+            element :isfriend, :attribute => true
+            element :isfamily, :attribute => true
+          end
+        end
+      end
+    end
+
+    action :get_user_by_username do
+      set :method, "flickr.people.findByUsername"
+      parameter :username, :required => true
+
+      parser :rsp do
+        element :status, :attribute => :stat
+
+        element :user do
+          element :id, :attribute => true
+          element :nsid, :attribute => true
+          element :username
+        end
+      end
+    end
+  end
+end
+
+FakeWeb.register_uri(:get, 'http://api.flickr.com/services/rest?api_key=secret&method=flickr.people.findByUsername&username=duncandavidson', :string => <<-RESPONSE)
+  <?xml version="1.0" encoding="utf-8" ?>
+  <rsp stat="ok">
+    <user id="59532755@N00" nsid="59532755@N00">
+      <username>duncandavidson</username>
+    </user>
+  </rsp>
+RESPONSE
+
+FakeWeb.register_uri(:get, 'http://api.flickr.com/services/rest?user_id=59532755@N00&per_page=3&method=flickr.people.getPublicPhotos&api_key=secret', :string => <<-RESPONSE)
+<?xml version="1.0" encoding="utf-8" ?>
+<rsp stat="ok">
+  <photos page="1" pages="2610" perpage="3" total="7830">
+    <photo id="3508500178" owner="59532755@N00" secret="2ebe0307e3" server="3562" farm="4" title="Rich Kilmer" ispublic="1" isfriend="0" isfamily="0" />
+    <photo id="3508500140" owner="59532755@N00" secret="10b217377b" server="3593" farm="4" title="Women In Rails" ispublic="1" isfriend="0" isfamily="0" />
+    <photo id="3507688713" owner="59532755@N00" secret="83bc8fbf71" server="3620" farm="4" title="Obie Fernandez" ispublic="1" isfriend="0" isfamily="0" />
+  </photos>
+</rsp>
+RESPONSE