Merge pull request #77 from aspose-pdf-cloud/develop

update to 24.11

Author: boiledgas

README.md

@@ -30,15 +30,10 @@ XLS, XLSX, PPTX, DOC, DOCX, MobiXML, JPEG, EMF, PNG, BMP, GIF, TIFF, Text
 ## Read PDF Formats
 MHT, PCL, PS, XSLFO, MD
 
-## Enhancements in Version 24.10
-- Develop a method to add XMP metadata.
-- Develop a method to obtain XMP metadata in the XML form.
-- Develop a method to obtain XMP metadata in the JSON form.
+## Enhancements in Version 24.11
+- Add DocRecognitionMode EnhancedFlow mode.
 - A new version of Aspose.PDF Cloud was prepared using the latest version of Aspose.PDF for .NET.
 
-## Bugs fixed in Version 24.10
-- PDF XFA form to Acro from conversion API results corrupt PDF.
-
 ## Requirements.
 Python 2.7 and 3.4+
 

asposepdfcloud/__init__.py

@@ -262,6 +262,7 @@
 from .models.strike_out_annotation_response import StrikeOutAnnotationResponse
 from .models.strike_out_annotations import StrikeOutAnnotations
 from .models.strike_out_annotations_response import StrikeOutAnnotationsResponse
+from .models.svg_images import SvgImages
 from .models.table import Table
 from .models.table_recognized import TableRecognized
 from .models.table_recognized_response import TableRecognizedResponse

asposepdfcloud/api_client.py

@@ -83,7 +83,7 @@ def __init__(self, app_key, app_sid, host=None, self_host=False):
         self.rest_client = RESTClientObject()
         self.default_headers = {}
         self.default_headers['x-aspose-client'] = 'python sdk'
-        self.default_headers['x-aspose-client-version'] = '24.10.0'
+        self.default_headers['x-aspose-client-version'] = '24.11.0'
 
         self.self_host = self_host
         self.app_key = app_key

asposepdfcloud/apis/pdf_api.py

@@ -10612,6 +10612,129 @@ def get_images_with_http_info(self, name, page_number, **kwargs):
                                         _request_timeout=params.get('_request_timeout'),
                                         collection_formats=collection_formats)
 
