saasposesdk 0.0.1

data/lib/saaspose.rb

@@ -0,0 +1,7 @@
+#this file refers all the other necessary files of the saaspose.sdk for Ruby.
+
+require 'saaspose_common'
+require 'saaspose_storage'
+require 'saaspose_cells'
+require 'saaspose_pdf'
+require 'saaspose_slides'

data/lib/saaspose_cells.rb

@@ -0,0 +1,24 @@
+require_relative 'saaspose_storage'
+
+# This module provide wrapper classes to work with Saaspose.Cells resources
+module Cells
+    # This class provides functionality for converting Excel Spreadsheets to other supported formats.
+    class Convertor
+        # Constructor for the Convertor Class.
+        # * :name represents the name of the Excel Spreadsheet on the Saaspose server 		
+        def initialize(name)  
+             # Instance variables   
+             @name = name
+        end
+	     # Uploads file from the local path to the remote folder.
+		 # * :localFile represents full local file path and name
+         # * :saveFormat represents the converted format. For a list of supported formats, please visit 
+		 #  http://saaspose.com/docs/display/cells/workbook		 
+        def convert(localFile,saveFormat)
+		    urlDoc = $productURI + '/cells/' + @name + '?format=' + saveFormat
+		    signedURL = Common::Utils.sign(urlDoc)
+		    response = RestClient.get(signedURL, :accept => 'application/json')
+			Common::Utils.saveFile(response,localFile)
+        end		
+    end  
+end

data/lib/saaspose_common.rb

@@ -0,0 +1,98 @@
+require 'rubygems'
+require 'rest_client'
+require 'json'
+require 'openssl'
+require 'base64'
+require 'uri'
+require 'rexml/document'
+
+# This module provide common classes and methods to be ued by other modules
+module Common
+    
+    # This class allows you to set the base host Saaspose URI
+	class Product
+	    def self.setBaseProductUri(productURI)
+		     $productURI = productURI
+		end
+	end
+
+	# This class allows you to set the AppSID and AppKey values you get upon signing up
+    class SaasposeApp
+         def initialize(appSID,appKey)  
+		     $appSID = appSID
+		     $appKey = appKey
+         end	
+	end
+		
+    # This class provides common methods to be repeatedly used by other wrapper classes
+    class Utils
+	     # Signs a URI with your appSID and Key.
+		 # * :url describes the URL to sign
+         # * :appSID holds the appSID value
+         # * :key holds the key value		 
+         def self.sign(url)
+  	         url = URI.escape(url)
+  	         parsedURL = URI.parse(url)
+  
+  	         urlToSign =''
+  	         if parsedURL.query.nil? 
+		         urlToSign = parsedURL.scheme+"://"+ parsedURL.host + parsedURL.path + "?appSID=" + $appSID
+  	         else
+		         urlToSign = parsedURL.scheme+"://"+ parsedURL.host + parsedURL.path + '?' + parsedURL.query + "&appSID=" + $appSID
+  	         end
+
+  	         # create a signature using the private key and the URL
+  	         rawSignature = OpenSSL::HMAC.digest(OpenSSL::Digest::Digest.new('sha1'), $appKey, urlToSign)
+  
+  	         #Convert raw to encoded string
+  	         signature = Base64.strict_encode64(rawSignature).tr('+/','-_')
+  
+  	         #remove invalid character 
+  	         signature = signature.gsub(/[=_-]/,'=' => '','_' => '%2f','-' => '%2b')
+
+  	         #Define expression
+  	         pat = Regexp.new("%[0-9a-f]{2}")
+
+	         #Replace the portion matched to the above pattern to upper case
+	         for i in 0..5
+  	             signature = signature.sub(pat,pat.match(signature).to_s.upcase)
+	         end
+
+  	         # prepend the server and append the signature.
+  	         signedUrl = urlToSign + "&signature=#{signature}"  
+  	         return signedUrl
+         end
+    
+	     # Parses JSON date value to a valid date format
+		 # * :datestring holds the JSON Date value
+	     def self.parse_date(datestring)
+             seconds_since_epoch = datestring.scan(/[0-9]+/)[0].to_i
+             return Time.at((seconds_since_epoch-(21600000 + 18000000))/1000)
+         end
+
+         # Uploads a binary file from the client system
+		 # * :localfile holds the local file path alongwith name
+		 # * :url holds the required url to use while uploading the file to Saaspose Storage		 
+         def self.uploadFileBinary(localfile,url)
+		     RestClient.put( url,File.new(localfile, 'rb'))
+         end
+         
+         # Gets the count of a particular field in the response
+		 # * :localfile holds the local file path alongwith name
+		 # * :url holds the required url to use while uploading the file to Saaspose Storage		 		 
+	     def self.getFieldCount(url,fieldName)	    
+		     response = RestClient.get(url, :accept => 'application/xml')
+		     doc = REXML::Document.new(response.body)
+		     pages = []		
+		     doc.elements.each(fieldName) do |ele|
+                 pages << ele.text
+             end
+             return pages.size
+	     end
+		 def self.saveFile(responseStream,localFile)
+		     open(localFile, "wb") do |file|
+                 file.write(responseStream.body)
+              end
+		 end
+    end
+end

