asposecloudsdk 0.0.1

data/lib/Common/aspose_app.rb

@@ -0,0 +1,14 @@
+# This class allows you to set the AppSID and AppKey values you get upon signing up
+module Aspose
+  module Cloud
+    module Common
+      class AsposeApp
+        def initialize(app_sid,app_key)  
+          $app_sid = app_sid
+          $app_key = app_key      
+          $out_put_location = ''
+        end
+      end
+    end
+  end
+end

data/lib/Common/product.rb

@@ -0,0 +1,17 @@
+# This class allows you to set the base host Aspose URI
+module Aspose
+  module Cloud
+    module Common
+      class Product
+        def initialize
+
+        end
+
+        # Sets the host product URI
+        def self.set_base_product_uri product_uri
+          $product_uri = product_uri
+        end
+      end
+    end    
+  end
+end

data/lib/Common/utils.rb

@@ -0,0 +1,108 @@
+# This class provides common methods to be repeatedly used by other wrapper classes
+module Aspose
+  module Cloud
+    module Common
+      class Utils
+        # Signs a URI with your appSID and Key.
+        # * :url describes the URL to sign
+   
+        def self.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=' + $app_sid
+          else
+            url_to_sign = parsed_url.scheme+'://' + parsed_url.host + parsed_url.path + '?' + parsed_url.query + '&appSID=' + $app_sid
+          end
+
+          # create a signature using the private key and the URL
+          raw_signature = OpenSSL::HMAC.digest(OpenSSL::Digest::Digest.new('sha1'), $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 = 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.
+          signed_url = url_to_sign + "&signature=#{signature}"
+          return signed_url
+        end
+   
+        def self.validate_output(result)
+         
+          validate = ['Unknown file format.', 'Unable to read beyond the end of the stream', 
+            'Index was out of range', 'Cannot read that as a ZipFile', 'Not a Microsoft PowerPoint 2007 presentation',
+            'Index was outside the bounds of the array', 'An attempt was made to move the position before the beginning of the stream',
+          ]
+         
+          invalid = false
+         
+          validate.each do |value|
+            if result.index(value) != nil
+              invalid = ture
+            end
+          end
+         
+          if invalid == true
+            return result
+          else
+            return ''
+          end         
+        end
+
+        # Parses JSON date value to a valid date format
+        # * :datestring holds the JSON Date value
+        def self.parse_date(date_string)
+          seconds_since_epoch = date_string.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 along with name
+        # * :url holds the required url to use while uploading the file to Aspose Storage		 
+        def self.upload_file_binary(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 along with name
+        # * :url holds the required url to use while uploading the file to Aspose Storage		 		 
+        def self.get_field_count(url,field_name)	    
+          response = RestClient.get(url, :accept => 'application/xml')
+          doc = REXML::Document.new(response.body)
+          pages = []		
+          doc.elements.each(field_name) do |ele|
+            pages << ele.text
+          end
+          return pages.size
+        end
+        # Saves the response stream to a local file.
+        def self.save_file(response_stream,local_file)
+          open(local_file, 'wb') do |file|
+            file.write(response_stream.body)
+          end
+        end
+   
+        def self.get_filename(file)
+     
+          filename = File.basename(file, File.extname(file) );
+     
+          return filename
+     
+        end
+   
+      end
+    end    
+  end
+end

data/lib/Ocr/extractor.rb

@@ -0,0 +1,128 @@
+module Aspose
+  module Cloud
+
+    module OCR
+      class Extractor
+        def initialize
+      
+        end
+    
+        def extract_text(*args)
+          case args.size
+          when 2
+            image_file_name,folder = *args
+            begin
+              str_uri = ''
+              if(folder=='' || folder==nil)
+                str_uri += $product_uri + '/ocr/' + image_file_name.to_s + '/recognize'
+              else
+                str_uri += $product_uri + '/ocr/' + image_file_name.to_s + '/recognize?folder=' + folder.to_s
+              end
+          
+              signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)
+
+              response = RestClient.get(signed_uri, :accept=> 'application/json')
+              json = JSON.parse(response)
+              return json         
+            rescue Exception=>e
+              print e
+              return nil
+            end
+          when 4
+            image_file_name,folder,language,use_default_dictionaries = *args
+            begin
+              str_uri = ''
+              if(folder=='' || folder==nil)
+                str_uri += $product_uri + '/ocr/' + image_file_name.to_s + '/recognize?language=' + language.to_s + '&useDefaultDictionaries=' + use_default_dictionaries.to_s
+              else
+                str_uri += $product_uri + '/ocr/' + image_file_name.to_s + '/recognize?language=' + language.to_s + '&useDefaultDictionaries=' + use_default_dictionaries.to_s + '&folder=' + folder.to_s
+              end
+          
+              signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)
+        
+              response = RestClient.get(signed_uri, :accept=> 'application/json')
+              json = JSON.parse(response)
+              return json         
+            rescue Exception=>e
+              print e
+              return nil
+            end
+          when 1
+            image_file_name = args[0]
+            begin
+              str_uri = $product_uri + '/ocr/'	+ image_file_name + '/recognize?useDefaultDictionaries=true'
+              signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)
+              response = RestClient.get(signed_uri, :accept=> 'application/json')
+              json = JSON.parse(response)
+              return json         
+            rescue Exception=>e
+              print e
+              return nil
+            end
+          when 8
+            image_file_name, language , use_default_dictionaries, x , y, height, width, folder = *args
+            begin
+              str_uri = $product_uri
+              str_uri	+= '/ocr/'
+              str_uri	+= image_file_name
+              str_uri	+= '/recognize?language='
+              str_uri	+= language
+              str_uri	+= ((x >= 0 && y >= 0 && width > 0 && height > 0) ? '&rectX=' + x.to_s	+ '&rectY=' + y.to_s + '&rectWidth=' + width.to_s + '&rectHeight=' + height.to_s : '') 
+              str_uri	+= '&useDefaultDictionaries='
+              str_uri	+= ((use_default_dictionaries) ? 'true' : 'false')
+              str_uri	+=((folder=='') ? '' : '&folder=' + folder)
+
+              signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)
+
+              response = RestClient.get(signed_uri, :accept=> 'application/json')
+              json = JSON.parse(response)
+              return json         
+            rescue Exception=>e
+              print e
+              return nil
+            end
+          when 3
+            stream,language,use_default_dictionaries = *args
+            begin
+              str_uri = $product_uri + '/ocr/recognize?language=' + language.to_s + '&useDefaultDictionaries=' + use_default_dictionaries.to_s
+              signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)
+              response = RestClient.post(signed_uri,stream, :accept=> 'application/json')
+              json = JSON.parse(response)
+              return json         
+            rescue Exception=>e
+              print e
+              return nil
+            end
+          end
+        end
+
+
+        def extract_text_from_local_file(local_file,language,use_default_dictionaries)
+          begin
+            str_uri = $product_uri + '/ocr/recognize?language=' + language.to_s + '&useDefaultDictionaries=' + use_default_dictionaries.to_s
+            file_stream = File.binread(local_file)
+            signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)
+            response = RestClient.post(signed_uri,file_stream, :accept=> 'application/json')
+            json = JSON.parse(response)
+            return json         
+          rescue Exception=>e
+            print e
+            return nil
+          end
+        end
+        def extract_text_from_url(url,language,use_default_dictionaries)
+          begin
+            str_uri = $product_uri + '/ocr/recognize?url=' + url + '&language=' + language + '&useDefaultDictionaries=' + use_default_dictionaries
+            signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)
+            response = RestClient.post(signed_uri,:accept => 'application/json')
+            json=JSON.parse(response)
+            return json
+          rescue Exception=>e
+            print e
+          end
+        end
+      end
+    end
+    
+  end
+end

