hello_sign 0.0.5 → 0.1.0

data/lib/hello_sign/account_proxy.rb

@@ -1,8 +1,9 @@
-require 'hello_sign/settings'
+require 'hello_sign/settings_proxy'
 
 module HelloSign
   class AccountProxy
     attr_reader :client
+    attr_writer :settings_proxy_source
 
     def initialize(client)
       @client = client
@@ -12,25 +13,20 @@ module HelloSign
       email    = credentials.fetch(:email)
       password = credentials.fetch(:password)
 
-      create_account(email, password)
-
-      true
+      client.post('/account/create',
+        :body => {:email_address => email, :password => password},
+        :unauthenticated => true
+      )
     end
 
     def settings
-      settings = client.get('/account')
-
-      Settings.new(settings, client)
+      settings_proxy_source.new(client)
     end
 
     private
 
-    def create_account(email, password)
-      client.post(
-        '/account/create',
-        :body => {:email_address => email, :password => password},
-        :unauthenticated => true
-      )
+    def settings_proxy_source
+      @settings_proxy_source || SettingsProxy
     end
 
   end

data/lib/hello_sign/client.rb

@@ -27,8 +27,9 @@ module HelloSign
     def request(method, path, options)
       connection = options[:unauthenticated] ? unauth_connection : auth_connection
       request = connection.send(method) do |request|
-        request.path = "#{API_VERSION}#{path}"
-        request.body = options[:body]
+        request.path   = "#{API_VERSION}#{path}"
+        request.params = options[:params] if options[:params]
+        request.body   = options[:body]
       end
 
       request.body

data/lib/hello_sign/parameters/reusable_form_signature_request.rb

@@ -0,0 +1,41 @@
+module HelloSign
+  module Parameters
+    class ReusableFormSignatureRequest
+      attr_accessor :reusable_form_id, :title, :subject, :message
+      attr_writer :ccs, :signers, :custom_fields
+
+      def ccs
+        @ccs.inject({}) do |parameter, cc|
+          parameter[cc[:role]] = {:email_address => cc[:email]}
+          parameter
+        end
+      end
+
+      def signers
+        @signers.inject({}) do |parameter, signer|
+          parameter[signer[:role]] = {:name => signer[:name], :email_address => signer[:email]}
+          parameter
+        end
+      end
+
+      def custom_fields
+        @custom_fields.inject({}) do |parameter, custom_field|
+          parameter[custom_field[:name]] = custom_field[:value]
+          parameter
+        end
+      end
+
+      def formatted
+        {
+          :reusable_form_id => reusable_form_id,
+          :title            => title,
+          :subject          => subject,
+          :message          => message,
+          :ccs              => ccs,
+          :signers          => signers,
+          :custom_fields    => custom_fields
+        }
+      end
+    end
+  end
+end

data/lib/hello_sign/parameters/signature_request.rb

@@ -0,0 +1,47 @@
+require 'faraday/upload_io'
+
+module HelloSign
+  module Parameters
+    class SignatureRequest
+      attr_accessor :title, :subject, :message, :ccs
+      attr_writer :signers, :files
+
+      def signers
+        @signers.each_with_index.inject({}) do |parameter, (signer, index)|
+          signer = {
+            :name          => signer[:name],
+            :email_address => signer[:email],
+            :order         => index
+          }
+          parameter[index] = signer
+          parameter
+        end
+      end
+
+      def files
+        @files.each_with_index.inject({}) do |parameter, (file, index)|
+          parameter[index + 1] = upload_io.new(file[:io], file[:mime], file[:name])
+          parameter
+        end
+      end
+
+      def formatted
+        {
+          :title              => title,
+          :subject            => subject,
+          :message            => message,
+          :cc_email_addresses => ccs,
+          :signers            => signers,
+          :file               => files
+        }
+      end
+
+      private
+
+      def upload_io
+        Faraday::UploadIO
+      end
+
+    end
+  end
+end

data/lib/hello_sign/settings_proxy.rb

