ruby_universign 1.1.1 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 643db604dae9b3845c99f1132678a2c389f9437c358c9997d6df73b33885988d
-  data.tar.gz: 1126e1093a85b951c271e09de88d85dce0e5b40828a2d03987f5b273aea8387e
+  metadata.gz: e4146faa8f8d27032db64034d6350a8b01fc48867c1eb34fde2c0b23327022bb
+  data.tar.gz: 89bf6f2025a5ee0f25f93d246a43443780d4c314de35dff59f5e025334d0a69d
 SHA512:
-  metadata.gz: f18d2ed61d73775f401724500f144afc0eee8b3a467bb920ff60fd4f8b729600d99b272a89133bd55f3035954b4561e50ed0057ca35457d2fc51a31267d39c45
-  data.tar.gz: 8d66842d4991b222d394b8253e6b8226797388e5b62d81fe911c47737edd2b983e225c0edc23054ea5f06ee0b5d64670d0c00410b74faff220b72bbbabe4e966
+  metadata.gz: ad3b266194f219e15daeb6a0be93004ebb46ee35dc93ed67ccc1077a6601ae5a91189f0fbd5b5f809c049b05ad98ffe6a284448268e04904c889030b5d20b0e4
+  data.tar.gz: 798fee3c9d80556a8d6dcd4ece8ea5127974e6b16d8075d9ec0fce5bda7f0d7ac3b9f5cc94a2da2e451c505e97db663d1cef759dbe4dfa45532f76b4ac49691e

data/.gitignore

@@ -8,4 +8,6 @@
 /spec/reports/
 /tmp/
 .env
-.idea
+.idea
+*.swp
+*.swo

data/CHANGELOG.md

@@ -1,7 +1,43 @@
-v???
+v1.4.0
 -------------------------
+- Refactor and rename errors. They now all inherit from `Universign::Error`.
 
-- rename gem to `ruby_universign` and `ESign` module to `Universign`
+v1.3.1
+-------------------------
+
+- Fixing regressions added
+
+v1.3.0 - NOT WORKING
+-------------------------
+
+- Adding the possibility to configure proxy and timeout options for the XMLRPC Client
+
+v1.2.1
+-------------------------
+
+- Bumping rake development dependancy due to security issues
+
+v1.2.0
+-------------------------
+
+- Add `chaining_mode` to `Universign::Transaction` options.
+
+v1.1.1
+-------------------------
+
+- bugfix : do not add `name` parameter to SignatureField when it's nil.
+
+v1.1.0
+-------------------------
+
+- SignatureField can be managed with a named field instead of coordinates.
+
+v1.0.0
+-------------------------
+
+- rename gem to `ruby_universign`
+- rename`ESign` module to `Universign`
+- release gem on rubygems
 
 v0.1.6 (26/11/2015)
 -------------------------

data/README.md

@@ -38,9 +38,11 @@ Configuration:
 ```ruby
 # if you're using Rails, put this in an initializer
 Universign.configure do |config|
-  config.endpoint = ENV['UNIVERSIGN_ENDPOINT']
-  config.login    = ENV['UNIVERSIGN_LOGIN']
-  config.password = ENV['UNIVERSIGN_PASSWORD']
+  config.endpoint = 'your_universign_endpoint' # Required ...
+  config.login    = 'your_login' # Required ...
+  config.password = 'your_password' # Required ...
+  config.proxy    = 'your_proxy_uri:your_proxy_port' # Optionnal ...
+  config.timeout  = 30 # Optionnal if you wanna change the default XMLRPC Timeout ...
 end
 ```
 
