aspose-cells-foss 25.12.1__tar.gz

aspose_cells_foss-25.12.1/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: aspose-cells-foss
+Version: 25.12.1
+Summary: Modern Pythonic Excel processing library with plugin ecosystem
+Author-email: "Aspose.Cells Team" <cells@aspose.com>
+License: Apache-2.0 OR Proprietary
+Keywords: excel,xlsx,spreadsheet,aspose,cells,python,markitdown,markdown,converter,plugin
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Office/Business :: Financial :: Spreadsheet
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Provides-Extra: markitdown
+Requires-Dist: markitdown>=0.1.0; extra == "markitdown"
+Provides-Extra: docling
+Requires-Dist: docling; extra == "docling"
+
+# Aspose.Cells for Python (FOSS Edition)
+
+Modern Pythonic Excel processing library with advanced plugin ecosystem for enhanced document conversion.
+
+[![PyPI version](https://badge.fury.io/py/aspose-cells-foss.svg)](https://badge.fury.io/py/aspose-cells-foss)
+[![License: Split](https://img.shields.io/badge/License-Split-blue.svg)](https://aspose.org/)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![Downloads](https://pepy.tech/badge/aspose-cells-foss)](https://pepy.tech/project/aspose-cells-foss)
+
+## Overview
+
+Aspose.Cells for Python is a high-performance Excel processing library that provides a clean, Pythonic API for working with Excel files. It offers both standalone functionality and seamless integration with popular document conversion frameworks through its plugin ecosystem.
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+# Core library
+pip install aspose-cells-foss
+
+# With MarkItDown plugin support
+pip install aspose-cells-foss[markitdown]
+
+# With Docling backend support
+pip install aspose-cells-foss[docling]
+
+# With all optional dependencies
+pip install aspose-cells-foss[markitdown,docling]
+```
+
+### From Source
+
+```bash
+# Clone repository
+git clone https://github.com/aspose-cells/aspose-cells-python.git
+cd aspose-cells-python
+
+# Install in development mode
+pip install -e .
+
+# With plugin support
+pip install -e .[markitdown]  # MarkItDown plugin
+pip install -e .[docling]     # Docling backend
+```
+
+## Quick Start
+
+```python
+from aspose.cells import Workbook, FileFormat
+
+# Create and populate workbook
+wb = Workbook()
+ws = wb.active
+
+# Multiple ways to set data
+ws['A1'] = "Product"        # Excel-style
+ws[0, 1] = "Price"          # Python-style (0-based)
+ws.cell(1, 3).value = "Qty" # Traditional method
+
+# Batch operations
+ws.append(["Laptop", 999.99, 5])
+ws.append(["Mouse", 29.95, 50])
+
+# Export to multiple formats
+wb.save("products.xlsx", FileFormat.XLSX)
+wb.save("products.csv", FileFormat.CSV)
+json_str = wb.exportAs(FileFormat.JSON)
+markdown_str = wb.exportAs(FileFormat.MARKDOWN)
+```
+
+## Core Features
+
+### Multi-Access Cell Interface
+Three flexible ways to work with cells:
+- **Excel-style**: `ws['A1'] = value`
+- **Python-style**: `ws[0, 1] = value` (0-based indexing)  
+- **Traditional**: `ws.cell(1, 3).value = value`
+
+### Styling and Formatting
+```python
+# Cell styling
+ws['A1'].font.bold = True
+ws['A1'].font.size = 14
+ws['A1'].fill.color = "lightgray"
+
+# Range styling
+ws['A1:C1'].font.bold = True
+```
+
+### Data Import/Export
+```python
+# From records
+records = [{"name": "Alice", "age": 25}, {"name": "Bob", "age": 30}]
+ws.from_records(records)
+
+# Export formats
+formats = [FileFormat.XLSX, FileFormat.CSV, FileFormat.JSON, FileFormat.MARKDOWN]
+```
+
+## Plugin Ecosystem
+
+Aspose.Cells for Python extends functionality through specialized plugins for popular document conversion frameworks:
+
+### MarkItDown Plugin
+Enhanced Excel-to-Markdown conversion with improved formatting capabilities.
+
+**Key Benefits:**
+- Hyperlink preservation and clean table formatting  
+- Configurable conversion parameters
+- Enhanced output quality
+
+```bash
+# Install and use
+pip install -e .[markitdown]
+markitdown --use-plugins spreadsheet.xlsx -o output.md
+```
+
+**→ [View MarkItDown Plugin Documentation](aspose/cells/plugins/markitdown_plugin/README.md)**
+
+### Docling Backend
+Document backend for IBM Docling framework.
+
+**Key Benefits:**
+- Enhanced Excel processing for complex spreadsheets
+- Multi-format export (Markdown, JSON)
+- Advanced document structure support
+
+```bash
+# Install and use
+pip install -e .[docling]
+```
+
+```python
+from docling.datamodel.base_models import InputFormat
+from docling.datamodel.document import InputDocument
+from aspose.cells.plugins.docling_backend import CellsDocumentBackend
+
+# Create input document with Aspose backend
+input_doc = InputDocument(
+    path_or_stream="spreadsheet.xlsx",
+    format=InputFormat.XLSX,
+    backend=CellsDocumentBackend,
+    filename="spreadsheet.xlsx"
+)
+
+# Initialize backend and convert
+backend = CellsDocumentBackend(in_doc=input_doc, path_or_stream="spreadsheet.xlsx")
+document = backend.convert()
+markdown_content = document.export_to_markdown()
+```
+
+**→ [View Docling Backend Documentation](aspose/cells/plugins/docling_backend/README.md)**
+
+## License
+
+This project is licensed under the Aspose Split License Agreement - see the [LICENSE](license/Aspose_Split-License-Agreement_2025-07-08_WIP.txt) file for details.
+
+Part of the [Aspose.org](https://aspose.org) open source ecosystem.
+
+## Requirements
+
+- Python 3.8+
+- Optional: markitdown>=0.1.0 (for MarkItDown plugin)
+- Optional: docling (for Docling backend)

aspose_cells_foss-25.12.1/README.md

@@ -0,0 +1,165 @@
+# Aspose.Cells for Python (FOSS Edition)
+
+Modern Pythonic Excel processing library with advanced plugin ecosystem for enhanced document conversion.
+
+[![PyPI version](https://badge.fury.io/py/aspose-cells-foss.svg)](https://badge.fury.io/py/aspose-cells-foss)
+[![License: Split](https://img.shields.io/badge/License-Split-blue.svg)](https://aspose.org/)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![Downloads](https://pepy.tech/badge/aspose-cells-foss)](https://pepy.tech/project/aspose-cells-foss)
+
+## Overview
+
+Aspose.Cells for Python is a high-performance Excel processing library that provides a clean, Pythonic API for working with Excel files. It offers both standalone functionality and seamless integration with popular document conversion frameworks through its plugin ecosystem.
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+# Core library
+pip install aspose-cells-foss
+
+# With MarkItDown plugin support
+pip install aspose-cells-foss[markitdown]
+
+# With Docling backend support
+pip install aspose-cells-foss[docling]
+
+# With all optional dependencies
+pip install aspose-cells-foss[markitdown,docling]
+```
+
+### From Source
+
+```bash
+# Clone repository
+git clone https://github.com/aspose-cells/aspose-cells-python.git
+cd aspose-cells-python
+
+# Install in development mode
+pip install -e .
+
+# With plugin support
+pip install -e .[markitdown]  # MarkItDown plugin
+pip install -e .[docling]     # Docling backend
+```
+
+## Quick Start
+
+```python
+from aspose.cells import Workbook, FileFormat
+
+# Create and populate workbook
+wb = Workbook()
+ws = wb.active
+
+# Multiple ways to set data
+ws['A1'] = "Product"        # Excel-style
+ws[0, 1] = "Price"          # Python-style (0-based)
+ws.cell(1, 3).value = "Qty" # Traditional method
+
+# Batch operations
+ws.append(["Laptop", 999.99, 5])
+ws.append(["Mouse", 29.95, 50])
+
+# Export to multiple formats
+wb.save("products.xlsx", FileFormat.XLSX)
+wb.save("products.csv", FileFormat.CSV)
+json_str = wb.exportAs(FileFormat.JSON)
+markdown_str = wb.exportAs(FileFormat.MARKDOWN)
+```
+
+## Core Features
+
+### Multi-Access Cell Interface
+Three flexible ways to work with cells:
+- **Excel-style**: `ws['A1'] = value`
+- **Python-style**: `ws[0, 1] = value` (0-based indexing)  
+- **Traditional**: `ws.cell(1, 3).value = value`
+
+### Styling and Formatting
+```python
+# Cell styling
+ws['A1'].font.bold = True
+ws['A1'].font.size = 14
+ws['A1'].fill.color = "lightgray"
+
+# Range styling
+ws['A1:C1'].font.bold = True
+```
+
+### Data Import/Export
+```python
+# From records
+records = [{"name": "Alice", "age": 25}, {"name": "Bob", "age": 30}]
+ws.from_records(records)
+
+# Export formats
+formats = [FileFormat.XLSX, FileFormat.CSV, FileFormat.JSON, FileFormat.MARKDOWN]
+```
+
+## Plugin Ecosystem
+
+Aspose.Cells for Python extends functionality through specialized plugins for popular document conversion frameworks:
+
+### MarkItDown Plugin
+Enhanced Excel-to-Markdown conversion with improved formatting capabilities.
+
+**Key Benefits:**
+- Hyperlink preservation and clean table formatting  
+- Configurable conversion parameters
+- Enhanced output quality
+
+```bash
+# Install and use
+pip install -e .[markitdown]
+markitdown --use-plugins spreadsheet.xlsx -o output.md
+```
+
+**→ [View MarkItDown Plugin Documentation](aspose/cells/plugins/markitdown_plugin/README.md)**
+
+### Docling Backend
+Document backend for IBM Docling framework.
+
+**Key Benefits:**
+- Enhanced Excel processing for complex spreadsheets
+- Multi-format export (Markdown, JSON)
+- Advanced document structure support
+
+```bash
+# Install and use
+pip install -e .[docling]
+```
+
+```python
+from docling.datamodel.base_models import InputFormat
+from docling.datamodel.document import InputDocument
+from aspose.cells.plugins.docling_backend import CellsDocumentBackend
+
+# Create input document with Aspose backend
+input_doc = InputDocument(
+    path_or_stream="spreadsheet.xlsx",
+    format=InputFormat.XLSX,
+    backend=CellsDocumentBackend,
+    filename="spreadsheet.xlsx"
+)
+
+# Initialize backend and convert
+backend = CellsDocumentBackend(in_doc=input_doc, path_or_stream="spreadsheet.xlsx")
+document = backend.convert()
+markdown_content = document.export_to_markdown()
+```
+
+**→ [View Docling Backend Documentation](aspose/cells/plugins/docling_backend/README.md)**
+
+## License
+
+This project is licensed under the Aspose Split License Agreement - see the [LICENSE](license/Aspose_Split-License-Agreement_2025-07-08_WIP.txt) file for details.
+
+Part of the [Aspose.org](https://aspose.org) open source ecosystem.
+
+## Requirements
+
+- Python 3.8+
+- Optional: markitdown>=0.1.0 (for MarkItDown plugin)
+- Optional: docling (for Docling backend)

aspose_cells_foss-25.12.1/aspose/__init__.py

@@ -0,0 +1,14 @@
+"""
+Aspose.Cells.Python - Modern Excel processing library
+
+Open source Excel processing library from Aspose.org providing Pythonic API 
+for Excel file manipulation with comprehensive data structures, conversion 
+capabilities, and extensible plugin ecosystem.
+
+Part of the Aspose.org open source ecosystem.
+"""
+
+from .cells import Workbook, FileFormat
+
+__version__ = "1.0.0"
+__all__ = ["Workbook", "FileFormat"]

aspose_cells_foss-25.12.1/aspose/cells/__init__.py

@@ -0,0 +1,31 @@
+"""
+Core Excel processing module providing workbook, worksheet, and cell management.
+
+Part of Aspose.Cells.Python - an open source Excel processing library from Aspose.org.
+"""
+
+from .workbook import Workbook
+from .worksheet import Worksheet
+from .cell import Cell
+from .range import Range
+from .formats import FileFormat, ConversionOptions, CellValue
+from .style import Style, Font, Fill
+from .drawing import Image, ImageFormat, Anchor, AnchorType, ImageCollection
+
+__all__ = [
+    "Workbook", 
+    "Worksheet", 
+    "Cell", 
+    "Range", 
+    "FileFormat",
+    "ConversionOptions",
+    "CellValue",
+    "Style", 
+    "Font", 
+    "Fill",
+    "Image",
+    "ImageFormat",
+    "Anchor",
+    "AnchorType",
+    "ImageCollection"
+]