Merge branch 'master' into release

Author: YaroslawEkimov

README.md

@@ -16,6 +16,19 @@ Python Cloud SDK wraps Aspose.Words Cloud API so you could seamlessly integrate
 - [Convert a document to desired file format](https://docs.aspose.cloud/display/wordscloud/Convert+Document+to+Destination+Format+with+Detailed+Settings+and+Save+Result+to+Storage) along with detailed settings.
 - Convert an encrypted PDF document into Word document format.
 
+## Enhancements in Version 22.6
+
+- Added 'DeleteBookmark' and 'DeleteBookmarkOnline' API methods for delete bookmarks by name from the document.
+- Added 'DeleteBookmarks' and 'DeleteBookmarksOnline' API methods for delete all bookmarks from the document.
+- Added 'InsertBookmark' and 'InsertBookmarkOnline' API methods for create new bookmarks in the document.
+- Support all save formats for 'CreateDocument' operation.
+
+
+## Enhancements in Version 22.5
+
+- Internal API fixes and improvments.
+
+
 ## Enhancements in Version 22.4
 
 - Added ExportShapesAsSvg to HtmlSaveOption.

TestData/DocumentElements/Sections/Source.docx

@@ -15,6 +15,7 @@
 from asposewordscloud.models.bmp_save_options_data import BmpSaveOptionsData
 from asposewordscloud.models.bookmark import Bookmark
 from asposewordscloud.models.bookmark_data import BookmarkData
+from asposewordscloud.models.bookmark_insert import BookmarkInsert
 from asposewordscloud.models.bookmark_response import BookmarkResponse
 from asposewordscloud.models.bookmarks import Bookmarks
 from asposewordscloud.models.bookmarks_outline_level_data import BookmarksOutlineLevelData

asposewordscloud/__init__.py

@@ -83,12 +83,12 @@ def __init__(self, configuration=None, header_name=None, header_value=None,
 
         self.pool = None
         self.rest_client = rest.RESTClientObject(configuration)
-        self.default_headers = {'x-aspose-client': 'python sdk', 'x-aspose-version': '22.5'}
+        self.default_headers = {'x-aspose-client': 'python sdk', 'x-aspose-version': '22.6'}
         if header_name is not None:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'python sdk 22.5'
+        self.user_agent = 'python sdk 22.6'
 
     def __del__(self):
         if not self.pool is None:

asposewordscloud/api_client.py

@@ -262,6 +262,6 @@ def to_debug_report(self):
         return "Python SDK Debug Report:\n"\
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
-               "Version of the API: 22.5\n"\
-               "SDK Package Version: 22.5".\
+               "Version of the API: 22.6\n"\
+               "SDK Package Version: 22.6".\
                format(env=sys.platform, pyversion=sys.version)

asposewordscloud/apis/words_api.py

@@ -10,6 +10,7 @@
 from asposewordscloud.models.bmp_save_options_data import BmpSaveOptionsData
 from asposewordscloud.models.bookmark import Bookmark
 from asposewordscloud.models.bookmark_data import BookmarkData
+from asposewordscloud.models.bookmark_insert import BookmarkInsert
 from asposewordscloud.models.bookmark_response import BookmarkResponse
 from asposewordscloud.models.bookmarks import Bookmarks
 from asposewordscloud.models.bookmarks_outline_level_data import BookmarksOutlineLevelData

asposewordscloud/configuration.py

@@ -0,0 +1,237 @@
+# coding: utf-8
+# -----------------------------------------------------------------------------------
+# <copyright company="Aspose" file="bookmark_insert.py">
+#   Copyright (c) 2022 Aspose.Words for Cloud
+# </copyright>
+# <summary>
+#   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.
+# </summary>
+# -----------------------------------------------------------------------------------
+import pprint
+import re  # noqa: F401
+
+import datetime
+import six
+import json
+
+
+class BookmarkInsert(object):
+    """Represents a bookmark to insert.
+    """
+
+    """
+    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 = {
+        'name': 'str',
+        'text': 'str',
+        'end_range': 'DocumentPosition',
+        'start_range': 'DocumentPosition'
+    }
+
+    attribute_map = {
+        'name': 'Name',
+        'text': 'Text',
+        'end_range': 'EndRange',
+        'start_range': 'StartRange'
+    }
+
+    def __init__(self, name=None, text=None, end_range=None, start_range=None):  # noqa: E501
+        """BookmarkInsert - a model defined in Swagger"""  # noqa: E501
+
+        self._name = None
+        self._text = None
+        self._end_range = None
+        self._start_range = None
+        self.discriminator = None
+
+        if name is not None:
+            self.name = name
+        if text is not None:
+            self.text = text
+        if end_range is not None:
+            self.end_range = end_range
+        if start_range is not None:
+            self.start_range = start_range
+
+    @property
+    def name(self):
+        """Gets the name of this BookmarkInsert.  # noqa: E501
+
+        Gets or sets the name of the bookmark.  # noqa: E501
+
+        :return: The name of this BookmarkInsert.  # noqa: E501
+        :rtype: str
+        """
+        return self._name
+
+    @name.setter
+    def name(self, name):
+        """Sets the name of this BookmarkInsert.
+
+        Gets or sets the name of the bookmark.  # noqa: E501
+
+        :param name: The name of this BookmarkInsert.  # noqa: E501
+        :type: str
+        """
+        self._name = name
+
+    @property
+    def text(self):
+        """Gets the text of this BookmarkInsert.  # noqa: E501
+
+        Gets or sets text, enclosed in the bookmark.  # noqa: E501
+
+        :return: The text of this BookmarkInsert.  # noqa: E501
+        :rtype: str
+        """
+        return self._text
+
+    @text.setter
+    def text(self, text):
+        """Sets the text of this BookmarkInsert.
+
+        Gets or sets text, enclosed in the bookmark.  # noqa: E501
+
+        :param text: The text of this BookmarkInsert.  # noqa: E501
+        :type: str
+        """
+        self._text = text
+
+    @property
+    def end_range(self):
+        """Gets the end_range of this BookmarkInsert.  # noqa: E501
+
+        Gets or sets the link to end bookmark node.  # noqa: E501
+
+        :return: The end_range of this BookmarkInsert.  # noqa: E501
+        :rtype: DocumentPosition
+        """
+        return self._end_range
+
+    @end_range.setter
+    def end_range(self, end_range):
+        """Sets the end_range of this BookmarkInsert.
+
+        Gets or sets the link to end bookmark node.  # noqa: E501
+
+        :param end_range: The end_range of this BookmarkInsert.  # noqa: E501
+        :type: DocumentPosition
+        """
+        self._end_range = end_range
+
+    @property
+    def start_range(self):
+        """Gets the start_range of this BookmarkInsert.  # noqa: E501
+
+        Gets or sets the link to start bookmark node.  # noqa: E501
+
+        :return: The start_range of this BookmarkInsert.  # noqa: E501
+        :rtype: DocumentPosition
+        """
+        return self._start_range
+
+    @start_range.setter
+    def start_range(self, start_range):
+        """Sets the start_range of this BookmarkInsert.
+
+        Gets or sets the link to start bookmark node.  # noqa: E501
+
+        :param start_range: The start_range of this BookmarkInsert.  # noqa: E501
+        :type: DocumentPosition
+        """
+        self._start_range = start_range
+
+
+    def to_dict(self):
+        """Returns the model properties as a dict"""
+        result = {}
+
+        for attr, _ in six.iteritems(self.swagger_types):
+            value = getattr(self, attr)
+            if value is None:
+                continue
+            if isinstance(value, list):
+                result[self.attribute_map[attr]] = list(map(
+                    lambda x: x.to_dict() if hasattr(x, "to_dict") else x,
+                    value
+                ))
+            elif hasattr(value, "to_dict"):
+                result[self.attribute_map[attr]] = value.to_dict()
+            elif isinstance(value, dict):
+                result[self.attribute_map[attr]] = dict(map(
+                    lambda item: (item[0], item[1].to_dict())
+                    if hasattr(item[1], "to_dict") else item,
+                    value.items()
+                ))
+            elif isinstance(value, (datetime.datetime, datetime.date)):
+                result[self.attribute_map[attr]] = value.isoformat()
+            else:
+                result[self.attribute_map[attr]] = value
+
+        return result
+
+    def to_json(self):
+        """Returns the model properties as a dict"""
+        result = {}
+
+        for attr, _ in six.iteritems(self.swagger_types):
+            value = getattr(self, attr)
+            if isinstance(value, list):
+                result[self.attribute_map[attr]] = list(map(
+                    lambda x: x.to_dict() if hasattr(x, "to_dict") else x,
+                    value
+                ))
+            elif hasattr(value, "to_dict"):
+                result[self.attribute_map[attr]] = value.to_dict()
+            elif isinstance(value, dict):
+                result[self.attribute_map[attr]] = dict(map(
+                    lambda item: (item[0], item[1].to_dict())
+                    if hasattr(item[1], "to_dict") else item,
+                    value.items()
+                ))
+            elif isinstance(value, (datetime.datetime, datetime.date)):
+                result[self.attribute_map[attr]] = value.isoformat()
+            else:
+                result[self.attribute_map[attr]] = value
+
+        return json.dumps(result)
+
+    def to_str(self):
+        """Returns the string representation of the model"""
+        return pprint.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, BookmarkInsert):
+            return False
+
+        return self.__dict__ == other.__dict__
+
+    def __ne__(self, other):
+        """Returns true if both objects are not equal"""
+        return not self == other

asposewordscloud/models/__init__.py

@@ -77,8 +77,6 @@ class EpubSaveOptionsData(object):
         'export_page_setup': 'bool',
         'export_relative_font_size': 'bool',
         'export_roundtrip_information': 'bool',
-        'export_shapes_as_svg': 'bool',
-        'export_text_box_as_svg': 'bool',
         'export_text_input_form_field_as_text': 'bool',
         'export_toc_page_numbers': 'bool',
         'export_xhtml_transitional': 'bool',
@@ -136,8 +134,6 @@ class EpubSaveOptionsData(object):
         'export_page_setup': 'ExportPageSetup',
         'export_relative_font_size': 'ExportRelativeFontSize',
         'export_roundtrip_information': 'ExportRoundtripInformation',
-        'export_shapes_as_svg': 'ExportShapesAsSvg',
-        'export_text_box_as_svg': 'ExportTextBoxAsSvg',
         'export_text_input_form_field_as_text': 'ExportTextInputFormFieldAsText',
         'export_toc_page_numbers': 'ExportTocPageNumbers',
         'export_xhtml_transitional': 'ExportXhtmlTransitional',
@@ -160,7 +156,7 @@ class EpubSaveOptionsData(object):
         'save_format': 'SaveFormat'
     }
 
-    def __init__(self, allow_embedding_post_script_fonts=None, custom_time_zone_info_data=None, dml3_d_effects_rendering_mode=None, dml_effects_rendering_mode=None, dml_rendering_mode=None, file_name=None, flat_opc_xml_mapping_only=None, iml_rendering_mode=None, update_created_time_property=None, update_fields=None, update_last_printed_property=None, update_last_saved_time_property=None, update_sdt_content=None, zip_output=None, allow_negative_indent=None, css_class_name_prefix=None, css_style_sheet_file_name=None, css_style_sheet_type=None, document_split_criteria=None, document_split_heading_level=None, encoding=None, export_document_properties=None, export_drop_down_form_field_as_text=None, export_font_resources=None, export_fonts_as_base64=None, export_headers_footers_mode=None, export_images_as_base64=None, export_language_information=None, export_list_labels=None, export_original_url_for_linked_images=None, export_page_margins=None, export_page_setup=None, export_relative_font_size=None, export_roundtrip_information=None, export_shapes_as_svg=None, export_text_box_as_svg=None, export_text_input_form_field_as_text=None, export_toc_page_numbers=None, export_xhtml_transitional=None, font_resources_subsetting_size_threshold=None, fonts_folder=None, fonts_folder_alias=None, html_version=None, image_resolution=None, images_folder=None, images_folder_alias=None, metafile_format=None, office_math_output_mode=None, pretty_format=None, resolve_font_names=None, resource_folder=None, resource_folder_alias=None, scale_image_to_shape_size=None, table_width_output_mode=None, epub_navigation_map_level=None):  # noqa: E501
+    def __init__(self, allow_embedding_post_script_fonts=None, custom_time_zone_info_data=None, dml3_d_effects_rendering_mode=None, dml_effects_rendering_mode=None, dml_rendering_mode=None, file_name=None, flat_opc_xml_mapping_only=None, iml_rendering_mode=None, update_created_time_property=None, update_fields=None, update_last_printed_property=None, update_last_saved_time_property=None, update_sdt_content=None, zip_output=None, allow_negative_indent=None, css_class_name_prefix=None, css_style_sheet_file_name=None, css_style_sheet_type=None, document_split_criteria=None, document_split_heading_level=None, encoding=None, export_document_properties=None, export_drop_down_form_field_as_text=None, export_font_resources=None, export_fonts_as_base64=None, export_headers_footers_mode=None, export_images_as_base64=None, export_language_information=None, export_list_labels=None, export_original_url_for_linked_images=None, export_page_margins=None, export_page_setup=None, export_relative_font_size=None, export_roundtrip_information=None, export_text_input_form_field_as_text=None, export_toc_page_numbers=None, export_xhtml_transitional=None, font_resources_subsetting_size_threshold=None, fonts_folder=None, fonts_folder_alias=None, html_version=None, image_resolution=None, images_folder=None, images_folder_alias=None, metafile_format=None, office_math_output_mode=None, pretty_format=None, resolve_font_names=None, resource_folder=None, resource_folder_alias=None, scale_image_to_shape_size=None, table_width_output_mode=None, epub_navigation_map_level=None):  # noqa: E501
         """EpubSaveOptionsData - a model defined in Swagger"""  # noqa: E501
 
         self._allow_embedding_post_script_fonts = None
@@ -197,8 +193,6 @@ def __init__(self, allow_embedding_post_script_fonts=None, custom_time_zone_info
         self._export_page_setup = None
         self._export_relative_font_size = None
         self._export_roundtrip_information = None
-        self._export_shapes_as_svg = None
-        self._export_text_box_as_svg = None
         self._export_text_input_form_field_as_text = None
         self._export_toc_page_numbers = None
         self._export_xhtml_transitional = None
@@ -289,10 +283,6 @@ def __init__(self, allow_embedding_post_script_fonts=None, custom_time_zone_info
             self.export_relative_font_size = export_relative_font_size
         if export_roundtrip_information is not None:
             self.export_roundtrip_information = export_roundtrip_information
-        if export_shapes_as_svg is not None:
-            self.export_shapes_as_svg = export_shapes_as_svg
-        if export_text_box_as_svg is not None:
-            self.export_text_box_as_svg = export_text_box_as_svg
         if export_text_input_form_field_as_text is not None:
             self.export_text_input_form_field_as_text = export_text_input_form_field_as_text
         if export_toc_page_numbers is not None:
@@ -1144,50 +1134,6 @@ def export_roundtrip_information(self, export_roundtrip_information):
         """
         self._export_roundtrip_information = export_roundtrip_information
 
-    @property
-    def export_shapes_as_svg(self):
-        """Gets the export_shapes_as_svg of this EpubSaveOptionsData.  # noqa: E501
-
-        Gets or sets the flag, that controls whether Aspose.Words.Drawing.Shape nodes are converted to SVG images when saving to HTML, MHTML or EPUB. Default value is false.  # noqa: E501
-
-        :return: The export_shapes_as_svg of this EpubSaveOptionsData.  # noqa: E501
-        :rtype: bool
-        """
-        return self._export_shapes_as_svg
-
-    @export_shapes_as_svg.setter
-    def export_shapes_as_svg(self, export_shapes_as_svg):
-        """Sets the export_shapes_as_svg of this EpubSaveOptionsData.
-
-        Gets or sets the flag, that controls whether Aspose.Words.Drawing.Shape nodes are converted to SVG images when saving to HTML, MHTML or EPUB. Default value is false.  # noqa: E501
-
-        :param export_shapes_as_svg: The export_shapes_as_svg of this EpubSaveOptionsData.  # noqa: E501
-        :type: bool
-        """
-        self._export_shapes_as_svg = export_shapes_as_svg
-
-    @property
-    def export_text_box_as_svg(self):
-        """Gets the export_text_box_as_svg of this EpubSaveOptionsData.  # noqa: E501
-
-        Gets or sets the flag, that controls how textboxes represented by Aspose.Words.Drawing.Shape are saved to HTML, MHTML or EPUB. The default value is false. When set to true, exports textboxes as inline "svg" elements. When false, exports as "image" elements.  # noqa: E501
-
-        :return: The export_text_box_as_svg of this EpubSaveOptionsData.  # noqa: E501
-        :rtype: bool
-        """
-        return self._export_text_box_as_svg
-
-    @export_text_box_as_svg.setter
-    def export_text_box_as_svg(self, export_text_box_as_svg):
-        """Sets the export_text_box_as_svg of this EpubSaveOptionsData.
-
-        Gets or sets the flag, that controls how textboxes represented by Aspose.Words.Drawing.Shape are saved to HTML, MHTML or EPUB. The default value is false. When set to true, exports textboxes as inline "svg" elements. When false, exports as "image" elements.  # noqa: E501
-
-        :param export_text_box_as_svg: The export_text_box_as_svg of this EpubSaveOptionsData.  # noqa: E501
-        :type: bool
-        """
-        self._export_text_box_as_svg = export_text_box_as_svg
-
     @property
     def export_text_input_form_field_as_text(self):
         """Gets the export_text_input_form_field_as_text of this EpubSaveOptionsData.  # noqa: E501