ilovepdf 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ab9733af9742fe03c368936f81761ca6578829d9
-  data.tar.gz: b669af4fc8cabbdbcdfe4878ae410bc9193be00d
+  metadata.gz: 0211e131cc78ddb6b8820c6e0945ab437fb261ee
+  data.tar.gz: 06818cd4287dba2b14133892f1fce8d936ad650f
 SHA512:
-  metadata.gz: 2ec1cbd5795ff1b5cbe7f7f47bb887254fb7ed543cfb0e97fd49c8ff360f76b0fc0a1cfd9d98ba6c19681120116259e71d51afe32558bac760eaae609dd9d854
-  data.tar.gz: aa4ce004721604ac3fe6930ea5a1bace19bd327d60e317612ccf442a3476f3a14dc3e0d7fe0523accafc122cbff05dc4c3822bcafb91ecceb0c044733c1e75a9
+  metadata.gz: 8735a92025a4918ea8ab6dbbaa81242c0a3e00e699eabed76b044c544376e3d19f1378dd70bd1beda9a71638cd2286e67bd61ad98d55c735b18f41e189d9eac4
+  data.tar.gz: 181d5b26c2d02fcffd22f07b0035bf7c458696144d2f3a1375581717ba733411628c84d9682e345a6da1366dd21c07b0a540306e20a361ed14c241846463f88f

data/README.md

@@ -1,5 +1,6 @@
 iLovePDF Api - Ruby Library
 --------------------------
