aspose_imaging_cloud 20.8 → 21.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 90e22614499953c33cc3dac218ecca3f1e4b3771a01b023ddd7fc8260f46677a
-  data.tar.gz: 58cfb883bde337ef54ff26f532bb133265d4980d6fb3168166ebcc4f9db475d6
+  metadata.gz: cf94497d9d36b174512561253ee819a077778a2606d1a955d091d388975011fb
+  data.tar.gz: d8912a658bf5f13443512392a1ebbe1757ffa77b79c4229930154779afe140e1
 SHA512:
-  metadata.gz: 3afd212cd24083765361735ebf4a343e1fee3f8a30cbd6aed54cf79c8dc1e2f04cc6f59b7ea81668152280322e903724ef4b5c0f55ec389ba22147d07c37d685
-  data.tar.gz: 0dd2ebc618ebbdcb351b71f65f408508089d57570422a13fd4aecb79b02133b7069697d0f1dd876e8e2e20ac4702df172d8e5d9e215dc3220a70bc3e77c95ced
+  metadata.gz: d4ba1382197fd123de6decc4ea4696029fde0fb3e4453c52aecbb3b3f0690a46a5a4726bf6497de7e3cf74b3fd3d6d45f2503ee5e613ab7c74568040bf168061
+  data.tar.gz: a31e712c63ba348edfcee41a23252ab83cf6ed66591e711c520b5cc57e4216e21a6a795043da89d2b18c9ace5c9b178405246d7a0b86ce62085e4fa36f98a6e5

data/README.md

