pyxtxt 0.1.8__py3-none-any.whl

pyxtxt/__init__.py

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

pyxtxt/core.py

@@ -0,0 +1,71 @@
+from .estrattori import estrattori
+from functools import singledispatch
+import io
+import magic
+
+@singledispatch
+def xtxt(file_input):
+    raise NotImplementedError(f"Type not supported : {type(file_input)}")
+
+# Caso 1: file path (str)
+@xtxt.register
+def _(file_input: str):
+    try:
+        with open(file_input, "rb") as f:
+            data = f.read()
+        buffer = io.BytesIO(data)
+        buffer.name=file_input
+        buffer.mimeType=magic.Magic(mime=True).from_file(file_input)
+        return xtxt(buffer)
+    except Exception as e:
+        print(f"⚠️ File opening error'{file_input}': {e}")
+        return None
+
+# Caso 2: buffer (BytesIO)
+@xtxt.register
+def _(file_input: io.BytesIO):
+    try:
+
+
+        # Mappa dei MIME Type gestiti dagli estrattori
+        # estrattori = {
+            # "application/pdf": xtxt_pdf,
+            # "application/vnd.openxmlformats-officedocument.wordprocessingml.document": xtxt_docx,
+            # "application/vnd.openxmlformats-officedocument.presentationml.presentation": xtxt_pptx,
+            # "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": xtxt_xlsx,
+            # "application/vnd.ms-excel": xtxt_xls,
+            # "text/plain": xtxt_txt,
+            # "application/vnd.oasis.opendocument.text": xtxt_odt,
+            # "text/html": xtxt_html,
+# #            "text/rtf": xtxt_rtf,
+            # "application/xml": xtxt_xml,
+            # "text/xml": xtxt_xml,
+        # }
+        if hasattr(file_input,'mimeType'):
+            mime_type=file_input.mimeType
+        else:
+            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")
+               mime_type = "text/plain"
+        if mime_type not in estrattori:
+            print(f"⚠️ MIME type not supported {mime_type} ({file_input.name}) ignored.")
+            return None
+
+
+        # Estrai il testo
+        testo = estrattori[mime_type](file_input)
+        return f"{testo}"
+    except  Exception as e:
+        print(f"❌ Error while reading: {e}")
+        return None
+def extxt_available_formats(pretty=False):
+    if pretty:
+        from .estrattori import pretty_names
+        return sorted({pretty_names.get(mime, mime) for mime in estrattori.keys()})
+    else:
+        return sorted(estrattori.keys())

pyxtxt/estrattori/__init__.py

@@ -0,0 +1,18 @@
+import os
+import importlib
+
+# Qui vengono registrati gli estrattori disponibili
+estrattori = {}
+pretty_names = {}
+
+def register_extractor(mime_type, func, name=None):
+    estrattori[mime_type] = func
+    if name:
+        pretty_names[mime_type] = name
+
+# Carica automaticamente tutti i moduli presenti
+current_dir = os.path.dirname(__file__)
+for filename in os.listdir(current_dir):
+    if filename.endswith(".py") and filename != "__init__.py":
+        module_name = f"{__name__}.{filename[:-3]}"
+        importlib.import_module(module_name)

pyxtxt/estrattori/docx.py

@@ -0,0 +1,31 @@
+from . import register_extractor
+import io
+import zipfile
+from docx import Document
+
+def xtxt_docx(file_buffer) -> str:
+    try:
+        # Copia del buffer per poterlo riutilizzare
+        file_buffer.seek(0)
+        data = file_buffer.read()
+        buffer_copy = io.BytesIO(data)
+
+        if not zipfile.is_zipfile(buffer_copy):
+            print("⚠️ Invalid DOCX (not a ZIP file)")
+            return ""
+
+        buffer_copy.seek(0)
+        doc = Document(buffer_copy)
+
+        text = "\n".join(p.text for p in doc.paragraphs)
+        return text
+
+    except Exception as e:
+        print(f"⚠️  Error during extraction DOCX: {e}")
+        return ""
+
+register_extractor(
+    "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    xtxt_docx,
+    name="DOCX"
+)

pyxtxt/estrattori/html.py

@@ -0,0 +1,10 @@
+from . import register_extractor
+from bs4 import BeautifulSoup
+def xtxt_html(file_buffer):
+    soup = BeautifulSoup(file_buffer.read(), "html.parser")
+    return soup.get_text(separator="\n")
+register_extractor(
+    "text/html",
+    xtxt_html,
+    name="HTML"
+)

