pdflinkcheck 1.1.70__tar.gz → 1.3.8__tar.gz

pdflinkcheck-1.3.8/LICENSE

@@ -0,0 +1,27 @@
+Some distributed binaries of this project include the PyMuPDF library, which is licensed under **AGPL3.0orlater**. 
+Any binary that incorporates PyMuPDF is therefore distributed under **AGPL3.0orlater**. 
+Other binaries use only the `pypdf` library and do not include PyMuPDF; these binaries are distributed under the **MIT License**.
+
+For AGPL-licensed binaries, the complete corresponding source code must be made available to anyone who possesses a copy, upon request. 
+This obligation applies only to recipients of those binaries, and hosting the source code in GitHub Releases satisfies this requirement.
+
+A binary becomes AGPL-licensed only when built with the optional `"full"` dependency group (as defined in `pyproject.toml` under `[project.optional-dependencies]`) or when PyMuPDF is otherwise included in the build environment. 
+The **source code of pdflinkcheck itself** remains licensed under the **MIT License**. Only a distributed binary (or a publicly served web app) becomes AGPL-licensed when PyMuPDF is included.
+
+Source code for each released version is available in the `pdflinkcheckVERSION.tar.gz` files on the projects GitHub Releases page.
+
+Fulltext copies of **LICENSEMIT** and **LICENSEAGPL3** are included in the root of the repository.
+
+**Links:**
+- Project source code: https://github.com/City-of-Memphis-Wastewater/pdflinkcheck 
+- PyMuPDF source code: https://github.com/pymupdf/PyMuPDF 
+- pypdfium2 source code: https://github.com/pypdfium2-team/pypdfium2
+- PDFium source code: https://pdfium.googlesource.com/pdfium/
+- pypdf source code: https://github.com/py-pdf/pypdf 
+- AGPLv3 text (FSF): https://www.gnu.org/licenses/agpl-3.0.html 
+- MIT License text: https://opensource.org/license/mit 
+- BSD-3 License text: https://opensource.org/license/bsd-3-clause
+- Apache-v2 License text: https://opensource.org/license/apache-2-0
+
+
+Copyright 2025 George Clayton Bennett

pdflinkcheck-1.3.8/LICENSE-MIT

@@ -0,0 +1,9 @@
+MIT
+
+Copyright © 2025 George Clayton Bennett <https://github.com/City-of-Memphis-Wastewater/>
+
+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.

pdflinkcheck-1.3.8/MANIFEST.in

