mifiel 1.1.1 → 1.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 257016e4e77054c3292a7e7528b1ec9b40767e8d
-  data.tar.gz: 0b9faa1c6348cc9c3dcf13d923c4db0d06def6cc
+  metadata.gz: 6b81aa9ae009760bdbf21c71d2af638956d898e7
+  data.tar.gz: 7b62d15b2abe554804ba41b5eaf9d13fe2a06199
 SHA512:
-  metadata.gz: f51d10e9289b7ef5fdfde4102765a8035dc930ee8f3e53abd14bbde8b6da712873155ba83e1d10253bae355291b515e34a38909595970f25aaa0a0a4b6953ccc
-  data.tar.gz: 2bde1b42e48e6984d020499831998574c62f68da6c4ca6edfbf4122f9ff371ee3a562e494f4dbba05f5e35a70ed153f4e43a23f8d117af89e9fbf2363083cd39
+  metadata.gz: 4aa349459b1752a1e682cd4dc8c959dede12e95b519cda0497b1d6c4cc381b1000c9eb7bf147e983ab6d6166c97ddcfa3638d261ab998352526042d5bcc0bb95
+  data.tar.gz: 484c3f9becf2180f30e3bc11c105ba79e72c764c2ac07632897c6333b52b731c598bd5e566914bfd0ba18e513609322fce3c1d1f6bf45c221f9f99fd508ecefd

data/README.md

@@ -2,6 +2,7 @@
 
 [![Gem Version][gem-version-image]][gem-version-url]
 [![Build Status][travis-image]][travis-url]