@@ -0,0 +1,20 @@
+require 'hello_sign/client'
+
+module HelloSign
+  class SettingsProxy
+    attr_reader :client
+
+    def initialize(client)
+      @client = client
+    end
+
+    def show
+      client.get('/account')
+    end
+
+    def update(attributes)
+      client.post('/account', :body => attributes)
+    end
+
+  end
+end

data/lib/hello_sign/signature_request_proxy.rb

@@ -1,27 +1,59 @@
-require 'hello_sign/signature_request_parameters'
+require 'hello_sign/parameters/signature_request'
+require 'hello_sign/parameters/reusable_form_signature_request'
 
 module HelloSign
   class SignatureRequestProxy
     attr_reader :client
-    attr_writer :request_parameters
+    attr_writer :request_parameters, :reusable_form_request_parameters
 
     def initialize(client)
       @client = client
     end
 
-    def create(raw_parameters)
-      raw_parameters.call(request_parameters)
-      client.post('/signature_request/send', :body => request_parameters.formatted)
+    def send(params = {})
+      if form_id = params[:form]
+        reusable_form_request_parameters.reusable_form_id = form_id
+        yield reusable_form_request_parameters
+        client.post(
+          '/signature_request/send_with_reusable_form',
+          :body => reusable_form_request_parameters.formatted
+        )
+      else
+        yield request_parameters
+        client.post('/signature_request/send', :body => request_parameters.formatted)
+      end
     end
 
     def status(request_id)
       client.get("/signature_request/#{request_id}")
     end
 
+    def list(params = {})
+      params = {:page => 1}.merge(params)
+      client.get('/signature_request/list', :params => params)
+    end
+
+    def remind(request_id, parameters = {})
+      email = parameters.fetch(:email)
+      client.post("/signature_request/remind/#{request_id}", :body => {:email_address => email})
+    end
+
+    def cancel(request_id)
+      client.post("/signature_request/cancel/#{request_id}")
+    end
+
+    def final_copy(request_id)
+      client.get("/signature_request/final_copy/#{request_id}")
+    end
+
     private
 
     def request_parameters
-      @request_parameters ||= SignatureRequestParameters.new
+      @request_parameters ||= Parameters::SignatureRequest.new
+    end
+
+    def reusable_form_request_parameters
+      @reusable_form_request_parameters ||= Parameters::ReusableFormSignatureRequest.new
     end
 
   end

data/lib/hello_sign/version.rb

@@ -1,3 +1,3 @@
 module HelloSign
-  VERSION = '0.0.5'
+  VERSION = '0.1.0'
 end

data/lib/hello_sign.rb

@@ -11,12 +11,8 @@ module HelloSign
       AccountProxy.new(client)
     end
 
-    def signature_request(request_id = nil, &parameters)
-      if request_id
-        SignatureRequestProxy.new(client).status(request_id)
-      else
-        SignatureRequestProxy.new(client).create(parameters)
-      end
+    def signature_request
+      SignatureRequestProxy.new(client)
     end
 
     def client
@@ -27,5 +23,11 @@ module HelloSign
       yield(self)
     end
 
+    private
+
+    def signature_request_proxy
+      SignatureRequestProxy.new(client)
+    end
+
   end
 end

data/spec/integration/account_spec.rb

@@ -18,7 +18,7 @@ describe HelloSign do
   context "when accessing an account's settings" do
     before do
       stub_get_with_auth('/account')
-      @settings = HelloSign.account.settings
+      HelloSign.account.settings.show
     end
 
     it "fetches the account's settings from the HelloSign API" do
@@ -28,7 +28,6 @@ describe HelloSign do
 
   context "when updating an account's settings" do
     before do
-      stub_get_with_auth('/account')
       stub_post_with_auth('/account')
       HelloSign.account.settings.update(:callback_url => 'http://callmemaybe.com')
     end

data/spec/integration/signature_request_spec.rb

@@ -2,42 +2,136 @@ require 'integration/helper'
 
 describe HelloSign do
   context "when sending a signature request" do
-    let(:text_file_io)  { File.new('spec/fixtures/test.txt') }
-    let(:image_io)      { File.new('spec/fixtures/test.jpg') }
+    context "when not using a reusable form" do
+      let(:text_file_io)  { File.new('spec/fixtures/test.txt') }
+      let(:image_io)      { File.new('spec/fixtures/test.jpg') }
 
