cloud_convert_merge_pdf 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 34f833e62dc61b2a8eaa74ba5af47dff3127af23
+  data.tar.gz: b83ca855a363a6eb29bc51a471b9da62dd4f6fb0
+SHA512:
+  metadata.gz: cd0ab6a556f3437a07ea511f99b5c6b78016111f8266600b674f8aafb25934adab6758f196b1f3b10b65f11dd363ec2076812f017bc9dcc9d2617ba26530c609
+  data.tar.gz: 023c1b23b1818151ebf5ba86dbf88ecc0d9dbf4eb88b58a9e6bf86a88bccd04de12aa3dd91721a28a8ebb9d02b0da4c688c56d008e7ac17506e9681d20a6c26d

data/README.md

@@ -0,0 +1,50 @@
+# CloudConvertMergePDF
+
+CloudConvertMergePDF is a ruby wrapper for the [Cloud Convert](https://cloudconvert.com/api/combine) combine files to pdf API. The CloudConvert combine to pdf API merge files of any supported file type to a single PDF file.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'cloud_convert_merge_pdf'
+```
+
+And then execute:
+
+    $ bundle
+
+## Basic Usage
+
+Add the following to an initializer file.
+
+```ruby
+CloudConvertMergePdf.configure do |config|
+  config.api_key  = "YOUR CLOUD CONVERT API KEY"
+end
+```
+If you need a file object for the combined pdf:
+```ruby
+CloudConvertMergePdf::Merge.new(files).call
+```
+If you need the url for the combined pdf:
+```ruby
+CloudConvertMergePdf::Merge.new(files, false).call
+```
+
+## Basic Example
+
+```ruby
+files = ['http://www.example.com/1.pdf', 'http://www.example.com/2.pdf']
+merge_obj = CloudConvertMergePdf::Merge.new(files)
+out_file = @client.call # This will return a Tempfile object for the combined pdf
+out_file.unlink # Its a good apporach to unlink the tempfile than leaving it for the garbage collector
+```
+
+## Contributing
+
+Please feel free to contribute to the repository.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/lib/cloud_convert_merge_pdf.rb

@@ -0,0 +1,19 @@
+require 'cloud_convert_merge_pdf/version'
+require 'cloud_convert_merge_pdf/configuration'
+require 'cloud_convert_merge_pdf/merge'
+
+require 'faraday'
+require 'json'
+
+#
+# CloudConvertMergePdf
+#
+# @author sufinsha
+#
+module CloudConvertMergePdf
+  CLOUD_CONVERT_ENDPOINT = 'https://api.cloudconvert.org/'.freeze
+
+  API_KEY_ERROR = 'API Key cant be blank!'.freeze
+
+  CloudConvertMergePdf.configure
+end

data/lib/cloud_convert_merge_pdf/configuration.rb

@@ -0,0 +1,20 @@
+#
+# CloudConvertMergePdf
+#
+# @author sufinsha
+#
+module CloudConvertMergePdf
+  # Configuration
+  class Configuration
+    attr_accessor :api_key
+  end
+
+  class << self
+    attr_accessor :configuration
+  end
+
+  def self.configure
+    self.configuration ||= Configuration.new
+    yield(configuration) if block_given?
+  end
+end

data/lib/cloud_convert_merge_pdf/merge.rb

@@ -0,0 +1,97 @@
+require 'tempfile'
+require 'securerandom'
+
+module CloudConvertMergePdf
+  #
+  # CloudConvertMergePdf::Merge
+  #
+  # @author sufinsha
+  #
+  class Merge
+    attr_reader :download_url
+
+    def initialize(files, download = true)
+      @connection = Faraday.new(
+        url: CloudConvertMergePdf::CLOUD_CONVERT_ENDPOINT
+      )
+      @files = files
+      @can_download = download
+    end
+
+    def call
+      api_key = CloudConvertMergePdf.configuration.api_key
+      return CloudConvertMergePdf::API_KEY_ERROR if api_key.nil?
+
+      fetch_process_url
+      process
+
+      download
+    end
+
+    def fetch_process_url
+      response = @connection.post '/process', process_url_params
+
+      parsed_response = parse_response(response.body)
+
+      @process_url = parsed_response['url']
+    end
+
+    def process
+      response = @connection.post @process_url, process_params
+      parsed_response = parse_response(response.body)
+
+      return nil if parsed_response['output'].nil?
+
+      @download_url = parsed_response['output']['url']
+    end
+
+    def download
+      response = @connection.get @download_url
+
+      return parse_response(response.body) if response.status != 200
+
+      return clean_url(@download_url) unless @can_download
+
+      combined_pdf(response.body)
+    end
+
+    private
+
+    def process_url_params
+      {
+        'apikey' => CloudConvertMergePdf.configuration.api_key,
+        'mode' => 'combine',
+        'inputformat' => 'pdf',
+        'outputformat' => 'pdf'
+      }
+    end
+
+    def process_params
+      {
+        'mode' => 'combine',
+        'input' => 'download',
+        'files' => @files,
+        'outputformat' => 'pdf',
+        'wait' => true
+      }
+    end
+
+    def parse_response(response)
+      JSON.parse(response)
+    end
+
+    def combined_pdf(file_body)
+      file = Tempfile.new("#{SecureRandom.uuid}.pdf")
+      file.puts file_body
+      file.close
+
+      file
+    end
+
+    def clean_url(url)
+      return '' if url.nil? || url.empty?
+
+      url.gsub(%r{^\/\/}, '')
+    end
+  end
+end

data/lib/cloud_convert_merge_pdf/version.rb

@@ -0,0 +1,8 @@
+#
+# CloudConvertMergePdf
+#
+# @author sufinsha
+#
+module CloudConvertMergePdf
+  VERSION = '0.0.0'.freeze
+end

data/test/test_merge.rb

@@ -0,0 +1,16 @@
+require 'minitest/autorun'
+require_relative '../lib/cloud_convert_merge_pdf'
+
+class TestMerge < Minitest::Test
+  FILES = [
+    'https://cloudconvert.com/assets/11e13801/testfiles/pdfexample1.pdf',
+    'https://cloudconvert.com/assets/11e13801/testfiles/pdfexample2.pdf'
+  ].freeze
+
+  def test_nil_api_key
+    assert_equal(
+      CloudConvertMergePdf::Merge.new([]).call,
+      'API Key cant be blank!'
+    )
+  end
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification
+name: cloud_convert_merge_pdf
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- Sufinsha
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-06-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.7.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.7.3
+- !ruby/object:Gem::Dependency
+  name: faraday
+  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: json
+  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'
+description: Ruby Wrapper for CloudConvert Combine files to PDF API.
+email: sufinsha@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/cloud_convert_merge_pdf.rb
+- lib/cloud_convert_merge_pdf/configuration.rb
+- lib/cloud_convert_merge_pdf/merge.rb
+- lib/cloud_convert_merge_pdf/version.rb
+- test/test_merge.rb
+homepage: https://github.com/72pulses/CloudConvertMergePdf
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.3
+signing_key: 
+specification_version: 4
+summary: Ruby Wrapper for CloudConvert Merge PDF API
+test_files: []