+    def get_images_extract_svg(self, name, page_number, **kwargs):
+        """
+        Extract SVG images from document page.
+        This method makes a synchronous HTTP request by default. To make an
+        asynchronous HTTP request, please define a `callback` function
+        to be invoked when receiving the response.
+        >>> def callback_function(response):
+        >>>     pprint(response)
+        >>>
+        >>> thread = api.get_images_extract_svg(name, page_number, callback=callback_function)
+
+        :param callback function: The callback function
+            for asynchronous request. (optional)
+        :param str name: The document name. (required)
+        :param int page_number: The page number. (required)
+        :param str storage: The document storage.
+        :param str folder: The document folder.
+        :param str pass_base64: The password (Base64).
+        :return: SvgImages
+                 If the method is called asynchronously,
+                 returns the request thread.
+        """
+        kwargs['_return_http_data_only'] = True
+        if kwargs.get('callback'):
+            return self.get_images_extract_svg_with_http_info(name, page_number, **kwargs)
+        else:
+            (data) = self.get_images_extract_svg_with_http_info(name, page_number, **kwargs)
+            return data
+
+    def get_images_extract_svg_with_http_info(self, name, page_number, **kwargs):
+        """
+        Extract SVG images from document page.
+        This method makes a synchronous HTTP request by default. To make an
+        asynchronous HTTP request, please define a `callback` function
+        to be invoked when receiving the response.
+        >>> def callback_function(response):
+        >>>     pprint(response)
+        >>>
+        >>> thread = api.get_images_extract_svg_with_http_info(name, page_number, callback=callback_function)
+
+        :param callback function: The callback function
+            for asynchronous request. (optional)
+        :param str name: The document name. (required)
+        :param int page_number: The page number. (required)
+        :param str storage: The document storage.
+        :param str folder: The document folder.
+        :param str pass_base64: The password (Base64).
+        :return: SvgImages
+                 If the method is called asynchronously,
+                 returns the request thread.
+        """
+
+        all_params = ['name', 'page_number', 'storage', 'folder', 'pass_base64']
+        all_params.append('callback')
+        all_params.append('_return_http_data_only')
+        all_params.append('_preload_content')
+        all_params.append('_request_timeout')
+
+        params = locals()
+        for key, val in iteritems(params['kwargs']):
+            if key not in all_params:
+                raise TypeError(
+                    "Got an unexpected keyword argument '%s'"
+                    " to method get_images_extract_svg" % key
+                )
+            params[key] = val
+        del params['kwargs']
+        # verify the required parameter 'name' is set
+        if ('name' not in params) or (params['name'] is None):
+            raise ValueError("Missing the required parameter `name` when calling `get_images_extract_svg`")
+        # verify the required parameter 'page_number' is set
+        if ('page_number' not in params) or (params['page_number'] is None):
+            raise ValueError("Missing the required parameter `page_number` when calling `get_images_extract_svg`")
+
+
+        collection_formats = {}
+
+        path_params = {}
+        if 'name' in params:
+            path_params['name'] = params['name']
+        if 'page_number' in params:
+            path_params['pageNumber'] = params['page_number']
+
+        query_params = []
+        if 'storage' in params:
+            query_params.append(('storage', params['storage']))
+        if 'folder' in params:
+            query_params.append(('folder', params['folder']))
+        if 'pass_base64' in params:
+            query_params.append(('passBase64', params['pass_base64']))
+
+        header_params = {}
+
+        form_params = []
+        local_var_files = {}
+
+        body_params = None
+        # HTTP header `Accept`
+        header_params['Accept'] = self.api_client.\
+            select_header_accept(['application/json'])
+
+        # HTTP header `Content-Type`
+        header_params['Content-Type'] = self.api_client.\
+            select_header_content_type(['application/json'])
+
+        # Authentication setting
+        auth_settings = ['JWT']
+
+        return self.api_client.call_api('/pdf/{name}/pages/{pageNumber}/images/extract/svg', 'GET',
+                                        path_params,
+                                        query_params,
+                                        header_params,
+                                        body=body_params,
+                                        post_params=form_params,
+                                        files=local_var_files,
+                                        response_type='SvgImages',
+                                        auth_settings=auth_settings,
+                                        callback=params.get('callback'),
+                                        _return_http_data_only=params.get('_return_http_data_only'),
+                                        _preload_content=params.get('_preload_content', True),
+                                        _request_timeout=params.get('_request_timeout'),
+                                        collection_formats=collection_formats)
+
     def get_import_fields_from_fdf_in_storage(self, name, fdf_file_path, **kwargs):
         """
         Update fields from FDF file in storage.

asposepdfcloud/configuration.py

@@ -199,5 +199,5 @@ def to_debug_report(self):
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: 3.0\n"\
-               "SDK Package Version: 24.10.0".\
+               "SDK Package Version: 24.11.0".\
                format(env=sys.platform, pyversion=sys.version)

asposepdfcloud/models/__init__.py

@@ -262,6 +262,7 @@
 from .strike_out_annotation_response import StrikeOutAnnotationResponse
 from .strike_out_annotations import StrikeOutAnnotations
 from .strike_out_annotations_response import StrikeOutAnnotationsResponse
+from .svg_images import SvgImages
 from .table import Table
 from .table_recognized import TableRecognized
 from .table_recognized_response import TableRecognizedResponse

asposepdfcloud/models/doc_recognition_mode.py

@@ -44,6 +44,7 @@ class DocRecognitionMode(object):
     """
     TEXTBOX = "Textbox"
     FLOW = "Flow"