-    before do
-      stub_post_with_auth('/signature_request/send')
-      request = HelloSign.signature_request do |request|
-        request.title   = 'Lease'
-        request.subject = 'Sign this'
-        request.message = 'You must sign this.'
-        request.ccs     = ['lawyer@lawfirm.com', 'spouse@family.com']
-        request.signers = [
-          {:name => 'Jack', :email => 'jack@hill.com'},
-          {:name => 'Jill', :email => 'jill@hill.com'}
-        ]
-        request.files   = [
-          {:name => 'test.txt', :io => text_file_io, :mime => 'text/plain'},
-          {:name => 'test.jpg', :io => image_io,     :mime => 'image/jpeg'}
-        ]
+      before do
+        stub_post_with_auth('/signature_request/send')
+        HelloSign.signature_request.send do |request|
+          request.title   = 'Lease'
+          request.subject = 'Sign this'
+          request.message = 'You must sign this.'
+          request.ccs     = ['lawyer@lawfirm.com', 'spouse@family.com']
+          request.signers = [
+            {:name => 'Jack', :email => 'jack@hill.com'},
+            {:name => 'Jill', :email => 'jill@hill.com'}
+          ]
+          request.files   = [
+            {:name => 'test.txt', :io => text_file_io, :mime => 'text/plain'},
+            {:name => 'test.jpg', :io => image_io,     :mime => 'image/jpeg'}
+          ]
+        end
+      end
+
+      it "sends a signature request to the HelloSign API" do
+        expect(a_post_with_auth('/signature_request/send')
+          .with(:headers => {'Content-Type' => /multipart\/form-data/}, :body => /This is a test upload file\./)
+        ).to have_been_made
       end
     end
 
-    it "sends a signature request to the HelloSign API" do
-      expect(a_post_with_auth('/signature_request/send')
-        .with(:headers => {'Content-Type' => /multipart\/form-data/}, :body => /This is a test upload file\./)
-      ).to have_been_made
+    context "when using a reusable form" do
+      before do
+        stub_post_with_auth('/signature_request/send_with_reusable_form')
+        HelloSign.signature_request.send(:form => 'form_id') do |request|
+          request.title         = 'Lease'
+          request.subject       = 'Sign this'
+          request.message       = 'You must sign this.'
+          request.ccs           = [
+            {:email => 'lawyer@lawfirm.com', :role => 'lawyer'},
+            {:email => 'accountant@llc.com', :role => 'accountant'}
+          ]
+          request.signers       = [
+            {:name => 'Jack', :email => 'jack@hill.com', :role => 'consultant'},
+            {:name => 'Jill', :email => 'jill@hill.com', :role => 'client'}
+          ]
+          request.custom_fields = [
+            {:name => 'cost', :value => '$20,000'},
+            {:name => 'time', :value => 'two weeks'}
+          ]
+        end
+      end
+
+      it "sends a signature request using a reusable form to the HelloSign API" do
+        expect(a_post_with_auth('/signature_request/send_with_reusable_form')
+          .with(:body => {
+            :reusable_form_id => 'form_id',
+            :title            => 'Lease',
+            :subject          => 'Sign this',
+            :message          => 'You must sign this.',
+            :ccs              => {
+              'lawyer'     => {:email_address => 'lawyer@lawfirm.com'},
+              'accountant' => {:email_address => 'accountant@llc.com'}
+            },
+            :signers          => {
+              'consultant' => {:name => 'Jack', :email_address => 'jack@hill.com'}, 
+              'client'     => {:name => 'Jill', :email_address => 'jill@hill.com'}
+            },
+            :custom_fields    => {
+              'cost' => '$20,000',
+              'time' => 'two weeks'
+            }
+          })
+        ).to have_been_made
+      end
     end
   end
 
   context "when fetching a signature request" do
     before do
       stub_get_with_auth('/signature_request/request_id')
-      HelloSign.signature_request('request_id')
+      HelloSign.signature_request.status('request_id')
     end
 
     it "fetches the signature request information from the HelloSign API" do
       expect(a_get_with_auth('/signature_request/request_id')).to have_been_made
     end
   end