data/lib/saaspose_pdf.rb

@@ -0,0 +1,34 @@
+require_relative 'saaspose_storage'
+
+# This module provide wrapper classes to work with Saaspose.Pdf resources
+module Pdf
+    # This class provides functionality for converting PDF Documents to other supported formats.
+    class Convertor
+	    # Constructor for the Convertor Class.
+        # * :name represents the name of the PDF Document on the Saaspose server 		
+        def initialize(name)  
+           # Instance variables   
+           @name = name
+        end
+		 # Uploads file from the local path to the remote folder.
+		 # * :localFile represents full local file path and name
+         # * :saveImageFormat represents the converted image format. For a list of supported image formats, please visit 
+		 #  http://saaspose.com/docs/display/pdf/page
+         # * :pageNumber represents the page number in the PDF document
+         # * :height represents height of the converted image
+         # * :width represents width of the converted image 		 
+        def convert(localFile,saveImageFormat,pageNumber,height,width)
+		    urlDoc = $productURI + '/pdf/' + @name + '/pages/' + pageNumber + '?format=' + saveImageFormat + '&width=' + width + '&height=' + height
+		    signedURL = Common::Utils.sign(urlDoc)
+		    response = RestClient.get(signedURL, :accept => 'application/json')
+			Common::Utils.saveFile(response,localFile)
+        end
+		# Retruns the number of pages in a PDF document
+        def getPageCount
+		    urlPage = $productURI + '/pdf/' + @name + '/pages'
+			signedURL = Common::Utils.sign(urlPage)
+			count = Common::Utils.getFieldCount(signedURL,'/SaaSposeResponse/Pages/Page')
+			return count 
+        end		
+    end  
+end

data/lib/saaspose_slides.rb

@@ -0,0 +1,24 @@
+require_relative 'saaspose_storage'
+
+# This module provide wrapper classes to work with Saaspose.Slides resources
+module Slides
+    # This class provides functionality for converting PowerPoint Presentations to other supported formats.
+    class Convertor  
+        # Constructor for the Convertor Class.
+        # * :name represents the name of the PowerPoint Presentation on the Saaspose server 		
+	    def initialize(name)  
+             # Instance variables   
+             @name = name
+        end
+		 # Uploads file from the local path to the remote folder.
+		 # * :localFile represents full local file path and name
+         # * :saveFormat represents the converted format. For a list of supported formats, please visit 
+		 #  http://saaspose.com/docs/display/slides/presentation+Resource		 
+        def convert(localFile,saveFormat)
+		    urlDoc = $productURI + '/slides/' + @name + '?format=' + saveFormat
+		    signedURL = Common::Utils.sign(urlDoc)
+		    response = RestClient.get(signedURL, :accept => 'application/json')
+			Common::Utils.saveFile(response,localFile)
+        end		
+    end  
+end

data/lib/saaspose_storage.rb