+[![Coverage Status][coveralls-image]][coveralls-url]
 [![security][security-image]][security-url]
 
 Ruby SDK for [Mifiel](https://www.mifiel.com) API.
@@ -78,6 +79,17 @@ Document methods:
   )
 ```
 
+- Save Document related files
+
+```ruby
+  # save the original file
+  document.save_file('path/to/save/file.pdf')
+  # save the signed file (original file + signatures page)
+  document.save_file_signed('path/to/save/file-signed.pdf')
+  # save the signed xml file
+  document.save_xml('path/to/save/xml.xml')
+```
+
 - Sign:
   + With a pre-created Certificate
 
@@ -146,7 +158,12 @@ Certificate methods:
 
 [gem-version-image]: https://badge.fury.io/rb/mifiel.svg
 [gem-version-url]: https://badge.fury.io/rb/mifiel
+
 [security-url]: https://hakiri.io/github/Mifiel/ruby-api-client/master
 [security-image]: https://hakiri.io/github/Mifiel/ruby-api-client/master.svg
+
 [travis-image]: https://travis-ci.org/Mifiel/ruby-api-client.svg?branch=master
 [travis-url]: https://travis-ci.org/Mifiel/ruby-api-client
+
+[coveralls-image]: https://coveralls.io/repos/github/Mifiel/ruby-api-client/badge.svg?branch=master
+[coveralls-url]: https://coveralls.io/github/Mifiel/ruby-api-client?branch=master

data/lib/mifiel/document.rb

@@ -17,7 +17,8 @@ module Mifiel
         original_hash: hash,
         name: name
       }
-      process_request('/documents', :post, payload)
+      response = process_request('/documents', :post, payload)
+      JSON.load(response)
     end
 
     def request_signature(email, cc: nil)
@@ -26,7 +27,22 @@ module Mifiel
       Mifiel::Document._request("#{Mifiel.config.base_url}/documents/#{id}/request_signature", :post, params)
     end
 
-    def self.process_request(path, method, payload)
+    def save_file(path)
+      response = Mifiel::Document.process_request("/documents/#{id}/file", :get)
+      File.open(path, 'wb') { |file| file.write(response) }
+    end
+
+    def save_file_signed(path)
+      response = Mifiel::Document.process_request("/documents/#{id}/file_signed", :get)
+      File.open(path, 'wb') { |file| file.write(response) }
+    end
+
+    def save_xml(path)
+      response = Mifiel::Document.process_request("/documents/#{id}/xml", :get)
+      File.open(path, 'w') { |file| file.write(response) }
+    end
+
+    def self.process_request(path, method, payload=nil)
       path[0] = '' if path[0] == '/'
       rest_request = RestClient::Request.new(
         url: "#{Mifiel.config.base_url}/#{path}",
@@ -35,7 +51,7 @@ module Mifiel
         ssl_version: 'SSLv23'
       )
       req = ApiAuth.sign!(rest_request, Mifiel.config.app_id, Mifiel.config.app_secret)
-      JSON.load(req.execute)
+      req.execute
     end
 
     def self.build_signatories(signatories)

data/lib/mifiel/version.rb

@@ -1,3 +1,3 @@
 module Mifiel
-  VERSION = '1.1.1'.freeze
+  VERSION = '1.1.2'.freeze
 end

data/spec/mifiel/document_spec.rb

@@ -19,39 +19,72 @@ describe Mifiel::Document do
     end
   end
 
-  describe '#request_signature' do
+  describe 'working with a document' do
     let!(:document) { Mifiel::Document.all.first }
-    let!(:error_body) { { errors: ['some error'] }.to_json }
 
-    it '' do
-      expect do
-        document.request_signature('some@email.com')
-      end.not_to raise_error
-    end
+    describe '#save_file' do
+      let!(:path) {'tmp/the-file.pdf' }
+      before { File.unlink(path) if File.exist?(path)}
 
-    context 'when bad request' do
-      before do
-        url = %r{mifiel.com\/api\/v1\/documents\/#{document.id}\/request_signature}
-        stub_request(:post, url).to_return(body: error_body, status: 404)
+      it 'should get the file' do
+        document.save_file(path)
+        expect(File.exist?(path)).to be true
       end
+    end
 
-      it '' do
-        expect do
-          document.request_signature('some@email.com')
-        end.to raise_error(Mifiel::BadRequestError)
+    describe '#save_file_signed' do
+      let!(:path) {'tmp/the-file-signed.pdf' }
+      before { File.unlink(path) if File.exist?(path)}
+
+      it 'should get the file' do
+        document.save_file_signed(path)
+        expect(File.exist?(path)).to be true
       end
     end
 
-    context 'when server error' do
-      before do
-        url = %r{mifiel.com\/api\/v1\/documents\/#{document.id}\/request_signature}
-        stub_request(:post, url).to_return(body: error_body, status: 500)
+    describe '#save_xml' do
+      let!(:path) {'tmp/the-xml.xml' }
+      before { File.unlink(path) if File.exist?(path)}
+
+      it 'should get the file' do
+        document.save_xml(path)
+        expect(File.exist?(path)).to be true
       end
+    end
+
+    describe '#request_signature' do
+      let!(:error_body) { { errors: ['some error'] }.to_json }
 
       it '' do
         expect do
           document.request_signature('some@email.com')
-        end.to raise_error(Mifiel::ServerError)
+        end.not_to raise_error
+      end
+
+      context 'when bad request' do
+        before do
+          url = %r{mifiel.com\/api\/v1\/documents\/#{document.id}\/request_signature}
+          stub_request(:post, url).to_return(body: error_body, status: 404)
+        end
+
+        it '' do
+          expect do
+            document.request_signature('some@email.com')
+          end.to raise_error(Mifiel::BadRequestError)
+        end
+      end
+
+      context 'when server error' do
+        before do
+          url = %r{mifiel.com\/api\/v1\/documents\/#{document.id}\/request_signature}
+          stub_request(:post, url).to_return(body: error_body, status: 500)
+        end
+
+        it '' do
+          expect do
+            document.request_signature('some@email.com')
+          end.to raise_error(Mifiel::ServerError)
+        end
       end
     end
   end

data/spec/support/fake_mifiel.rb

@@ -45,6 +45,21 @@ class FakeMifiel < Sinatra::Base
     ).to_json
   end
 
+  get '/api/v1/documents/:id/file' do
+    status 200
+    'some-pdf-formatted-string'
+  end
+
+  get '/api/v1/documents/:id/file_signed' do
+    status 200
+    'some-pdf-formatted-string'
+  end
+
+  get '/api/v1/documents/:id/xml' do
+    status 200
+    '<some><xml>contents</xml></some>'
+  end
+
   post '/api/v1/documents/:id/request_signature' do
     content_type :json
     status 200

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mifiel
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.1.2
 platform: ruby
 authors:
 - Genaro Madrid
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-08-05 00:00:00.000000000 Z
+date: 2016-08-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client