pdflinkcheck 1.2.29__tar.gz → 1.3.8__tar.gz

{pdflinkcheck-1.2.29 → pdflinkcheck-1.3.8}/LICENSE

@@ -2,11 +2,11 @@ Some distributed binaries of this project include the PyMuPDF library, which is
 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 AGPLlicensed binaries, the complete corresponding source code must be made available to anyone who possesses a copy, upon request. 
+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 AGPLlicensed 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 the distributed binary becomes AGPLlicensed when PyMuPDF is included.
+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.
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pdflinkcheck
-Version: 1.2.29
+Version: 1.3.8
 Summary: A purpose-built PDF link analysis and reporting tool with GUI and CLI.
 Author-email: George Clayton Bennett <george.bennett@memphistn.gov>
 Maintainer-email: George Clayton Bennett <george.bennett@memphistn.gov>
@@ -34,12 +34,13 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: LICENSE-MIT
 License-File: LICENSE-AGPL3
-Requires-Dist: pyhabitat>=1.1.5
+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
-Provides-Extra: mupdf
-Requires-Dist: pymupdf<2.0.0,>=1.24.0; extra == "mupdf"
+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
@@ -51,9 +52,11 @@ Dynamic: license-file
 
 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.97.png)
+![Screenshot of the pdflinkcheck GUI](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_gui_v1.3.3.png)
 
 -----
 
@@ -102,7 +105,7 @@ Ways to launch the GUI interface:
 The core functionality is accessed via the `analyze` command. 
 
 `pdflinkcheck --help`:
-![Screenshot of the pdflinkcheck CLI Tree Help](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_cli_v1.1.97.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.
@@ -112,7 +115,7 @@ 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.1.97_tree_help.png)
+![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)
 
 
 
@@ -132,7 +135,7 @@ $env:DEV_TYPER_HELP_TREE = "1"; pdflinkcheck help-tree` # PowerShell
 |---|---|---|
 |`<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`|
+|`--format / -f`|Export to `JSON`, `TXT`, `XLSX`, and/or `None` to suppress file output.|`JSON`|
 
 ### `gui` Command Options
 
@@ -143,8 +146,8 @@ $env:DEV_TYPER_HELP_TREE = "1"; pdflinkcheck help-tree` # PowerShell
 #### 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, 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 
@@ -177,8 +180,8 @@ from pdflinkcheck import ( run_report,
 
 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)
 ```
 
 -----
@@ -254,7 +257,7 @@ Expecte that all binaries and artifacts contain PyMuPDF, unlss they are built on
 To install the complete version use one of these options:
 
 ```bash
-pip install "pdflinkcheck[mupdf]"
+pip install "pdflinkcheck[pymupdf]"
 pipx install "pdflinkcheck[pdfium]"
 uv tool install "pdflinkcheck[pdfium]"
 uv add "pdflinkcheck[pdfium]"
@@ -279,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

{pdflinkcheck-1.2.29 → 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.97.png)
+![Screenshot of the pdflinkcheck GUI](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_gui_v1.3.3.png)
 
 -----
 
@@ -53,7 +55,7 @@ Ways to launch the GUI interface:
 The core functionality is accessed via the `analyze` command. 
 
 `pdflinkcheck --help`:
-![Screenshot of the pdflinkcheck CLI Tree Help](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_cli_v1.1.97.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.
@@ -63,7 +65,7 @@ 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.1.97_tree_help.png)
+![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)
 
 
 
@@ -83,7 +85,7 @@ $env:DEV_TYPER_HELP_TREE = "1"; pdflinkcheck help-tree` # PowerShell
 |---|---|---|
 |`<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`|
+|`--format / -f`|Export to `JSON`, `TXT`, `XLSX`, and/or `None` to suppress file output.|`JSON`|
 
 ### `gui` Command Options
 
@@ -94,8 +96,8 @@ $env:DEV_TYPER_HELP_TREE = "1"; pdflinkcheck help-tree` # PowerShell
 #### 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, 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 