@@ -0,0 +1,59 @@
+require_relative 'saaspose_common'
+
+# This module provides wrapper classes to work with Saaspose.Storage resources
+module Storage  
+     # This class represents File Saaspose URI data
+     class AppFile
+         attr_accessor :Name, :IsFolder, :ModifiedDate, :Size
+     end
+     
+	 # This class represents IsExist Saaspose URI data
+     class FileExist
+         attr_accessor :IsExist, :IsFolder
+     end
+
+	 # This class represents Disc Saaspose URI data
+     class Disc
+         attr_accessor :TotalSize, :UsedSize
+     end
+	 
+     # This class provides functionality to manage files in a Remote Saaspose Folder
+	 class Folder
+	     # Uploads file from the local path to the remote folder.
+		 # * :localFilePath represents full local file path and name
+         # * :remoteFolderPath represents remote folder relative to the root. Pass empty string for the root folder.		 
+         def self.uploadFile(localFilePath,remoteFolderPath)
+             fileName = File.basename(localFilePath)
+			 urlFile = $productURI + '/storage/file/' + fileName
+			 if not remoteFolderPath.empty?
+			     urlFile = $productURI + '/storage/file/' + remoteFolderPath + '/' + fileName
+			 end
+             signedURL = Common::Utils.sign(urlFile)
+             Common::Utils.uploadFileBinary(localFilePath,signedURL)			 
+         end
+		 # Retrieves Files and Folder information from a remote folder. The method returns an Array of AppFile objects.
+		 # * :remoteFolderPath represents remote folder relative to the root. Pass empty string for the root folder.
+         def self.getFiles(remoteFolderPath)
+             urlFolder = $productURI + '/storage/folder'
+             urlFile = ''
+             urlExist = ''
+             urlDisc = ''
+			 if not remoteFolderPath.empty?
+			     urlFile = $productURI + '/storage/folder/' + remoteFolderPath 
+			 end             
+			 signedURL = Common::Utils.sign(urlFolder)
+             response = RestClient.get(signedURL, :accept => 'application/json')
+             result = JSON.parse(response.body)
+             apps = Array.new(result["Files"].size)
+
+             for i in 0..result["Files"].size - 1
+                 apps[i] = AppFile.new
+                 apps[i].Name = result["Files"][i]["Name"]
+                 apps[i].IsFolder = result["Files"][i]["IsFolder"]
+                 apps[i].Size = result["Files"][i]["Size"]
+                 apps[i].ModifiedDate = Common::Utils.parse_date(result["Files"][i]["ModifiedDate"])
+             end
+             return apps	 
+         end
+     end
+end

data/lib/saaspose_words.rb

@@ -0,0 +1,24 @@
+require_relative 'saaspose_storage'
+
+# This module provide wrapper classes to work with Saaspose.Words resources
+module Words
+    # This class provides functionality for converting Word Documents to other supported formats.
+    class Convertor  
+        # Constructor for the Convertor Class.
+        # * :name represents the name of the Word Document on the Saaspose server 		
+	    def initialize(name)  
+             # Instance variables   
+             @name = name
+        end
+	     # Uploads file from the local path to the remote folder.
+		 # * :localFile represents full local file path and name
+         # * :saveFormat represents the converted format. For a list of supported formats, please visit 
+		 #  http://saaspose.com/docs/display/words/document		 
+        def convert(localFile,saveFormat)
+		    urlDoc = $productURI + '/words/' + @name + '?format=' + saveFormat
+		    signedURL = Common::Utils.sign(urlDoc)
+		    response = RestClient.get(signedURL, :accept => 'application/json')
+			Common::Utils.saveFile(response,localFile)
+        end		
+    end  
+end

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: saasposesdk
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Saaspose
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-12 00:00:00.000000000 Z
+dependencies: []
+description: Saaspose.SDK for Ruby allows you to use Saaspose API in your Ruby applications
+email: contact@saaspose.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/saaspose.rb
+- lib/saaspose_cells.rb
+- lib/saaspose_common.rb
+- lib/saaspose_pdf.rb
+- lib/saaspose_slides.rb
+- lib/saaspose_storage.rb
+- lib/saaspose_words.rb
+homepage: http://www.saaspose.com
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.17
+signing_key: 
+specification_version: 3
+summary: Saaspose.SDK for Ruby
+test_files: []