@@ -1,8 +1,56 @@
-# aspose-imaging-cloud
+![](https://img.shields.io/badge/api-v3.0-lightgrey) ![Gem](https://img.shields.io/gem/v/aspose_imaging_cloud) ![Gem](https://img.shields.io/gem/dt/aspose_words_cloud) [![GitHub license](https://img.shields.io/github/license/aspose-imaging-cloud/aspose-imaging-cloud-ruby)](https://github.com/aspose-imaging-cloud/aspose-imaging-cloud-ruby/blob/master/LICENSE)
+## Image Processing in Cloud via Ruby REST API
+[Aspose.Imaging Cloud](https://products.aspose.cloud/imaging) is a true [REST API](https://apireference.aspose.cloud/imaging/) that enables you to perform a wide range of image processing operations including creation, manipulation and conversion in the cloud, with zero initial costs. Our Cloud SDKs are wrappers around REST API in various programming languages, allowing you to process images in language of your choice quickly and easily, gaining all benefits of strong types and IDE highlights.
 
-AsposeImagingCloud - the Ruby gem for the Aspose.Imaging Cloud API Reference
+This repository contains [Aspose.Imaging Cloud Ruby SDK](https://products.aspose.cloud/imaging/ruby) source code. This SDK allows you to work with Aspose.Imaging Cloud REST APIs in your Python applications quickly and easily, with zero initial cost.
 
-No description provided (generated by Swagger Codegen https://github.com/swagger-api/swagger-codegen)
+To use this SDK, you will need Client ID and Client secret which can be looked up at [Aspose Cloud Dashboard](https://dashboard.aspose.cloud/#/apps) (free registration in Aspose Cloud is required for this).
+
+The solution is updated using [code generator](https://github.com/aspose-imaging-cloud/aspose-imaging-cloud-codegen).
+## Image Processing Features
+
+- Fetch or update properties of cloud-hosted images.
+- Scale, flip, crop, and export an image with a single API call.
+- Resize, crop, flip, convert, and export an image to other supported formats.
+- Update image parameters of JPEG2000 & WEBP images.
+- Access and multi-frame TIFF image and extract the desired frames from it.
+- Rotate, flip, crop, resize, or fetch properties of the selected TIFF frame.
+- Merge multiple TIFF images.
+
+## Read & Write Image Formats
+BMP, GIF, JPEG, JPEG2000, PSD, TIFF, WEBP, PNG, WMF, EMF, SVG
+
+## Save Image As
+PDF, DICOM
+
+## Read Image Formats
+DJVU, DICOM, CDR, CMX, ODG, DNG, EPS
+
+## Enhancements in Version 20.12
+
+- Enhanced the **EPS** file format inheritance to support rotate, resize, flip, etc. operations as vector images support.
+- Improved image loading, conversion, and export features.
+- Added the JavaScript SDK.
+
+## Enhancements in Version 20.9
+- Resumed the support of **Android SDK** and updated reference to Aspose.Imaging and Aspose.PSD.
+
+
+## Enhancements in Version 20.10
+
+- Support for additional image formats in Object Detection.
+- Support to load and convert **EPS** files to **PDF/A** format.
+
+## Storage API support
+Since version 19.4, SDK includes support of storage operations for better user experience and unification, so now there's no need to use 2 different SDKs!
+
+It gives you an ability to:
+* Upload, download, copy, move and delete files, including versions handling (if you are using Cloud storage that supports this feature - true by default)
+* Create, copy, move and delete folders
+* Copy and move files and folders accross separate storages in scope of a single operation
+* Check if certain file, folder or storage exists
+
+Detalied official documentation can be found at the [following link](https://docs.aspose.cloud/imaging/).
 
 This SDK is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project:
 
@@ -31,7 +79,7 @@ or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.or
 
 Finally add this to the Gemfile:
 
-    gem 'aspose-imaging-cloud', '~> 20.8'
+    gem 'aspose-imaging-cloud', '~> 21.12'
 
 ### Install from Git
 
@@ -47,38 +95,15 @@ Include the Ruby code directly using `-I` as follows:
 ruby -Ilib script.rb
 ```
 
-## Getting Started
-
-Please follow the [installation](#installation) procedure and then run the following code:
-```ruby
-# Load the gem
-require 'aspose-imaging-cloud'
-
-# Setup authorization
-AsposeImagingCloud.configure do |config|
-  # Configure OAuth2 access token for authorization: JWT
-  config.access_token = 'YOUR ACCESS TOKEN'
-end
-
-api_instance = AsposeImagingCloud::ImagingApi.new
 
-search_context_id = 'search_context_id_example' # String | Search context identifier.
+## Convert PNG to JPG in Ruby
 
-image_id = 'image_id_example' # String | Image identifier.
-
-opts = { 
-  image_data: File.new('/path/to/file.txt'), # File | Input image
-  folder: 'folder_example', # String | Folder.
-  storage: 'storage_example' # String | Storage
-}
-
-begin
-  #Add image and images features to search context. Image data may be passed as zero-indexed multipart/form-data content or as raw body stream.
-  api_instance.add_search_image(search_context_id, image_id, opts)
-rescue AsposeImagingCloud::ApiError => e
-  puts "Exception when calling ImagingApi->add_search_image: #{e}"
-end
+```ruby
+    # Get your ClientId and ClientSecret from https://dashboard.aspose.cloud (free registration required).
+	api = AsposeImagingCloud::ImagingApi.new("MY_CLIENT_SECRET", "MY_CLIENT_ID")
 
+	requestParam = AsposeImagingCloud::ConvertImageRequest.new("sample.png", "jpg", "tempFolder", "My_Storage_Name")
+	result = api.convert_image(requestParam)
 ```
 
 ## Documentation for API Endpoints
@@ -231,6 +256,14 @@ Class | Method | HTTP request | Description
 
 - **Type**: OAuth
 - **Flow**: application
-- **Authorization URL**: 
+- **Authorization URL**:
 - **Scopes**: N/A
 
+## Aspose.Imaging Cloud SDKs in Popular Languages
+
+| .NET | Java | PHP | Python | Ruby | Node.js |Android|
+|---|---|---|---|---|---|--|
+| [GitHub](https://github.com/aspose-imaging-cloud/aspose-imaging-cloud-dotnet) | [GitHub](https://github.com/aspose-imaging-cloud/aspose-imaging-cloud-java) | [GitHub](https://github.com/aspose-imaging-cloud/aspose-imaging-cloud-php) | [GitHub](https://github.com/aspose-imaging-cloud/aspose-imaging-cloud-python) | [GitHub](https://github.com/aspose-imaging-cloud/aspose-imaging-cloud-ruby)  | [GitHub](https://github.com/aspose-imaging-cloud/aspose-imaging-cloud-node) | [GitHub](https://github.com/aspose-imaging-cloud/aspose-imaging-cloud-android) | [GitHub](https://github.com/aspose-imaging-cloud/aspose-imaging-cloud-swift)|[GitHub](https://github.com/aspose-imaging-cloud/aspose-imaging-cloud-dart) |[GitHub](https://github.com/aspose-imaging-cloud/aspose-imaging-cloud-go) |
+| [NuGet](https://www.nuget.org/packages/Aspose.Imaging-Cloud/) | [Maven](https://repository.aspose.cloud/webapp/#/artifacts/browse/tree/General/repo/com/aspose/aspose-imaging-cloud) | [Composer](https://packagist.org/packages/aspose/aspose-imaging-cloud) | [PIP](https://pypi.org/project/aspose.imaging-cloud/) | [GEM](https://rubygems.org/gems/aspose_imaging_cloud)  | [NPM](https://www.npmjs.com/package/@asposecloud/aspose-imaging-cloud) |[Maven](https://repository.aspose.cloud/webapp/#/artifacts/browse/tree/General/repo/com/aspose/aspose-imaging-cloud)|
+
+[Product Page](https://products.aspose.cloud/imaging/ruby) | [Documentation](https://docs.aspose.cloud/display/imagingcloud/Home) | [API Reference](https://apireference.aspose.cloud/imaging/) | [Code Samples](https://github.com/aspose-imaging-cloud/aspose-imaging-cloud-ruby) | [Blog](https://blog.aspose.cloud/category/imaging/) | [Free Support](https://forum.aspose.cloud/c/imaging) | [Free Trial](https://dashboard.aspose.cloud/#/apps)

data/lib/aspose-imaging-cloud/api/imaging_api.rb

@@ -32,13 +32,13 @@ module AsposeImagingCloud
     attr_accessor :api_client
 
     # Initializes a new instance of the ImagingApi class.
-    # @param [String] app_key Key to access the server.
-    # @param [String] app_sid ID to access the server.
+    # @param [String] client_secret Key to access the server.
+    # @param [String] client_id ID to access the server.
     # @param [String] base_url Server URL.
     # @param [String] api_version Api version.
     # @param [Object] debug Debug switch [true, false].
-    def initialize(app_key = nil, app_sid = nil, base_url = 'api-qa.aspose.cloud', api_version = 'v3.0', debug = false)
-      @api_client = ApiClient.new(app_key, app_sid, base_url, api_version, debug)
+    def initialize(client_secret = nil, client_id = nil, base_url = 'api-qa.aspose.cloud', api_version = 'v3.0', debug = false)
+      @api_client = ApiClient.new(client_secret, client_id, base_url, api_version, debug)
     end
 
     # Add image and images features to search context. Image data may be passed as zero-indexed multipart/form-data content or as raw body stream.
@@ -725,13 +725,8 @@ module AsposeImagingCloud
     private
 
     def make_request(http_request, method, return_type)
+      ensure_token
       call_api(http_request, method, return_type)
-    rescue ApiError => e
-      if e.code.equal? 401
-        request_token
-        return call_api(http_request, method, return_type)
-      end
-      raise
 
     end
 
@@ -747,13 +742,17 @@ module AsposeImagingCloud
       response[0]
     end
 
+    def ensure_token
+      request_token unless @api_client.config.access_token
+    end
+
     def request_token
       config = @api_client.config
       request_url = '/connect/token'
       form_params =
         {
           'grant_type': 'client_credentials',
-          'client_id': config.api_key[:app_sid],
+          'client_id': config.api_key[:client_id],
           'client_secret': config.api_key[:api_key]
         }
 

data/lib/aspose-imaging-cloud/api_client.rb

@@ -45,16 +45,16 @@ module AsposeImagingCloud
     attr_accessor :default_headers
 
     # Initializes the ApiClient
-    # @param [String] app_key Key to access the server.
-    # @param [String] app_sid ID to access the server.
+    # @param [String] client_secret Key to access the server.
+    # @param [String] client_id ID to access the server.
     # @param [String] base_url Server URL.
     # @param [String] api_version Api version.
     # @param [Object] debug Debug switch [true, false].
-    def initialize(app_key = nil, app_sid = nil, base_url = 'api-qa.aspose.cloud', api_version = 'v3.0', debug = false)
-      @config = Configuration.new(app_key, app_sid, base_url, api_version, debug)
+    def initialize(client_secret = nil, client_id = nil, base_url = 'api-qa.aspose.cloud', api_version = 'v3.0', debug = false)
+      @config = Configuration.new(client_secret, client_id, base_url, api_version, debug)
       @default_headers = {
         'x-aspose-client' => 'ruby sdk',
-        'x-aspose-version' => '20.8'
+        'x-aspose-version' => '21.12'
       }
     end
 

data/lib/aspose-imaging-cloud/configuration.rb

@@ -149,18 +149,18 @@ module AsposeImagingCloud
     attr_accessor :force_ending_format
 
     # Initializes a new instance.
-    # @param [String] app_key Key to access the server.
-    # @param [String] app_sid ID to access the server.
+    # @param [String] client_secret Key to access the server.
+    # @param [String] client_id ID to access the server.
     # @param [String] base_url Server URL.
     # @param [String] api_version Api version.
     # @param [Object] debug Debug switch [true, false].
-    def initialize(app_key = nil, app_sid = nil, base_url = 'api-qa.aspose.cloud', api_version = 'v3.0', debug = false)
+    def initialize(client_secret = nil, client_id = nil, base_url = 'api-qa.aspose.cloud', api_version = 'v3.0', debug = false)
       @scheme = 'https'
       self.host = base_url
       @api_version = api_version
       self.base_path = @api_version
-      @api_key = { 'api_key': app_key || '',
-                   'app_sid': app_sid || '' }
+      @api_key = { 'api_key': client_secret || '',
+                   'client_id': client_id || '' }
       @api_key_prefix = {}
       @timeout = 0
       @client_side_validation = true
@@ -173,7 +173,7 @@ module AsposeImagingCloud
       @inject_format = false
       @force_ending_format = false
       @logger = defined?(Rails) ? Rails.logger : Logger.new(STDOUT)
-      @on_premise = (!(app_key || app_sid) && base_url)
+      @on_premise = (!(client_secret || client_id) && base_url)
 
       yield(self) if block_given?
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aspose_imaging_cloud
 version: !ruby/object:Gem::Version
-  version: '20.8'
+  version: '21.12'
 platform: ruby
 authors:
 - Sergei Zubov
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-08-28 00:00:00.000000000 Z
+date: 2021-12-27 00:00:00.000000000 Z
 dependencies: []
 description: |2
 
@@ -18,7 +18,8 @@ description: |2
 
   This repository contains Aspose.Imaging Cloud Ruby SDK source code. This SDK allows you to work with Aspose.Imaging Cloud REST APIs in your Ruby applications quickly and easily, with zero initial cost.
 
-  To use this SDK, you will need App SID and App Key which can be looked up at Aspose Cloud Dashboard (free registration in Aspose Cloud is required for this).
+  To use this SDK, you will need Client ID and Client Key which can be looked up at Aspose Cloud Dashboard (free
+  registration in Aspose Cloud is required for this).
 
   The solution is updated using code generator.
 email: sergei.zubov@aspose.com
@@ -177,7 +178,7 @@ licenses:
 - MIT
 metadata:
   source_code_uri: https://github.com/aspose-imaging-cloud/aspose-imaging-cloud-ruby
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -192,8 +193,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.1.6
+signing_key:
 specification_version: 4
 summary: Aspose.Imaging Cloud Ruby SDK
 test_files: []