aspose-words-docling 0.1.1__py3-none-any.whl

aspose_words_docling/__about__.py

@@ -0,0 +1,3 @@
+# SPDX-FileCopyrightText: 2026-Aspose Pty Ltd
+# SPDX-License-Identifier: MIT
+__version__ = "0.1.1"

aspose_words_docling/__init__.py

@@ -0,0 +1,14 @@
+# SPDX-FileCopyrightText: 2026-Aspose Pty Ltd
+# SPDX-License-Identifier: MIT
+
+from .aspose_words_converter import (
+    AsposeWordsConverter, LicenseManager
+)
+
+from .__about__ import __version__
+
+__all__ = [
+    "__version__",
+    "AsposeWordsConverter",
+    "LicenseManager"
+]

aspose_words_docling/aspose_words_converter.py

@@ -0,0 +1,47 @@
+# Copyright (c) 2001-2026 Aspose Pty Ltd.
+
+from io import BytesIO
+import json, os, logging
+from docling_core.types.doc.document import DoclingDocument
+
+import aspose.words as aw
+
+
+class AsposeWordsConverter:
+    def convert(self, file: str) -> DoclingDocument:
+        license_manager = LicenseManager()
+        license_manager.apply_license() 
+
+        aspose_doc = aw.Document(file)
+        aspose_doc.update_list_labels()
+        buffer = BytesIO()
+        save_options = aw.saving.DoclingSaveOptions()
+        aspose_doc.save(buffer, save_options)
+        doc_dict = json.loads(buffer.getvalue())
+        origin = doc_dict.get("origin")
+        if origin is not None:
+            mimetype = origin.get("mimetype")
+        # Docling doesn't support such mime types.
+        if (mimetype == "application/rtf" or mimetype == "multipart/related"):
+            origin["mimetype"] = "text/plain"
+
+        docling_doc = DoclingDocument.model_validate(doc_dict)
+        return docling_doc
+    
+
+""" To activate your Aspose License, set the corresponding environment variable.
+    Refer to the OS-specific instructions below:
+    Unix-based (Linux/macOS):
+        export ASPOSE_WORDS_LICENSE_PATH="/path/to/license/aspose.words.lic"
+    Windows-based:
+        set ASPOSE_WORDS_LICENSE_PATH=c:\\path\\to\\license\\aspose.words.lic """
+class LicenseManager:
+    def apply_license(self, license_path: str = None):
+        if license_path is None:
+            license_path = os.getenv("ASPOSE_WORDS_LICENSE_PATH")
+        if license_path is not None and os.path.exists(license_path):
+            logging.info(f"Applying Aspose.Words license from: {license_path}")
+            license = aw.License()
+            license.set_license(license_path)
+        else:
+            logging.warning("No valid Aspose.Words license found. Running in Evaluation mode. Please set the ASPOSE_WORDS_LICENSE_PATH environment variable.")

