pdfmonkey 0.3.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f949266c25fee699e6a0a3bde90256f2240e0b866a873034f54b9e31b7e6fa88
-  data.tar.gz: dde8fa07bba2aa84869fd8945183b9cc82eb9b6439054eca030e541503a7e7e4
+  metadata.gz: 0e3a3403ab1a990afe5d3a7ef306b21c03bfba1d49cd5c668a9700dd0e9bc882
+  data.tar.gz: f8db2ef91cc4335ded29af594b690614d58c1228e066d231e0d39626ee73c41f
 SHA512:
-  metadata.gz: 9ef0addfc109cb571ac602b3acf2c783afd61013114e424133c6144c9f375741056421db9ccdaf8a536b6aa87a5257deca76c0152b32892add868a7c57a55752
-  data.tar.gz: 55a890ebe8f847c8cbc0e483d55dcc72a1f7f355cb7a4b3ec66f3488376199887cf0f55ec29894880af2f77f81c2044fda67b7f66909b1d2ac73673719a39648
+  metadata.gz: 165b35b6d11bcf094b9bd95a24a642c19e5b74a8988c03368c77bfca8feddfffff0435eb19e80e0f13aa155790eaf2168d240f58954c4b9406369647a849f185
+  data.tar.gz: ab2b6ba2f1218bd8ffa636fbe89c7f9eea3996740c6fc5a4ec1e8fb2d00dcbbb3b090fd8e74e180c8d39755d6cd22c1b76677128a81c1566c1c0e7694db93d28

data/.travis.yml

@@ -1,11 +1,23 @@
 language: ruby
 
-before_install:
-  - gem install bundler --version '~> 1.17'
+before_install: gem install bundler --version '~> 1.17'
+cache: bundler
+dist: bionic
+
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: jruby-head
+  fast_finish: true
+
+notifications:
+  email: false
+  slack:
+    secure: YimzUcOW2fIo+CyYB5sBgUydS49JNtTIEowyinPAfDifAYgRNx/8c5kPk0aLk8klbnNBd8pMene/i4MIfApRuUmzAkGLe/1CCbotGn7zN7R6S46tpkGaHyMya5leiQemT6gIeL5+J4mQwDcTppXYh9kNTSYKh6RNLJxS7XUZZrNqOK6R2e/hX71aqUJTA5laSQ5mR5Hvyl9kUaJW5b77myXiU6VdrHmCl3sZ9hMqe6mroyBbVOAf1eFQMo7QX9HuLTUHJA2KIpnA7cLEXLINtnKjkhRVR0hcuGMETJhrJI/Ylqi1kf3PRPqkD/Q9msBo01OcRSoGwTjQ2IS1gOcYDowgvpJhkvx2v17fk4j1w3zR5KHSYJlrYOnr+ayU9K3LTs62X8ppVHff6pkKjOEF+p1Mayk/DqbaaH0PnCxqBqJOqZ5kFSkz6y4DDQzVuYILi6qUfgZFQJ01LNR7zbJAI6v9xDqREPG/Bfh7QI5z4eETlZWF9CVX6OARYm43to/wLLg2AEEduoMjexMoIxXRgzsTyBnxKYW3P+0oXWtiH68PXEKF9qAEl8lK4tTjbPBiEgXgUMDWQIiG0y6M567Rg8s8CUiw5ZsQTGJE+9zn4OkM/3VTce1mNLoZPyF66S5sXTPFXjieHCnMS3vegc3OJzLI/Xpx/lPDEU+8CYBaA1I=
 
 rvm:
-  - 2.6
-  - 2.5
-  - 2.4
-  - rbx-3
-  - truffleruby
+- ruby-head
+- 2.6
+- 2.5
+- 2.4
+- jruby-head

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.7.0
+
+* Updating bundler to v2.2
+* Adding `failure_cause`, `generation_logs` and `public_share_link` to the `Document` class
+
+## 0.6.0
+
+* Making the request `User-Agent` header configurable
+
+## 0.5.0
+
+* Adding `Document#filename`
+* Adding `Document.delete` and `Document#delete!`
+
+## 0.4.0
+
+* Adding meta to `Document.generate!` and `Document.generate`
+* Fixing the errors extraction to conform to the current API format
+* Adding `Document.fetch` to retrieve a document
+
 ## 0.3.0
 
 * Adding `Document#done?` to check if a document is complete

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    pdfmonkey (0.3.0)
+    pdfmonkey (0.7.0)
 
 GEM
   remote: https://rubygems.org/
@@ -16,13 +16,13 @@ GEM
     diff-lcs (1.3)
     docile (1.3.1)
     jaro_winkler (1.5.2)
-    json (2.1.0)
+    json (2.3.1)
     parallel (1.12.1)
     parser (2.5.3.0)
       ast (~> 2.4.0)
     powerpack (0.1.2)
     rainbow (3.0.0)
-    rake (10.5.0)
+    rake (13.0.1)
     rspec (3.8.0)
       rspec-core (~> 3.8.0)
       rspec-expectations (~> 3.8.0)