+
+  context "when getting a list of signature requests" do
+    before do
+      stub_get_with_auth('/signature_request/list?page=1')
+      HelloSign.signature_request.list
+    end
+
+    it "fetches a list of signature requests from the HelloSign API" do
+      expect(a_get_with_auth('/signature_request/list?page=1')).to have_been_made
+    end
+  end
+
+  context "when sending a signature request reminder" do
+    before do
+      stub_post_with_auth('/signature_request/remind/request_id')
+      HelloSign.signature_request.remind('request_id', :email => 'john@johnson.com')
+    end
+
+    it "sends a reminder request to the HelloSign API" do
+      expect(a_post_with_auth('/signature_request/remind/request_id')
+        .with(:body => {:email_address => 'john@johnson.com'})
+      ).to have_been_made
+    end
+  end
+
+  context "when canceling a signature request" do
+    before do
+      stub_post_with_auth('/signature_request/cancel/request_id')
+      HelloSign.signature_request.cancel('request_id')
+    end
+
+    it "sends a signature request cancellation to the HelloSign API" do
+      expect(a_post_with_auth('/signature_request/cancel/request_id')).to have_been_made
+    end
+  end
+
+  context "when fetching a final copy of a signature request" do
+    before do
+      stub_get_with_auth('/signature_request/final_copy/request_id')
+      HelloSign.signature_request.final_copy('request_id')
+    end
+
+    it "fetches a final copy of the signature request from the HelloSign API" do
+      expect(a_get_with_auth('/signature_request/final_copy/request_id')).to have_been_made
+    end
+  end
 end

data/spec/unit/account_proxy_spec.rb

@@ -13,7 +13,9 @@ describe HelloSign::AccountProxy do
 
   describe "#create" do
     context "when passed the proper parameters" do
-      before { client.stub(:post) }
+      let(:api_response) { double('API response') }
+
+      before { client.stub(:post).and_return(api_response) }
 
       it "sends an account creation request" do
         client.should_receive(:post)
@@ -25,8 +27,8 @@ describe HelloSign::AccountProxy do
         account_proxy.create(:email => 'david@bowman.com', :password => 'space')
       end
 
-      it "returns true" do
-        expect(account_proxy.create(:email => 'david@bowman.com', :password => 'space')). to be true
+      it "returns the API response" do
+        expect(account_proxy.create(:email => 'david@bowman.com', :password => 'space')). to eq api_response
       end
     end
 
@@ -38,22 +40,16 @@ describe HelloSign::AccountProxy do
   end
 
   describe "#settings" do
-    let(:settings) { double('settings') }
-
-    before { client.stub(:get).and_return(settings) }
-
-    it "sends a request to fetch the account's settings" do
-      client.should_receive(:get).with('/account')
-      account_proxy.settings
-    end
+    let(:settings_proxy_source) { double('settings proxy source') }
+    let(:settings_proxy)        { double('settings proxy') }
 
-    it "creates an account object" do
-      HelloSign::Settings.should_receive(:new).with(settings, client)
-      account_proxy.settings
+    before do
+      account_proxy.settings_proxy_source = settings_proxy_source
+      settings_proxy_source.should_receive(:new).with(client).and_return(settings_proxy)
     end
 
-    it "returns an account object" do
-      expect(account_proxy.settings).to be_a HelloSign::Settings
+    it "returns a signature request proxy" do
+      expect(account_proxy.settings).to be settings_proxy
     end
   end
 end

data/spec/unit/hello_sign_spec.rb

@@ -9,25 +9,8 @@ describe HelloSign do
   end
 
   describe "::signature_request" do
-    let(:sr_proxy)       { mock }
-    let(:request_result) { stub }
-
-    before { HelloSign::SignatureRequestProxy.stub(:new).and_return(sr_proxy) }
-
-    context "when called without passing a request ID" do
-      before { sr_proxy.should_receive(:create).and_return(request_result) }
-
-      it "calls #create on the signature request proxy and returns the result" do
-        expect(HelloSign.signature_request).to eq request_result
-      end
-    end
-
-    context "when called with a signature ID" do
-      before { sr_proxy.should_receive(:status).with('request_id').and_return(request_result) }
-
-      it "calls #status on the signature request proxy and returns the result " do
-        expect(HelloSign.signature_request('request_id')).to eq request_result
-      end
+    it "returns a signature request proxy" do
+      expect(HelloSign.signature_request).to be_a HelloSign::SignatureRequestProxy
     end
   end
 

