Merge pull request #50 from bact/warn-uninstalled-ai-lib

Warn users if AI extraction library is not installed

Author: bact

CHANGELOG.md

@@ -15,7 +15,15 @@ and this project adheres to
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 - Full release notes: <https://github.com/bact/pitloom/releases>
-- Commit history: <https://github.com/bact/pitloom/compare/v0.3.0...v0.4.0>
+- Commit history: <https://github.com/bact/pitloom/compare/v0.4.0...v0.4.1>
+
+## [0.4.1] - 2026-04-02
+
+### Changed
+
+- Warns if the AI extraction library is not installed ([#50][])
+
+[#50]: https://github.com/bact/pitloom/pull/50
 
 ## [0.4.0] - 2026-04-02
 
@@ -91,6 +99,7 @@ release because "Loom" and "Pyloom" were unavailable on PyPI.
 
 ---
 
+[0.4.1]: https://github.com/bact/pitloom/compare/v0.4.0...v0.4.1
 [0.4.0]: https://github.com/bact/pitloom/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/bact/pitloom/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/bact/pitloom/compare/v0.1.0...v0.2.0

CITATION.cff

@@ -9,7 +9,7 @@ abstract: Automated transparency, woven from the ground up. SBOM generation for
 repository-code: "https://github.com/bact/pitloom"
 type: software
 doi: 10.5281/zenodo.19243681
-version: 0.4.0
+version: 0.4.1
 license-url: "https://spdx.org/licenses/Apache-2.0"
 keywords:
   - sbom

codemeta.json

@@ -54,5 +54,5 @@
     "programmingLanguage": "Python 3",
     "readme": "https://github.com/bact/pitloom/blob/main/README.md",
     "url": "https://github.com/bact/pitloom",
-    "version": "0.4.0"
+    "version": "0.4.1"
 }

pyproject.toml

@@ -142,6 +142,10 @@ strict = true
 strict_equality_for_none = true
 warn_unreachable = true
 
+[[tool.mypy.overrides]]
+ignore_missing_imports = true
+module = ["fasttext", "fasttext.*"]
+
 [[tool.mypy.overrides]]
 ignore_missing_imports = true
 module = "fickling.*"

src/pitloom/__about__.py

@@ -4,4 +4,4 @@
 
 """Package information for Pitloom."""
 
-__version__ = "0.4.0"
+__version__ = "0.4.1"

src/pitloom/extract/_fasttext.py

@@ -35,7 +35,7 @@ def _load_fasttext_model(model_path: Path) -> Any:
     """Load a fastText model with consistent dependency and format errors."""
     try:
         # pylint: disable=import-outside-toplevel
-        import fasttext  # type: ignore[import-untyped]
+        import fasttext
     except ImportError as exc:
         raise ImportError(
             "The 'fasttext' package is required to extract fastText model metadata. "

src/pitloom/extract/scanner.py

@@ -66,9 +66,16 @@ def scan_project_for_ai_models(
                 log.debug(
                     "Discovered AI model: %s (format: %s)", pf.distribution_path, fmt
                 )
+            except ImportError as e:
+                log.warning(
+                    "FORMAT=%s FILE=%s: required library not installed; %s",
+                    fmt,
+                    phys_path,
+                    e,
+                )
             except Exception as e:  # pylint: disable=broad-exception-caught
                 log.warning(
-                    "Failed to extract metadata for format %s from %s: %s",
+                    "FORMAT=%s FILE=%s: failed to extract metadata; %s",
                     fmt,
                     phys_path,
                     e,