@@ -83,6 +85,33 @@ transaction = Universign::Transaction.new('9696179e-a43d-4803-beeb-9e5c02fd159b'
 transaction.signed?
 ```
 
+The gem also supports the updated way of creating multiple signature fields per document:
+
+```ruby
+doc_1 = Universign::Document.new(
+  name:    'one.pdf',
+  content: File.open('spec/fixtures/universign-guide-8.8.pdf').read,
+  signature_fields: [
+    Universign::SignatureField.new(coordinate: [20, 20], page: 1, signer_index: 0),
+    Universign::SignatureField.new(coordinate: [80, 20], page: 1, signer_index: 0)
+  ]
+)
+
+doc_2 = Universign::Document.new(
+  name:    'two.pdf',
+  content: File.open('spec/fixtures/universign-guide-8.8.pdf').read,
+  signature_fields: [
+    Universign::SignatureField.new(coordinate: [100, 120], page: 4, signer_index: 0),
+  ]
+)
+
+transaction = Universign::Transaction.create(
+  documents: [doc_1, doc_2],
+  signers:   [signer],
+  options:   { profile: 'default', final_doc_sent: true }
+)
+```
+
 ### `Universign::Document`
 
 It can be created with either your file's content or your file's url.
@@ -118,6 +147,7 @@ handwritten_signature
 profile
 final_doc_sent
 final_doc_requester_sent
+chaining_mode
 ```
 
 Default options are:

data/lib/universign.rb

@@ -10,11 +10,10 @@ require 'universign/transaction'
 require 'universign/signature_field'
 require 'universign/signer_infos'
 require 'universign/transaction_signer'
+require 'universign/error'
 require 'universign/client'
 require 'universign/document'
 require 'universign/configuration'
-require 'universign/error'
 
 module Universign
-  include Error
 end

data/lib/universign/client.rb

@@ -6,7 +6,11 @@ module Universign
     attr_reader :client
 
     def initialize
-      @client          = XMLRPC::Client.new2(Universign.configuration.endpoint)
+      @client          = XMLRPC::Client.new2(
+        Universign.configuration.endpoint,
+        Universign.configuration.proxy,
+        Universign.configuration.timeout
+      )
       @client.user     = Universign.configuration.login
       @client.password = Universign.configuration.password
     end
@@ -18,15 +22,5 @@ module Universign
         super(method, *args, &block)
       end
     end
-
-    #                          _   _
-    #   _____  _____ ___ _ __ | |_(_) ___  _ __  ___
-    #  / _ \ \/ / __/ _ \ '_ \| __| |/ _ \| '_ \/ __|
-    # |  __/>  < (_|  __/ |_) | |_| | (_) | | | \__ \
-    #  \___/_/\_\___\___| .__/ \__|_|\___/|_| |_|___/
-    #                   |_|
-    class InvalidCredentials < StandardError; end
-    class ErrorWhenSigningPDF < StandardError; end
-    class UnknownException < StandardError; end
   end
 end

data/lib/universign/configuration.rb

@@ -1,11 +1,13 @@
 module Universign
   class Configuration
-    attr_accessor :login, :password, :endpoint
+    attr_accessor :login, :password, :endpoint, :proxy, :timeout
 
     def initialize
-      @login    = ''
-      @password = ''
-      @endpoint = ''
+      @login    = nil
+      @password = nil
+      @endpoint = nil
+      @proxy    = nil
+      @timeout  = nil
     end
   end
 

data/lib/universign/document.rb

@@ -75,6 +75,19 @@ module Universign
       params['name'] = data
     end
 
+    def signature_fields=(data)
+      if !data.is_a?(Array)
+        raise 'SignatureFieldsMustBeAnArray'
+      end
+
+      @signature_fields = data
+      params['signatureFields'] = data.map do |d|
+        raise 'BadSignatureFieldType' unless d.instance_of?(SignatureField)
+
+        d.params
+      end
+    end
+
     # The meta data of the PDF document
     #
     # @return [Hash]
@@ -90,27 +103,5 @@ module Universign
       @meta_data         = data
       params['metaData'] = data
     end
-
-    #                          _   _
-    #   _____  _____ ___ _ __ | |_(_) ___  _ __  ___
-    #  / _ \ \/ / __/ _ \ '_ \| __| |/ _ \| '_ \/ __|
-    # |  __/>  < (_|  __/ |_) | |_| | (_) | | | \__ \
-    #  \___/_/\_\___\___| .__/ \__|_|\___/|_| |_|___/
-    #                   |_|
-    class UnknownDocument < StandardError; end
-    class NotSigned < StandardError; end
-    class MissingDocument < StandardError; end
-    class MetaDataMustBeAHash < StandardError; end
-    class DocumentURLInvalid < StandardError
-      attr_accessor :url
-
-      def initialize(url)
-        @url = url
-      end
-
-      def to_s
-        "Can't find document at '#{@url}''"
-      end
-    end
   end
 end

data/lib/universign/error.rb

@@ -1,14 +1,34 @@
 module Universign
-  module Error
-    autoload :Client, 'client'
-    ERROR_CODE = {
-      73002 => Universign::Client::ErrorWhenSigningPDF, # An error occured when signing the PDF document
-      73010 => Universign::Client::InvalidCredentials, # The login and/or password are invalid.
-      73025 => Universign::Document::UnknownDocument, # The used transaction id or custom id is invalid
-      73027 => Universign::Document::NotSigned
-    }
-
-    class UniversignError < StandardError; end
-    class NotEnoughTokens < UniversignError; end
+  class Error < ::StandardError
+    def self.match_class(code)
+      {
+        73002 => Universign::ErrorWhenSigningPDF, # An error occured when signing the PDF document
+        73010 => Universign::InvalidCredentials, # The login and/or password are invalid.
+        73025 => Universign::UnknownDocument, # The used transaction id or custom id is invalid
+        73027 => Universign::DocumentNotSigned
+      }.fetch(code, nil)
+    end
+  end
+
+  class NotEnoughTokens < Error; end
+
+  class ErrorWhenSigningPDF < Error; end
+  class InvalidCredentials < Error; end
+  class UnknownException < Error; end
+
+  class UnknownDocument < Error; end
+  class DocumentNotSigned < Error; end
+  class MissingDocument < Error; end
+  class MetaDataMustBeAHash < Error; end
+  class DocumentURLInvalid < Error
+    attr_accessor :url
+
+    def initialize(url)
+      @url = url
+    end
+
+    def to_s
+      "Can't find document at '#{@url}'"
+    end
   end
 end

data/lib/universign/safeguard.rb

@@ -16,27 +16,27 @@ module Universign
           raise ex
         end
 
-        known_exception = Universign::ERROR_CODE[ex.faultCode]
+        known_exception = Universign::Error.match_class(ex.faultCode)
 
         if known_exception
           raise known_exception
         elsif ex.faultString.include?('Error on document download for this URL')
           url = ex.faultString.match(/<(.+)>/)[1] rescue 'unknown URL'
-          raise Universign::Document::DocumentURLInvalid.new(url)
+          raise Universign::DocumentURLInvalid.new(url)
         elsif ex.faultString.include?('Invalid document URL')
           url = ex.faultString.match(/<(.+)>/)[1] rescue 'unknown URL'
-          raise Universign::Document::DocumentURLInvalid.new(url)
+          raise Universign::DocumentURLInvalid.new(url)
         elsif ex.faultString.include?('Not enough tokens')
           raise Universign::NotEnoughTokens
         elsif ex.faultString.include?('ID is unknown')
-          raise Universign::Document::UnknownDocument
+          raise Universign::UnknownDocument
         else
           handle_exception(ex, callback)
         end
 
       rescue RuntimeError => ex
         if ex.message.include?('Authorization failed')
-          raise Universign::Client::InvalidCredentials
+          raise Universign::InvalidCredentials
         end
         raise ex
       end

data/lib/universign/service/transaction.rb

@@ -11,7 +11,8 @@ module Universign
         handwritten_signature:      :handwrittenSignature,
         profile:                    :profile,
         final_doc_sent:             :finalDocSent,
-        final_doc_requester_sent:   :finalDocRequesterSent
+        final_doc_requester_sent:   :finalDocRequesterSent,
+        chaining_mode:              :chainingMode
       }
 
       DEFAULT_OPTIONS = {

data/lib/universign/signature_field.rb

@@ -2,15 +2,17 @@ module Universign
   class SignatureField
     attr_reader :params
 
-    def initialize(coordinate:, name: nil, page:)
+    def initialize(coordinate:, name: nil, page:, signer_index: 0)
       @coordinate   = coordinate || [0, 0]
       @name         = name
       @page         = page
+      @signer_index = signer_index
 
       @params = {
-        page: @page,
-        x:    @coordinate[0],
-        y:    @coordinate[1]
+        page:          @page,
+        x:             @coordinate[0],
+        y:             @coordinate[1],
+        'signerIndex': @signer_index
       }
 
       @params[:name] = @name unless @name.nil?

data/lib/universign/version.rb

@@ -1,3 +1,3 @@
 module Universign
-  VERSION = "1.1.1"
+  VERSION = "1.5.0"
 end

data/ruby_universign.gemspec

@@ -23,12 +23,13 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.required_ruby_version = '>= 2.0'
+  spec.required_ruby_version = '>= 2.3'
 
   spec.add_runtime_dependency 'activesupport', '>= 4.1'
+  spec.add_runtime_dependency "xmlrpc"
 
-  spec.add_development_dependency "bundler", "~> 1.10"
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "bundler", ">= 1.10"
+  spec.add_development_dependency "rake", ">= 12.3.3"
   spec.add_development_dependency "rspec", "~> 3.0"
   spec.add_development_dependency "dotenv", "~> 2.0"
   spec.add_development_dependency "webmock", "~> 3.0"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_universign
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.5.0
 platform: ruby
 authors:
 - Nicolas Besnard
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-11-29 00:00:00.000000000 Z
+date: 2021-03-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -26,34 +26,48 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '4.1'
+- !ruby/object:Gem::Dependency
+  name: xmlrpc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.10'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 12.3.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 12.3.3
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -161,14 +175,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.0'
+      version: '2.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.2
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Universign's API Wrapper