data/spec/unit/parameters/reusable_form_signature_request_spec.rb

@@ -0,0 +1,51 @@
+require 'helper'
+require 'hello_sign/parameters/reusable_form_signature_request'
+
+describe HelloSign::Parameters::ReusableFormSignatureRequest do
+  describe "#formatted" do
+    let(:request_parameters) { HelloSign::Parameters::ReusableFormSignatureRequest.new }
+    let(:expected) do
+      {
+        :reusable_form_id => 'form_id',
+        :title            => 'Lease',
+        :subject          => 'Sign this',
+        :message          => 'You must sign this.',
+        :ccs              => {
+          'lawyer'     => {:email_address => 'lawyer@lawfirm.com'},
+          'accountant' => {:email_address => 'accountant@llc.com'}
+        },
+        :signers          => {
+          'consultant' => {:name => 'Jack', :email_address => 'jack@hill.com'}, 
+          'client'     => {:name => 'Jill', :email_address => 'jill@hill.com'}
+        },
+        :custom_fields    => {
+          'cost' => '$20,000',
+          'time' => 'two weeks'
+        }
+      }
+    end
+
+    before do
+      request_parameters.reusable_form_id = 'form_id'
+      request_parameters.title   = 'Lease'
+      request_parameters.subject = 'Sign this'
+      request_parameters.message = 'You must sign this.'
+      request_parameters.ccs     = [
+        {:email => 'lawyer@lawfirm.com', :role => 'lawyer'},
+        {:email => 'accountant@llc.com', :role => 'accountant'}
+      ]
+      request_parameters.signers = [
+        {:name => 'Jack', :email => 'jack@hill.com', :role => 'consultant'},
+        {:name => 'Jill', :email => 'jill@hill.com', :role => 'client'}
+      ]
+      request_parameters.custom_fields = [
+        {:name => 'cost', :value => '$20,000'},
+        {:name => 'time', :value => 'two weeks'}
+      ]
+    end
+
+    it "returns formatted parameters" do
+      expect(request_parameters.formatted).to eq expected
+    end
+  end
+end

data/spec/unit/{signature_request_parameters_spec.rb → parameters/signature_request_spec.rb}

@@ -1,32 +1,17 @@
 require 'helper'
-require 'hello_sign/signature_request_parameters'
+require 'hello_sign/parameters/signature_request'
 
-describe HelloSign::SignatureRequestParameters do
+describe HelloSign::Parameters::SignatureRequest do
   describe "#formatted" do