@@ -60,12 +60,12 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
-  bundler (~> 1.17)
+  bundler (~> 2.2)
   coveralls (~> 0.8)
   pdfmonkey!
-  rake (~> 10.0)
+  rake (~> 13.0)
   rspec (~> 3.8)
   rubocop (~> 0.60.0)
 
 BUNDLED WITH
-   1.17.3
+   2.2.30

data/README.md

@@ -50,7 +50,7 @@ Once your App is created in the [PDFMonkey Dashboard](https://dashboard.pdfmonke
 If your want to wait for a Document’s generation before continuing with your workflow, use the `generate!` method, it will request a document generation and wait for it to succeed or fail before giving you any answer.
 
 ```ruby
-tempalte_id = 'b13ebd75-d290-409b-9cac-8f597ae3e785'
+template_id = 'b13ebd75-d290-409b-9cac-8f597ae3e785'
 data = { name: 'John Doe' }
 
 document = Pdfmonkey::Document.generate!(template_id, data)
@@ -72,7 +72,7 @@ PDFMonkey was created with an asynchronous workflow in mind. It provides webhook
 To leverage this behavior and continue working while your Document is generated, use the `generate` method:
 
 ```ruby
-tempalte_id = 'b13ebd75-d290-409b-9cac-8f597ae3e785'
+template_id = 'b13ebd75-d290-409b-9cac-8f597ae3e785'
 data = { name: 'John Doe' }
 
 document = Pdfmonkey::Document.generate(template_id, data)
@@ -94,6 +94,7 @@ curl <url of your app> \
           "created_at": "2020-01-02T03:04:05.000+01:00",
           "document_template_id": "f7fbe2b4-a57c-46ee-8422-5ae8cc37daac",
           "download_url": "https://example.com/76bebeb9-9eb1-481a-bc3c-faf43dc3ac81.pdf",
+          "filename": "76bebeb9-9eb1-481a-bc3c-faf43dc3ac81.pdf",
           "id": "76bebeb9-9eb1-481a-bc3c-faf43dc3ac81",
           "meta": null,
           "payload": "{\"name\": \"John Doe\"}",
@@ -104,6 +105,27 @@ curl <url of your app> \
       }'
 ```
 
+#### Attaching meta data to the document
+
+In addition to the Document’s payload you can add meta data when generating a Document.
+
+This can be done by passing a third argument to the `generate!` and `generate` methods:
+
+```ruby
+meta = {
+  _filename: 'john-doe-contract.pdf',
+  client_id: '123xxx123'
+}
+
+document = Pdfmonkey::Document.generate!(template_id, payload, meta)
+document.meta
+# => '{"_filename":"john-doe-contract.pdf","client_id":"123xxx123"}'
+
+document = Pdfmonkey::Document.generate(template_id, payload, meta)
+document.meta
+# => '{"_filename":"john-doe-contract.pdf","client_id":"123xxx123"}'
+```
+
 #### Error handling
 
 In case of error, be it an HTTP layer error or an API error, `document.status` will be set to `'error'` and `document.error` will contain the error message.
@@ -111,13 +133,13 @@ In case of error, be it an HTTP layer error or an API error, `document.status` w
 ```ruby
 # Using an unknown template
 
-tempalte_id = 'unknown'
+template_id = 'unknown'
 data = { name: 'John Doe' }
 
 document = Pdfmonkey::Document.generate(template_id, data)
 
 document.status # => 'error'
-document.errors # => ["Couldn't find DocumentTemplate with 'id'=unknown"]
+document.errors # => ["Document template must exist"]
 
 # If the network is down
 document = Pdfmonkey::Document.generate(template_id, data)