@@ -0,0 +1,4 @@
+include src/pdflinkcheck/data/*
+recursive-include src/pdflinkcheck/data/themes *
+recursive-include src/pdflinkcheck/data/icons *
+

{pdflinkcheck-1.1.70 → pdflinkcheck-1.3.8}/PKG-INFO

@@ -1,18 +1,20 @@
 Metadata-Version: 2.4
 Name: pdflinkcheck
-Version: 1.1.70
+Version: 1.3.8
 Summary: A purpose-built PDF link analysis and reporting tool with GUI and CLI.
-Author: George Clayton Bennett
 Author-email: George Clayton Bennett <george.bennett@memphistn.gov>
-License-File: LICENSE
+Maintainer-email: George Clayton Bennett <george.bennett@memphistn.gov>
+License-Expression: MIT AND AGPL-3.0-or-later
+Project-URL: Homepage, https://github.com/city-of-memphis-wastewater/pdflinkcheck
+Project-URL: Repository, https://github.com/city-of-memphis-wastewater/pdflinkcheck
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
 Classifier: Operating System :: OS Independent
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: Intended Audience :: Developers
@@ -27,28 +29,34 @@ Classifier: Environment :: MacOS X
 Classifier: Environment :: Win32 (MS Windows)
 Classifier: Typing :: Typed
 Classifier: Development Status :: 4 - Beta
-Requires-Dist: pyhabitat>=1.0.53
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: LICENSE-MIT
+License-File: LICENSE-AGPL3
+Requires-Dist: openpyxl>=3.1.5
+Requires-Dist: pyhabitat>=1.1.6
 Requires-Dist: pypdf>=6.4.2
 Requires-Dist: rich>=14.2.0
 Requires-Dist: typer>=0.20.0
-Requires-Dist: pymupdf>=1.26.7 ; extra == 'full'
-Requires-Dist: sv-ttk>=2.6.1 ; extra == 'gui'
-Maintainer: George Clayton Bennett
-Maintainer-email: George Clayton Bennett <george.bennett@memphistn.gov>
-Requires-Python: >=3.10
-Project-URL: Homepage, https://github.com/city-of-memphis-wastewater/pdflinkcheck
-Project-URL: Repository, https://github.com/city-of-memphis-wastewater/pdflinkcheck
+Provides-Extra: pymupdf
+Requires-Dist: pymupdf<2.0.0,>=1.24.0; extra == "pymupdf"
+Provides-Extra: pdfium
+Requires-Dist: pypdfium2<6.0.0,>=5.2.0; extra == "pdfium"
 Provides-Extra: full
-Provides-Extra: gui
-Description-Content-Type: text/markdown
+Requires-Dist: pymupdf<2.0.0,>=1.24.0; extra == "full"
+Requires-Dist: pypdfium2<6.0.0,>=5.2.0; extra == "full"
+Dynamic: license-file
 
 # pdflinkcheck
 
 A purpose-built tool for comprehensive analysis of hyperlinks and GoTo links within PDF documents. Users may leverage either the PyMuPDF or the pypdf library. Use the CLI or the GUI.
 
+[![Get it from the Microsoft Store](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/ms_store_badge_en-us-light.svg)](https://apps.microsoft.com/store/detail/9n11hxvls1wg)
+
 -----
 
-![Screenshot of the pdflinkcheck GUI](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_gui_v1.1.58.png)
+![Screenshot of the pdflinkcheck GUI](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_gui_v1.3.3.png)
 
 -----
 
@@ -63,7 +71,7 @@ For the most user-typical experience, download the single-file binary matching y
 | **File Type** | **Primary Use Case** | **Recommended Launch Method** |
 | :--- | :--- | :--- |
 | **Executable (.exe, .elf)** | **GUI** | Double-click the file. |
-| **PYZ (Python Zip App)** | **CLI** or **GUI** | Run using your system's `python` command: `python pdflinkcheck-VERSION.pyz --help` |
+| **PYZ (Python Zip App)** | **CLI** or **GUI** | Run using your system's `python` command: `python pdflinkcheck-VERSION.pyz --help` | 
 
 ### Installation via pipx
 
@@ -86,20 +94,9 @@ The tool can be run as simple cross-platform graphical interface (Tkinter).
 
 ### Launching the GUI
 
-There are three ways to launch the GUI interface:
-
-1.  **Implicit Launch:** Run the main command with no arguments, subcommands, or flags (`pdflinkcheck`).
+Ways to launch the GUI interface:
+1.  **Implicit Launch:** Run the tool or file with no arguments, subcommands, or flags. (Note: PyInstaller builds use the --windowed (or -noconsole) flag, except for on Termux.)
 2.  **Explicit Command:** Use the dedicated GUI subcommand (`pdflinkcheck gui`).
-3.  **Binary Double-Click:**
-      * **Windows:** Double-click the `pdflinkcheck-VERSION-gui.bat` file.
-      * **macOS/Linux:** Double-click the downloaded `.pyz` or `.elf` file.
-
-### Planned GUI Updates
-
-We are actively working on the following enhancements:
-
-  * **Report Export:** Functionality to export the full analysis report to a plain text file.
-  * **License Visibility:** A dedicated "License Info" button within the GUI to display the terms of the AGPLv3+ license.
 
 -----
 
@@ -107,20 +104,30 @@ We are actively working on the following enhancements:
 
 The core functionality is accessed via the `analyze` command. 
 
-`DEV_TYPER_HELP_TREE=1 pdflinkcheck help-tree`:
-![Screenshot of the pdflinkcheck CLI Tree Help](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_cli_v1.1.58_tree_help.png)
-
 `pdflinkcheck --help`:
-![Screenshot of the pdflinkcheck CLI Tree Help](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_cli_v1.1.58.png)
+![Screenshot of the pdflinkcheck CLI Tree Help](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_cli_v1.3.3.png)
+
+
+See the Help Tree by unlocking the help-tree CLI command, using the DEV_TYPER_HELP_TREE env var.
+
+```
+DEV_TYPER_HELP_TREE=1 pdflinkcheck help-tree` # bash
+$env:DEV_TYPER_HELP_TREE = "1"; pdflinkcheck help-tree` # PowerShell
+```
+
+![Screenshot of the pdflinkcheck CLI Tree Help](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_cli_v1.3.3_tree_help.png)
+
 
 
 ### Available Commands
 
 |**Command**|**Description**|
 |---|---|
-|`pdflinkcheck analyze`|Analyzes a PDF file for links |
+|`pdflinkcheck analyze`|Analyzes a PDF file for links and validates their reasonableness.|
 |`pdflinkcheck gui`|Explicitly launch the Graphical User Interface.|
 |`pdflinkcheck docs`|Access documentation, including the README and AGPLv3+ license.|
+|`pdflinkcheck serve`|Serve a basic local web app which uses only the Python standard library.|
+|`pdflinkcheck tools`|Access additional tools, like `--clear-cache`.|
 
 ### `analyze` Command Options
 
@@ -128,8 +135,7 @@ The core functionality is accessed via the `analyze` command.
 |---|---|---|
 |`<PDF_PATH>`|**Required.** The path to the PDF file to analyze.|N/A|
 |`--pdf-library / -p`|Select engine: `pymupdf` or `pypdf`.|`pypdf`|
-|`--export-format / -e`|Export to `JSON`, `TXT`, or `None` to suppress file output.|`JSON`|
-|`--max-links / -m`|Maximum links to display per section. Use `0` for all.|`0`|
+|`--format / -f`|Export to `JSON`, `TXT`, `XLSX`, and/or `None` to suppress file output.|`JSON`|
 
 ### `gui` Command Options
 
@@ -140,11 +146,8 @@ The core functionality is accessed via the `analyze` command.
 #### Example Runs
 
 ```bash 
-# Analyze a document, show all links, and save the report as JSON and TXT
-pdflinkcheck analyze "TE Maxson WWTF O&M Manual.pdf" --export-format JSON,TXT
-
-# Analyze a document but keep the print block short, showing only the first 10 links for each type
-pdflinkcheck analyze "TE Maxson WWTF O&M Manual.pdf" --max-links 10
+# Analyze a document, show all links, and save the report as XLSX, JSON, and TXT
+pdflinkcheck analyze "TE Maxson WWTF O&M Manual.pdf" --format xlsx -f json -f txt
 
 # Show the GUI for only a moment, like in a build check
 pdflinkcheck gui --auto-close 3000 
@@ -157,27 +160,28 @@ pdflinkcheck docs --license --readme
 
 ## 📦 Library Access (Advanced)
 
-For developers importing `pdflinkcheck` into other Python projects, the core analysis functions are exposed directly in the root namespace:
+For developers importing `pdflinkcheck` into other Python projects, the core analysis functions are exposed directly in the root namespace. The various `analysis_pdf_*` functions each use a different library to extract the target PDF's internal TOC, external links, and metadata.
 
-|**Function**|**Description**|
-|---|---|
-|`run_report()`|**(Primary function)** Performs the full analysis, prints to console, and handles file export.|
-|`extract_links_pynupdf()`|Function to retrieve all explicit links (URIs, GoTo, etc.) from a PDF path.|
-|`extract_toc_pymupdf()`|Function to extract the PDF's internal Table of Contents (bookmarks/outline).|
-|`extract_links_pynupdf()`|Function to retrieve all explicit links (URIs, GoTo, etc.) from a PDF path, using the pypdf library.|
-|`extract_toc_pymupdf()`|Function to extract the PDF's internal Table of Contents (bookmarks/outline), using the pypdf library.|
+|**Function**|**Library**|**Description**|
+|---|---|---|
+|`run_report()`|pdflinkcheck | **(Primary function)** Performs the full analysis, prints to console, and handles file export.|
+|`analyze_pdf_pdfium()`| pypdfium2 | Fast, ~10 mb, Permissively licensed |
+|`analyze_pdf_pymupdf()`| PyMuPDF | Fast, ~30 mb, AGPL3+ licensed |
+|`analyze_pdf_pypdf()`| pypdf library | Slow, ~2 mb, Permissively licensed |
 
 Exanple:
 
 ```python
-from pdflinkcheck.report import run_report
-from pdflinkcheck.analysis_pymupdf import extract_links_pymupdf, extract_toc_pymupdf                                                                          130 from pdflinkcheck.analysis_pymupdf import extract_links_pynupdf, extract_toc_pymupdf
-from pdflinkcheck.analysis_pypdf import extract_links_pypdf, extract_toc_pypdf
+from pdflinkcheck import ( run_report,
+                          analyze_pdf_pymupdf, 
+                          analyze_pdf_pypdf, 
+                          analyze_pdf_pdfium, 
+                          )
 
 file = "document1.pdf"
 report_data = run_report(file)
-links_pymupdf = extract_links_pymupdf(file)
-links_pypdf = extract_links_pypdf(file)
+links_pdfium = analyze_pdf_pdfium(file)
+links_pypdf = analyze_pdf_pypdf(file)
 ```
 
 -----
@@ -232,22 +236,34 @@ This `help-tree` feature has not yet been submitted for inclusion into Typer.
 
 ## ⚠️ Compatibility Notes
 
-#### Termux Compatibility as a Key Goal
+### Termux Compatibility as a Key Goal
 A key goal of City-of-Memphis-Wastewater is to release all software as Termux-compatible.
 
-Termux compatibility is important in the modern age as Android devices are common among technicians, field engineers, and maintenace staff. 
+Termux compatibility is important in the modern age, because Android devices are common among technicians, field engineers, and maintenace staff. 
 Android is the most common operating system in the Global South. 
 We aim to produce stable software that can do the most possible good. 
 
-While using `PyMuPDF` in Python dependency resolution on Termux simply isn't possible, we are proud to have achieved a work-around by implementing a parallel solution in `pypdf`! 
-Now, there is PDF Engine selection in both the CLI and the GUI. 
-`pypdf` is the default in pdflinkcheck.report.run_report(); PyMuPDF can be explicitly requested in the CLI and is the default in the TKinter GUI.
+Now `pdflinkcheck` can run on Termux by using the `pypdf` engine and the `pdfium` engine. 
+Benefits:
+- `pypdf`-only artifacts, to reduce size to about 6% compared to artifacts that include `PyMuPDF`.
+- Web-stack GUI as an alternative to the Tkinter GUI, which can be run locally on Termux or as a web app.
+
+
+### PDF Library Selection
+At long last, `PyMuPDF` is an optional dependency. All testing comparing `pypdf` and `PyMuPDF` has shown identical validation performance. However `PyMuPDF` is much faster. The benfit of `pypdf` is small size of packages and cross-platform compatibility. We have recently added a PDFium option, which circumvents the AGPL3+.
+
+Expecte that all binaries and artifacts contain PyMuPDF, unlss they are built on Android. The GUI and CLI interfaces both allow selection of the library; if PyMuPDF is selected but is not available, the user will be warned.
 
-Now that `pdflinkcheck` can run on Termux, we may find a work-around and be able to drop the PyMuPDF dependency. 
-- Build `pypdf`-only artifacts, to reduce size.
-- Build a web-stack GUI as an alternative to the Tkinter GUI, to be compatible with Termux.
+To install the complete version use one of these options:
+
+```bash
+pip install "pdflinkcheck[pymupdf]"
+pipx install "pdflinkcheck[pdfium]"
+uv tool install "pdflinkcheck[pdfium]"
+uv add "pdflinkcheck[pdfium]"
+```
 
-Because it works, we plan to keep the `PyMuPDF` portion of the codebase.
+---
 
 ### Document Compatibility: 
 Not all PDF files can be processed successfully. This tool is designed primarily for digitally generated (vector-based) PDFs.
@@ -259,22 +275,6 @@ Processing may fail or yield incomplete results for:
 
 -----
 
-## PDF Library Selection
-At long last, `PyMuPDF` is an optional dependency. The default is `pypdf`. All testing has shown identical performance, though the `analyze_pymupdf.py` is faster and more direct and robust than `analyze_pypdf.py`, which requires a lot of intentional parsing. 
-
-Binaries and artifacts are expected to contain PyMuPDF, unless they are build on Android. The GUI and CLI interfaces both allow selection of the library; if PyMuPDF is selected but is not available, the user will be warned.
-
-To install the complete version use one of these options:
-
-```bash
-pip install "pdflinkcheck[full]"
-pipx install "pdflinkcheck[full]"
-uv tool install "pdflinkcheck[full]"
-uv add "pdflinkcheck[full]"
-```
-
------
-
 ## Run from Source (Developers)
 
 ```bash
@@ -282,12 +282,12 @@ git clone http://github.com/city-of-memphis-wastewater/pdflinkcheck.git
 cd pdflinkcheck
 
 # To include the PyMuPDF dependency in the installation:
-uv sync --extras full
+uv sync --extras pdfium --extra pymupdf
 
 # On Termux, to not include PyMuPDF:
-uv sync
+uv sync --extra pdfium
 
-# To include developer depedecies:
+# To include developer dependencies:
 uv sync --all-extras --group dev
 
 # Run the CLI
@@ -301,22 +301,28 @@ uv run  python -m pdflinkcheck.stdlib_server
 
 ## 📜 License Implications (AGPLv3+)
 
-**`pdflinkcheck` is licensed under the `GNU Affero General Public License` version 3 or later (`AGPLv3+`).**
-
-The `AGPL3+` is required for portions of this codebase because `pdflinkcheck` uses `PyMuPDF`, which is licensed under the `AGPL3`.
 
-To stay in compliance, the AGPL3 license text is readily available in the CLI and the GUI, and it is included in the build artifacts.
-The `AGPL3` appears as the primary license file in the source code. While this infers that the entire project is AGPL3-licensed, this is not true - portions of the codebase are MIT-licensed.
+The `AGPL3-or-later` is required for binaries of `pdflinkcheck` which include `PyMuPDF`, which is licensed under the `AGPL3`.
+The source code itself for `pdflinkcheck` is licensed under the `MIT`. 
 
-This license has significant implications for **distribution and network use**, particularly for organizations:
+The AGPL3-or-later license has significant implications for **distribution and network use**, particularly for organizations:
 
   * **Source Code Provision:** If you distribute this tool (modified or unmodified) to anyone, you **must** provide the full source code under the same license.
   * **Network Interaction (Affero Clause):** If you modify this tool and make the modified version available to users over a computer network (e.g., as a web service or backend), you **must** also offer the source code to those network users.
 
 > **Before deploying or modifying this tool for organizational use, especially for internal web services or distribution, please ensure compliance with the AGPLv3+ terms.**
 
+Because the AGPLv3 is a strong copyleft license, any version of `pdflinkcheck` that includes AGPL‑licensed components (such as `PyMuPDF`) must be distributed as a whole under AGPLv3+. This means that for those versions, anyone who distributes the application — or makes a modified version available over a network — must also provide the complete corresponding source code under the same terms.
+
+The source code of pdflinkcheck itself remains licensed under the **MIT License**; only the distributed binary becomes AGPL‑licensed when PyMuPDF is included.
+
+
 Links:
 - Source code: https://github.com/City-of-Memphis-Wastewater/pdflinkcheck/  
-- Official AGPLv3 Text (FSF): https://www.gnu.org/licenses/agpl-3.0.html
+- PyMuPDF source code: https://github.com/pymupdf/PyMuPDF/
+- pypdfium2 source code: https://github.com/pypdfium2-team/pypdfium2
+- pypdf source code: https://github.com/py-pdf/pypdf/
+- AGPLv3 text (FSF): https://www.gnu.org/licenses/agpl-3.0.html  
+- MIT License text: https://opensource.org/license/mit  
 
 Copyright © 2025 George Clayton Bennett

{pdflinkcheck-1.1.70 → pdflinkcheck-1.3.8}/README.md

@@ -2,9 +2,11 @@
 
 A purpose-built tool for comprehensive analysis of hyperlinks and GoTo links within PDF documents. Users may leverage either the PyMuPDF or the pypdf library. Use the CLI or the GUI.
 
+[![Get it from the Microsoft Store](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/ms_store_badge_en-us-light.svg)](https://apps.microsoft.com/store/detail/9n11hxvls1wg)
+
 -----
 
-![Screenshot of the pdflinkcheck GUI](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_gui_v1.1.58.png)
+![Screenshot of the pdflinkcheck GUI](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_gui_v1.3.3.png)
 
 -----
 
@@ -19,7 +21,7 @@ For the most user-typical experience, download the single-file binary matching y
 | **File Type** | **Primary Use Case** | **Recommended Launch Method** |
 | :--- | :--- | :--- |
 | **Executable (.exe, .elf)** | **GUI** | Double-click the file. |
-| **PYZ (Python Zip App)** | **CLI** or **GUI** | Run using your system's `python` command: `python pdflinkcheck-VERSION.pyz --help` |
+| **PYZ (Python Zip App)** | **CLI** or **GUI** | Run using your system's `python` command: `python pdflinkcheck-VERSION.pyz --help` | 
 
 ### Installation via pipx
 
@@ -42,20 +44,9 @@ The tool can be run as simple cross-platform graphical interface (Tkinter).
 
 ### Launching the GUI
 
-There are three ways to launch the GUI interface:
-
-1.  **Implicit Launch:** Run the main command with no arguments, subcommands, or flags (`pdflinkcheck`).
+Ways to launch the GUI interface:
+1.  **Implicit Launch:** Run the tool or file with no arguments, subcommands, or flags. (Note: PyInstaller builds use the --windowed (or -noconsole) flag, except for on Termux.)
 2.  **Explicit Command:** Use the dedicated GUI subcommand (`pdflinkcheck gui`).
-3.  **Binary Double-Click:**
-      * **Windows:** Double-click the `pdflinkcheck-VERSION-gui.bat` file.
-      * **macOS/Linux:** Double-click the downloaded `.pyz` or `.elf` file.
-
-### Planned GUI Updates
-
-We are actively working on the following enhancements:
-
-  * **Report Export:** Functionality to export the full analysis report to a plain text file.
-  * **License Visibility:** A dedicated "License Info" button within the GUI to display the terms of the AGPLv3+ license.
 
 -----
 
@@ -63,20 +54,30 @@ We are actively working on the following enhancements:
 
 The core functionality is accessed via the `analyze` command. 
 
-`DEV_TYPER_HELP_TREE=1 pdflinkcheck help-tree`:
-![Screenshot of the pdflinkcheck CLI Tree Help](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_cli_v1.1.58_tree_help.png)
-
 `pdflinkcheck --help`:
-![Screenshot of the pdflinkcheck CLI Tree Help](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_cli_v1.1.58.png)
+![Screenshot of the pdflinkcheck CLI Tree Help](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_cli_v1.3.3.png)
+
+
+See the Help Tree by unlocking the help-tree CLI command, using the DEV_TYPER_HELP_TREE env var.
+
+```
+DEV_TYPER_HELP_TREE=1 pdflinkcheck help-tree` # bash
+$env:DEV_TYPER_HELP_TREE = "1"; pdflinkcheck help-tree` # PowerShell
+```
+
+![Screenshot of the pdflinkcheck CLI Tree Help](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_cli_v1.3.3_tree_help.png)
+
 
 
 ### Available Commands
 
 |**Command**|**Description**|
 |---|---|
-|`pdflinkcheck analyze`|Analyzes a PDF file for links |
+|`pdflinkcheck analyze`|Analyzes a PDF file for links and validates their reasonableness.|
 |`pdflinkcheck gui`|Explicitly launch the Graphical User Interface.|
 |`pdflinkcheck docs`|Access documentation, including the README and AGPLv3+ license.|
+|`pdflinkcheck serve`|Serve a basic local web app which uses only the Python standard library.|
+|`pdflinkcheck tools`|Access additional tools, like `--clear-cache`.|
 
 ### `analyze` Command Options
 
@@ -84,8 +85,7 @@ The core functionality is accessed via the `analyze` command.
 |---|---|---|
 |`<PDF_PATH>`|**Required.** The path to the PDF file to analyze.|N/A|
 |`--pdf-library / -p`|Select engine: `pymupdf` or `pypdf`.|`pypdf`|
-|`--export-format / -e`|Export to `JSON`, `TXT`, or `None` to suppress file output.|`JSON`|
-|`--max-links / -m`|Maximum links to display per section. Use `0` for all.|`0`|
+|`--format / -f`|Export to `JSON`, `TXT`, `XLSX`, and/or `None` to suppress file output.|`JSON`|
 
 ### `gui` Command Options
 
@@ -96,11 +96,8 @@ The core functionality is accessed via the `analyze` command.
 #### Example Runs
 
 ```bash 
-# Analyze a document, show all links, and save the report as JSON and TXT
-pdflinkcheck analyze "TE Maxson WWTF O&M Manual.pdf" --export-format JSON,TXT
-
-# Analyze a document but keep the print block short, showing only the first 10 links for each type
-pdflinkcheck analyze "TE Maxson WWTF O&M Manual.pdf" --max-links 10
+# Analyze a document, show all links, and save the report as XLSX, JSON, and TXT
+pdflinkcheck analyze "TE Maxson WWTF O&M Manual.pdf" --format xlsx -f json -f txt
 
 # Show the GUI for only a moment, like in a build check
 pdflinkcheck gui --auto-close 3000 
@@ -113,27 +110,28 @@ pdflinkcheck docs --license --readme
 
 ## 📦 Library Access (Advanced)
 
-For developers importing `pdflinkcheck` into other Python projects, the core analysis functions are exposed directly in the root namespace:
+For developers importing `pdflinkcheck` into other Python projects, the core analysis functions are exposed directly in the root namespace. The various `analysis_pdf_*` functions each use a different library to extract the target PDF's internal TOC, external links, and metadata.
 
-|**Function**|**Description**|
-|---|---|
-|`run_report()`|**(Primary function)** Performs the full analysis, prints to console, and handles file export.|
-|`extract_links_pynupdf()`|Function to retrieve all explicit links (URIs, GoTo, etc.) from a PDF path.|
-|`extract_toc_pymupdf()`|Function to extract the PDF's internal Table of Contents (bookmarks/outline).|
-|`extract_links_pynupdf()`|Function to retrieve all explicit links (URIs, GoTo, etc.) from a PDF path, using the pypdf library.|
-|`extract_toc_pymupdf()`|Function to extract the PDF's internal Table of Contents (bookmarks/outline), using the pypdf library.|
+|**Function**|**Library**|**Description**|
+|---|---|---|
+|`run_report()`|pdflinkcheck | **(Primary function)** Performs the full analysis, prints to console, and handles file export.|
+|`analyze_pdf_pdfium()`| pypdfium2 | Fast, ~10 mb, Permissively licensed |
+|`analyze_pdf_pymupdf()`| PyMuPDF | Fast, ~30 mb, AGPL3+ licensed |
+|`analyze_pdf_pypdf()`| pypdf library | Slow, ~2 mb, Permissively licensed |
 
 Exanple:
 
 ```python
-from pdflinkcheck.report import run_report
-from pdflinkcheck.analysis_pymupdf import extract_links_pymupdf, extract_toc_pymupdf                                                                          130 from pdflinkcheck.analysis_pymupdf import extract_links_pynupdf, extract_toc_pymupdf
-from pdflinkcheck.analysis_pypdf import extract_links_pypdf, extract_toc_pypdf
+from pdflinkcheck import ( run_report,
+                          analyze_pdf_pymupdf, 
+                          analyze_pdf_pypdf, 
+                          analyze_pdf_pdfium, 
+                          )
 
 file = "document1.pdf"
 report_data = run_report(file)
-links_pymupdf = extract_links_pymupdf(file)
-links_pypdf = extract_links_pypdf(file)
+links_pdfium = analyze_pdf_pdfium(file)
+links_pypdf = analyze_pdf_pypdf(file)
 ```
 
 -----
@@ -188,22 +186,34 @@ This `help-tree` feature has not yet been submitted for inclusion into Typer.
 
 ## ⚠️ Compatibility Notes
 
-#### Termux Compatibility as a Key Goal
+### Termux Compatibility as a Key Goal
 A key goal of City-of-Memphis-Wastewater is to release all software as Termux-compatible.
 
-Termux compatibility is important in the modern age as Android devices are common among technicians, field engineers, and maintenace staff. 
+Termux compatibility is important in the modern age, because Android devices are common among technicians, field engineers, and maintenace staff. 
 Android is the most common operating system in the Global South. 
 We aim to produce stable software that can do the most possible good. 
 
-While using `PyMuPDF` in Python dependency resolution on Termux simply isn't possible, we are proud to have achieved a work-around by implementing a parallel solution in `pypdf`! 
-Now, there is PDF Engine selection in both the CLI and the GUI. 
-`pypdf` is the default in pdflinkcheck.report.run_report(); PyMuPDF can be explicitly requested in the CLI and is the default in the TKinter GUI.
+Now `pdflinkcheck` can run on Termux by using the `pypdf` engine and the `pdfium` engine. 
+Benefits:
+- `pypdf`-only artifacts, to reduce size to about 6% compared to artifacts that include `PyMuPDF`.
+- Web-stack GUI as an alternative to the Tkinter GUI, which can be run locally on Termux or as a web app.
+
+
+### PDF Library Selection
+At long last, `PyMuPDF` is an optional dependency. All testing comparing `pypdf` and `PyMuPDF` has shown identical validation performance. However `PyMuPDF` is much faster. The benfit of `pypdf` is small size of packages and cross-platform compatibility. We have recently added a PDFium option, which circumvents the AGPL3+.
 
-Now that `pdflinkcheck` can run on Termux, we may find a work-around and be able to drop the PyMuPDF dependency. 
-- Build `pypdf`-only artifacts, to reduce size.
-- Build a web-stack GUI as an alternative to the Tkinter GUI, to be compatible with Termux.
+Expecte that all binaries and artifacts contain PyMuPDF, unlss they are built on Android. The GUI and CLI interfaces both allow selection of the library; if PyMuPDF is selected but is not available, the user will be warned.
 
-Because it works, we plan to keep the `PyMuPDF` portion of the codebase.
+To install the complete version use one of these options:
+
+```bash
+pip install "pdflinkcheck[pymupdf]"
+pipx install "pdflinkcheck[pdfium]"
+uv tool install "pdflinkcheck[pdfium]"
+uv add "pdflinkcheck[pdfium]"
+```
+
+---
 
 ### Document Compatibility: 
 Not all PDF files can be processed successfully. This tool is designed primarily for digitally generated (vector-based) PDFs.
@@ -215,22 +225,6 @@ Processing may fail or yield incomplete results for:
 
 -----
 
-## PDF Library Selection
-At long last, `PyMuPDF` is an optional dependency. The default is `pypdf`. All testing has shown identical performance, though the `analyze_pymupdf.py` is faster and more direct and robust than `analyze_pypdf.py`, which requires a lot of intentional parsing. 
-
-Binaries and artifacts are expected to contain PyMuPDF, unless they are build on Android. The GUI and CLI interfaces both allow selection of the library; if PyMuPDF is selected but is not available, the user will be warned.
-
-To install the complete version use one of these options:
-
-```bash
-pip install "pdflinkcheck[full]"
-pipx install "pdflinkcheck[full]"
-uv tool install "pdflinkcheck[full]"
-uv add "pdflinkcheck[full]"
-```
-
------
-
 ## Run from Source (Developers)
 
 ```bash
@@ -238,12 +232,12 @@ git clone http://github.com/city-of-memphis-wastewater/pdflinkcheck.git
 cd pdflinkcheck
 
 # To include the PyMuPDF dependency in the installation:
-uv sync --extras full
+uv sync --extras pdfium --extra pymupdf
 
 # On Termux, to not include PyMuPDF:
-uv sync
+uv sync --extra pdfium
 
-# To include developer depedecies:
+# To include developer dependencies:
 uv sync --all-extras --group dev
 
 # Run the CLI
@@ -257,22 +251,28 @@ uv run  python -m pdflinkcheck.stdlib_server
 
 ## 📜 License Implications (AGPLv3+)
 
-**`pdflinkcheck` is licensed under the `GNU Affero General Public License` version 3 or later (`AGPLv3+`).**
 
-The `AGPL3+` is required for portions of this codebase because `pdflinkcheck` uses `PyMuPDF`, which is licensed under the `AGPL3`.
+The `AGPL3-or-later` is required for binaries of `pdflinkcheck` which include `PyMuPDF`, which is licensed under the `AGPL3`.
+The source code itself for `pdflinkcheck` is licensed under the `MIT`. 
 
-To stay in compliance, the AGPL3 license text is readily available in the CLI and the GUI, and it is included in the build artifacts.
-The `AGPL3` appears as the primary license file in the source code. While this infers that the entire project is AGPL3-licensed, this is not true - portions of the codebase are MIT-licensed.
-
-This license has significant implications for **distribution and network use**, particularly for organizations:
+The AGPL3-or-later license has significant implications for **distribution and network use**, particularly for organizations:
 
   * **Source Code Provision:** If you distribute this tool (modified or unmodified) to anyone, you **must** provide the full source code under the same license.
   * **Network Interaction (Affero Clause):** If you modify this tool and make the modified version available to users over a computer network (e.g., as a web service or backend), you **must** also offer the source code to those network users.
 
 > **Before deploying or modifying this tool for organizational use, especially for internal web services or distribution, please ensure compliance with the AGPLv3+ terms.**
 
+Because the AGPLv3 is a strong copyleft license, any version of `pdflinkcheck` that includes AGPL‑licensed components (such as `PyMuPDF`) must be distributed as a whole under AGPLv3+. This means that for those versions, anyone who distributes the application — or makes a modified version available over a network — must also provide the complete corresponding source code under the same terms.
+
+The source code of pdflinkcheck itself remains licensed under the **MIT License**; only the distributed binary becomes AGPL‑licensed when PyMuPDF is included.
+
+
 Links:
 - Source code: https://github.com/City-of-Memphis-Wastewater/pdflinkcheck/  
-- Official AGPLv3 Text (FSF): https://www.gnu.org/licenses/agpl-3.0.html
+- PyMuPDF source code: https://github.com/pymupdf/PyMuPDF/
+- pypdfium2 source code: https://github.com/pypdfium2-team/pypdfium2
+- pypdf source code: https://github.com/py-pdf/pypdf/
+- AGPLv3 text (FSF): https://www.gnu.org/licenses/agpl-3.0.html  
+- MIT License text: https://opensource.org/license/mit  
 
 Copyright © 2025 George Clayton Bennett