-    before do
-      Faraday::UploadIO.should_receive(:new).with('text file IO object', 'text/plain', 'test.txt').and_return(text_file = stub)
-      Faraday::UploadIO.should_receive(:new).with('image file IO object', 'image/jpeg', 'test.jpg').and_return(image_file = stub)
-
-      @request_parameters = HelloSign::SignatureRequestParameters.new
-
-      @request_parameters.title   = 'Lease'
-      @request_parameters.subject = 'Sign this'
-      @request_parameters.message = 'You must sign this.'
-      @request_parameters.ccs     = ['lawyer@lawfirm.com', 'spouse@family.com']
-      @request_parameters.signers = [
-        {:name => 'Jack', :email => 'jack@hill.com'},
-        {:name => 'Jill', :email => 'jill@hill.com'}
-      ]
-      @request_parameters.files   = [
-        {:name => 'test.txt', :io => 'text file IO object', :mime => 'text/plain'},
-        {:name => 'test.jpg', :io => 'image file IO object', :mime => 'image/jpeg'}
-      ]
-
-      @expected = {
+    let(:request_parameters) { HelloSign::Parameters::SignatureRequest.new }
+    let(:text_file)          { double('text file') }
+    let(:image_file)         { double('image file') }
+    let(:expected) do
+      {
         :title => 'Lease',
         :subject =>'Sign this',
         :message =>'You must sign this.',
-        :cc_email_addresses => ['lawyer@lawfirm.com', 'spouse@family.com'],
+        :cc_email_addresses => ['lawyer@lawfirm.com', 'spouse@family.com'], # BUGBUG: should have explicit indexes
         :signers => {
           0 => {:name => 'Jack', :email_address => 'jack@hill.com', :order => 0}, 
           1 => {:name => 'Jill', :email_address => 'jill@hill.com', :order => 1}
@@ -35,8 +20,26 @@ describe HelloSign::SignatureRequestParameters do
       }
     end
 
+    before do
+      Faraday::UploadIO.should_receive(:new).with('text file IO object', 'text/plain', 'test.txt').and_return(text_file)
+      Faraday::UploadIO.should_receive(:new).with('image file IO object', 'image/jpeg', 'test.jpg').and_return(image_file)
+
+      request_parameters.title   = 'Lease'
+      request_parameters.subject = 'Sign this'
+      request_parameters.message = 'You must sign this.'
+      request_parameters.ccs     = ['lawyer@lawfirm.com', 'spouse@family.com']
+      request_parameters.signers = [
+        {:name => 'Jack', :email => 'jack@hill.com'},
+        {:name => 'Jill', :email => 'jill@hill.com'}
+      ]
+      request_parameters.files   = [
+        {:name => 'test.txt', :io => 'text file IO object', :mime => 'text/plain'},
+        {:name => 'test.jpg', :io => 'image file IO object', :mime => 'image/jpeg'}
+      ]
+    end
+
     it "returns formatted parameters" do
-      expect(@request_parameters.formatted).to eq @expected
+      expect(request_parameters.formatted).to eq expected
     end
   end
 end

data/spec/unit/settings_proxy_spec.rb

@@ -0,0 +1,29 @@
+require 'helper'
+require 'hello_sign/settings_proxy'
+
+describe HelloSign::SettingsProxy do
+  let(:client)       { double('client') }
+  subject(:settings) { HelloSign::SettingsProxy.new(client) }
+
+  describe "#client" do
+    it "returns the client" do
+      expect(settings.client).to eq client
+    end
+  end
+
+  describe "#update" do
+    let(:callback_url) { 'http://www.callmemaybe.com' }
+    let(:api_response) { double('API response') }
+
+    before { client.stub(:post).and_return(api_response) }
+
+    it "sends a request to update the account's settings" do
+      client.should_receive(:post).with('/account', :body => {:callback_url => callback_url})
+      settings.update(:callback_url => callback_url)
+    end
+
+    it "returns the API response" do
+      expect(settings.update(:callback_url => callback_url)).to be api_response
+    end
+  end
+end

data/spec/unit/signature_request_proxy_spec.rb

@@ -2,8 +2,9 @@ require 'helper'
 require 'hello_sign/signature_request_proxy'
 
 describe HelloSign::SignatureRequestProxy do
-  let(:client)       { mock }
-  let(:api_response) { stub }
+  let(:client)       { double('client') }
+  let(:request_id)   { 'request_id' }
+  let(:api_response) { double('API response') }
   subject(:sr_proxy) { HelloSign::SignatureRequestProxy.new(client) }
 
   describe "#client" do
@@ -12,34 +13,114 @@ describe HelloSign::SignatureRequestProxy do
     end
   end
 
-  describe "#create" do
-    let(:formatted_request_body) { stub }
-    let(:raw_parameters)         { Proc.new { |params| params.foo = 'bar' } }
-    let(:request_parameters)     { mock }
+  describe "#send" do
+    let(:formatted_request_body) { double('formatted request body') }
+    let(:request_parameters)     { double('request parameters') }
 
-    before do
-      sr_proxy.request_parameters = request_parameters
-      request_parameters.stub(:formatted).and_return(formatted_request_body)
-      request_parameters.should_receive(:foo=).with('bar')
-      client.should_receive(:post)
-        .with('/signature_request/send', :body => formatted_request_body)
-        .and_return(api_response)
+    context "when a reusable form is not specified" do
+      before do
+        sr_proxy.request_parameters = request_parameters
+        request_parameters.stub(:formatted).and_return(formatted_request_body)
+        request_parameters.should_receive(:foo=).with('bar')
+        client.should_receive(:post)
+          .with('/signature_request/send', :body => formatted_request_body)
+          .and_return(api_response)
+      end
+
+      it "sends a signature request creation request and returns the result" do
+        expect(sr_proxy.send { |params| params.foo = 'bar' }).to eq api_response
+      end
     end
 
-    it "sends a signature request creation request and returns the result" do
-      expect(sr_proxy.create(raw_parameters)).to eq api_response
+    context "when a reusable form is specified" do
+      before do
+        sr_proxy.reusable_form_request_parameters = request_parameters
+        request_parameters.stub(:formatted).and_return(formatted_request_body)
+        request_parameters.should_receive(:reusable_form_id=).with('form_id')
+        request_parameters.should_receive(:foo=).with('bar')
+        client.should_receive(:post)
+          .with('/signature_request/send_with_reusable_form', :body => formatted_request_body)
+          .and_return(api_response)
+      end
+
+      it "sends a signature request using a reusable form and returns the result" do
+        expect(sr_proxy.send(:form => 'form_id') { |params| params.foo = 'bar' }).to eq api_response
+      end
     end
   end
 
   describe "#status" do
-    let(:request_id) { 'request_id' }
-
-    before do
-      client.should_receive(:get).with('/signature_request/request_id').and_return(api_response)
-    end
+    before { client.should_receive(:get).with('/signature_request/request_id').and_return(api_response) }
 
     it "fetches the signature request status and returns the result" do
       expect(sr_proxy.status(request_id)).to eq api_response
     end
   end
+
+  describe "#list" do
+    context "when called without options" do
+      before { client.should_receive(:get).with('/signature_request/list', :params => {:page => 1}).and_return(api_response) }
+
+      it "fetches the first page of signature requests and returns the result" do
+        expect(sr_proxy.list).to eq api_response
+      end
+    end
+
+    context "when called with a page number" do
+      before { client.should_receive(:get).with('/signature_request/list', :params => {:page => 10}).and_return(api_response) }
+
+      it "fetches a list of signature requests for the passed page number and returns the result" do
+        expect(sr_proxy.list(:page => 10)).to eq api_response
+      end
+    end
+  end
+
+  describe "#remind" do
+    let(:email) { 'john@johnson.com' }
+
+    before { client.stub(:post).and_return(api_response) }
+
+    context "when called with the proper parameters" do
+      it "sends a signature request reminder to the email address" do
+        client.should_receive(:post).with('/signature_request/remind/request_id', :body => {:email_address => email})
+        sr_proxy.remind(request_id, :email => email)
+      end
+
+      it "returns the API response" do
+        expect(sr_proxy.remind(request_id, :email => email)).to eq api_response
+      end
+    end
+
+    context "when called without proper parameters" do
+      it "raises an exception" do
+        expect { sr_proxy.remind(request_id) }.to raise_error
+      end
+    end
+  end
+
+  describe "#cancel" do
+    before { client.stub(:post).and_return(api_response) }
+
+    it "sends a signature request cancellation" do
+      client.should_receive(:post).with('/signature_request/cancel/request_id')
+      sr_proxy.cancel(request_id)
+    end
+
+    it "returns the API response" do
+      expect(sr_proxy.cancel(request_id)).to eq api_response
+    end
+  end
+
+  describe "#final_copy" do
+    before { client.stub(:get).and_return(api_response) }
+
+    it "sends a request to fetch a final copy of the signature request" do
+      client.should_receive(:get).with('/signature_request/final_copy/request_id')
+      sr_proxy.final_copy(request_id)
+    end
+
+    it "returns the API response" do
+      expect(sr_proxy.final_copy(request_id)).to eq api_response
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hello_sign
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-27 00:00:00.000000000 Z
+date: 2013-01-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -84,8 +84,9 @@ extra_rdoc_files: []
 files:
 - lib/hello_sign/account_proxy.rb
 - lib/hello_sign/client.rb
-- lib/hello_sign/settings.rb
-- lib/hello_sign/signature_request_parameters.rb
+- lib/hello_sign/parameters/reusable_form_signature_request.rb
+- lib/hello_sign/parameters/signature_request.rb
+- lib/hello_sign/settings_proxy.rb
 - lib/hello_sign/signature_request_proxy.rb
 - lib/hello_sign/version.rb
 - lib/hello_sign.rb
@@ -100,8 +101,9 @@ files:
 - spec/unit/account_proxy_spec.rb
 - spec/unit/client_spec.rb
 - spec/unit/hello_sign_spec.rb
-- spec/unit/settings_spec.rb
-- spec/unit/signature_request_parameters_spec.rb
+- spec/unit/parameters/reusable_form_signature_request_spec.rb
+- spec/unit/parameters/signature_request_spec.rb
+- spec/unit/settings_proxy_spec.rb
 - spec/unit/signature_request_proxy_spec.rb
 homepage: http://www.github.com/craiglittle/hello_sign
 licenses: []
@@ -139,6 +141,7 @@ test_files:
 - spec/unit/account_proxy_spec.rb
 - spec/unit/client_spec.rb
 - spec/unit/hello_sign_spec.rb
-- spec/unit/settings_spec.rb
-- spec/unit/signature_request_parameters_spec.rb
+- spec/unit/parameters/reusable_form_signature_request_spec.rb
+- spec/unit/parameters/signature_request_spec.rb
+- spec/unit/settings_proxy_spec.rb
 - spec/unit/signature_request_proxy_spec.rb

data/lib/hello_sign/settings.rb

@@ -1,19 +0,0 @@
-require 'hello_sign/client'
-
-module HelloSign
-  class Settings
-    attr_reader :attributes, :client
-
-    def initialize(attributes, client)
-      @attributes = attributes
-      @client     = client
-    end
-
-    def update(attributes)
-      client.post('/account', :body => attributes)
-
-      true
-    end
-
-  end
-end

data/lib/hello_sign/signature_request_parameters.rb

@@ -1,45 +0,0 @@
-require 'faraday/upload_io'
-
-module HelloSign
-  class SignatureRequestParameters
-    attr_accessor :title, :subject, :message, :ccs
-    attr_writer :signers, :files
-
-    def signers
-      @signers.each_with_index.inject({}) do |parameter, (signer, index)|
-        signer = {
-          :name          => signer[:name],
-          :email_address => signer[:email],
-          :order         => index
-        }
-        parameter[index] = signer
-        parameter
-      end
-    end
-
-    def files
-      @files.each_with_index.inject({}) do |parameter, (file, index)|
-        parameter[index + 1] = upload_io.new(file[:io], file[:mime], file[:name])
-        parameter
-      end
-    end
-
-    def formatted
-      {
-        :title              => title,
-        :subject            => subject,
-        :message            => message,
-        :cc_email_addresses => ccs,
-        :signers            => signers,
-        :file               => files
-      }
-    end
-
-    private
-
-    def upload_io
-      Faraday::UploadIO
-    end
-
-  end
-end

data/spec/unit/settings_spec.rb

@@ -1,36 +0,0 @@
-require 'helper'
-require 'hello_sign/settings'
-
-describe HelloSign::Settings do
-  let(:attributes)   { double('attributes') }
-  let(:client)       { double('client') }
-  subject(:settings) { HelloSign::Settings.new(attributes, client) }
-
-  describe "#attributes" do
-    it "returns the attributes" do
-      expect(settings.attributes).to eq attributes
-    end
-  end
-
-  describe "#client" do
-    it "returns the client" do
-      expect(settings.client).to eq client
-    end
-  end
-
-  describe "#update" do
-    let(:callback_url) { 'http://www.callmemaybe.com' }
-
-    before { client.stub(:post) }
-
-    it "sends a request to update the account's settings" do
-      client.should_receive(:post)
-        .with('/account', :body => {:callback_url => callback_url})
-      settings.update(:callback_url => callback_url)
-    end
-
-    it "returns true" do
-      expect(settings.update(:callback_url => callback_url)).to be true
-    end
-  end
-end