pyxtxt/estrattori/odt.py

@@ -0,0 +1,22 @@
+from . import register_extractor
+from odf.opendocument import load
+from odf.text import P
+def xtxt_odt(file_buffer):
+    odt_doc = load(file_buffer)
+    paragraphs = odt_doc.getElementsByType(P)
+    
+    testo = []
+    for p in paragraphs:
+        contenuto = []
+        for n in p.childNodes:
+            if n.nodeType == 3:  # TEXT_NODE
+                contenuto.append(n.data)
+        if contenuto:
+            testo.append("".join(contenuto))
+    
+    return "\n".join(testo)
+register_extractor(
+     "application/vnd.oasis.opendocument.text",
+     xtxt_odt,
+    name="ODT"
+)

pyxtxt/estrattori/pdf.py

@@ -0,0 +1,27 @@
+from . import register_extractor
+import fitz  # PyMuPDF
+def xtxt_pdf(file_buffer):
+    try:
+        raw_data = file_buffer.read()
+        if not raw_data:
+            print("⚠️  PDF blank or not read correctly")
+            return None
+
+        doc = fitz.open(stream=raw_data, filetype="pdf")
+        return "\n".join(page.get_text() for page in doc)
+
+    except fitz.EmptyFileError:
+        print("⚠️ Error: PDF is blank or unreadable")
+        return None
+    except Exception as e:
+        print(f"⚠️  Error during PDF extraction: {e}")
+        return None
+
+
+
+
+register_extractor(
+    "application/pdf",
+    xtxt_pdf,
+    name="PDF"
+)

pyxtxt/estrattori/pptx.py

@@ -0,0 +1,35 @@
+from . import register_extractor
+import io
+import zipfile
+from pptx import Presentation
+def xtxt_pptx(file_buffer) -> str:
+    try:
+        # Convertiamo il file_buffer (che è già un BytesIO o simile) in modo da poterlo riusare
+        file_buffer.seek(0)
+        data = file_buffer.read()
+        buffer_copy = io.BytesIO(data)
+
+        if not zipfile.is_zipfile(buffer_copy):
+            print("⚠️  Invalid PPTX (not a ZIP file)" )
+            return ""
+
+        # Se è un file zip valido, possiamo ripassare i dati a Presentation
+        buffer_copy.seek(0)
+        prs = Presentation(buffer_copy)
+
+        text = "\n".join(
+            shape.text
+            for slide in prs.slides
+            for shape in slide.shapes
+            if hasattr(shape, "text")
+        )
+        return text
+
+    except Exception as e:
+        print(f"⚠️ Error during PPTX extraction: {e}")
+        return ""
+register_extractor(
+    "application/vnd.openxmlformats-officedocument.presentationml.presentation" ,
+    xtxt_pptx,
+    name="PPTX"
+)

pyxtxt/estrattori/svg.py

@@ -0,0 +1,19 @@
+from . import register_extractor
+from lxml import etree
+
+def xtxt_svg(file_buffer):
+    try:
+        tree = etree.parse(file_buffer)
+        root = tree.getroot()
+
+        # Estrai tutto il testo dai tag <text>
+        texts = [element.text for element in root.findall('.//{http://www.w3.org/2000/svg}text')]
+        return "\n".join(texts)
+    except Exception as e:
+        print(f"⚠️ Error while extracting SVG: {e}")
+        return ""
+register_extractor(
+    "image/svg+xml",
+    xtxt_svg,
+    name="SVG"
+)

pyxtxt/estrattori/txt.py

@@ -0,0 +1,8 @@
+from . import register_extractor
+def xtxt_txt(file_buffer):
+    return file_buffer.read().decode("utf-8", errors="ignore")
+register_extractor(
+     "text/plain",
+     xtxt_txt,
+    name="TXT"
+)

pyxtxt/estrattori/xls.py

