natural-pdf 0.1.15__tar.gz → 0.1.17__tar.gz

natural_pdf-0.1.17/.pre-commit-config.yaml

@@ -0,0 +1,12 @@
+repos:
+  - repo: https://github.com/psf/black
+    rev: 24.4.2
+    hooks:
+      - id: black
+        language_version: python3
+  - repo: https://github.com/pycqa/isort
+    rev: 5.13.2
+    hooks:
+      - id: isort
+        name: isort (python)
+        language_version: python3 

{natural_pdf-0.1.15/natural_pdf.egg-info → natural_pdf-0.1.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: natural-pdf
-Version: 0.1.15
+Version: 0.1.17
 Summary: A more intuitive interface for working with PDFs
 Author-email: Jonathan Soma <jonathan.soma@gmail.com>
 License-Expression: MIT
@@ -12,6 +12,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pdfplumber
+Requires-Dist: colormath2
 Requires-Dist: pillow
 Requires-Dist: colour
 Requires-Dist: numpy
@@ -21,47 +22,31 @@ Requires-Dist: pydantic
 Requires-Dist: jenkspy
 Requires-Dist: pikepdf>=9.7.0
 Requires-Dist: scipy
-Provides-Extra: viewer
-Requires-Dist: ipywidgets<9.0.0,>=7.0.0; extra == "viewer"
-Provides-Extra: easyocr
-Requires-Dist: easyocr; extra == "easyocr"
-Requires-Dist: natural-pdf[core-ml]; extra == "easyocr"
-Provides-Extra: paddle
-Requires-Dist: paddlepaddle; extra == "paddle"
-Requires-Dist: paddleocr; extra == "paddle"
-Provides-Extra: layout-yolo
-Requires-Dist: doclayout_yolo; extra == "layout-yolo"
-Requires-Dist: natural-pdf[core-ml]; extra == "layout-yolo"
-Provides-Extra: surya
-Requires-Dist: surya-ocr; extra == "surya"
-Requires-Dist: natural-pdf[core-ml]; extra == "surya"
-Provides-Extra: doctr
-Requires-Dist: python-doctr[torch]; extra == "doctr"
-Requires-Dist: natural-pdf[core-ml]; extra == "doctr"
-Provides-Extra: docling
-Requires-Dist: docling; extra == "docling"
-Requires-Dist: natural-pdf[core-ml]; extra == "docling"
-Provides-Extra: llm
-Requires-Dist: openai>=1.0; extra == "llm"
+Requires-Dist: torch
+Requires-Dist: torchvision
+Requires-Dist: transformers[sentencepiece]<=4.34.1
+Requires-Dist: huggingface_hub>=0.29.3
+Requires-Dist: sentence-transformers
+Requires-Dist: timm
 Provides-Extra: test
 Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-xdist; extra == "test"
+Requires-Dist: setuptools; extra == "test"
 Provides-Extra: search
 Requires-Dist: lancedb; extra == "search"
 Requires-Dist: pyarrow; extra == "search"
 Provides-Extra: favorites
 Requires-Dist: natural-pdf[deskew]; extra == "favorites"
-Requires-Dist: natural-pdf[llm]; extra == "favorites"
-Requires-Dist: natural-pdf[surya]; extra == "favorites"
-Requires-Dist: natural-pdf[easyocr]; extra == "favorites"
-Requires-Dist: natural-pdf[layout_yolo]; extra == "favorites"
 Requires-Dist: natural-pdf[ocr-export]; extra == "favorites"
-Requires-Dist: natural-pdf[viewer]; extra == "favorites"
 Requires-Dist: natural-pdf[search]; extra == "favorites"
+Requires-Dist: ipywidgets; extra == "favorites"
+Requires-Dist: surya-ocr; extra == "favorites"
 Provides-Extra: dev
 Requires-Dist: black; extra == "dev"
 Requires-Dist: isort; extra == "dev"
 Requires-Dist: mypy; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-xdist; extra == "dev"
 Requires-Dist: nox; extra == "dev"
 Requires-Dist: nox-uv; extra == "dev"
 Requires-Dist: build; extra == "dev"
@@ -71,31 +56,28 @@ Requires-Dist: nbformat; extra == "dev"
 Requires-Dist: jupytext; extra == "dev"
 Requires-Dist: nbclient; extra == "dev"
 Requires-Dist: ipykernel; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: setuptools; extra == "dev"
 Provides-Extra: deskew
 Requires-Dist: deskew>=1.5; extra == "deskew"
 Requires-Dist: img2pdf; extra == "deskew"
+Provides-Extra: addons
+Requires-Dist: surya-ocr; extra == "addons"
+Requires-Dist: doclayout_yolo; extra == "addons"
+Requires-Dist: paddlepaddle>=3.0.0; extra == "addons"
+Requires-Dist: paddleocr>=3.0.0; extra == "addons"
+Requires-Dist: ipywidgets>=7.0.0; extra == "addons"
+Requires-Dist: easyocr; extra == "addons"
+Requires-Dist: surya-ocr; extra == "addons"
+Requires-Dist: doclayout_yolo; extra == "addons"
+Requires-Dist: python-doctr[torch]; extra == "addons"
+Requires-Dist: docling; extra == "addons"
 Provides-Extra: all
-Requires-Dist: natural-pdf[viewer]; extra == "all"
-Requires-Dist: natural-pdf[easyocr]; extra == "all"
-Requires-Dist: natural-pdf[paddle]; extra == "all"
-Requires-Dist: natural-pdf[layout_yolo]; extra == "all"
-Requires-Dist: natural-pdf[surya]; extra == "all"
-Requires-Dist: natural-pdf[doctr]; extra == "all"
 Requires-Dist: natural-pdf[ocr-export]; extra == "all"
-Requires-Dist: natural-pdf[docling]; extra == "all"
-Requires-Dist: natural-pdf[llm]; extra == "all"
-Requires-Dist: natural-pdf[core-ml]; extra == "all"
 Requires-Dist: natural-pdf[deskew]; extra == "all"
 Requires-Dist: natural-pdf[test]; extra == "all"
 Requires-Dist: natural-pdf[search]; extra == "all"
-Provides-Extra: core-ml
-Requires-Dist: torch; extra == "core-ml"
-Requires-Dist: torchvision; extra == "core-ml"
-Requires-Dist: transformers[sentencepiece]; extra == "core-ml"
-Requires-Dist: huggingface_hub; extra == "core-ml"
-Requires-Dist: sentence-transformers; extra == "core-ml"
-Requires-Dist: numpy; extra == "core-ml"
-Requires-Dist: timm; extra == "core-ml"
+Requires-Dist: natural-pdf[addons]; extra == "all"
 Provides-Extra: ocr-export
 Requires-Dist: pikepdf; extra == "ocr-export"
 Provides-Extra: export-extras

natural_pdf-0.1.17/docs/describe/index.ipynb

@@ -0,0 +1,438 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "725fe29c",
+   "metadata": {},
+   "source": [
+    "# Describe Functionality\n",
+    "\n",
+    "The `describe()` and `inspect()` methods provide an easy way to understand the contents of your PDF elements without having to visualize them as images.\n",
+    "\n",
+    "## Basic Usage\n",
+    "\n",
+    "Get a summary of an entire page:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "5bc39925",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2025-06-15T16:10:40.070939Z",
+     "iopub.status.busy": "2025-06-15T16:10:40.070809Z",
+     "iopub.status.idle": "2025-06-15T16:10:45.409526Z",
+     "shell.execute_reply": "2025-06-15T16:10:45.409235Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "CropBox missing from /Page, defaulting to MediaBox\n"
+     ]
+    },
+    {
+     "data": {
+      "text/markdown": [
+       "## Page 1 Summary\n",
+       "\n",
+       "**Elements**:\n",
+       "  - **text**: 44 elements\n",
+       "  - **line**: 21 elements\n",
+       "  - **rect**: 8 elements\n",
+       "\n",
+       "**Text Analysis**:\n",
+       "  - **typography**:\n",
+       "    - **fonts**:\n",
+       "      - Helvetica: 44\n",
+       "    - **sizes**:\n",
+       "      - 10.0pt: 40\n",
+       "      - 8.0pt: 3\n",
+       "      - 12.0pt: 1\n",
+       "    - styles: 9 bold\n",
+       "    - **colors**:\n",
+       "      - black: 43\n",
+       "      - other: 1"
+      ],
+      "text/plain": [
+       "## Page 1 Summary\n",
+       "\n",
+       "**Elements**:\n",
+       "  - **text**: 44 elements\n",
+       "  - **line**: 21 elements\n",
+       "  - **rect**: 8 elements\n",
+       "\n",
+       "**Text Analysis**:\n",
+       "  - **typography**:\n",
+       "    - **fonts**:\n",
+       "      - Helvetica: 44\n",
+       "    - **sizes**:\n",
+       "      - 10.0pt: 40\n",
+       "      - 8.0pt: 3\n",
+       "      - 12.0pt: 1\n",
+       "    - styles: 9 bold\n",
+       "    - **colors**:\n",
+       "      - black: 43\n",
+       "      - other: 1"
+      ]
+     },
+     "execution_count": 1,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "from natural_pdf import PDF\n",
+    "\n",
+    "pdf = PDF(\"https://github.com/jsoma/natural-pdf/raw/refs/heads/main/pdfs/01-practice.pdf\")\n",
+    "page = pdf.pages[0]\n",
+    "\n",
+    "page.describe()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "b0e3354c",
+   "metadata": {},
+   "source": [
+    "## Element collection summaries\n",
+    "\n",
+    "You can describe element collections on a page with `.describe()`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "eac4e22b",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2025-06-15T16:10:45.411081Z",
+     "iopub.status.busy": "2025-06-15T16:10:45.410822Z",
+     "iopub.status.idle": "2025-06-15T16:10:45.413903Z",
+     "shell.execute_reply": "2025-06-15T16:10:45.413620Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/markdown": [
+       "## Collection Summary (44 elements)\n",
+       "\n",
+       "**Typography**:\n",
+       "  - **fonts**:\n",
+       "    - Helvetica: 44\n",
+       "  - **sizes**:\n",
+       "    - 10.0pt: 40\n",
+       "    - 8.0pt: 3\n",
+       "    - 12.0pt: 1\n",
+       "  - **styles**: 9 bold\n",
+       "  - **colors**:\n",
+       "    - black: 43\n",
+       "    - other: 1"
+      ],
+      "text/plain": [
+       "## Collection Summary (44 elements)\n",
+       "\n",
+       "**Typography**:\n",
+       "  - **fonts**:\n",
+       "    - Helvetica: 44\n",
+       "  - **sizes**:\n",
+       "    - 10.0pt: 40\n",
+       "    - 8.0pt: 3\n",
+       "    - 12.0pt: 1\n",
+       "  - **styles**: 9 bold\n",
+       "  - **colors**:\n",
+       "    - black: 43\n",
+       "    - other: 1"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Describe all elements on the page\n",
+    "page.find_all('text').describe()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "503c2a31",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2025-06-15T16:10:45.415172Z",
+     "iopub.status.busy": "2025-06-15T16:10:45.415052Z",
+     "iopub.status.idle": "2025-06-15T16:10:45.417592Z",
+     "shell.execute_reply": "2025-06-15T16:10:45.417343Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/markdown": [
+       "## Collection Summary (8 elements)\n",
+       "\n",
+       "**Size Stats**:\n",
+       "  - **width range**: 8-180\n",
+       "  - **height range**: 8-35\n",
+       "  - **avg area**: 844 sq pts\n",
+       "\n",
+       "**Styles**:\n",
+       "  - **stroke widths**:\n",
+       "    - 0.5: 7\n",
+       "  - **colors**:\n",
+       "    - black: 8"
+      ],
+      "text/plain": [
+       "## Collection Summary (8 elements)\n",
+       "\n",
+       "**Size Stats**:\n",
+       "  - **width range**: 8-180\n",
+       "  - **height range**: 8-35\n",
+       "  - **avg area**: 844 sq pts\n",
+       "\n",
+       "**Styles**:\n",
+       "  - **stroke widths**:\n",
+       "    - 0.5: 7\n",
+       "  - **colors**:\n",
+       "    - black: 8"
+      ]
+     },
+     "execution_count": 3,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Describe all elements on the page\n",
+    "page.find_all('rect').describe()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "5b468a5e",
+   "metadata": {},
+   "source": [
+    "## Inspecting lists of elements\n",
+    "\n",
+    "For more detail, you can view specific details of element collections with `inspect()`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "ea04905b",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2025-06-15T16:10:45.418792Z",
+     "iopub.status.busy": "2025-06-15T16:10:45.418688Z",
+     "iopub.status.idle": "2025-06-15T16:10:45.421581Z",
+     "shell.execute_reply": "2025-06-15T16:10:45.421321Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/markdown": [
+       "## Collection Inspection (44 elements)\n",
+       "\n",
+       "### Word Elements\n",
+       "\n",
+       "| text | x0 | top | x1 | bottom | font_family | size | bold | italic | source | confidence | color |\n",
+       "|------|------|------|------|------|------|------|------|------|------|------|------|\n",
+       "| Jungle Health and Safety Inspection Service | 385 | 36 | 542 | 44 | Helvetica | 8 | False | False | native | 1.00 | #000000 |\n",
+       "| INS-UP70N51NCL41R | 385 | 46 | 466 | 54 | Helvetica | 8 | False | False | native | 1.00 | #ff0000 |\n",
+       "| Site:  | 50 | 84 | 74 | 94 | Helvetica | 10 | True | False | native | 1.00 | #000000 |\n",
+       "| Durham’s Meatpacking   | 74 | 84 | 182 | 94 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Chicago, Ill. | 182 | 84 | 235 | 94 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Date:   | 50 | 104 | 81 | 114 | Helvetica | 10 | True | False | native | 1.00 | #000000 |\n",
+       "| February 3, 1905 | 81 | 104 | 157 | 114 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Violation Count:  | 50 | 124 | 130 | 134 | Helvetica | 10 | True | False | native | 1.00 | #000000 |\n",
+       "| 7 | 130 | 124 | 136 | 134 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Summary:  | 50 | 144 | 102 | 154 | Helvetica | 10 | True | False | native | 1.00 | #000000 |\n",
+       "| Worst of any, however, were the fertilizer men, an... | 102 | 144 | 506 | 154 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| These people could not be shown to the visitor - f... | 50 | 160 | 512 | 170 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| visitor at a hundred yards, and as for the other m... | 50 | 176 | 491 | 186 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| some of which there were open vats near the level ... | 50 | 192 | 496 | 202 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| into the vats; and when they were fished out, ther... | 50 | 208 | 465 | 218 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| exhibiting - sometimes they would be overlooked fo... | 50 | 224 | 492 | 234 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| to the world as Durham’s Pure Leaf Lard! | 50 | 240 | 232 | 250 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Violations | 50 | 372 | 107 | 384 | Helvetica | 12 | True | False | native | 1.00 | #000000 |\n",
+       "| Statute | 55 | 398 | 89 | 408 | Helvetica | 10 | True | False | native | 1.00 | #000000 |\n",
+       "| Description | 105 | 398 | 160 | 408 | Helvetica | 10 | True | False | native | 1.00 | #000000 |\n",
+       "| Level | 455 | 398 | 481 | 408 | Helvetica | 10 | True | False | native | 1.00 | #000000 |\n",
+       "| Repeat? | 505 | 398 | 544 | 408 | Helvetica | 10 | True | False | native | 1.00 | #000000 |\n",
+       "| 4.12.7 | 55 | 418 | 83 | 428 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Unsanitary Working Conditions. | 105 | 418 | 245 | 428 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Critical | 455 | 418 | 486 | 428 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| 5.8.3 | 55 | 438 | 77 | 448 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Inadequate Protective Equipment. | 105 | 438 | 256 | 448 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Serious | 455 | 438 | 489 | 448 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| 6.3.9 | 55 | 458 | 77 | 468 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Ineffective Injury Prevention. | 105 | 458 | 231 | 468 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "_Showing 30 of 44 elements (pass limit= to see more)_"
+      ],
+      "text/plain": [
+       "## Collection Inspection (44 elements)\n",
+       "\n",
+       "### Word Elements\n",
+       "\n",
+       "| text | x0 | top | x1 | bottom | font_family | size | bold | italic | source | confidence | color |\n",
+       "|------|------|------|------|------|------|------|------|------|------|------|------|\n",
+       "| Jungle Health and Safety Inspection Service | 385 | 36 | 542 | 44 | Helvetica | 8 | False | False | native | 1.00 | #000000 |\n",
+       "| INS-UP70N51NCL41R | 385 | 46 | 466 | 54 | Helvetica | 8 | False | False | native | 1.00 | #ff0000 |\n",
+       "| Site:  | 50 | 84 | 74 | 94 | Helvetica | 10 | True | False | native | 1.00 | #000000 |\n",
+       "| Durham’s Meatpacking   | 74 | 84 | 182 | 94 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Chicago, Ill. | 182 | 84 | 235 | 94 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Date:   | 50 | 104 | 81 | 114 | Helvetica | 10 | True | False | native | 1.00 | #000000 |\n",
+       "| February 3, 1905 | 81 | 104 | 157 | 114 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Violation Count:  | 50 | 124 | 130 | 134 | Helvetica | 10 | True | False | native | 1.00 | #000000 |\n",
+       "| 7 | 130 | 124 | 136 | 134 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Summary:  | 50 | 144 | 102 | 154 | Helvetica | 10 | True | False | native | 1.00 | #000000 |\n",
+       "| Worst of any, however, were the fertilizer men, an... | 102 | 144 | 506 | 154 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| These people could not be shown to the visitor - f... | 50 | 160 | 512 | 170 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| visitor at a hundred yards, and as for the other m... | 50 | 176 | 491 | 186 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| some of which there were open vats near the level ... | 50 | 192 | 496 | 202 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| into the vats; and when they were fished out, ther... | 50 | 208 | 465 | 218 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| exhibiting - sometimes they would be overlooked fo... | 50 | 224 | 492 | 234 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| to the world as Durham’s Pure Leaf Lard! | 50 | 240 | 232 | 250 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Violations | 50 | 372 | 107 | 384 | Helvetica | 12 | True | False | native | 1.00 | #000000 |\n",
+       "| Statute | 55 | 398 | 89 | 408 | Helvetica | 10 | True | False | native | 1.00 | #000000 |\n",
+       "| Description | 105 | 398 | 160 | 408 | Helvetica | 10 | True | False | native | 1.00 | #000000 |\n",
+       "| Level | 455 | 398 | 481 | 408 | Helvetica | 10 | True | False | native | 1.00 | #000000 |\n",
+       "| Repeat? | 505 | 398 | 544 | 408 | Helvetica | 10 | True | False | native | 1.00 | #000000 |\n",
+       "| 4.12.7 | 55 | 418 | 83 | 428 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Unsanitary Working Conditions. | 105 | 418 | 245 | 428 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Critical | 455 | 418 | 486 | 428 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| 5.8.3 | 55 | 438 | 77 | 448 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Inadequate Protective Equipment. | 105 | 438 | 256 | 448 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Serious | 455 | 438 | 489 | 448 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| 6.3.9 | 55 | 458 | 77 | 468 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "| Ineffective Injury Prevention. | 105 | 458 | 231 | 468 | Helvetica | 10 | False | False | native | 1.00 | #000000 |\n",
+       "_Showing 30 of 44 elements (pass limit= to see more)_"
+      ]
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "page.find_all('text').inspect()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "06c8d813",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2025-06-15T16:10:45.422781Z",
+     "iopub.status.busy": "2025-06-15T16:10:45.422665Z",
+     "iopub.status.idle": "2025-06-15T16:10:45.425191Z",
+     "shell.execute_reply": "2025-06-15T16:10:45.424938Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/markdown": [
+       "## Collection Inspection (21 elements)\n",
+       "\n",
+       "### Line Elements\n",
+       "\n",
+       "| x0 | top | x1 | bottom | width | is_horizontal | is_vertical |\n",
+       "|------|------|------|------|------|------|------|\n",
+       "| 50 | 352 | 550 | 352 | 2 | True | False |\n",
+       "| 50 | 392 | 550 | 392 | 0 | True | False |\n",
+       "| 50 | 392 | 50 | 552 | 0 | False | True |\n",
+       "| 100 | 392 | 100 | 552 | 0 | False | True |\n",
+       "| 450 | 392 | 450 | 552 | 0 | False | True |\n",
+       "| 500 | 392 | 500 | 552 | 0 | False | True |\n",
+       "| 550 | 392 | 550 | 552 | 0 | False | True |\n",
+       "| 50 | 412 | 550 | 412 | 0 | True | False |\n",
+       "| 520 | 418 | 528 | 426 | 0 | False | False |\n",
+       "| 520 | 418 | 528 | 426 | 0 | False | False |\n",
+       "| 50 | 432 | 550 | 432 | 0 | True | False |\n",
+       "| 520 | 438 | 528 | 446 | 0 | False | False |\n",
+       "| 520 | 438 | 528 | 446 | 0 | False | False |\n",
+       "| 50 | 452 | 550 | 452 | 0 | True | False |\n",
+       "| 50 | 472 | 550 | 472 | 0 | True | False |\n",
+       "| 50 | 492 | 550 | 492 | 0 | True | False |\n",
+       "| 50 | 512 | 550 | 512 | 0 | True | False |\n",
+       "| 520 | 518 | 528 | 526 | 0 | False | False |\n",
+       "| 520 | 518 | 528 | 526 | 0 | False | False |\n",
+       "| 50 | 532 | 550 | 532 | 0 | True | False |\n",
+       "| 50 | 552 | 550 | 552 | 0 | True | False |"
+      ],
+      "text/plain": [
+       "## Collection Inspection (21 elements)\n",
+       "\n",
+       "### Line Elements\n",
+       "\n",
+       "| x0 | top | x1 | bottom | width | is_horizontal | is_vertical |\n",
+       "|------|------|------|------|------|------|------|\n",
+       "| 50 | 352 | 550 | 352 | 2 | True | False |\n",
+       "| 50 | 392 | 550 | 392 | 0 | True | False |\n",
+       "| 50 | 392 | 50 | 552 | 0 | False | True |\n",
+       "| 100 | 392 | 100 | 552 | 0 | False | True |\n",
+       "| 450 | 392 | 450 | 552 | 0 | False | True |\n",
+       "| 500 | 392 | 500 | 552 | 0 | False | True |\n",
+       "| 550 | 392 | 550 | 552 | 0 | False | True |\n",
+       "| 50 | 412 | 550 | 412 | 0 | True | False |\n",
+       "| 520 | 418 | 528 | 426 | 0 | False | False |\n",
+       "| 520 | 418 | 528 | 426 | 0 | False | False |\n",
+       "| 50 | 432 | 550 | 432 | 0 | True | False |\n",
+       "| 520 | 438 | 528 | 446 | 0 | False | False |\n",
+       "| 520 | 438 | 528 | 446 | 0 | False | False |\n",
+       "| 50 | 452 | 550 | 452 | 0 | True | False |\n",
+       "| 50 | 472 | 550 | 472 | 0 | True | False |\n",
+       "| 50 | 492 | 550 | 492 | 0 | True | False |\n",
+       "| 50 | 512 | 550 | 512 | 0 | True | False |\n",
+       "| 520 | 518 | 528 | 526 | 0 | False | False |\n",
+       "| 520 | 518 | 528 | 526 | 0 | False | False |\n",
+       "| 50 | 532 | 550 | 532 | 0 | True | False |\n",
+       "| 50 | 552 | 550 | 552 | 0 | True | False |"
+      ]
+     },
+     "execution_count": 5,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "page.find_all('line').inspect()"
+   ]
+  }
+ ],
+ "metadata": {
+  "jupytext": {
+   "cell_metadata_filter": "-all",
+   "main_language": "python",
+   "notebook_metadata_filter": "-all",
+   "text_representation": {
+    "extension": ".md",
+    "format_name": "markdown"
+   }
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.11.11"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

natural_pdf-0.1.17/docs/describe/index.md

@@ -0,0 +1,42 @@
+# Describe Functionality
+
+The `describe()` and `inspect()` methods provide an easy way to understand the contents of your PDF elements without having to visualize them as images.
+
+## Basic Usage
+
+Get a summary of an entire page:
+
+```python
+from natural_pdf import PDF
+
+pdf = PDF("https://github.com/jsoma/natural-pdf/raw/refs/heads/main/pdfs/01-practice.pdf")
+page = pdf.pages[0]
+
+page.describe()
+```
+
+## Element collection summaries
+
+You can describe element collections on a page with `.describe()`.
+
+```python
+# Describe all elements on the page
+page.find_all('text').describe()
+```
+
+```python
+# Describe all elements on the page
+page.find_all('rect').describe()
+```
+
+## Inspecting lists of elements
+
+For more detail, you can view specific details of element collections with `inspect()`.
+
+```python
+page.find_all('text').inspect()
+```
+
+```python
+page.find_all('line').inspect()
+```

{natural_pdf-0.1.15 → natural_pdf-0.1.17}/docs/installation/index.md

@@ -12,50 +12,24 @@ pip install natural-pdf
 
 But! If you want to recognize text, do page layout analysis, document q-and-a or other things, you can install optional dependencies.
 
-```bash
-# Install deskewing, OCR (surya and easyocr),
-# layout analysis (yolo), and interactive browsing
-pip install natural-pdf[favorites]
-
-# Install **everything**
-pip install natural-pdf[all]
-```
-
-
-### Optional Dependencies
-
 Natural PDF has modular dependencies for different features. Install them based on your needs:
 
 ```bash
-# Interactive PDF viewer 
-pip install natural-pdf[viewer]
-
 # Deskewing
 pip install natural-pdf[deskew]
 
-# OCR options
-pip install natural-pdf[easyocr]
-pip install natural-pdf[surya]
-pip install natural-pdf[paddle]
-pip install natural-pdf[doctr]
-
-# Layout analysis
-pip install natural-pdf[surya]
-pip install natural-pdf[docling]
-pip install natural-pdf[layout_yolo]
-pip install natural-pdf[paddle]
-
-# AI stuff
-pip install natural-pdf[core-ml]
+# LLM features (OpenAI)
 pip install natural-pdf[llm]
 
 # Semantic search
-pip install natural-pdf[core-ml]
+pip install natural-pdf[search]
 
-# Install everything
-pip install natural-pdf[all]
+# Install everything in the 'favorites' collection
+pip install natural-pdf[favorites]
 ```
 
+Other OCR and layout analysis engines like `surya`, `easyocr`, `paddle`, `doctr`, and `docling` can be installed via `pip` as needed. The library will provide you with an error message and installation command if you try to use an engine that isn't installed.
+
 ## Your First PDF Extraction
 
 Here's a quick example to make sure everything is working: