pyxtxt 0.1.23__tar.gz → 0.2__tar.gz

{pyxtxt-0.1.23/src/pyxtxt.egg-info → pyxtxt-0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyxtxt
-Version: 0.1.23
+Version: 0.2
 Summary: A Python library for extracting text from different types of files (PDF, DOCX, PPTX, XLSX, ODT, ecc.).
 Author-email: Giuseppe Levi <giuseppe.levi@gmail.com>
 License: MIT License
@@ -63,23 +63,26 @@ Requires-Dist: lxml; extra == "all"
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 **PyxTxt** is a simple and powerful Python library to extract text from various file formats.  
-It supports PDF, DOCX, XLSX, PPTX, ODT, HTML, XML, TXT, legacy XLS files, and more.
+It supports PDF, DOCX, XLSX, PPTX, ODT, HTML, XML, TXT, legacy Office files, and more.
+
+**NEW in v0.1.24+**: Enhanced support for web content, byte streams, and requests integration!
 
 ---
 
 ## ✨ Features
 
-- Extracts text from both file paths and in-memory buffers (`io.BytesIO`).
-- Supports multiple formats: PDF, DOCX, PPTX, XLSX, ODT, HTML, XML, TXT, legacy Office files (.xls,.ppt).
-- Automatically detects MIME type using `python-magic`.
-- Compatible with modern and legacy formats.
-- Can handle streamed content without saving to disk (with some limitations).
+- **Multiple input types**: File paths, `io.BytesIO` buffers, raw `bytes` objects, and `requests.Response` objects
+- **Wide format support**: PDF, DOCX, PPTX, XLSX, ODT, HTML, XML, TXT, legacy Office files (.xls, .ppt, .doc)
+- **Automatic MIME detection**: Uses `python-magic` for intelligent file type recognition
+- **Web-ready**: Direct support for downloading and extracting text from URLs
+- **Memory efficient**: Process files without saving to disk
+- **Modern Python**: Full type hints and clean API design
 
 ---
 
 ## 📦 Installation 
 
-The library i modular so you can install all modules:
+The library is modular so you can install all modules:
 
 ```bash
 pip install pyxtxt[all]
@@ -88,8 +91,8 @@ or just the modules you need:
 ```bash
 pip install pyxtxt[pdf,odf,docx,presentation,spreadsheet,html]
 ```
-Beause needed libraries are common installing the html module will enable also SVG and XML.
-The architecture is designed to be able to grow with new modules to work with other formats as well.
+Because needed libraries are common, installing the html module will also enable SVG and XML support.
+The architecture is designed to grow with new modules for additional formats.
 ## ⚠️ Note: You must have libmagic installed on your system (required by python-magic).
 The pyproject.toml file should select the correct version for your system. But if you have any problem you can install it manually.
 
@@ -129,55 +132,105 @@ Use python-magic-bin instead of python-magic for easier installation.
 
 Dependencies are automatically installed from pyproject.toml.
 
-## 📚 Usage Example
-Extract text from a file path:
+## 📚 Usage Examples
 
+### Basic Usage
 ```python
 from pyxtxt import xtxt
 
+# Extract from file path
 text = xtxt("document.pdf")
 print(text)
-```
-Extract text from a file-like buffer:
 
-```python
+# Extract from BytesIO buffer
 import io
-
 with open("document.docx", "rb") as f:
     buffer = io.BytesIO(f.read())
-
-from pyxtxt import xtxt
 text = xtxt(buffer)
 print(text)
 ```
-Show available formats:
-from pyxtxt import extxt_available_formats
+
+### NEW: Web Content Support
 ```python
-from pyxtxt import extxt_available_formats
-text = extxt_available_formats()
-print(text)
-# For a pretty printing
-text = extxt_available_formats(True)
-print(text)
+import requests
+from pyxtxt import xtxt, xtxt_from_url
+
+# Method 1: Direct from bytes
+response = requests.get("https://example.com/document.pdf")
+text = xtxt(response.content)
+
+# Method 2: Direct from Response object  
+text = xtxt(response)
+
+# Method 3: URL helper function
+text = xtxt_from_url("https://example.com/document.pdf")
 ```
-## ⚠️ Known Limitations
-When passing a raw stream (io.BytesIO) without a filename, legacy files (.doc, .xls, .ppt) may not be correctly detected.
 
-This is a limitation of libmagic beacuse the signature byte sequence at the start of doc/xls/ppt is exactly the same (b'\xD0\xCF\x11\xE0\xA1\xB1\x1A\xE1'),
-not of pyxtxt.
+### Show Available Formats
+```python
+from pyxtxt import extxt_available_formats
+
+# List supported MIME types
+formats = extxt_available_formats()
+print(formats)
+
+# Pretty format names
+formats = extxt_available_formats(pretty=True)
+print(formats)
+```
+## 🌐 Common Web Use Cases
 
-If available, using the original filename is highly recommended.
+```python
+# API responses
+api_response = requests.post("https://api.example.com/generate-pdf")
+text = xtxt(api_response.content)
 
-To extract text from documents in MSWrite's old .doc format, it is necessary to install antiword.
+# File uploads (Flask/Django)
+uploaded_bytes = request.files['document'].read()
+text = xtxt(uploaded_bytes)
 
-```bash
-sudo apt-get update
-sudo apt-get -y install antiword
+# Email attachments
+attachment_bytes = email_msg.get_payload(decode=True)
+text = xtxt(attachment_bytes)
 ```
 
+## ⚠️ Known Limitations
+
+- **Legacy file detection**: When using raw streams without filenames, legacy files (.doc, .xls, .ppt) may not be correctly detected due to identical file signatures in libmagic
+- **Filename hints recommended**: When available, providing original filenames improves detection accuracy
+- **MSWrite .doc files**: Require `antiword` installation:
+  ```bash
+  sudo apt-get update && sudo apt-get install antiword
+  ```
+
+## 📖 Full Examples
+
+See [examples.py](https://github.com/dede-amdp/pyxtxt/blob/main/examples.py) for comprehensive usage examples including:
+- Local file processing
+- Memory buffer handling  
+- Web content extraction
+- Error handling patterns
+- All supported formats demonstration
+
 ## 🔒 License
-Distributed under the MIT License.
+
+Distributed under the MIT License. See LICENSE file for details.
 
 The software is provided "as is" without any warranty of any kind.
 
+## 🤝 Contributing
+
 Pull requests, issues, and feedback are warmly welcome! 🚀
+
+- **Bug reports**: Please include file samples and error details
+- **Feature requests**: Describe your use case and expected behavior
+- **Code contributions**: Follow existing patterns and add tests
+
+## 📊 Changelog
+
+### v0.1.24+
+- ✅ Added support for `bytes` objects
+- ✅ Added support for `requests.Response` objects  
+- ✅ Added `xtxt_from_url()` helper function
+- ✅ Improved type hints and error handling
+- ✅ Enhanced web content processing capabilities

pyxtxt-0.2/README.md

@@ -0,0 +1,178 @@
+# PyxTxt
+
+[![PyPI version](https://img.shields.io/pypi/v/pyxtxt.svg)](https://pypi.org/project/pyxtxt/)
+[![Python versions](https://img.shields.io/pypi/pyversions/pyxtxt.svg)](https://pypi.org/project/pyxtxt/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**PyxTxt** is a simple and powerful Python library to extract text from various file formats.  
+It supports PDF, DOCX, XLSX, PPTX, ODT, HTML, XML, TXT, legacy Office files, and more.
+
+**NEW in v0.1.24+**: Enhanced support for web content, byte streams, and requests integration!
+
+---
+
+## ✨ Features
+
+- **Multiple input types**: File paths, `io.BytesIO` buffers, raw `bytes` objects, and `requests.Response` objects
+- **Wide format support**: PDF, DOCX, PPTX, XLSX, ODT, HTML, XML, TXT, legacy Office files (.xls, .ppt, .doc)
+- **Automatic MIME detection**: Uses `python-magic` for intelligent file type recognition
+- **Web-ready**: Direct support for downloading and extracting text from URLs
+- **Memory efficient**: Process files without saving to disk
+- **Modern Python**: Full type hints and clean API design
+
+---
+
+## 📦 Installation 
+
+The library is modular so you can install all modules:
+
+```bash
+pip install pyxtxt[all]
+```
+or just the modules you need:
+```bash
+pip install pyxtxt[pdf,odf,docx,presentation,spreadsheet,html]
+```
+Because needed libraries are common, installing the html module will also enable SVG and XML support.
+The architecture is designed to grow with new modules for additional formats.
+## ⚠️ Note: You must have libmagic installed on your system (required by python-magic).
+The pyproject.toml file should select the correct version for your system. But if you have any problem you can install it manually.
+
+**On Ubuntu/Debian:**
+
+```bash
+sudo apt install libmagic1
+```
+
+**On Mac (Homebrew):**
+
+```bash
+brew install libmagic
+```
+**On Windows:**
+
+Use python-magic-bin instead of python-magic for easier installation.
+
+## 🛠️ Dependencies
+- PyMuPDF (fitz)
+
+- beautifulsoup4
+
+- python-docx
+
+- python-pptx
+
+- odfpy
+
+- openpyxl
+
+- lxml
+
+- xlrd (<2.0.0)
+
+- python-magic
+
+Dependencies are automatically installed from pyproject.toml.
+
+## 📚 Usage Examples
+
+### Basic Usage
+```python
+from pyxtxt import xtxt
+
+# Extract from file path
+text = xtxt("document.pdf")
+print(text)
+
+# Extract from BytesIO buffer
+import io
+with open("document.docx", "rb") as f:
+    buffer = io.BytesIO(f.read())
+text = xtxt(buffer)
+print(text)
+```
+
+### NEW: Web Content Support
+```python
+import requests
+from pyxtxt import xtxt, xtxt_from_url
+
+# Method 1: Direct from bytes
+response = requests.get("https://example.com/document.pdf")
+text = xtxt(response.content)
+
+# Method 2: Direct from Response object  
+text = xtxt(response)
+
+# Method 3: URL helper function
+text = xtxt_from_url("https://example.com/document.pdf")
+```
+
+### Show Available Formats
+```python
+from pyxtxt import extxt_available_formats
+
+# List supported MIME types
+formats = extxt_available_formats()
+print(formats)
+
+# Pretty format names
+formats = extxt_available_formats(pretty=True)
+print(formats)
+```
+## 🌐 Common Web Use Cases
+
+```python
+# API responses
+api_response = requests.post("https://api.example.com/generate-pdf")
+text = xtxt(api_response.content)
+
+# File uploads (Flask/Django)
+uploaded_bytes = request.files['document'].read()
+text = xtxt(uploaded_bytes)
+
+# Email attachments
+attachment_bytes = email_msg.get_payload(decode=True)
+text = xtxt(attachment_bytes)
+```
+
+## ⚠️ Known Limitations
+
+- **Legacy file detection**: When using raw streams without filenames, legacy files (.doc, .xls, .ppt) may not be correctly detected due to identical file signatures in libmagic
+- **Filename hints recommended**: When available, providing original filenames improves detection accuracy
+- **MSWrite .doc files**: Require `antiword` installation:
+  ```bash
+  sudo apt-get update && sudo apt-get install antiword
+  ```
+
+## 📖 Full Examples
+
+See [examples.py](https://github.com/dede-amdp/pyxtxt/blob/main/examples.py) for comprehensive usage examples including:
+- Local file processing
+- Memory buffer handling  
+- Web content extraction
+- Error handling patterns
+- All supported formats demonstration
+
+## 🔒 License
+
+Distributed under the MIT License. See LICENSE file for details.
+
+The software is provided "as is" without any warranty of any kind.
+
+## 🤝 Contributing
+
+Pull requests, issues, and feedback are warmly welcome! 🚀
+
+- **Bug reports**: Please include file samples and error details
+- **Feature requests**: Describe your use case and expected behavior
+- **Code contributions**: Follow existing patterns and add tests
+
+## 📊 Changelog
+
+### v0.1.24+
+- ✅ Added support for `bytes` objects
+- ✅ Added support for `requests.Response` objects  
+- ✅ Added `xtxt_from_url()` helper function
+- ✅ Improved type hints and error handling
+- ✅ Enhanced web content processing capabilities

{pyxtxt-0.1.23 → pyxtxt-0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pyxtxt"
-version = "0.1.23"
+version = "0.2"
 description = "A Python library for extracting text from different types of files (PDF, DOCX, PPTX, XLSX, ODT, ecc.)."
 readme = "README.md"
 requires-python = ">=3.7"

pyxtxt-0.2/src/pyxtxt/__init__.py

@@ -0,0 +1 @@
+from .core import xtxt, extxt_available_formats, xtxt_from_url

{pyxtxt-0.1.23 → pyxtxt-0.2}/src/pyxtxt/core.py

@@ -2,6 +2,8 @@ from .estrattori import estrattori
 from functools import singledispatch
 import io
 import magic
+from typing import Union, Optional
+from urllib.parse import urlparse
 
 @singledispatch
 def xtxt(file_input):
@@ -9,7 +11,7 @@ def xtxt(file_input):
 
 # Caso 1: file path (str)
 @xtxt.register
-def _(file_input: str):
+def _(file_input: str) -> Optional[str]:
     try:
         with open(file_input, "rb") as f:
             data = f.read()
@@ -23,7 +25,7 @@ def _(file_input: str):
 
 # Caso 2: buffer (BytesIO)
 @xtxt.register
-def _(file_input: io.BytesIO):
+def _(file_input: io.BytesIO) -> Optional[str]:
     try:
 
 
@@ -47,7 +49,6 @@ def _(file_input: io.BytesIO):
             mime_type = magic.Magic(mime=True).from_buffer(file_input.read(2048))
             file_input.name='IO_buffer'
             file_input.seek(0)
-        print(mime_type)
         if mime_type.startswith("text/"):
             if (mime_type != "text/html") and (mime_type != "text/xml") and (mime_type != "text/plain"):
                print(f"📄 File recognized as text type: {mime_type}, treated as text/plain")
@@ -63,6 +64,59 @@ def _(file_input: io.BytesIO):
     except  Exception as e:
         print(f"❌ Error while reading: {e}")
         return None
+
+# Caso 3: bytes object
+@xtxt.register
+def _(file_input: bytes) -> Optional[str]:
+    """Estrae testo da oggetto bytes (es. da download web)"""
+    try:
+        buffer = io.BytesIO(file_input)
+        buffer.name = 'bytes_input'
+        mime_type = magic.Magic(mime=True).from_buffer(file_input[:2048])
+        buffer.mimeType = mime_type
+        return xtxt(buffer)
+    except Exception as e:
+        print(f"❌ Error processing bytes: {e}")
+        return None
+
+# Supporto per requests.Response (se disponibile)
+try:
+    import requests
+    
+    @xtxt.register
+    def _(file_input: requests.Response) -> Optional[str]:
+        """Estrae testo da requests.Response object"""
+        try:
+            return xtxt(file_input.content)
+        except Exception as e:
+            print(f"❌ Error processing Response: {e}")
+            return None
+except ImportError:
+    # requests non installato, skip registrazione
+    pass
+
+def xtxt_from_url(url: str, **kwargs) -> Optional[str]:
+    """Scarica contenuto da URL e ne estrae il testo
+    
+    Args:
+        url: URL del documento da processare  
+        **kwargs: Parametri aggiuntivi per requests.get()
+        
+    Returns:
+        str: Testo estratto o None se errore
+    """
+    try:
+        import requests
+        response = requests.get(url, **kwargs)
+        response.raise_for_status()
+        return xtxt(response.content)
+    except ImportError:
+        print("❌ requests library not installed. Install with: pip install requests")
+        return None
+    except Exception as e:
+        print(f"❌ Error downloading from URL {url}: {e}")
+        return None
+
 def extxt_available_formats(pretty=False):
     if pretty:
         from .estrattori import pretty_names

pyxtxt-0.2/src/pyxtxt/estrattori/doc.py

@@ -0,0 +1,26 @@
+
+from . import register_extractor
+import shutil
+import tempfile
+import subprocess
+def xtxt_doc(file_buffer):
+        if shutil.which("antiword") is None:
+            print("⚠️ 'antiword' is not installed or is not in the system PATH.")
+            return None
+        try:
+            file_buffer.seek(0)
+            data = file_buffer.read()
+            with tempfile.NamedTemporaryFile(suffix=".doc") as temp_file:
+                temp_file.write(data)
+                temp_file.flush()
+                temp_path = temp_file.name
+            result = subprocess.run(["antiword", temp_path],capture_output=True,text=True)
+            if result.returncode != 0:
+                print(f"⚠️ antiword failed: {result.stderr}")
+                return None
+            return result.stdout.strip()
+        except Exception as e:
+            print(f"⚠️ Error during extraction from DOC: {e}")
+            return None
+
+register_extractor("application/msword",xtxt_doc,name="DOC")

{pyxtxt-0.1.23 → pyxtxt-0.2}/src/pyxtxt/estrattori/xlsx.py

@@ -41,10 +41,11 @@ if openpyxl:
                 count += 1
 
     return "\n".join(testo)
-register_extractor(
-                "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+
+ register_extractor(
+    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
     xtxt_xlsx,
     name="XLSX"
-)
+ )
 
 

{pyxtxt-0.1.23 → pyxtxt-0.2/src/pyxtxt.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyxtxt
-Version: 0.1.23
+Version: 0.2
 Summary: A Python library for extracting text from different types of files (PDF, DOCX, PPTX, XLSX, ODT, ecc.).
 Author-email: Giuseppe Levi <giuseppe.levi@gmail.com>
 License: MIT License
@@ -63,23 +63,26 @@ Requires-Dist: lxml; extra == "all"
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 **PyxTxt** is a simple and powerful Python library to extract text from various file formats.  
-It supports PDF, DOCX, XLSX, PPTX, ODT, HTML, XML, TXT, legacy XLS files, and more.
+It supports PDF, DOCX, XLSX, PPTX, ODT, HTML, XML, TXT, legacy Office files, and more.
+
+**NEW in v0.1.24+**: Enhanced support for web content, byte streams, and requests integration!
 
 ---
 
 ## ✨ Features
 
-- Extracts text from both file paths and in-memory buffers (`io.BytesIO`).
-- Supports multiple formats: PDF, DOCX, PPTX, XLSX, ODT, HTML, XML, TXT, legacy Office files (.xls,.ppt).
-- Automatically detects MIME type using `python-magic`.
-- Compatible with modern and legacy formats.
-- Can handle streamed content without saving to disk (with some limitations).
+- **Multiple input types**: File paths, `io.BytesIO` buffers, raw `bytes` objects, and `requests.Response` objects
+- **Wide format support**: PDF, DOCX, PPTX, XLSX, ODT, HTML, XML, TXT, legacy Office files (.xls, .ppt, .doc)
+- **Automatic MIME detection**: Uses `python-magic` for intelligent file type recognition
+- **Web-ready**: Direct support for downloading and extracting text from URLs
+- **Memory efficient**: Process files without saving to disk
+- **Modern Python**: Full type hints and clean API design
 
 ---
 
 ## 📦 Installation 
 
-The library i modular so you can install all modules:
+The library is modular so you can install all modules:
 
 ```bash
 pip install pyxtxt[all]
@@ -88,8 +91,8 @@ or just the modules you need:
 ```bash
 pip install pyxtxt[pdf,odf,docx,presentation,spreadsheet,html]
 ```
-Beause needed libraries are common installing the html module will enable also SVG and XML.
-The architecture is designed to be able to grow with new modules to work with other formats as well.
+Because needed libraries are common, installing the html module will also enable SVG and XML support.
+The architecture is designed to grow with new modules for additional formats.
 ## ⚠️ Note: You must have libmagic installed on your system (required by python-magic).
 The pyproject.toml file should select the correct version for your system. But if you have any problem you can install it manually.
 
@@ -129,55 +132,105 @@ Use python-magic-bin instead of python-magic for easier installation.
 
 Dependencies are automatically installed from pyproject.toml.
 
-## 📚 Usage Example
-Extract text from a file path:
+## 📚 Usage Examples
 
+### Basic Usage
 ```python
 from pyxtxt import xtxt
 
+# Extract from file path
 text = xtxt("document.pdf")
 print(text)
-```
-Extract text from a file-like buffer:
 
-```python
+# Extract from BytesIO buffer
 import io
-
 with open("document.docx", "rb") as f:
     buffer = io.BytesIO(f.read())
-
-from pyxtxt import xtxt
 text = xtxt(buffer)
 print(text)
 ```
-Show available formats:
-from pyxtxt import extxt_available_formats
+
+### NEW: Web Content Support
 ```python
-from pyxtxt import extxt_available_formats
-text = extxt_available_formats()
-print(text)
-# For a pretty printing
-text = extxt_available_formats(True)
-print(text)
+import requests
+from pyxtxt import xtxt, xtxt_from_url
+
+# Method 1: Direct from bytes
+response = requests.get("https://example.com/document.pdf")
+text = xtxt(response.content)
+
+# Method 2: Direct from Response object  
+text = xtxt(response)
+
+# Method 3: URL helper function
+text = xtxt_from_url("https://example.com/document.pdf")
 ```
-## ⚠️ Known Limitations
-When passing a raw stream (io.BytesIO) without a filename, legacy files (.doc, .xls, .ppt) may not be correctly detected.
 
-This is a limitation of libmagic beacuse the signature byte sequence at the start of doc/xls/ppt is exactly the same (b'\xD0\xCF\x11\xE0\xA1\xB1\x1A\xE1'),
-not of pyxtxt.
+### Show Available Formats
+```python
+from pyxtxt import extxt_available_formats
+
+# List supported MIME types
+formats = extxt_available_formats()
+print(formats)
+
+# Pretty format names
+formats = extxt_available_formats(pretty=True)
+print(formats)
+```
+## 🌐 Common Web Use Cases
 
-If available, using the original filename is highly recommended.
+```python
+# API responses
+api_response = requests.post("https://api.example.com/generate-pdf")
+text = xtxt(api_response.content)
 
-To extract text from documents in MSWrite's old .doc format, it is necessary to install antiword.
+# File uploads (Flask/Django)
+uploaded_bytes = request.files['document'].read()
+text = xtxt(uploaded_bytes)
 
-```bash
-sudo apt-get update
-sudo apt-get -y install antiword
+# Email attachments
+attachment_bytes = email_msg.get_payload(decode=True)
+text = xtxt(attachment_bytes)
 ```
 
+## ⚠️ Known Limitations
+
+- **Legacy file detection**: When using raw streams without filenames, legacy files (.doc, .xls, .ppt) may not be correctly detected due to identical file signatures in libmagic
+- **Filename hints recommended**: When available, providing original filenames improves detection accuracy
+- **MSWrite .doc files**: Require `antiword` installation:
+  ```bash
+  sudo apt-get update && sudo apt-get install antiword
+  ```
+
+## 📖 Full Examples
+
+See [examples.py](https://github.com/dede-amdp/pyxtxt/blob/main/examples.py) for comprehensive usage examples including:
+- Local file processing
+- Memory buffer handling  
+- Web content extraction
+- Error handling patterns
+- All supported formats demonstration
+
 ## 🔒 License
-Distributed under the MIT License.
+
+Distributed under the MIT License. See LICENSE file for details.
 
 The software is provided "as is" without any warranty of any kind.
 
+## 🤝 Contributing
+
 Pull requests, issues, and feedback are warmly welcome! 🚀
+
+- **Bug reports**: Please include file samples and error details
+- **Feature requests**: Describe your use case and expected behavior
+- **Code contributions**: Follow existing patterns and add tests
+
+## 📊 Changelog
+
+### v0.1.24+
+- ✅ Added support for `bytes` objects
+- ✅ Added support for `requests.Response` objects  
+- ✅ Added `xtxt_from_url()` helper function
+- ✅ Improved type hints and error handling
+- ✅ Enhanced web content processing capabilities

pyxtxt-0.1.23/README.md

@@ -1,125 +0,0 @@
-# PyxTxt
-
-[![PyPI version](https://img.shields.io/pypi/v/pyxtxt.svg)](https://pypi.org/project/pyxtxt/)
-[![Python versions](https://img.shields.io/pypi/pyversions/pyxtxt.svg)](https://pypi.org/project/pyxtxt/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-**PyxTxt** is a simple and powerful Python library to extract text from various file formats.  
-It supports PDF, DOCX, XLSX, PPTX, ODT, HTML, XML, TXT, legacy XLS files, and more.
-
----
-
-## ✨ Features
-
-- Extracts text from both file paths and in-memory buffers (`io.BytesIO`).
-- Supports multiple formats: PDF, DOCX, PPTX, XLSX, ODT, HTML, XML, TXT, legacy Office files (.xls,.ppt).
-- Automatically detects MIME type using `python-magic`.
-- Compatible with modern and legacy formats.
-- Can handle streamed content without saving to disk (with some limitations).
-
----
-
-## 📦 Installation 
-
-The library i modular so you can install all modules:
-
-```bash
-pip install pyxtxt[all]
-```
-or just the modules you need:
-```bash
-pip install pyxtxt[pdf,odf,docx,presentation,spreadsheet,html]
-```
-Beause needed libraries are common installing the html module will enable also SVG and XML.
-The architecture is designed to be able to grow with new modules to work with other formats as well.
-## ⚠️ Note: You must have libmagic installed on your system (required by python-magic).
-The pyproject.toml file should select the correct version for your system. But if you have any problem you can install it manually.
-
-**On Ubuntu/Debian:**
-
-```bash
-sudo apt install libmagic1
-```
-
-**On Mac (Homebrew):**
-
-```bash
-brew install libmagic
-```
-**On Windows:**
-
-Use python-magic-bin instead of python-magic for easier installation.
-
-## 🛠️ Dependencies
-- PyMuPDF (fitz)
-
-- beautifulsoup4
-
-- python-docx
-
-- python-pptx
-
-- odfpy
-
-- openpyxl
-
-- lxml
-
-- xlrd (<2.0.0)
-
-- python-magic
-
-Dependencies are automatically installed from pyproject.toml.
-
-## 📚 Usage Example
-Extract text from a file path:
-
-```python
-from pyxtxt import xtxt
-
-text = xtxt("document.pdf")
-print(text)
-```
-Extract text from a file-like buffer:
-
-```python
-import io
-
-with open("document.docx", "rb") as f:
-    buffer = io.BytesIO(f.read())
-
-from pyxtxt import xtxt
-text = xtxt(buffer)
-print(text)
-```
-Show available formats:
-from pyxtxt import extxt_available_formats
-```python
-from pyxtxt import extxt_available_formats
-text = extxt_available_formats()
-print(text)
-# For a pretty printing
-text = extxt_available_formats(True)
-print(text)
-```
-## ⚠️ Known Limitations
-When passing a raw stream (io.BytesIO) without a filename, legacy files (.doc, .xls, .ppt) may not be correctly detected.
-
-This is a limitation of libmagic beacuse the signature byte sequence at the start of doc/xls/ppt is exactly the same (b'\xD0\xCF\x11\xE0\xA1\xB1\x1A\xE1'),
-not of pyxtxt.
-
-If available, using the original filename is highly recommended.
-
-To extract text from documents in MSWrite's old .doc format, it is necessary to install antiword.
-
-```bash
-sudo apt-get update
-sudo apt-get -y install antiword
-```
-
-## 🔒 License
-Distributed under the MIT License.
-
-The software is provided "as is" without any warranty of any kind.
-
-Pull requests, issues, and feedback are warmly welcome! 🚀

pyxtxt-0.1.23/src/pyxtxt/__init__.py

@@ -1 +0,0 @@
-from .core import xtxt, extxt_available_formats

pyxtxt-0.1.23/src/pyxtxt/estrattori/doc.py

@@ -1,41 +0,0 @@
-
-from . import register_extractor
-import shutil
-import tempfile
-try:
-    import textract
-except ImportError:
-    textract = None
-if textract:
-    def xtxt_doc(file_buffer):
-        if shutil.which("antiword") is None:
-            print("⚠️ 'antiword' is not installed or is not in the system PATH.")
-            return None
-        try:
-            file_buffer.seek(0)
-            data = file_buffer.read()
-            with tempfile.NamedTemporaryFile(suffix=".doc") as temp_file:
-                temp_file.write(data)
-                temp_file.flush()
-                testo = textract.process(temp_file.name)
-                return testo.decode("utf-8").strip()
-        except Exception as e:
-            print(f"⚠️ Error during extraction from DOC: {e}")
-            return None
-
-    register_extractor("application/msword",xtxt_doc,name="DOC")
-'''
- def xtxt_doc(file_buffer):
-
-    if shutil.which("antiword") is None:
-       print("⚠️ 'antiword' is not installed or is not in the system PATH.")
-       return None
-    try:
-        file_buffer.seek(0)
-        data = file_buffer.read()
-        testo = textract.process("temp.doc", input_data=data)
-        return testo.decode("utf-8").strip()
-    except Exception as e:
-        print(f"⚠️  Error during extraction from DOC: {e}")
-        return None
-'''