@@ -0,0 +1,29 @@
+import io
+from . import register_extractor
+import xlrd
+def xtxt_xls(file_buffer, max_rows_per_sheet: int = 100) -> str:
+    try:
+        file_buffer.seek(0)
+        workbook = xlrd.open_workbook(file_contents=file_buffer.read())
+        testo = []
+
+        for sheet in workbook.sheets():
+            testo.append(f"# {sheet.name}")
+            for row_idx in range(min(sheet.nrows, max_rows_per_sheet)):
+                row = sheet.row(row_idx)
+                valori = [str(cell.value).strip() for cell in row if str(cell.value).strip()]
+                if valori:
+                    testo.append(" | ".join(valori))
+
+        return "\n".join(testo)
+
+    except Exception as e:
+        print(f"⚠️ Error while extracting XLS: {e}")
+        return ""
+
+register_extractor(
+    "application/vnd.ms-excel",
+    xtxt_xls,
+    name="XLS"
+)
+

pyxtxt/estrattori/xlsx.py

@@ -0,0 +1,45 @@
+import io
+import zipfile
+from openpyxl import load_workbook
+from openpyxl.worksheet.worksheet import Worksheet
+from . import register_extractor
+import openpyxl
+
+def xtxt_xlsx(file_buffer, max_rows_per_sheet: int = 200) -> str:
+    try:
+        file_buffer.seek(0)
+        data = file_buffer.read()
+        buffer_copy = io.BytesIO(data)
+
+        if not zipfile.is_zipfile(buffer_copy):
+            print("⚠️  Invalid XLSX (not a ZIP archive)")
+            return ""
+
+        buffer_copy.seek(0)
+        wb = openpyxl.load_workbook(buffer_copy, data_only=True, read_only=True)
+    except Exception as e:
+        print(f"⚠️ Error while reading XLSX :  {e}")
+        return ""
+
+    testo = []
+    for sheet in wb.worksheets:
+        if sheet.sheet_state != 'visible':
+            continue
+        testo.append(f"# {sheet.title}")
+        count = 0
+        for row in sheet.iter_rows(values_only=True):
+            if max_rows_per_sheet != -1 and count >= max_rows_per_sheet:
+                break
+            valori = [str(cell).strip() if cell is not None else "" for cell in row]
+            if any(valori):
+                testo.append(" | ".join(valori))
+                count += 1
+
+    return "\n".join(testo)
+register_extractor(
+                "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    xtxt_xlsx,
+    name="XLSX"
+)
+
+

pyxtxt/estrattori/xml.py

@@ -0,0 +1,37 @@
+from . import register_extractor
+from lxml import etree
+
+def xtxt_xml(file_buffer) -> str:
+    try:
+        file_buffer.seek(0)
+        parser = etree.XMLParser(recover=True)
+        tree = etree.parse(file_buffer, parser)
+        root = tree.getroot()
+
+        # Estrai il testo ricorsivamente da tutti i nodi
+        def get_text_recursively(elem):
+            texts = []
+            if elem.text:
+                texts.append(elem.text.strip())
+            for child in elem:
+                texts.append(get_text_recursively(child))
+                if child.tail:
+                    texts.append(child.tail.strip())
+            return " ".join(filter(None, texts))
+
+        testo = get_text_recursively(root)
+        return testo.strip()
+
+    except Exception as e:
+        print(f"⚠️ Error while extracting XML : {e}")
+        return ""
+register_extractor(
+    "application/xml",
+    xtxt_xml,
+    name="XML"
+)
+register_extractor(
+    "text/xml",
+    xtxt_xml,
+    name="XML"
+)

pyxtxt/pyxtxt.py