aspose_words_docling-0.1.1.dist-info/METADATA

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: aspose-words-docling
+Version: 0.1.1
+Summary: Aspose.Words plugin for Docling
+Project-URL: Documentation, https://github.com/aspose-words/Aspose.Words-for-Docling#readme
+Project-URL: Repository, https://github.com/aspose-words/Aspose.Words-for-Docling
+Project-URL: Examples, https://github.com/aspose-words/Aspose.Words-for-Docling/blob/main/packages/aspose-words-docling/tests/test_aspose_backend.py
+Project-URL: Free Support, https://forum.aspose.com/c/words/8
+Author-email: Aspose <support@aspose.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: aspose,conversion,doc,docling,epub,mhtml,odt,pdf,plugin,rtf,word
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.13
+Requires-Dist: aspose-words>=26.1.0
+Requires-Dist: docling>=2.60.0
+Description-Content-Type: text/markdown
+
+# Aspose.Words for Docling
+
+![Python Version](https://img.shields.io/badge/python-3.12+-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+## Overview
+**Aspose.Words for Docling** is a free plugin for [Docling](https://github.com/docling-project/docling) based on [Aspose.Words for Python via .Net](https://products.aspose.com/words/python-net/) commercial library.  
+The plugin is designed for parsing multiple document formats and converting them into Docling Documents suitable for AI processing.  
+**Aspose.Words** plugin allows you to convert formats as `.docx`, `.pdf`, `.doc`, `.rtf`, `.html`, `.mhtml`, `.mobi`, `.azw3`, `.epub`, `.odt`, `.txt`, `.md` and `.xml`.
+
+
+## Features
+
+- Convert `.docx`, `.pdf`, `.doc`, `.rtf`, `.html`, `.mhtml`, `.mobi`, `.azw3`, `.epub`, `.odt`, `.txt`, `.md` and `.xml` to [DoclingDocument](https://docling-project.github.io/docling/concepts/docling_document/).
+- Support all document components, including paragraphs, tables, images, headers, and footers.
+
+## Requirements
+
+- [Docling](https://github.com/docling-project/docling) version 2.60.0 or higher.
+- [Aspose.Words for Python via .Net](https://products.aspose.com/words/python-net/). This library is a [commercial product](https://purchase.aspose.com/buy/words/python).  
+You'll need to obtain a valid license for Aspose.Words. The package will install this dependency, but you're responsible for complying with Aspose's licensing terms.
+
+## Installation
+
+```bash
+pip install aspose-words-docling
+```
+
+### Python API
+
+```python
+from aspose_words_docling import AsposeWordsConverter
+
+aspose_converter = AsposeWordsConverter()
+doc = aspose_converter.convert("test.doc")
+
+md = doc.export_to_markdown()
+print(md)
+```
+
+
+## Set License
+
+### Environment Variables
+To activate your Aspose.Words for Python license, set the corresponding environment variable.  
+Refer to the OS-specific instructions below:
+
+**Unix-based (Linux/macOS):**
+```
+export ASPOSE_WORDS_LICENSE_PATH="/path/to/license/aspose.words.lic"
+```
+**Windows-based:**
+```
+set ASPOSE_WORDS_LICENSE_PATH=c:\path\to\license\aspose.words.lic
+```
+**Python API:**
+```
+from aspose_words_docling import LicenseManager
+
+LicenseManager().apply_license("/path/to/license/aspose.words.lic")
+```
+
+## Running Tests
+
+To run unit tests for **Aspose.Words for Docling**, follow these steps:
+
+### 1. Navigate to the package directory
+
+From the root of the repository, change into the package directory:
+
+```bash
+cd /packages/aspose-words-docling/tests
+```
+
+### 2. Install test dependencies
+
+Make sure `pytest` is installed:
+
+```bash
+pip install pytest
+```
+
+### 3. Run tests using `pytest`
+
+To run all tests:
+
+```bash
+pytest
+```
+
+## License
+
+This package is licensed under the MIT License. However, it depends on Aspose.Words for Python via .Net library, which is proprietary, closed-source library.
+
+⚠️ You must obtain valid license for Aspose.Words for Python via .Net library. This repository does not include or distribute any proprietary components.
+
+## Trademarks
+
+This project may contain trademarks or logos for projects, products, or services. Authorized use of IBM
+trademarks or logos is subject to and must follow
+[IBM's Trademarks](https://www.ibm.com/legal/copyright-trademark).
+[IBM Logo and Brand Guidelines](https://www.ibm.com/design/language/files/IBM_Logo_3rdParties_300822.pdf).
+Use of IBM trademarks or logos in modified versions of this project must not cause confusion or imply IBM sponsorship.
+Any use of third-party trademarks or logos are subject to those third-party's policies.

aspose_words_docling-0.1.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+aspose_words_docling/__about__.py,sha256=NhRcI7y5OmKaA0sJgpxnJUPbYXJb_guZ5lWGli61jSc,102
+aspose_words_docling/__init__.py,sha256=n3efTQA80zJbH9kfZvZuyFCbuiL9B8MjNB-BED0TJBY,292
+aspose_words_docling/aspose_words_converter.py,sha256=rxs_SooKK5DhaYfLbBIybqUBmYjw-qNrUySEhCQPqT4,1956
+aspose_words_docling/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+aspose_words_docling-0.1.1.dist-info/METADATA,sha256=8leJS-a9FZE_8zQkdczC0uE8p-mMObyNM2ZFd9x7pDo,4482
+aspose_words_docling-0.1.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+aspose_words_docling-0.1.1.dist-info/licenses/LICENSE,sha256=QSZCFYZxbZBYb9MYRIvjLaleXR3Gt6G5q7Ml_YX9Zhw,1097
+aspose_words_docling-0.1.1.dist-info/RECORD,,

aspose_words_docling-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

aspose_words_docling-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Aspose Pty Ltd
+
+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.