rasgapdf 0.1.2__tar.gz → 0.2.0__tar.gz

{rasgapdf-0.1.2 → rasgapdf-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rasgapdf
-Version: 0.1.2
+Version: 0.2.0
 Summary: Ultra-fast 2D spatial PDF parser powered by Rust
 Author: Messias Martins
 Project-URL: Homepage, https://huggingface.co/martinsmessias/rasgapdf
@@ -8,7 +8,7 @@ Project-URL: Repository, https://huggingface.co/martinsmessias/rasgapdf
 Project-URL: Discussions, https://huggingface.co/martinsmessias/rasgapdf/discussions
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Rust
-Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Topic :: Text Processing :: General
 Requires-Python: >=3.8
@@ -23,7 +23,7 @@ Description-Content-Type: text/markdown
 
 [![PyPI version](https://img.shields.io/pypi/v/rasgapdf.svg?color=blue&logo=pypi&logoColor=white)](https://pypi.org/project/rasgapdf/)
 [![Python versions](https://img.shields.io/pypi/pyversions/rasgapdf.svg?logo=python&logoColor=white)](https://pypi.org/project/rasgapdf/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
 
 </div>
 
@@ -149,9 +149,40 @@ for page in doc["pages"]:
 | `min_table_cols` | `int` | `3` | Minimum number of columns required to classify as a table |
 | `col_tolerance` | `float` | `16.0` | Horizontal alignment threshold in typographical points |
 | `row_tolerance` | `float` | `6.0` | Vertical line clustering threshold in points |
+| `extract_images` | `bool` | `False` | Fill `page["images"]` with embedded image metadata (dimensions, colour space, filter, SHA-256, placement `bbox`) |
+| `extract_drawings` | `bool` | `False` | Fill `page["drawings"]` with vector paths (`line`/`curve`/`rect`/`quad` items, colours, dash, opacity) |
+| `keep_background_fills` | `bool` | `False` | Keep fills that cover the whole page (backgrounds are dropped by default) |
+
+---
+
+### 🖼️ Embedded Images & Vector Graphics
+
+Opt-in extraction of the graphics layer. Pixels are never decoded — metadata stays in the JSON and the original encoded stream is written to disk as-is:
+
+```python
+import rasgapdf
+
+doc = rasgapdf.parse_pdf("report.pdf", extract_images=True, extract_drawings=True)
+
+page = doc["pages"][0]
+for image in page["images"]:
+    print(image["name"], image["pixel_width"], "x", image["pixel_height"],
+          image["filter"], image["bbox"])
+
+for drawing in page["drawings"]:
+    print(drawing["drawing_id"], drawing["drawing_type"], drawing["stroke_color"])
+
+# Writes report JPEGs (e.g. page_001_img_001_xref7.jpg) plus manifest.json
+manifest = rasgapdf.extract_images("report.pdf", "./out")
+print(manifest["written"], "files written")
+```
 
 ---
 
 ## 📄 License
 
-MIT License. Copyright (c) 2026 Messias Martins.
+GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later). Copyright (c) 2026 Messias Martins.
+
+RasgaPDF embeds and links against [MuPDF](https://mupdf.com/) (Artifex Software),
+which is distributed under the AGPL-3.0. That is why this project is licensed
+under the same terms.

{rasgapdf-0.1.2 → rasgapdf-0.2.0}/README.md

@@ -7,7 +7,7 @@
 
 [![PyPI version](https://img.shields.io/pypi/v/rasgapdf.svg?color=blue&logo=pypi&logoColor=white)](https://pypi.org/project/rasgapdf/)
 [![Python versions](https://img.shields.io/pypi/pyversions/rasgapdf.svg?logo=python&logoColor=white)](https://pypi.org/project/rasgapdf/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
 
 </div>
 
@@ -133,9 +133,40 @@ for page in doc["pages"]:
 | `min_table_cols` | `int` | `3` | Minimum number of columns required to classify as a table |
 | `col_tolerance` | `float` | `16.0` | Horizontal alignment threshold in typographical points |
 | `row_tolerance` | `float` | `6.0` | Vertical line clustering threshold in points |
+| `extract_images` | `bool` | `False` | Fill `page["images"]` with embedded image metadata (dimensions, colour space, filter, SHA-256, placement `bbox`) |
+| `extract_drawings` | `bool` | `False` | Fill `page["drawings"]` with vector paths (`line`/`curve`/`rect`/`quad` items, colours, dash, opacity) |
+| `keep_background_fills` | `bool` | `False` | Keep fills that cover the whole page (backgrounds are dropped by default) |
+
+---
+
+### 🖼️ Embedded Images & Vector Graphics
+
+Opt-in extraction of the graphics layer. Pixels are never decoded — metadata stays in the JSON and the original encoded stream is written to disk as-is:
+
+```python
+import rasgapdf
+
+doc = rasgapdf.parse_pdf("report.pdf", extract_images=True, extract_drawings=True)
+
+page = doc["pages"][0]
+for image in page["images"]:
+    print(image["name"], image["pixel_width"], "x", image["pixel_height"],
+          image["filter"], image["bbox"])
+
+for drawing in page["drawings"]:
+    print(drawing["drawing_id"], drawing["drawing_type"], drawing["stroke_color"])
+
+# Writes report JPEGs (e.g. page_001_img_001_xref7.jpg) plus manifest.json
+manifest = rasgapdf.extract_images("report.pdf", "./out")
+print(manifest["written"], "files written")
+```
 
 ---
 
 ## 📄 License
 
-MIT License. Copyright (c) 2026 Messias Martins.
+GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later). Copyright (c) 2026 Messias Martins.
+
+RasgaPDF embeds and links against [MuPDF](https://mupdf.com/) (Artifex Software),
+which is distributed under the AGPL-3.0. That is why this project is licensed
+under the same terms.

{rasgapdf-0.1.2 → rasgapdf-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rasgapdf"
-version = "0.1.2"
+version = "0.2.0"
 authors = [
   { name="Messias Martins" },
 ]
@@ -14,7 +14,7 @@ requires-python = ">=3.8"
 classifiers = [
     "Programming Language :: Python :: 3",
     "Programming Language :: Rust",
-    "License :: OSI Approved :: MIT License",
+    "License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)",
     "Operating System :: POSIX :: Linux",
     "Topic :: Text Processing :: General",
 ]

{rasgapdf-0.1.2 → rasgapdf-0.2.0}/rasgapdf/__init__.py

@@ -49,9 +49,14 @@ if _lib:
     _lib.rasgapdf_version.argtypes = []
     _lib.rasgapdf_version.restype = ctypes.c_char_p
 
+    # Disponível a partir da 0.1.4 (extração de imagens embutidas em disco).
+    if hasattr(_lib, "rasgapdf_extract_images"):
+        _lib.rasgapdf_extract_images.argtypes = [ctypes.c_char_p, ctypes.c_char_p]
+        _lib.rasgapdf_extract_images.restype = ctypes.c_void_p
+
 def version() -> str:
     if not _lib:
-        return "0.1.0 (unlinked)"
+        return "0.2.0 (unlinked)"
     return _lib.rasgapdf_version().decode("utf-8")
 
 def parse_raw(file_path: str) -> Dict[str, Any]:
@@ -108,20 +113,27 @@ def parse_pdf(
     min_table_cols: int = 3,
     col_tolerance: float = 16.0,
     row_tolerance: float = 6.0,
+    extract_images: bool = False,
+    extract_drawings: bool = False,
+    keep_background_fills: bool = False,
 ) -> Dict[str, Any]:
     """
     🎯 Modo 2 (Estruturado): Processa o PDF e retorna o layout espacial hierárquico
     com blocos de texto, linhas, spans e tabelas detectadas.
-    
+
     Args:
         file_path: Caminho do arquivo PDF.
         detect_tables: Se deve detectar matrizes de tabelas automaticamente.
         min_table_cols: Quantidade mínima de colunas para agrupar em tabela.
         col_tolerance: Tolerância horizontal de alinhamento em pontos.
         row_tolerance: Tolerância vertical de linha em pontos.
+        extract_images: Preenche `page["images"]` com os metadados das imagens embutidas.
+        extract_drawings: Preenche `page["drawings"]` com os caminhos vetoriais.
+        keep_background_fills: Mantém preenchimentos que cobrem a página inteira (fundos).
 
     Returns:
-        dict: SpatialDocument contendo páginas, blocos, linhas e tabelas.
+        dict: SpatialDocument contendo páginas, blocos, linhas, tabelas,
+              imagens (opcional) e vetores (opcional).
     """
     if not _lib:
         raise RuntimeError(f"RasgaPDF native library ({_lib_path}) not loaded.")
@@ -135,6 +147,9 @@ def parse_pdf(
         "min_table_columns": min_table_cols,
         "column_tolerance": col_tolerance,
         "row_tolerance": row_tolerance,
+        "extract_images": extract_images,
+        "extract_drawings": extract_drawings,
+        "filter_background_fills": not keep_background_fills,
     }
 
     path_bytes = os.path.abspath(file_path).encode("utf-8")
@@ -153,4 +168,53 @@ def parse_pdf(
     finally:
         _lib.rasgapdf_free_string(res_ptr)
 
-__all__ = ["parse_raw", "parse_pdf", "version"]
+def extract_images(file_path: str, output_dir: str) -> Dict[str, Any]:
+    """
+    🖼️ Extrai os streams originais das imagens embutidas para `output_dir`.
+
+    Nenhum pixel é decodificado: o stream codificado é copiado como está
+    (ex.: `DCTDecode` → `.jpg`). Um `manifest.json` é gravado junto.
+
+    Args:
+        file_path: Caminho do arquivo PDF.
+        output_dir: Pasta destino (criada se não existir).
+
+    Returns:
+        dict: {
+            "total_images": int,
+            "written": int,
+            "images": [
+                {"page": int, "image": {..., "file": str}},
+                ...
+            ]
+        }
+    """
+    if not _lib:
+        raise RuntimeError(f"RasgaPDF native library ({_lib_path}) not loaded.")
+
+    if not hasattr(_lib, "rasgapdf_extract_images"):
+        raise RuntimeError(
+            "A biblioteca nativa carregada não expõe `rasgapdf_extract_images`. "
+            "Recompile/atualize o RasgaPDF."
+        )
+
+    if not os.path.exists(file_path):
+        raise FileNotFoundError(f"PDF file not found: {file_path}")
+
+    path_bytes = os.path.abspath(file_path).encode("utf-8")
+    dir_bytes = os.path.abspath(output_dir).encode("utf-8")
+
+    res_ptr = _lib.rasgapdf_extract_images(path_bytes, dir_bytes)
+    if not res_ptr:
+        raise RuntimeError("Null pointer returned from native rasgapdf library.")
+
+    try:
+        raw_json = ctypes.string_at(res_ptr).decode("utf-8")
+        parsed = json.loads(raw_json)
+        if isinstance(parsed, dict) and parsed.get("error"):
+            raise RuntimeError(f"RasgaPDF Error: {parsed.get('message')}")
+        return parsed
+    finally:
+        _lib.rasgapdf_free_string(res_ptr)
+
+__all__ = ["parse_raw", "parse_pdf", "extract_images", "version"]

{rasgapdf-0.1.2 → rasgapdf-0.2.0}/rasgapdf.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rasgapdf
-Version: 0.1.2
+Version: 0.2.0
 Summary: Ultra-fast 2D spatial PDF parser powered by Rust
 Author: Messias Martins
 Project-URL: Homepage, https://huggingface.co/martinsmessias/rasgapdf
@@ -8,7 +8,7 @@ Project-URL: Repository, https://huggingface.co/martinsmessias/rasgapdf
 Project-URL: Discussions, https://huggingface.co/martinsmessias/rasgapdf/discussions
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Rust
-Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Topic :: Text Processing :: General
 Requires-Python: >=3.8
@@ -23,7 +23,7 @@ Description-Content-Type: text/markdown
 
 [![PyPI version](https://img.shields.io/pypi/v/rasgapdf.svg?color=blue&logo=pypi&logoColor=white)](https://pypi.org/project/rasgapdf/)
 [![Python versions](https://img.shields.io/pypi/pyversions/rasgapdf.svg?logo=python&logoColor=white)](https://pypi.org/project/rasgapdf/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
 
 </div>
 
@@ -149,9 +149,40 @@ for page in doc["pages"]:
 | `min_table_cols` | `int` | `3` | Minimum number of columns required to classify as a table |
 | `col_tolerance` | `float` | `16.0` | Horizontal alignment threshold in typographical points |
 | `row_tolerance` | `float` | `6.0` | Vertical line clustering threshold in points |
+| `extract_images` | `bool` | `False` | Fill `page["images"]` with embedded image metadata (dimensions, colour space, filter, SHA-256, placement `bbox`) |
+| `extract_drawings` | `bool` | `False` | Fill `page["drawings"]` with vector paths (`line`/`curve`/`rect`/`quad` items, colours, dash, opacity) |
+| `keep_background_fills` | `bool` | `False` | Keep fills that cover the whole page (backgrounds are dropped by default) |
+
+---
+
+### 🖼️ Embedded Images & Vector Graphics
+
+Opt-in extraction of the graphics layer. Pixels are never decoded — metadata stays in the JSON and the original encoded stream is written to disk as-is:
+
+```python
+import rasgapdf
+
+doc = rasgapdf.parse_pdf("report.pdf", extract_images=True, extract_drawings=True)
+
+page = doc["pages"][0]
+for image in page["images"]:
+    print(image["name"], image["pixel_width"], "x", image["pixel_height"],
+          image["filter"], image["bbox"])
+
+for drawing in page["drawings"]:
+    print(drawing["drawing_id"], drawing["drawing_type"], drawing["stroke_color"])
+
+# Writes report JPEGs (e.g. page_001_img_001_xref7.jpg) plus manifest.json
+manifest = rasgapdf.extract_images("report.pdf", "./out")
+print(manifest["written"], "files written")
+```
 
 ---
 
 ## 📄 License
 
-MIT License. Copyright (c) 2026 Messias Martins.
+GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later). Copyright (c) 2026 Messias Martins.
+
+RasgaPDF embeds and links against [MuPDF](https://mupdf.com/) (Artifex Software),
+which is distributed under the AGPL-3.0. That is why this project is licensed
+under the same terms.