saaspose 0.0.1

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/.rvmrc

@@ -0,0 +1 @@
+rvm 1.9.3@saaspose --create

data/.travis.yml

@@ -0,0 +1,3 @@
+script: "bundle exec rspec"
+rvm:
+  - 1.9.3

data/Gemfile

@@ -0,0 +1,4 @@
+# A sample Gemfile
+source "https://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,44 @@
+PATH
+  remote: .
+  specs:
+    saasposesdk (0.1.0)
+      rest-client (~> 1.6)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.2.7)
+    coderay (1.0.6)
+    crack (0.3.1)
+    diff-lcs (1.1.3)
+    method_source (0.7.1)
+    mime-types (1.18)
+    pry (0.9.9.4)
+      coderay (~> 1.0.5)
+      method_source (~> 0.7.1)
+      slop (>= 2.4.4, < 3)
+    rest-client (1.6.7)
+      mime-types (>= 1.16)
+    rspec (2.9.0)
+      rspec-core (~> 2.9.0)
+      rspec-expectations (~> 2.9.0)
+      rspec-mocks (~> 2.9.0)
+    rspec-core (2.9.0)
+    rspec-expectations (2.9.1)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.9.0)
+    slop (2.4.4)
+    vcr (2.1.1)
+    webmock (1.8.6)
+      addressable (>= 2.2.7)
+      crack (>= 0.1.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  pry (~> 0.9)
+  rspec (~> 2.9)
+  saasposesdk!
+  vcr (~> 2.1)
+  webmock (~> 1.8)

data/README.md

@@ -0,0 +1,79 @@
+#Saaspose.SDK for Ruby Repository
+
+This repository contains Saaspose.SDK for Ruby source code. This SDK allows you to work with Saaspose REST API in your Ruby applications quickly and easily. 
+
+
+##What's included in this SDK repository?
+
+###Code
+
+<table>
+<tr>
+<th>Module</th>
+<th>Description</th>
+</tr>
+
+<tr>
+<td>Common</td>
+<td>This module provides the features commonly used by other sections of the SDK.</td>
+</tr>
+
+<tr>
+<td>Storage</td>
+<td>This module provides the features to work with Saaspose storage.</td>
+</tr>
+
+<tr>
+<td>Pdf</td>
+<td>This module provides the features to manipulate PDF files using Saaspose.Pdf.</td>
+</tr>
+
+<tr>
+<td>Words</td>
+<td>This module provides the features to manipulate Word files using Saaspose.Words.</td>
+</tr>
+
+<tr>
+<td>Cells</td>
+<td>This module provides the features to manipulate Excel files using Saaspose.Cells.</td>
+</tr>
+
+<tr>
+<td>Slides</td>
+<td>This module provides the features to manipulate Powerpoint files using Saaspose.Slides.</td>
+</tr>
+
+<tr>
+<td>BarCode</td>
+<td>This module provides the features to manipulate bar codes using Saaspose.BarCode.</td>
+</tr>
+
+
+</table>
+
+
+
+###Data
+
+In order to manipulate any files, you first need to upload them to the Saaspose storage using Storage module.
+
+###Output
+
+The Saaspose.SDK for Ruby allows you to save the output files at your specified location.
+
+
+###Help Material
+
+You may get help regarding Saaspose API or Saaspose.SDK for Ruby on [www.saaspose.com](http://www.saaspose.com).
+
+##How to use Saaspose.SDK for Ruby?
+
+Please see the Saaaspose.SDK for Ruby Examples sections in the [Documentation](http://www.saaspose.com/docs).
+
+
+
+ 
+
+
+
+

data/lib/saaspose.rb

@@ -0,0 +1,8 @@
+require "saaspose/version"
+require "saaspose/configuration"
+require "saaspose/utils"
+require "saaspose/pdf"
+require "saaspose/slides"
+require "saaspose/words"
+require "saaspose/cells"
+require "saaspose/storage"

data/lib/saaspose/cells.rb

@@ -0,0 +1,10 @@
+module Saaspose
+  class Cells
+    class << self
+      def convert(name, file, options={:format=>:pdf})
+        url = "/cells/#{name}"
+        Utils.call(url, options, file)
+      end
+    end
+  end
+end

data/lib/saaspose/configuration.rb

@@ -0,0 +1,39 @@
+require "logger"
+
+module Saaspose
+  class Configuration
+    class << self
+      attr_accessor :product_uri
+      attr_accessor :app_sid, :app_key
+      attr_accessor :logger
+      attr_accessor :init
+
+      def configure(options={})
+        init_config
+        if block_given?
+          yield self
+        else
+          options.each do |key, value|
+            send(:"#{key}=", value)
+          end
+        end
+        self
+      end
+
+      def reset
+        init_config(true)
+      end
+
+      private
+
+      def init_config(force=false)
+        return if @init && !force
+        @init     = true
+        @product_uri  = ""
+        @app_key      = ""
+        @app_sid      = ""
+        @logger        = Logger.new(STDERR)
+      end
+    end
+  end
+end

data/lib/saaspose/pdf.rb

@@ -0,0 +1,21 @@
+require "rexml/document"
+
+module Saaspose
+  class Pdf
+    class << self
+      def convert(name, local_file, save_image_format, page_number, height, width)
+        url_doc = Configuration.product_uri + '/pdf/' + name + '/pages/' + page_number + '?format=' + save_image_format + '&width=' + width + '&height=' + height
+        signed_url = Utils.sign(url_doc)
+        response = RestClient.get(signed_url, :accept => 'application/json')
+        Utils.save_file(response, local_file)
+      end
+
+      def page_count(name)
+        url_page = Configuration.product_uri + '/pdf/' + name + '/pages'
+        signed_url = Utils.sign(url_page)
+        response = RestClient.get(signed_url, :accept => 'application/xml')
+        REXML::Document.new(response.body).elements.size
+      end
+    end
+  end
+end

data/lib/saaspose/slides.rb

@@ -0,0 +1,12 @@
+module Saaspose
+  class Slides
+    class << self
+      def convert(name, local_file, save_format)
+        url_doc = Configuration.product_uri + '/slides/' + name + '?format=' + save_format
+        signed_url = Utils.sign(url_doc)
+        response = RestClient.get(signed_url, :accept => 'application/json')
+        Utils.save_file(response, local_file)
+      end
+    end
+  end
+end

data/lib/saaspose/storage.rb

@@ -0,0 +1,29 @@
+require "json"
+
+module Saaspose
+  class Storage
+    File = Struct.new(:name, :folder, :modified, :size)
+
+    class << self
+      def upload(local_file_path, remote_folder_path)
+        file_name = ::File.basename(local_file_path)
+        url_file = "#{Configuration.product_uri}/storage/file/#{remote_folder_path.empty? ? "" : "/#{remote_folder_path}" }#{file_name}"
+        signed_url = Utils.sign(url_file)
+        RestClient.put(signed_url, ::File.new(local_file_path, 'rb'))
+      end
+
+      def files(remote_folder_path="")
+        url_folder = "#{Configuration.product_uri}/storage/folder"
+        url_folder << "/#{remote_folder_path}" unless remote_folder_path.empty?
+
+        signed_url  = Utils.sign(url_folder)
+        response    = RestClient.get(signed_url, :accept => 'application/json')
+        result      = JSON.parse(response.body)
+
+        result["Files"].map do |entry|
+          File.new(entry["Name"], entry["IsFolder"], Utils.parse_date(entry["ModifiedDate"]), entry["Size"])
+        end
+      end
+    end
+  end
+end

data/lib/saaspose/utils.rb

@@ -0,0 +1,62 @@
+require 'cgi'
+require 'rest_client'
+require 'openssl'
+require 'base64'
+require 'uri'
+
+module Saaspose
+  class Utils
+    class << self
+      # Signs a URI with your appSID and Key.
+      # * :url describes the URL to sign
+      def sign(url)
+        url = URI.escape(url)
+        parsed_url = URI.parse(url)
+
+        url_to_sign =''
+        if parsed_url.query.nil?
+          url_to_sign = parsed_url.scheme+"://"+ parsed_url.host + parsed_url.path + "?appSID=" + Configuration.app_sid
+        else
+          url_to_sign = parsed_url.scheme+"://"+ parsed_url.host + parsed_url.path + '?' + parsed_url.query + "&appSID=" + Configuration.app_sid
+        end
+
+        # create a signature using the private key and the URL
+        raw_signature = OpenSSL::HMAC.digest(OpenSSL::Digest::Digest.new('sha1'), Configuration.app_key, url_to_sign)
+
+        #Convert raw to encoded string
+        signature = Base64.strict_encode64(raw_signature).tr('+/','-_')
+
+        #remove invalid character
+        signature = signature.gsub(/[=_-]/,'=' => '', '_' => '%2f', '-' => '%2b')
+
+        #Define expression
+        pat = /%[0-9a-f]{2}/
+
+        #Replace the portion matched to the above pattern to upper case
+        6.times do
+          signature = signature.sub(pat, pat.match(signature).to_s.upcase)
+        end
+
+        # prepend the server and append the signature.
+        url_to_sign + "&signature=#{signature}"
+      end
+
+      def parse_date(date_string)
+        seconds_since_epoch = date_string.scan(/[0-9]+/)[0].to_i
+        Time.at((seconds_since_epoch-(21600000 + 18000000))/1000)
+      end
+
+      def call(uri, options, file)
+        url = "#{Configuration.product_uri}#{uri}"
+        url << "?" << options.map{|key, value| "#{key}=#{CGI::escape(value.to_s)}"}.join("&") if options
+        signed_url = Utils.sign(url)
+        response   = RestClient.get(signed_url, :accept => 'application/json')
+        Utils.save_file(response, file)
+      end
+
+      def save_file(response_stream, local_file)
+        File.open(local_file, "wb") { |file| file.write(response_stream.body) }
+      end
+    end
+  end
+end

data/lib/saaspose/version.rb

@@ -0,0 +1,3 @@
+module Saaspose
+  VERSION = "0.0.1"
+end

data/lib/saaspose/words.rb

@@ -0,0 +1,12 @@
+module Saaspose
+  class Words
+    class << self
+      def convert(name, local_file, save_format)
+        urlDoc = Configuration.product_uri + '/words/' + name + '?format=' + save_format
+        signedURL = Utils.sign(urlDoc)
+        response = RestClient.get(signedURL, :accept => 'application/json')
+        Utils.save_file(response, local_file)
+      end
+    end
+  end
+end

data/saaspose.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "saaspose/version"
+
+Gem::Specification.new do |s|
+  s.name        = 'saaspose'
+  s.version     = Saaspose::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.summary     =  s.description = "Ruby bindings to Saaspose REST API"
+  s.authors     = ["Peter Schröder"]
+  s.email       = 'phoetmail@googlemail.com'
+  s.homepage    = 'http://nofail.de'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency 'rest-client', '~> 1.6'
+
+  s.add_development_dependency 'vcr', '~> 2.1'
+  s.add_development_dependency 'webmock', '~> 1.8'
+  s.add_development_dependency 'rspec', '~> 2.9'
+  s.add_development_dependency 'pry', '~> 0.9'
+end

data/spec/lib/saaspose_spec.rb

@@ -0,0 +1,105 @@
+require "spec_helper"
+
+describe "saaspose" do
+  REMOTE_ROOT_DIR = ""
+
+  PNG_PATH = "/tmp/test.png"
+  PDF_PATH = "/tmp/test.pdf"
+
+  TEST_PDF_NAME = "saaspose_test.pdf"
+  TEST_PPT_NAME = "saaspose_test.ppt"
+  TEST_DOC_NAME = "saaspose_test.doc"
+  TEST_XLS_NAME = "saaspose_test.xls"
+
+  before(:all) do
+    configure_client
+    [TEST_PDF_NAME, TEST_PPT_NAME, TEST_DOC_NAME, TEST_XLS_NAME].each { |path| ensure_remote_file(path) }
+  end
+
+  before(:each) do
+    [PNG_PATH, PDF_PATH].each { |path| FileUtils.rm(path) if File.exists?(path) }
+  end
+
+  context "pdf" do
+    it "should generate a png from a remote pdf", :vcr => true do
+      Saaspose::Pdf.convert(TEST_PDF_NAME, PNG_PATH, 'png', '1', '800', '600')
+      File.exists?(PNG_PATH).should be_true
+    end
+
+    it "should read the number of pages from a remote pdf", :vcr => true do
+      Saaspose::Pdf.page_count(TEST_PDF_NAME).should eql(1)
+    end
+  end
+
+  context "slides" do
+    it "should generate a pdf from a remote ppt", :vcr => true do
+      Saaspose::Slides.convert(TEST_PPT_NAME, PDF_PATH, 'pdf')
+      File.exists?(PDF_PATH).should be_true
+    end
+  end
+
+  context "words" do
+    it "should generate a pdf from a remote doc", :vcr => true do
+      Saaspose::Words.convert(TEST_DOC_NAME, PDF_PATH, 'pdf')
+      File.exists?(PDF_PATH).should be_true
+    end
+  end
+
+  context "cells" do
+    it "should generate a pdf from a remote xls", :vcr => true do
+      Saaspose::Cells.convert(TEST_XLS_NAME, PDF_PATH)
+      File.exists?(PDF_PATH).should be_true
+    end
+  end
+
+  context "storage" do
+    let(:folder) { Saaspose::Storage::File.new("test", true, Time.at(1334562314), 0) }
+
+    it "should upload a file to the root dir", :vcr => true do
+      resp = Saaspose::Storage.upload(fixture_path(TEST_PDF_NAME), REMOTE_ROOT_DIR)
+      resp.should match("<Status>OK</Status>")
+    end
+
+    it "should get a list of files from the root dir", :vcr => true do
+      files = Saaspose::Storage.files(REMOTE_ROOT_DIR)
+      files.first.should be_an_instance_of(Saaspose::Storage::File)
+      files.map(&:name).should include(TEST_PDF_NAME)
+      files.first.should eql(folder)
+    end
+  end
+
+  context "utils" do
+    before(:each) do
+      Saaspose::Configuration.configure do |config|
+        config.app_sid = "SAASPOSE_APPSID"
+        config.app_key = "SAASPOSE_APPKEY"
+      end
+    end
+
+    let(:url) { "http://example.com/path?uschi=true&a_param=yes" }
+    it "should sign a uri" do
+      Saaspose::Utils.sign(url).should eql("http://example.com/path?uschi=true&a_param=yes&appSID=SAASPOSE_APPSID&signature=zl%2BjolbjggyKZ31QgflGVILu%2F0I")
+    end
+  end
+end
+
+def configure_client
+  Saaspose::Configuration.configure do |config|
+    config.product_uri = "http://api.saaspose.com/v1.0"
+    config.app_sid     = ENV["SAASPOSE_APPSID"]
+    config.app_key     = ENV["SAASPOSE_APPKEY"]
+  end
+end
+
+def ensure_remote_file(test_file)
+  VCR.use_cassette("ensure_remote_file #{test_file}", :record => :new_episodes, :match_requests_on => [:host, :path]) do
+    unless Saaspose::Storage.files.map(&:name).include?(test_file)
+      puts "uploading #{test_file} for testing purposes"
+      Saaspose::Storage.upload(fixture_path(test_file), REMOTE_ROOT_DIR)
+    end
+  end
+end
+
+def fixture_path(name)
+  File.expand_path("../fixtures/#{name}", File.dirname(__FILE__))
+end