@@ -128,8 +130,8 @@ from pdflinkcheck import ( run_report,
 
 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)
 ```
 
 -----
@@ -205,7 +207,7 @@ Expecte that all binaries and artifacts contain PyMuPDF, unlss they are built on
 To install the complete version use one of these options:
 
 ```bash
-pip install "pdflinkcheck[mupdf]"
+pip install "pdflinkcheck[pymupdf]"
 pipx install "pdflinkcheck[pdfium]"
 uv tool install "pdflinkcheck[pdfium]"
 uv add "pdflinkcheck[pdfium]"
@@ -230,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

{pdflinkcheck-1.2.29/src/pdflinkcheck/data → pdflinkcheck-1.3.8}/pyproject.toml

@@ -1,11 +1,12 @@
 [project]
 name = "pdflinkcheck"
-version = "1.2.29"
+version = "1.3.8"
 description = "A purpose-built PDF link analysis and reporting tool with GUI and CLI."
 readme = "README.md"
 requires-python = ">=3.9"
 dependencies = [
-    "pyhabitat>=1.1.5",
+    "openpyxl>=3.1.5",
+    "pyhabitat>=1.1.6",
     "pypdf>=6.4.2",
     "rich>=14.2.0",
     "typer>=0.20.0",
@@ -56,7 +57,7 @@ pdflinkcheck = "pdflinkcheck.cli:app"
 
 [project.optional-dependencies]
 # If you choose to include PyMuPDF, you must comply with the AGPL3
-mupdf = ["pymupdf>=1.24.0,<2.0.0"] # fails on termux
+pymupdf = ["pymupdf>=1.24.0,<2.0.0"] # fails on termux
 pdfium = ["pypdfium2>=5.2.0,<6.0.0"]
 full = ["pymupdf>=1.24.0,<2.0.0", "pypdfium2>=5.2.0,<6.0.0"]
 

{pdflinkcheck-1.2.29 → pdflinkcheck-1.3.8}/src/pdflinkcheck/__init__.py

@@ -49,7 +49,7 @@ def analyze_pdf_pymupdf(path):
     except ImportError:
         raise ImportError(
             "PyMuPDF engine is not installed. "
-            "Install with the [mupdf] extra to enable PyMuPDF support."
+            "Install with the [pymupdf] extra to enable PyMuPDF support."
         )
     return _analyze(path)
 analyze_pdf_pymupdf.__doc__ = (

{pdflinkcheck-1.2.29 → pdflinkcheck-1.3.8}/src/pdflinkcheck/cli.py

@@ -3,7 +3,7 @@
 # src/pdflinkcheck/cli.py
 from __future__ import annotations
 import typer
-from typing import Literal
+from typing import Literal, List
 from typer.models import OptionInfo
 from rich.console import Console
 from pathlib import Path
@@ -13,10 +13,10 @@ import pyhabitat
 import sys
 import os
 from importlib.resources import files
+from enum import Enum
 
 from pdflinkcheck.version_info import get_version_from_pyproject
-from pdflinkcheck.validate import run_validation 
-from pdflinkcheck.environment import is_in_git_repo, assess_default_pdf_library
+from pdflinkcheck.environment import is_in_git_repo, assess_default_pdf_library, pymupdf_is_available, pdfium_is_available
 from pdflinkcheck.io import get_first_pdf_in_cwd
 
 console = Console() # to be above the tkinter check, in case of console.print
@@ -37,6 +37,13 @@ app = typer.Typer(
                       "help_option_names": ["-h", "--help"]},
 )
 
+class ExportFormat(str, Enum):
+    json = "json"
+    txt = "txt"
+    xlsx = "xlsx"
+    none = "none"
+                
+ALLOWED_EXPORTS = {"json", "txt", "xlsx", "none"}
 
 def debug_callback(value: bool):
 #def debug_callback(ctx: typer.Context, value: bool):
@@ -50,8 +57,36 @@ def debug_callback(value: bool):
         typer.echo(f"command:\n{command_string}\n")
     return value
 
-if "--show-command" in sys.argv or "--debug" in sys.argv:
+if "--show-command" in sys.argv or "--debug" in sys.argv: # requires that --show-command flag be used before the sub command
     debug_callback(True)
+
+
+        
+def _parse_export_formats(value: str) -> List[str]:
+    """
+    Parse a comma-separated string of export formats, validate allowed values.
+    Converts everything to lowercase.
+    """
+    if not value:
+        return []
+
+    # Split by comma and normalize
+    parts = [v.strip().lower() for v in value.split(",")]
+
+    # Validate
+    invalid = [v for v in parts if v not in ALLOWED_EXPORTS]
+    if invalid:
+        raise typer.BadParameter(
+            f"Invalid export format(s): {', '.join(invalid)}. "
+            f"Allowed values: {', '.join(sorted(ALLOWED_EXPORTS))}"
+        )
+
+    # If 'none' is included, return empty list to suppress exports
+    if "none" in parts:
+        return []
+
+    return parts
+
     
 @app.callback()
 def main(ctx: typer.Context,
@@ -136,8 +171,8 @@ def docs_command(
     
     # Exit successfully if any flag was processed
     raise typer.Exit(code=0)
-
-@app.command(name="tools", help= "Additional features, hamburger menu.")
+"""
+@app.command(name="tools_defunct", help= "Additional features, hamburger menu.")
 def tools_command(
     clear_cache: bool = typer.Option(
         False,
@@ -149,6 +184,34 @@ def tools_command(
     from pdflinkcheck.environment import clear_all_caches
     if clear_cache:
         clear_all_caches()
+"""
+# Create the sub-group
+tools_app = typer.Typer(help="Additional utility features and maintenance tools.")
+app.add_typer(tools_app, name="tools")
+
+@tools_app.command(name="clear-cache")
+def tools_clear_cache():
+    """Clear the environment and engine discovery caches."""
+    from pdflinkcheck.environment import clear_all_caches
+    clear_all_caches()
+    console.print("[green]Discovery caches cleared.[/green]")
+    console.print(f"pymupdf_is_available: {pymupdf_is_available()}")
+    console.print(f"pymupdf_is_available: {pdfium_is_available()}")
+    
+
+@tools_app.command(name="browse-exports")
+def tools_browse_exports():
+    """Open the system file explorer at the report output directory."""
+    from pdflinkcheck.helpers import show_system_explorer, get_export_path
+    
+    target_dir = get_export_path()
+    console.print(f"Opening: [bold cyan]{target_dir}[/bold cyan]")
+    
+    try:
+        show_system_explorer()
+    except Exception as e:
+        console.print(f"[bold red]Error:[/bold red] {e}")
+        raise typer.Exit(code=1)
 
 @app.command(name="analyze") # Added a command name 'analyze' for clarity
 def analyze_pdf( # Renamed function for clarity
@@ -161,11 +224,25 @@ def analyze_pdf( # Renamed function for clarity
         resolve_path=True,
         help="Path to the PDF file to analyze. If omitted, searches current directory."
     ), 
-    export_format: Optional[Literal["JSON", "TXT", "JSON,TXT", "NONE"]] = typer.Option(
-        "JSON,TXT", 
-        "--format","-f",
-        case_sensitive=False, 
-        help="Export format. Use 'None' to suppress file export.",
+    #export_format: Optional[Literal["JSON", "TXT", "XLSX", "JSON,TXT,XLSX", "NONE"]] = typer.Option(
+    #export_format: str = typer.Option(
+    #    "json,txt,xlsx", 
+    #    "--format","-f",
+    #    case_sensitive=False, 
+    #    help="Export format. Use 'None' to suppress file export.",
+    #),
+    #export_format: List[str] = typer.Option(
+    #    ["json", "txt", "xlsx"],
+    #    "--format", "-f",
+    #    case_sensitive=False,
+    #    callback=_parse_export_formats,
+    #    help="Comma-separated list of export formats. Allowed: json, txt, xlsx, none."
+    #),
+    export_format: List[ExportFormat] = typer.Option(
+        [ExportFormat.json, ExportFormat.txt, ExportFormat.xlsx],
+        "--format", "-f",
+        case_sensitive=False,
+        help="Export formats (repeatable). Use --format none to suppress all exports."
     ),
 
     pdf_library: Literal["auto","pdfium","pypdf", "pymupdf"] = typer.Option(
@@ -213,44 +290,49 @@ def analyze_pdf( # Renamed function for clarity
             raise typer.Exit(code=1)
         console.print(f"[dim]No file specified — using: {Path(pdf_path).name}[/dim]")
 
-    pdf_path_str = str(pdf_path)
-
-    VALID_FORMATS = ("JSON") # extend later
+    
+    if ExportFormat.none in export_format:
+        export_formats = []
+    else:
+        export_formats = [f.name.upper() for f in export_format]
+    export_format="".join(export_formats)
+    """#VALID_FORMATS = ("JSON","TXT") # extend later
     requested_formats = [fmt.strip().upper() for fmt in export_format.split(",")]
     if "NONE" in requested_formats or not export_format.strip() or export_format == "0":
         export_formats = ""
     else:
         # Filter for valid ones: ("JSON", "TXT")
         # This allows "JSON,TXT" to become "JSONTXT" which run_report logic can handle
-        valid = [f for f in requested_formats if f in ("JSON", "TXT")]
+        valid = [f for f in requested_formats if f in ("JSON", "TXT", "XLSX")]
         export_formats = "".join(valid)
 
         if not valid and "NONE" not in requested_formats:
             typer.echo(f"Warning: No valid formats found in '{export_format}'. Supported: JSON, TXT.")
-    
+    """
 
     # The meat and potatoes
     report_results = run_report_and_call_exports(
         pdf_path=str(pdf_path), 
-        export_format = export_formats,
+        export_format = export_format,
         pdf_library = pdf_library,
         print_bool = print_bool,
+        concise_print = True, # ideal for CLI, to not overwhelm the terminal.
     )
 
     if not report_results or not report_results.get("data"):
         console.print("[yellow]No links or TOC found — nothing to validate.[/yellow]")
         raise typer.Exit(code=0)
 
-    validation_results = report_results["data"]["validation"]
+    #validation_results = report_results["data"]["validation"]
     # Optional: fail on broken links
-    broken_page_count = validation_results["summary-stats"]["broken-page"] + validation_results["summary-stats"]["broken-file"]
+    #broken_page_count = validation_results["summary-stats"]["broken-page"] + validation_results["summary-stats"]["broken-file"]
     
-    if broken_page_count > 0:
+    #if broken_page_count > 0:
         console.print(f"\n[bold yellow]Warning:[/bold yellow] {broken_page_count} broken link(s) found.")
     #else:
     #    console.print(f"\n[bold green]Success:[/bold green] No broken links or TOC issues!\n")
 
-    raise typer.Exit(code=0 if broken_page_count == 0 else 1)
+    #raise typer.Exit(code=0 if broken_page_count == 0 else 1)
 
 @app.command(name="serve")
 def serve(
@@ -270,13 +352,14 @@ def serve(
         console.print("   → [yellow]Reload mode enabled[/yellow]")
 
     # Import here to avoid slow imports on other commands
-    from pdflinkcheck.stdlib_server_alt import ThreadedTCPServer, PDFLinkCheckHandler
+    from pdflinkcheck.stdlib_server import main as stdlib_server_main# ThreadedHTTPServer, PDFLinkCheckHandler
     import socketserver
 
     try:
-        with ThreadedTCPServer((host, port), PDFLinkCheckHandler) as httpd:
-            console.print(f"[green]Server running — press Ctrl+C to stop[/green]\n")
-            httpd.serve_forever()
+        stdlib_server_main()
+        #with ThreadedTCPServer((host, port), PDFLinkCheckHandler) as httpd:
+        #    console.print(f"[green]Server running — press Ctrl+C to stop[/green]\n")
+        #    httpd.serve_forever()
     except OSError as e:
         if "Address already in use" in str(e):
             console.print(f"[red]Error: Port {port} is already in use.[/red]")
@@ -314,8 +397,7 @@ def gui_command(
     if not pyhabitat.tkinter_is_available():
         _gui_failure_msg()
         return
-    #from pdflinkcheck.gui import start_gui
-    #from pdflinkcheck.gui_alt import start_gui
+    
     from pdflinkcheck.gui import start_gui
     start_gui(time_auto_close = assured_auto_close_value)
 
@@ -329,6 +411,8 @@ def _gui_failure_msg():
     console.print(f"pyhabitat.tkinter_is_available() = {pyhabitat.tkinter_is_available()}")
     pass
 
+
+
 if __name__ == "__main__":
     app()
     

{pdflinkcheck-1.2.29 → pdflinkcheck-1.3.8}/src/pdflinkcheck/data/LICENSE

@@ -2,11 +2,11 @@ Some distributed binaries of this project include the PyMuPDF library, which is
 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 AGPLlicensed binaries, the complete corresponding source code must be made available to anyone who possesses a copy, upon request. 
+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 AGPLlicensed 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 the distributed binary becomes AGPLlicensed when PyMuPDF is included.
+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.
 

{pdflinkcheck-1.2.29 → pdflinkcheck-1.3.8}/src/pdflinkcheck/data/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.97.png)
+![Screenshot of the pdflinkcheck GUI](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_gui_v1.3.3.png)
 
 -----
 
@@ -53,7 +55,7 @@ Ways to launch the GUI interface:
 The core functionality is accessed via the `analyze` command. 
 
 `pdflinkcheck --help`:
-![Screenshot of the pdflinkcheck CLI Tree Help](https://raw.githubusercontent.com/City-of-Memphis-Wastewater/pdflinkcheck/main/assets/pdflinkcheck_cli_v1.1.97.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.
@@ -63,7 +65,7 @@ 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.1.97_tree_help.png)
+![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)
 
 
 
@@ -83,7 +85,7 @@ $env:DEV_TYPER_HELP_TREE = "1"; pdflinkcheck help-tree` # PowerShell
 |---|---|---|
 |`<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`|
+|`--format / -f`|Export to `JSON`, `TXT`, `XLSX`, and/or `None` to suppress file output.|`JSON`|
 
 ### `gui` Command Options
 
@@ -94,8 +96,8 @@ $env:DEV_TYPER_HELP_TREE = "1"; pdflinkcheck help-tree` # PowerShell
 #### 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, 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 
@@ -128,8 +130,8 @@ from pdflinkcheck import ( run_report,
 
 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)
 ```
 
 -----
@@ -205,7 +207,7 @@ Expecte that all binaries and artifacts contain PyMuPDF, unlss they are built on
 To install the complete version use one of these options:
 
 ```bash
-pip install "pdflinkcheck[mupdf]"
+pip install "pdflinkcheck[pymupdf]"
 pipx install "pdflinkcheck[pdfium]"
 uv tool install "pdflinkcheck[pdfium]"
 uv add "pdflinkcheck[pdfium]"
@@ -230,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

{pdflinkcheck-1.2.29 → pdflinkcheck-1.3.8/src/pdflinkcheck/data}/pyproject.toml

@@ -1,11 +1,12 @@
 [project]
 name = "pdflinkcheck"
-version = "1.2.29"
+version = "1.3.8"
 description = "A purpose-built PDF link analysis and reporting tool with GUI and CLI."
 readme = "README.md"
 requires-python = ">=3.9"
 dependencies = [
-    "pyhabitat>=1.1.5",
+    "openpyxl>=3.1.5",
+    "pyhabitat>=1.1.6",
     "pypdf>=6.4.2",
     "rich>=14.2.0",
     "typer>=0.20.0",
@@ -56,7 +57,7 @@ pdflinkcheck = "pdflinkcheck.cli:app"
 
 [project.optional-dependencies]
 # If you choose to include PyMuPDF, you must comply with the AGPL3
-mupdf = ["pymupdf>=1.24.0,<2.0.0"] # fails on termux
+pymupdf = ["pymupdf>=1.24.0,<2.0.0"] # fails on termux
 pdfium = ["pypdfium2>=5.2.0,<6.0.0"]
 full = ["pymupdf>=1.24.0,<2.0.0", "pypdfium2>=5.2.0,<6.0.0"]