data/lib/Pdf/annotation_editor.rb

@@ -0,0 +1,533 @@
+module Aspose
+  module Cloud
+
+    module Pdf
+      class AnnotationEditor
+        def initialize filename
+          @filename = filename
+        end
+    
+=begin
+   Gets number of annotations on a specified document page
+   @param number page_number
+=end
+    
+        def get_annotations_count page_number
+          begin
+        
+            if @filename == ''
+              raise 'filename not specified'
+            end
+        
+            if page_number == ''
+              raise 'page number not specified'
+            end
+        
+            str_uri = $product_uri + '/pdf/' + @filename + '/pages/' + page_number.to_s + '/annotations'
+            str_signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)        
+            response_stream = RestClient.get(str_signed_uri, {:accept=>'application/json'})
+        
+            stream_hash = JSON.parse(response_stream)
+        
+            return stream_hash['Annotations']['List'].length
+        
+        
+          rescue Exception=>e
+            print e
+          end
+        end
+    
+=begin
+   Gets a specfied annotation on a specified document page	   
+   @param number page_number
+   @param number annotation_index
+=end
+    
+        def get_annotation page_number, annotation_index
+          begin
+        
+            if @filename == ''
+              raise 'filename not specified'
+            end
+        
+            if page_number == ''
+              raise 'page number not specified'
+            end
+        
+            if annotation_index == ''
+              raise 'annotation index not specified'
+            end
+        
+            str_uri = $product_uri + '/pdf/' + @filename + '/pages/' + page_number.to_s + '/annotations/' + annotation_index.to_s
+            str_signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)        
+            response_stream = RestClient.get(str_signed_uri, {:accept=>'application/json'})
+        
+            stream_hash = JSON.parse(response_stream)
+        
+            return stream_hash['Annotation']
+        
+        
+          rescue Exception=>e
+            print e
+          end
+        end
+
+=begin
+   Gets list of all the annotations on a specified document page	   
+   @param number page_number  
+=end
+    
+        def get_all_annotation page_number
+          begin
+        
+            if @filename == ''
+              raise 'filename not specified'
+            end
+        
+            if page_number == ''
+              raise 'page number not specified'
+            end
+                
+            total_annotations = self.get_annotations_count(page_number)
+        
+            all_annotations = Array.new
+        
+            index = 1
+            while index <= total_annotations
+          
+              all_annotations.push(self.get_annotation(page_number, index))
+          
+              index+=1
+            end
+        
+            return all_annotations
+        
+        
+          rescue Exception=>e
+            print e
+          end
+        end    
+
+=begin
+   Gets total number of Bookmarks in a Pdf document   
+=end
+    
+        def get_bookmarks_count
+          begin
+        
+            if @filename == ''
+              raise 'filename not specified'
+            end
+                
+        
+            str_uri = $product_uri + '/pdf/' + @filename + '/bookmarks'
+            str_signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)  
+            response_stream = RestClient.get(str_signed_uri, {:accept=>'application/json'})
+        
+            stream_hash = JSON.parse(response_stream)
+        
+            return stream_hash['Bookmarks']['List'].length
+        
+        
+          rescue Exception=>e
+            print e
+          end
+        end
+
+=begin
+   Gets number of child bookmarks in a specfied parent bookmark   
+   @param number parent
+=end
+    
+        def get_child_bookmarks_count parent
+          begin
+        
+            if @filename == ''
+              raise 'filename not specified'
+            end
+        
+            if parent == ''
+              raise 'parent not specified'
+            end
+                
+        
+            str_uri = $product_uri + '/pdf/' + @filename + '/bookmarks/' + parent.to_s + '/bookmarks'
+            str_signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)        
+            response_stream = RestClient.get(str_signed_uri, {:accept=>'application/json'})
+        
+            stream_hash = JSON.parse(response_stream)
+        
+            return stream_hash['Bookmarks']['List'].length
+        
+        
+          rescue Exception=>e
+            print e
+          end
+        end
+
+=begin
+   Gets a specfied Bookmark from a PDF document
+   @param number bookmark_index
+=end
+    
+        def get_bookmark bookmark_index
+          begin
+        
+            if @filename == ''
+              raise 'filename not specified'
+            end
+        
+            if bookmark_index == ''
+              raise 'bookmark index not specified'
+            end
+                
+        
+            str_uri = $product_uri + '/pdf/' + @filename + '/bookmarks/' + bookmark_index.to_s
+            str_signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)        
+            response_stream = RestClient.get(str_signed_uri, {:accept=>'application/json'})
+        
+            stream_hash = JSON.parse(response_stream)
+        
+            return stream_hash['Bookmark']
+        
+        
+          rescue Exception=>e
+            print e
+          end
+        end    
+
+=begin
+   Gets a specfied Child Bookmark from a PDF document
+   @param number parent_index
+   @param number child_index
+=end
+    
+        def get_child_bookmark parent_index, child_index
+          begin
+        
+            if @filename == ''
+              raise 'filename not specified'
+            end
+        
+            if parent_index == ''
+              raise 'parent index not specified'
+            end
+        
+            if child_index == ''
+              raise 'child index not specified'
+            end
+                
+        
+            str_uri = $product_uri + '/pdf/' + @filename + '/bookmarks/' + parent_index.to_s + '/bookmarks/' + child_index.to_s
+            str_signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)        
+            response_stream = RestClient.get(str_signed_uri, {:accept=>'application/json'})
+        
+            stream_hash = JSON.parse(response_stream)
+        
+            return stream_hash['Bookmark']
+        
+        
+          rescue Exception=>e
+            print e
+          end
+        end    
+
+=begin
+   Gets list of all the bookmarks in pdf     
+=end
+    
+        def get_all_bookmarks
+          begin
+        
+            if @filename == ''
+              raise 'filename not specified'
+            end
+                
+                
+            total_bookmarks = self.get_bookmarks_count
+        
+            all_bookmarks = Array.new
+        
+            index = 1
+            while index <= total_bookmarks
+          
+              all_annotations.push(self.get_bookmark(index))
+          
+              index+=1
+            end
+        
+            return all_bookmarks
+        
+        
+          rescue Exception=>e
+            print e
+          end
+        end    
+
+=begin
+   Gets total number of Attachments in a Pdf document   
+=end
+    
+        def get_attachments_count
+          begin
+        
+            if @filename == ''
+              raise 'filename not specified'
+            end
+                
+        
+            str_uri = $product_uri + '/pdf/' + @filename + '/attachments'
+            str_signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)        
+
+            response_stream = RestClient.get(str_signed_uri, {:accept=>'application/json'})
+        
+            stream_hash = JSON.parse(response_stream)
+        
+            return stream_hash['Attachments']['List'].length
+        
+        
+          rescue Exception=>e
+            print e
+          end
+        end    
+
+=begin
+   Gets a specfied Attachment from a PDF document
+   @param number attachment_index
+=end
+    
+        def get_attachment attachment_index
+          begin
+        
+            if @filename == ''
+              raise 'filename not specified'
+            end
+        
+            if attachment_index == ''
+              raise 'attachment index not specified'
+            end
+                
+        
+            str_uri = $product_uri + '/pdf/' + @filename + '/attachments/' + attachment_index.to_s
+            str_signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)        
+            response_stream = RestClient.get(str_signed_uri, {:accept=>'application/json'})
+        
+            stream_hash = JSON.parse(response_stream)
+        
+            return stream_hash['Attachment']
+        
+        
+          rescue Exception=>e
+            print e
+          end
+        end       
+
+=begin
+   Gets list of all the attachments in pdf     
+=end
+    
+        def get_all_attachments
+          begin
+        
+            if @filename == ''
+              raise 'filename not specified'
+            end
+                
+                
+            total_attachments = self.get_attachments_count
+        
+            all_attachments = Array.new
+        
+            index = 1
+            while index <= total_attachments
+          
+              all_annotations.push(self.get_attachment(index))
+          
+              index+=1
+            end
+        
+            return all_attachments
+        
+        
+          rescue Exception=>e
+            print e
+          end
+        end    
+
+=begin
+   Download a specfied Attachment from a PDF document
+   @param number attachment_index
+=end
+    
+        def download_attachment attachment_index
+          begin
+        
+            if @filename == ''
+              raise 'filename not specified'
+            end
+        
+            if attachment_index == ''
+              raise 'attachment index not specified'
+            end
+                
+            file_info = self.get_attachment(attachment_index)
+        
+        
+            str_uri = $product_uri + '/pdf/' + @filename + '/attachments/' + attachment_index.to_s + '/download'
+            str_signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)        
+            response_stream = RestClient.get(str_signed_uri, {:accept=>'application/json'})
+        
+            valid_output = Aspose::Cloud::Common::Utils.validate_output(response_stream)
+        
+            if valid_output == ''                   
+              output_path = $out_put_location + file_info['Name'];
+              Aspose::Cloud::Common::Utils.saveFile(response_stream,output_path)
+              return ''
+            else
+              return valid_output
+            end
+        
+        
+          rescue Exception=>e
+            print e
+          end
+        end     
+
+=begin
+   Gets total number of Links in a Pdf document
+   @param number page_number
+=end
+    
+        def get_links_count page_number
+          begin
+        
+            if @filename == ''
+              raise 'filename not specified'
+            end
+        
+            if page_number == ''
+              raise 'page number not specified'
+            end
+                
+        
+            str_uri = $product_uri + '/pdf/' + @filename + '/pages/' + page_number.to_s + '/links'
+            str_signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)        
+            response_stream = RestClient.get(str_signed_uri, {:accept=>'application/json'})
+        
+            stream_hash = JSON.parse(response_stream)
+        
+            return stream_hash['Links']['List'].length
+        
+        
+          rescue Exception=>e
+            print e
+          end
+        end 
+
+=begin
+   Gets a specfied link on a specified document page	   
+   @param number page_number
+   @param number annotation_index
+=end
+    
+        def get_link page_number, link_index
+          begin
+        
+            if @filename == ''
+              raise 'filename not specified'
+            end
+        
+            if page_number == ''
+              raise 'page number not specified'
+            end
+        
+            if link_index == ''
+              raise 'link index not specified'
+            end
+        
+            str_uri = $product_uri + '/pdf/' + @filename + '/pages/' + page_number.to_s + '/links/' + link_index.to_s
+            str_signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)        
+            response_stream = RestClient.get(str_signed_uri, {:accept=>'application/json'})
+        
+            stream_hash = JSON.parse(response_stream)
+        
+            return stream_hash['Link']
+        
+        
+          rescue Exception=>e
+            print e
+          end
+        end    
+
+=begin
+   Gets list of all the links on a specified document page	   
+   @param number page_number  
+=end
+    
+        def get_all_links page_number
+          begin
+        
+            if @filename == ''
+              raise 'filename not specified'
+            end
+        
+            if page_number == ''
+              raise 'page number not specified'
+            end
+                
+            total_links = self.get_links_count(page_number)
+        
+            all_links = Array.new
+        
+            index = 1
+            while index <= total_links
+          
+              all_annotations.push(self.get_link(page_number, index))
+          
+              index+=1
+            end
+        
+            return all_links
+        
+        
+          rescue Exception=>e
+            print e
+          end
+        end     
+
+=begin
+   Checks whether selected bookmark is parent or child Gets a specfied child Bookmark for selected parent bookmark in Pdf document   
+   @param number bookmark_index
+=end
+    
+        def is_child_bookmark bookmark_index
+          begin
+        
+            if @filename == ''
+              raise 'filename not specified'
+            end
+        
+            if bookmark_index == ''
+              raise 'bookmark index not specified'
+            end
+                
+        
+            str_uri = $product_uri + '/pdf/' + @filename + '/bookmarks/' + bookmark_index.to_s
+            str_signed_uri = Aspose::Cloud::Common::Utils.sign(str_uri)        
+            response_stream = RestClient.get(str_signed_uri, {:accept=>'application/json'})
+        
+            stream_hash = JSON.parse(response_stream)
+        
+            return stream_hash['Bookmark']
+        
+        
+          rescue Exception=>e
+            print e
+          end
+        end
+    
+      end
+    end
+    
+  end
+end