@@ -0,0 +1,280 @@
+import fitz  # PyMuPDF
+from bs4 import BeautifulSoup
+from docx import Document
+from pptx import Presentation
+from odf.opendocument import load
+from odf.text import P
+import openpyxl
+
+def xtxt_pdf(file_buffer):
+    try:
+        raw_data = file_buffer.read()
+        if not raw_data:
+            print("⚠️  PDF blank or not read correctly")
+            return None
+
+        doc = fitz.open(stream=raw_data, filetype="pdf")
+        return "\n".join(page.get_text() for page in doc)
+
+    except fitz.EmptyFileError:
+        print("⚠️ Error: PDF is blank or unreadable")
+        return None
+    except Exception as e:
+        print(f"⚠️  Error during PDF extraction: {e}")
+        return None
+
+
+
+def xtxt_docx(file_buffer) -> str:
+    try:
+        # Copia del buffer per poterlo riutilizzare
+        file_buffer.seek(0)
+        data = file_buffer.read()
+        buffer_copy = io.BytesIO(data)
+
+        if not zipfile.is_zipfile(buffer_copy):
+            print("⚠️ Invalid DOCX (not a ZIP file)")
+            return ""
+
+        buffer_copy.seek(0)
+        doc = Document(buffer_copy)
+
+        text = "\n".join(p.text for p in doc.paragraphs)
+        return text
+
+    except Exception as e:
+        print(f"⚠️  Error during extraction DOCX: {e}")
+        return ""
+
+import zipfile
+
+
+def xtxt_pptx(file_buffer) -> str:
+    try:
+        # Convertiamo il file_buffer (che è già un BytesIO o simile) in modo da poterlo riusare
+        file_buffer.seek(0)
+        data = file_buffer.read()
+        buffer_copy = io.BytesIO(data)
+
+        if not zipfile.is_zipfile(buffer_copy):
+            print("⚠️  Invalid PPTX (not a ZIP file)" )
+            return ""
+
+        # Se è un file zip valido, possiamo ripassare i dati a Presentation
+        buffer_copy.seek(0)
+        prs = Presentation(buffer_copy)
+
+        text = "\n".join(
+            shape.text
+            for slide in prs.slides
+            for shape in slide.shapes
+            if hasattr(shape, "text")
+        )
+        return text
+
+    except Exception as e:
+        print(f"⚠️ Error during PPTX extraction: {e}")
+        return ""
+
+
+from openpyxl import load_workbook
+from openpyxl.worksheet.worksheet import Worksheet
+import openpyxl
+
+def xtxt_xlsx(file_buffer, max_rows_per_sheet: int = 200) -> str:
+    try:
+        file_buffer.seek(0)
+        data = file_buffer.read()
+        buffer_copy = io.BytesIO(data)
+
+        if not zipfile.is_zipfile(buffer_copy):
+            print("⚠️  Invalid XLSX (not a ZIP archive)")
+            return ""
+
+        buffer_copy.seek(0)
+        wb = openpyxl.load_workbook(buffer_copy, data_only=True, read_only=True)
+    except Exception as e:
+        print(f"⚠️ Error while reading XLSX :  {e}")
+        return ""
+
+    testo = []
+    for sheet in wb.worksheets:
+        if sheet.sheet_state != 'visible':
+            continue
+        testo.append(f"# {sheet.title}")
+        count = 0
+        for row in sheet.iter_rows(values_only=True):
+            if max_rows_per_sheet != -1 and count >= max_rows_per_sheet:
+                break
+            valori = [str(cell).strip() if cell is not None else "" for cell in row]
+            if any(valori):
+                testo.append(" | ".join(valori))
+                count += 1
+
+    return "\n".join(testo)
+
+def xtxt_txt(file_buffer):
+    return file_buffer.read().decode("utf-8", errors="ignore")
+
+
+def xtxt_odt(file_buffer):
+    odt_doc = load(file_buffer)
+    paragraphs = odt_doc.getElementsByType(P)
+    
+    testo = []
+    for p in paragraphs:
+        contenuto = []
+        for n in p.childNodes:
+            if n.nodeType == 3:  # TEXT_NODE
+                contenuto.append(n.data)
+        if contenuto:
+            testo.append("".join(contenuto))
+    
+    return "\n".join(testo)
+
+
+def xtxt_html(file_buffer):
+    soup = BeautifulSoup(file_buffer.read(), "html.parser")
+    return soup.get_text(separator="\n")
+
+
+
+
+
+from lxml import etree
+
+def xtxt_xml(file_buffer) -> str:
+    try:
+        file_buffer.seek(0)
+        parser = etree.XMLParser(recover=True)
+        tree = etree.parse(file_buffer, parser)
+        root = tree.getroot()
+
+        # Estrai il testo ricorsivamente da tutti i nodi
+        def get_text_recursively(elem):
+            texts = []
+            if elem.text:
+                texts.append(elem.text.strip())
+            for child in elem:
+                texts.append(get_text_recursively(child))
+                if child.tail:
+                    texts.append(child.tail.strip())
+            return " ".join(filter(None, texts))
+
+        testo = get_text_recursively(root)
+        return testo.strip()
+
+    except Exception as e:
+        print(f"⚠️ Error while extracting XML : {e}")
+        return ""
+import xlrd
+
+def xtxt_xls(file_buffer, max_rows_per_sheet: int = 100) -> str:
+    try:
+        file_buffer.seek(0)
+        workbook = xlrd.open_workbook(file_contents=file_buffer.read())
+        testo = []
+
+        for sheet in workbook.sheets():
+            testo.append(f"# {sheet.name}")
+            for row_idx in range(min(sheet.nrows, max_rows_per_sheet)):
+                row = sheet.row(row_idx)
+                valori = [str(cell.value).strip() for cell in row if str(cell.value).strip()]
+                if valori:
+                    testo.append(" | ".join(valori))
+
+        return "\n".join(testo)
+
+    except Exception as e:
+        print(f"⚠️ Error while extracting XLS: {e}")
+        return ""
+
+# from pyth.plugins.plaintext.reader import PlaintextReader
+# from pyth.plugins.plaintext import PlaintextFile
+
+# def xtxt_rtf(file_buffer):
+    # try:
+        # rtf = PlaintextReader.read(file_buffer)
+        # return rtf
+    # except Exception as e:
+        # print(f"⚠️ Errore durante l'estrazione RTF: {e}")
+        # return ""
+
+from lxml import etree
+
+def xtxt_svg(file_buffer):
+    try:
+        tree = etree.parse(file_buffer)
+        root = tree.getroot()
+
+        # Estrai tutto il testo dai tag <text>
+        texts = [element.text for element in root.findall('.//{http://www.w3.org/2000/svg}text')]
+        return "\n".join(texts)
+    except Exception as e:
+        print(f"⚠️ Error while extracting SVG: {e}")
+        return ""
+
+from functools import singledispatch
+import io
+import magic
+
+@singledispatch
+def xtxt(file_input):
+    raise NotImplementedError(f"Type not supported : {type(file_input)}")
+
+# Caso 1: file path (str)
+@xtxt.register
+def _(file_input: str):
+    try:
+        with open(file_input, "rb") as f:
+            data = f.read()
+        buffer = io.BytesIO(data)
+        buffer.name=file_input
+        buffer.mimeType=magic.Magic(mime=True).from_file(file_input)
+        return xtxt(buffer)
+    except Exception as e:
+        print(f"⚠️ File opening error'{file_input}': {e}")
+        return None
+
+# Caso 2: buffer (BytesIO)
+@xtxt.register
+def _(file_input: io.BytesIO):
+    try:
+
+
+        # Mappa dei MIME Type gestiti dagli estrattori
+        estrattori = {
+            "application/pdf": xtxt_pdf,
+            "application/vnd.openxmlformats-officedocument.wordprocessingml.document": xtxt_docx,
+            "application/vnd.openxmlformats-officedocument.presentationml.presentation": xtxt_pptx,
+            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": xtxt_xlsx,
+            "application/vnd.ms-excel": xtxt_xls,
+            "text/plain": xtxt_txt,
+            "application/vnd.oasis.opendocument.text": xtxt_odt,
+            "text/html": xtxt_html,
+#            "text/rtf": xtxt_rtf,
+            "application/xml": xtxt_xml,
+            "text/xml": xtxt_xml,
+        }
+        if hasattr(file_input,'mimeType'):
+            mime_type=file_input.mimeType
+        else:
+            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")
+               mime_type = "text/plain"
+        if mime_type not in estrattori:
+            print(f"⚠️ MIME type not supported {mime_type} ({file_input.name}) ignored.")
+            return None
+
+
+        # Estrai il testo
+        testo = estrattori[mime_type](file_input)
+        return f"{testo}"
+    except  Exception as e:
+        print(f"❌ Error while reading: {e}")
+        return None