+    ENHANCEDFLOW = "EnhancedFlow"
 
     """
     Attributes:

asposepdfcloud/models/svg_images.py

@@ -0,0 +1,199 @@
+# coding: utf-8
+
+"""
+    Aspose.PDF Cloud API Reference
+
+
+Copyright (c) 2024 Aspose.PDF Cloud
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+
+    OpenAPI spec version: 3.0
+    
+"""
+
+
+from pprint import pformat
+from six import iteritems
+import re
+
+
+class SvgImages(object):
+    """
+    NOTE: This class is auto generated by the swagger code generator program.
+    Do not edit the class manually.
+    """
+
+
+    """
+    Attributes:
+      swagger_types (dict): The key is attribute name
+                            and the value is attribute type.
+      attribute_map (dict): The key is attribute name
+                            and the value is json key in definition.
+    """
+    swagger_types = {
+        'code': 'int',
+        'status': 'str',
+        'list': 'list[str]'
+    }
+
+    attribute_map = {
+        'code': 'Code',
+        'status': 'Status',
+        'list': 'List'
+    }
+
+    def __init__(self, code=None, status=None, list=None):
+        """
+        SvgImages - a model defined in Swagger
+        """
+
+        self._code = None
+        self._status = None
+        self._list = None
+
+        self.code = code
+        if status is not None:
+          self.status = status
+        if list is not None:
+          self.list = list
+
+    @property
+    def code(self):
+        """
+        Gets the code of this SvgImages.
+        Response status code.
+
+        :return: The code of this SvgImages.
+        :rtype: int
+        """
+        return self._code
+
+    @code.setter
+    def code(self, code):
+        """
+        Sets the code of this SvgImages.
+        Response status code.
+
+        :param code: The code of this SvgImages.
+        :type: int
+        """
+        if code is None:
+            raise ValueError("Invalid value for `code`, must not be `None`")
+
+        self._code = code
+
+    @property
+    def status(self):
+        """
+        Gets the status of this SvgImages.
+        Response status.
+
+        :return: The status of this SvgImages.
+        :rtype: str
+        """
+        return self._status
+
+    @status.setter
+    def status(self, status):
+        """
+        Sets the status of this SvgImages.
+        Response status.
+
+        :param status: The status of this SvgImages.
+        :type: str
+        """
+
+        self._status = status
+
+    @property
+    def list(self):
+        """
+        Gets the list of this SvgImages.
+        List of SVG images
+
+        :return: The list of this SvgImages.
+        :rtype: list[str]
+        """
+        return self._list
+
+    @list.setter
+    def list(self, list):
+        """
+        Sets the list of this SvgImages.
+        List of SVG images
+
+        :param list: The list of this SvgImages.
+        :type: list[str]
+        """
+
+        self._list = list
+
+    def to_dict(self):
+        """
+        Returns the model properties as a dict
+        """
+        result = {}
+
+        for attr, _ in iteritems(self.swagger_types):
+            value = getattr(self, attr)
+            if isinstance(value, list):
+                result[attr] = list(map(
+                    lambda x: x.to_dict() if hasattr(x, "to_dict") else x,
+                    value
+                ))
+            elif hasattr(value, "to_dict"):
+                result[attr] = value.to_dict()
+            elif isinstance(value, dict):
+                result[attr] = dict(map(
+                    lambda item: (item[0], item[1].to_dict())
+                    if hasattr(item[1], "to_dict") else item,
+                    value.items()
+                ))
+            else:
+                result[attr] = value
+
+        return result
+
+    def to_str(self):
+        """
+        Returns the string representation of the model
+        """
+        return pformat(self.to_dict())
+
+    def __repr__(self):
+        """
+        For `print` and `pprint`
+        """
+        return self.to_str()
+
+    def __eq__(self, other):
+        """
+        Returns true if both objects are equal
+        """
+        if not isinstance(other, SvgImages):
+            return False
+
+        return self.__dict__ == other.__dict__
+
+    def __ne__(self, other):
+        """
+        Returns true if both objects are not equal
+        """
+        return not self == other

docs/DocRecognitionMode.md

@@ -6,6 +6,7 @@ Name | Type | Value | Description
 ------------ | ------------- | ------------- | -------------
 **TEXTBOX** | **str** | "Textbox" | This mode is fast and good for maximally preserving original look of the PDF file, but editability of the resulting document could be limited.Every visually grouped block of text int the original PDF file is converted into a textbox in the resulting document. This achieves maximal resemblance of the output document to the original PDF file. The output document will look good, but it will consist entirely of textboxes and it could makes further editing of the document in Microsoft Word quite hard.This is the default mode.
 **FLOW** | **str** | "Flow" | Full recognition mode, the engine performs grouping and multi-level analysis to restore the original document author's intent and produce a maximally editable document. The downside is that the output document might look different from the original PDF file.
+**ENHANCEDFLOW** | **str** | "EnhancedFlow" | An alternative Flow mode that supports the recognition of tables.
 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)