+[![Build Status](https://travis-ci.org/ilovepdf/ilovepdf-php.svg?branch=master)](https://travis-ci.org/ilovepdf/ilovepdf-php)
 [![GitHub version](https://badge.fury.io/gh/ilovepdf%2Filovepdf-ruby.svg)](https://badge.fury.io/gh/ilovepdf%2Filovepdf-ruby)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
@@ -22,6 +23,8 @@ Develop and automate PDF processing tasks like:
 * Stamp a Watermark
 * Repair PDF
 * PDF to PDF/A
+* Validate PDF/A
+* Extract
 
 Each one with several settings to get your desired results.
 
@@ -103,6 +106,15 @@ end
 | packaged_filename                     | This allows you to specify the filename of the compressed file in case there is more than 1 file to be downloaded | |
 | output_filename                       | The final name of the processed file                                |                                   |
 
+#### Methods to query after performing the **execute** API method:
+* result: It has stored the last **Ilovepdf::Response**
+
+#### Methods to query after performing the **download** API method:
+* download_info: Returns a [struct](https://ruby-doc.org/core-2.2.0/Struct.html) with the following info
+  * :output_filename
+  * :output_file
+  * :output_filetype
+
 ### Tool attributes
 
 All tools have specific attributes you can access and modify.

data/lib/ilovepdf.rb

@@ -9,6 +9,7 @@ require 'rest-client'
 # Base classes
 require "ilovepdf/errors"
 require "ilovepdf/response"
+require "ilovepdf/helper"
 require "ilovepdf/ilovepdf"
 require "ilovepdf/file"
 require "ilovepdf/task"
@@ -20,12 +21,15 @@ require 'ilovepdf/tool/merge'
 require 'ilovepdf/tool/officepdf'
 require 'ilovepdf/tool/pagenumber'
 require 'ilovepdf/tool/pdfa'
+require 'ilovepdf/tool/validate_pdfa'
 require 'ilovepdf/tool/pdfjpg'
 require 'ilovepdf/tool/repair'
 require 'ilovepdf/tool/rotate'
 require 'ilovepdf/tool/split'
 require 'ilovepdf/tool/unlock'
 require 'ilovepdf/tool/watermark'
+require 'ilovepdf/tool/protect'
+require 'ilovepdf/tool/extract'
 
 module Ilovepdf
   class << self

data/lib/ilovepdf/errors.rb

@@ -47,5 +47,7 @@ module Ilovepdf
         super("Provided argument is invalid. Valid values: #{valid_values.join(', ')}")
       end
     end
+    class UnsupportedFunctionalityError < ::Ilovepdf::Error
+    end
   end
 end

data/lib/ilovepdf/helper.rb

@@ -0,0 +1,13 @@
+module Ilovepdf
+  module Helper
+    extend self
+
+    def underscore_str(str)
+      str.replace(str.scan(/[A-Z][a-z]*/).join("_").downcase)
+    end
+
+    def camelize_str(str)
+      str.split('_').map(&:capitalize).join
+    end
+  end
+end

data/lib/ilovepdf/ilovepdf.rb

@@ -1,6 +1,6 @@
 module Ilovepdf
   class Ilovepdf
-    attr_accessor :api_version, :token, :encrypt_key ,:debug
+    attr_accessor :api_version, :token, :encrypt_key, :debug, :timeout, :long_timeout
 
     START_SERVER        = 'https://api.ilovepdf.com'.freeze
     API_VERSION         = 'v1'.freeze
@@ -13,10 +13,13 @@ module Ilovepdf
     def initialize(public_key=nil, secret_key=nil)
       set_api_keys(public_key, secret_key)
       api_version = API_VERSION
+      self.timeout = 10
+      self.long_timeout = nil
     end
 
     def new_task(tool_name)
-      task_klass = ::Ilovepdf::Tool.const_get(tool_name.to_s.capitalize) rescue false
+      camelized_name = Helper.camelize_str(tool_name.to_s)
+      task_klass = ::Ilovepdf::Tool.const_get(camelized_name) rescue false
       unless task_klass
         raise ::Ilovepdf::Error.new("Unknown tool '#{tool_name}'. Available tools: #{self.class.all_tool_names.to_s}")
       end
@@ -24,7 +27,7 @@ module Ilovepdf
     end
 
     def self.all_tool_names
-      ::Ilovepdf::Tool.constants.map(&:downcase)
+      ::Ilovepdf::Tool.constants.map{|tool_name| Helper.underscore_str(tool_name.to_s)}
     end
 
     def self.raise_exceptions=(value)
@@ -62,7 +65,7 @@ module Ilovepdf
     def send_request(http_method, endpoint, extra_opts={})
       to_server = worker_server ? worker_server : START_SERVER
 
-      timeout_to_use = LONG_JOB_ENDPOINTS.include?(endpoint.to_sym) ? nil : 10
+      timeout_to_use = LONG_JOB_ENDPOINTS.include?(endpoint.to_sym) ? self.long_timeout : self.timeout
       extra_opts[:body]     ||= {}
       extra_opts[:headers]  ||= {}
 

data/lib/ilovepdf/task.rb

@@ -3,7 +3,10 @@ module Ilovepdf
     attr_accessor :task_id, :tool, :packaged_filename, :output_filename,
                   :ignore_errors, :ignore_password, :try_pdf_repair
 
-    API_PARAMS = []
+    attr_reader :result
+
+    API_PARAMS    = []
+    DOWNLOAD_INFO = [:output_filename, :output_file, :output_filetype]
 
     def initialize(public_key, secret_key)
       super(public_key, secret_key)
@@ -38,8 +41,29 @@ module Ilovepdf
       files.last
     end
 
-    def download(path=nil)
-      download_file(path)
+    def download(path=nil, create_directory: false)
+      download_file
+
+      if path
+        path = Pathname.new(path).to_s if path.is_a?(Pathname)
+        path.chop! if path.end_with? '/'
+      else
+        path = '.'
+      end
+
+      destination = "#{path}/#{download_info.output_filename}"
+      FileUtils.mkdir_p(path) if create_directory
+      ::File.open(destination, 'wb'){|file| file.write(download_info.output_file) }
+      true
+    end
+
+    def blob
+      download_file
+      download_info.output_file
+    end
+
+    def download_info
+      @download_info ||= Struct.new(*DOWNLOAD_INFO).new
     end
 
     # [API Methods] Actions on task
@@ -49,7 +73,7 @@ module Ilovepdf
     end
 
     def execute
-      perform_process_request
+      @result = perform_process_request
     end
 
     def delete!
@@ -87,7 +111,7 @@ module Ilovepdf
       @files = new_array_of_files
     end
 
-    def download_file path
+    def download_file
       response = perform_filedownload_request
       content_disposition = response.headers[:content_disposition]
 
@@ -98,15 +122,9 @@ module Ilovepdf
         filename =  match_data[1].gsub('"', '')
       end
 
-      if path
-        path = Pathname.new(path).to_s if path.is_a?(Pathname)
-        path.chop! if path.end_with? '/'
-      else
-        path = '.'
-      end
-      destination = "#{path}/#{filename}"
-      ::File.open(destination, 'wb'){|file| file.write(response.raw_body) }
-      file = response.raw_body
+      download_info.output_filename  = filename
+      download_info.output_file      = response.raw_body
+      download_info.output_filetype  = ::File.extname(filename)
       true
     end
 

data/lib/ilovepdf/tool/extract.rb

@@ -0,0 +1,18 @@
+module Ilovepdf
+  module Tool
+    class Extract < ::Ilovepdf::Task
+      API_PARAMS = [:detailed]
+      attr_accessor *API_PARAMS
+
+      def initialize(public_key, secret_key)
+        self.tool = :extract
+        super(public_key, secret_key)
+      end
+
+      def detailed
+        @detailed ||= false
+      end
+
+    end
+  end
+end

data/lib/ilovepdf/tool/pagenumber.rb

@@ -9,8 +9,8 @@ module Ilovepdf
 
       attr_accessor *API_PARAMS
 
-      VERTICAL_POSITION_VALUES    = ['bottom', 'top']
-      HORIZONTAL_POSITION_VALUES  = ['left', 'middle', 'right']
+      VERTICAL_POSITION_VALUES    = ['bottom', 'middle' ,'top']
+      HORIZONTAL_POSITION_VALUES  = ['left', 'center', 'right']
       FONT_FAMILY_VALUES          = [ 'Arial', 'Arial Unicode MS', 'Verdana', 'Courier',
                                       'Times New Roman', 'Comic Sans MS',
                                       'WenQuanYi Zen Hei', 'Lohit Marathi'

data/lib/ilovepdf/tool/pdfa.rb

@@ -1,7 +1,7 @@
 module Ilovepdf
   module Tool
     class Pdfa < ::Ilovepdf::Task
-      API_PARAMS = [:conformance]
+      API_PARAMS = [:conformance, :allow_downgrade]
       attr_accessor *API_PARAMS
 
       CONFORMANCE_VALUES = ['pdfa-1b', 'pdfa-1a', 'pdfa-2b', 'pdfa-2u',
@@ -11,6 +11,7 @@ module Ilovepdf
       def initialize(public_key, secret_key)
         self.tool = :pdfa
         super(public_key, secret_key)
+        self.allow_downgrade = true
       end
 
       def conformance= new_val
@@ -19,7 +20,7 @@ module Ilovepdf
       end
 
       def conformance
-        @conformance ||= 'default'
+        @conformance ||= 'pdfa-2b'
       end
     end
   end

data/lib/ilovepdf/tool/validate_pdfa.rb

@@ -0,0 +1,31 @@
+module Ilovepdf
+  module Tool
+    class ValidatePdfa < ::Ilovepdf::Task
+      API_PARAMS = [:conformance]
+      attr_accessor *API_PARAMS
+
+      CONFORMANCE_VALUES = ['pdfa-1b', 'pdfa-1a', 'pdfa-2b', 'pdfa-2u',
+                            'pdfa-2a', 'pdfa-3b', 'pdfa-3u', 'pdfa-3a'
+                           ]
+
+      def initialize(public_key, secret_key)
+        self.tool = :validatepdfa
+        super(public_key, secret_key)
+      end
+
+      def conformance= new_val
+        raise Errors::ArgumentEnumError.new(CONFORMANCE_VALUES) unless CONFORMANCE_VALUES.include? new_val
+        @conformance = new_val
+      end
+
+      def conformance
+        @conformance ||= 'pdfa-2b'
+      end
+
+      private
+      def download_file
+        raise ::Ilovepdf::Errors::UnsupportedFunctionalityError.new('This tool does not download files (Check in the sample files how to use it)')
+      end
+    end
+  end
+end

data/lib/ilovepdf/version.rb

@@ -1,3 +1,3 @@
 module Ilovepdf
-  VERSION = "1.0.1"
+  VERSION = "1.1.0"
 end

data/samples/extract_advanced.rb

@@ -0,0 +1,23 @@
+require "bundler/setup"
+require 'ilovepdf'
+
+# You can call task class directly
+my_task = Ilovepdf::Tool::Extract.new("PUBLIC_KEY", "SECRET_KEY");
+
+# File object keeps information about its server_filename and the properties you can set
+file = my_task.add_file '/path/to/file/document.pdf'
+
+# By setting this parameter to true,
+# we'll have detailed contents extraction into a CSV-formatted file
+my_task.detailed = true
+
+# and set name for output file.
+# the task will set the correct file extension for you.
+my_task.output_filename = 'csv_filename'
+
+# Process files
+response = my_task.execute
+
+# and finally download the file. If no path is set, it will be downloaded on your current working directory
+# It will download a text file with Linux line endings
+my_task.download

data/samples/extract_basic.rb

@@ -0,0 +1,15 @@
+require "bundler/setup"
+require 'ilovepdf'
+
+# You can call task class directly
+my_task = Ilovepdf::Tool::Extract.new("PUBLIC_KEY", "SECRET_KEY");
+
+# File object keeps information about its server_filename and the properties you can set
+file = my_task.add_file '/path/to/file/document.pdf'
+
+# Process files
+response = my_task.execute
+
+# and finally download the file. If no path is set, it will be downloaded on your current working directory
+# It will download a text file with Linux line endings
+my_task.download

data/samples/imagepdf_advanced.rb

@@ -0,0 +1,25 @@
+require "bundler/setup"
+require 'ilovepdf'
+
+# You can call task class directly
+my_task = Ilovepdf::Tool::Imagepdf.new("PUBLIC_KEY", "SECRET_KEY");
+
+# File object keeps information about its server_filename and the properties you can set
+file  = my_task.add_file '/path/to/file/photo.png'
+file2 = my_task.add_file '/path/to/file/image.tiff'
+
+# Merge After: Default is true. If it is false then it will download a zip file with a pdf for each image
+my_task.merge_after = false
+
+# and set name for output file.
+# the task will set the correct file extension for you.
+my_task.output_filename = 'pdf_filename'
+
+# and name for splitted document (inside the zip file)
+my_task.packaged_filename = 'zip_filename'
+
+# Process files
+response = my_task.execute
+
+# and finally download the file. If no path is set, it will be downloaded on your current working directory
+my_task.download

data/samples/imagepdf_basic.rb

@@ -0,0 +1,14 @@
+require "bundler/setup"
+require 'ilovepdf'
+
+# You can call task class directly
+my_task = Ilovepdf::Tool::Imagepdf.new("PUBLIC_KEY", "SECRET_KEY");
+
+# File object keeps information about its server_filename and the properties you can set
+file = my_task.add_file '/path/to/file/photo.png'
+
+# Process files
+response = my_task.execute
+
+# and finally download the file. If no path is set, it will be downloaded on your current working directory
+my_task.download

data/samples/pdfa_advanced.rb

@@ -8,7 +8,10 @@ my_task = Ilovepdf::Tool::Pdfa.new("PUBLIC_KEY", "SECRET_KEY");
 file = my_task.add_file '/path/to/file/document.pdf'
 
 # Set conformance
-file.conformance = 'pdfa-1b'
+my_task.conformance = 'pdfa-2a'
+
+# don't allow downgrading in case your conformance level fails
+file.allow_downgrade = false
 
 # and set name for output file.
 # the task will set the correct file extension for you.

data/samples/pdfa_basic.rb

@@ -7,9 +7,6 @@ my_task = Ilovepdf::Tool::Pdfa.new("PUBLIC_KEY", "SECRET_KEY");
 # File object keeps information about its server_filename and the properties you can set
 file = my_task.add_file '/path/to/file/document.pdf'
 
-# Set conformance
-file.conformance = 'pdfa-1b'
-
 # Finally is time to process the files. i.e We'll send them to Ilovepdf servers :)
 response = my_task.execute
 

data/samples/validatepdfa_advanced.rb

@@ -0,0 +1,18 @@
+require "bundler/setup"
+require 'ilovepdf'
+
+# You can call task class directly
+my_task = Ilovepdf::Tool::ValidatePdfa.new("PUBLIC_KEY", "SECRET_KEY");
+
+# File object keeps information about its server_filename and the properties you can set
+file = my_task.add_file '/path/to/file/document.pdf'
+
+file.conformance = 'pdfa-2a'
+
+# Finally is time to process the files. i.e We'll send them to Ilovepdf servers :)
+response = my_task.execute
+
+response.body['validations'].each do |results|
+  file = my_task.files.find{|file| file.server_filename == results['server_filename']}
+  puts "File with name '#{file.filename}' has the following status: #{results['status']}"
+end

data/samples/validatepdfa_basic.rb

@@ -0,0 +1,16 @@
+require "bundler/setup"
+require 'ilovepdf'
+
+# You can call task class directly
+my_task = Ilovepdf::Tool::ValidatePdfa.new("PUBLIC_KEY", "SECRET_KEY");
+
+# File object keeps information about its server_filename and the properties you can set
+file = my_task.add_file '/path/to/file/document.pdf'
+
+# Finally is time to process the files. i.e We'll send them to Ilovepdf servers :)
+response = my_task.execute
+
+response.body['validations'].each do |results|
+  file = my_task.files.find{|file| file.server_filename == results['server_filename']}
+  puts "File with name '#{file.filename}' has the following status: #{results['status']}"
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ilovepdf
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Leonardo Collazo
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-04-27 00:00:00.000000000 Z
+date: 2017-06-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -146,10 +146,12 @@ files:
 - lib/ilovepdf.rb
 - lib/ilovepdf/errors.rb
 - lib/ilovepdf/file.rb
+- lib/ilovepdf/helper.rb
 - lib/ilovepdf/ilovepdf.rb
 - lib/ilovepdf/response.rb
 - lib/ilovepdf/task.rb
 - lib/ilovepdf/tool/compress.rb
+- lib/ilovepdf/tool/extract.rb
 - lib/ilovepdf/tool/imagepdf.rb
 - lib/ilovepdf/tool/merge.rb
 - lib/ilovepdf/tool/officepdf.rb
@@ -161,10 +163,15 @@ files:
 - lib/ilovepdf/tool/rotate.rb
 - lib/ilovepdf/tool/split.rb
 - lib/ilovepdf/tool/unlock.rb
+- lib/ilovepdf/tool/validate_pdfa.rb
 - lib/ilovepdf/tool/watermark.rb
 - lib/ilovepdf/version.rb
 - samples/compress_advanced.rb
 - samples/compress_basic.rb
+- samples/extract_advanced.rb
+- samples/extract_basic.rb
+- samples/imagepdf_advanced.rb
+- samples/imagepdf_basic.rb
 - samples/merge_advanced.rb
 - samples/merge_basic.rb
 - samples/pdfa_advanced.rb
@@ -179,6 +186,8 @@ files:
 - samples/try_catch_errors.rb
 - samples/unlock_advanced.rb
 - samples/unlock_basic.rb
+- samples/validatepdfa_advanced.rb
+- samples/validatepdfa_basic.rb
 - samples/watermark_advanced.rb
 - samples/watermark_basic.rb
 - uploads/sample_pdf.pdf