pyxtxt-0.1.8.dist-info/METADATA

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: pyxtxt
+Version: 0.1.8
+Summary: Una libreria Python per estrarre testo da diversi tipi di file (PDF, DOCX, PPTX, XLSX, ODT, ecc.).
+Author-email: Giuseppe Levi <giuseppe.levi@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Giuseppe Levi
+        
+        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.
+        
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Provides-Extra: pdf
+Requires-Dist: PyMuPDF; extra == "pdf"
+Provides-Extra: docx
+Requires-Dist: python-docx; extra == "docx"
+Provides-Extra: presentation
+Requires-Dist: python-pptx; extra == "presentation"
+Provides-Extra: spreadsheet
+Requires-Dist: openpyxl; extra == "spreadsheet"
+Requires-Dist: xlrd; extra == "spreadsheet"
+Provides-Extra: odf
+Requires-Dist: odfpy; extra == "odf"
+Provides-Extra: html
+Requires-Dist: beautifulsoup4; extra == "html"
+Requires-Dist: lxml; extra == "html"
+Provides-Extra: all
+Requires-Dist: pytesseract; extra == "all"
+Requires-Dist: piexif; extra == "all"
+Requires-Dist: Pillow; extra == "all"
+Requires-Dist: PyMuPDF; extra == "all"
+Requires-Dist: python-docx; extra == "all"
+Requires-Dist: python-pptx; extra == "all"
+Requires-Dist: openpyxl; extra == "all"
+Requires-Dist: xlrd; extra == "all"
+Requires-Dist: odfpy; extra == "all"
+Requires-Dist: beautifulsoup4; extra == "all"
+Requires-Dist: lxml; extra == "all"
+
+# 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, .doc, .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
+
+```bash
+pip install pyxtxt
+```
+## ⚠️ Note: You must have libmagic installed on your system (required by python-magic).
+
+**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)
+```
+##⚠️ 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, not of pyxtxt.
+
+If available, passing the original filename along with the buffer is highly recommended.
+
+## 🔒 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.8.dist-info/RECORD

@@ -0,0 +1,18 @@
+pyxtxt/__init__.py,sha256=axFUvZRxw1OJQizuGqYKWe6bdJXFnT1SSVfuYzGEovA,48
+pyxtxt/core.py,sha256=kwGklxzc3o2tce3SOKZgwJSm0g2fKCeviYhj0p7Hgmw,2605
+pyxtxt/pyxtxt.py,sha256=HiuoEUSr-VpCOXsk2CGgKQB4w8yfZ-6RIUAPwFbDxVg,8480
+pyxtxt/estrattori/__init__.py,sha256=f0A9636Vi1yMgKMSxkguoYygCkjXN46aDAaKGjWy0Ow,543
+pyxtxt/estrattori/docx.py,sha256=SRiPuW8m-w5B_mpRfYUv9P0-kA_3ubGeae6qm3NENM4,793
+pyxtxt/estrattori/html.py,sha256=tTIKJ0xoJ44qCuUnBu5JUkBuChhB2mopbaWF_S8KIyU,262
+pyxtxt/estrattori/odt.py,sha256=49H7PRfQ5vzKENzBS5PA0uVYaE7oawg7BiqxjkoOPg8,580
+pyxtxt/estrattori/pdf.py,sha256=pg1lwr6vm9syUW285vNSq52KPqoNE8xnsfLjRD7wzv8,651
+pyxtxt/estrattori/pptx.py,sha256=Xx-p9YA4-5NpDZujnu-ikGlA2hvw2SON3DCJSZFfnJg,1040
+pyxtxt/estrattori/svg.py,sha256=Vkf8XBL9mks7gLJs-coTNP9hsjRzxdOCGroBqGeH1yA,515
+pyxtxt/estrattori/txt.py,sha256=6lhD3ccTsExTXJvs024qZ-RCH0uDbcQHmDXf88bzXK4,193
+pyxtxt/estrattori/xls.py,sha256=cWU5Z4XDFP4Xgz8lqqV7d6toWZTBEH03PQOEda-GneY,841
+pyxtxt/estrattori/xlsx.py,sha256=JFglzWiYdUh6PZ_yDPwg0g4Cp4HnAvMoRJEyu5Bg53k,1360
+pyxtxt/estrattori/xml.py,sha256=RA3x19wHS-y2hZIOXt1j7E7d2oRL1-RQBg6dnsSy86U,987
+pyxtxt-0.1.8.dist-info/METADATA,sha256=h596qN1Hd-12an9NP-v7m59Tqedm_svD21zUIlxCws0,4733
+pyxtxt-0.1.8.dist-info/WHEEL,sha256=SmOxYU7pzNKBqASvQJ7DjX3XGUF92lrGhMb3R6_iiqI,91
+pyxtxt-0.1.8.dist-info/top_level.txt,sha256=kHSwy3OBOTla47zuXMsHmSaUpa0wFjEd_xNwsZLpxOc,7
+pyxtxt-0.1.8.dist-info/RECORD,,

pyxtxt-0.1.8.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (79.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pyxtxt-0.1.8.dist-info/top_level.txt

@@ -0,0 +1 @@
+pyxtxt