@@ -126,6 +148,69 @@ document.status # => 'error'
 document.errors # => ["Failed to open TCP connection to api.pdfmonkey.io:443 (getaddrinfo: nodename nor servname provided, or not known)"]
 ```
 
+### Fetching a document
+
+You can fetch an existing document using the `.fetch` method:
+
+```ruby
+document = Pdfmonkey::Document.fetch('76bebeb9-9eb1-481a-bc3c-faf43dc3ac81')
+```
+
+#### Error handling
+
+In case of error, be it an HTTP layer error or an API error, `document.status` will be set to `'error'` and `document.error` will contain the error message.
+
+```ruby
+document = Pdfmonkey::Document.fetch('unknown')
+
+document.status # => 'error'
+document.errors # => ["We couldn't find any Document with ID \"unknown\"..."]
+
+# If the network is down
+document = Pdfmonkey::Document.fetch('95eb0b6e-090b-4195-9b7c-cc3d50099867')
+
+document.status # => 'error'
+document.errors # => ["Failed to open TCP connection to api.pdfmonkey.io:443 (getaddrinfo: nodename nor servname provided, or not known)"]
+```
+
+### Deleting a document
+
+You can delete an existing document using the `.delete` method:
+
+```ruby
+Pdfmonkey::Document.delete('76bebeb9-9eb1-481a-bc3c-faf43dc3ac81')
+#=> true
+```
+
+Alternatively you can call the `#delete!` method:
+
+```ruby
+document.delete!
+#=> true
+```
+
+#### Error handling
+
+In case of error, be it an HTTP layer error or an API error, an error Hash will be returned.
+
+```ruby
+document.delete!
+#=> true
+
+document.delete!
+# {
+#   errors: ["We couldn't find any Document with ID \"11111111-2222-3333-4444-555555555555\". If ..."],
+#   status: "error"
+# }
+
+# If the network is down
+document.delete!
+# {
+#   errors: ["Failed to open TCP connection to api.pdfmonkey.io:443 (getaddrinfo: nodename nor servname provided, or not known)"],
+#   status: "error"
+# }
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/Rakefile

@@ -1,6 +1,20 @@
-require 'bundler/gem_tasks'
+require 'rubygems'
+
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rake'
 require 'rspec/core/rake_task'
 
-RSpec::Core::RakeTask.new(:spec)
+desc "Run all examples"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = %w[--color --require spec_helper]
+end
 
 task default: :spec

data/lib/pdfmonkey/adapter.rb

@@ -11,15 +11,19 @@ module Pdfmonkey
     def call(method, resource)
       response = send_request(method, resource)
 
-      if response.is_a?(Net::HTTPSuccess)
-        extract_attributes(response, resource)
-      else
-        extract_errors(response)
+      case response
+      when Net::HTTPNoContent then true
+      when Net::HTTPSuccess then extract_attributes(response, resource)
+      else extract_errors(response)
       end
     rescue StandardError => e
       { errors: [e.message], status: 'error' }
     end
 
+    private def build_delete_request(uri, _resource)
+      Net::HTTP::Delete.new(uri, headers)
+    end
+
     private def build_get_request(uri, _resource)
       Net::HTTP::Get.new(uri, headers)
     end
@@ -37,13 +41,16 @@ module Pdfmonkey
 
     private def extract_errors(response)
       payload = JSON.parse(response.body)
-      { errors: payload['errors'], status: 'error' }
+      errors = payload['errors'].to_a.map { |error| error['detail'] }
+
+      { errors: errors, status: 'error' }
     end
 
     private def headers
       {
         'Authorization' => "Bearer #{config.private_key}",
-        'Content-Type' => 'application/json'
+        'Content-Type' => 'application/json',
+        'User-Agent' => config.user_agent
       }
     end
 

data/lib/pdfmonkey/configuration.rb

@@ -5,11 +5,13 @@ module Pdfmonkey
     attr_accessor :host
     attr_accessor :namespace
     attr_accessor :private_key
+    attr_accessor :user_agent
 
     def initialize
       @host = 'https://api.pdfmonkey.io'
       @namespace = 'api/v1'
       @private_key = ENV['PDFMONKEY_PRIVATE_KEY']
+      @user_agent = 'Ruby'
     end
   end
 

data/lib/pdfmonkey/document.rb

@@ -15,10 +15,14 @@ module Pdfmonkey
       document_template_id
       download_url
       errors
+      failure_cause
+      filename
+      generation_logs
       id
       meta
       payload
       preview_url
+      public_share_link
       status
       updated_at
     ].freeze
@@ -30,15 +34,24 @@ module Pdfmonkey
     attr_reader :attributes
     def_delegators :attributes, *ATTRIBUTES
 
-    def self.generate!(document_template_id, payload)
-      document = generate(document_template_id, payload)
+    def self.delete(document_id)
+      new(id: document_id).delete!
+    end
+
+    def self.fetch(document_id)
+      new(id: document_id).reload!
+    end
+
+    def self.generate!(document_template_id, payload, meta = {})
+      document = generate(document_template_id, payload, meta)
       document.reload! until document.done?
       document
     end
 
-    def self.generate(template_id, payload)
+    def self.generate(template_id, payload, meta = {})
       document = new(
         document_template_id: template_id,
+        meta: meta.to_json,
         payload: payload.to_json,
         status: 'pending')
 
@@ -51,6 +64,10 @@ module Pdfmonkey
       update(attributes)
     end
 
+    def delete!
+      adapter.call(:delete, self)
+    end
+
     def done?
       COMPLETE_STATUSES.include?(status)
     end

data/lib/pdfmonkey/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pdfmonkey
-  VERSION = '0.3.0'
+  VERSION = '0.7.0'
 end

data/pdfmonkey.gemspec

@@ -22,9 +22,9 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_development_dependency 'bundler', '~> 1.17'
+  spec.add_development_dependency 'bundler', '~> 2.2'
   spec.add_development_dependency 'coveralls', '~> 0.8'
-  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.8'
   spec.add_development_dependency 'rubocop', '~> 0.60.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pdfmonkey
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Simon Courtois
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2019-10-07 00:00:00.000000000 Z
+date: 2021-11-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: '2.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: '2.2'
 - !ruby/object:Gem::Dependency
   name: coveralls
   requirement: !ruby/object:Gem::Requirement
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -110,7 +110,7 @@ homepage: https://github.com/pdfmonkeyio/pdfmonkey-ruby
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -125,8 +125,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.4
-signing_key: 
+rubygems_version: 3.0.3
+signing_key:
 specification_version: 4
 summary: Connect to the PDFMonkey API
 test_files: []