libcontext 0.5.0__tar.gz → 0.6.1__tar.gz

{libcontext-0.5.0 → libcontext-0.6.1}/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.1] - 2026-03-25
+
+### Fixed
+
+- **ImportError crash with `packages_distributions()`**: wrapped call in try/except to handle broken metadata or mixed Python installations (e.g. `_csv` ImportError on Python 3.13).
+- **Python 3.9 compatibility**: fixed parenthesized context managers and `create=True` for `mock.patch`.
+
 ## [0.5.0] - 2026-03-23
 
 ### Added
@@ -101,7 +108,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Free-form `extra_context` field for library authors.
 - Python API for programmatic usage (`collect_package`, `render_package`).
 
-[Unreleased]: https://github.com/Syclaw/libcontext/compare/v0.5.0...HEAD
+[Unreleased]: https://github.com/Syclaw/libcontext/compare/v0.6.1...HEAD
+[0.6.1]: https://github.com/Syclaw/libcontext/compare/v0.6.0...v0.6.1
+[0.6.0]: https://github.com/Syclaw/libcontext/compare/v0.5.0...v0.6.0
 [0.5.0]: https://github.com/Syclaw/libcontext/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/Syclaw/libcontext/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/Syclaw/libcontext/compare/v0.2.0...v0.3.0

{libcontext-0.5.0 → libcontext-0.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: libcontext
-Version: 0.5.0
+Version: 0.6.1
 Summary: Generate optimized LLM context from Python library APIs — CLI, skill, and MCP server
 Project-URL: Homepage, https://github.com/Syclaw/libcontext
 Project-URL: Repository, https://github.com/Syclaw/libcontext
@@ -39,7 +39,7 @@ Description-Content-Type: text/markdown
 
 > Context-efficient API references for LLM toolchains — structured, on-demand, not always-on.
 
-**libcontext** inspects any installed Python package via static AST analysis (no code execution) and generates compact Markdown API references. It integrates with Claude Code (via a `/lib` skill) and VS Code Copilot (via an MCP server) to provide **progressive disclosure** — only loading API context when you actually need it, avoiding context window pollution.
+**libcontext** inspects any installed Python package via static AST analysis (no code execution) and generates compact Markdown API references. It integrates with Claude Code, GitHub Copilot (via a `/lib` skill), and VS Code / Cursor (via an MCP server) to provide **progressive disclosure** — only loading API context when you actually need it, avoiding context window pollution.
 
 ## Why This Exists
 
@@ -107,7 +107,7 @@ libctx inspect requests   libctx inspect requests     libctx inspect requests
   (no signatures)           for one module              across all modules
 ```
 
-The `/lib` skill (Claude Code) and MCP server (VS Code / Cursor) automate this workflow — the AI assistant decides what to inspect based on the task at hand.
+The `/lib` skill (Claude Code, GitHub Copilot) and MCP server (Claude Code, VS Code, Cursor) automate this workflow — the AI assistant decides what to inspect based on the task at hand.
 
 ### Direct CLI Usage
 
@@ -332,7 +332,7 @@ All async operations use httpx internally.
 | `diff.py` | API diff between two package versions with breaking change detection |
 | `cache.py` | Persistent disk cache with mtime/file-count invalidation and LRU eviction |
 | `cli.py` | CLI entry point — `inspect`, `install`, `diff`, and `cache` subcommands |
-| `mcp_server.py` | MCP server for VS Code / Cursor integration (optional) |
+| `mcp_server.py` | MCP server for Claude Code / VS Code / Cursor integration (optional) |
 
 ## Development
 

{libcontext-0.5.0 → libcontext-0.6.1}/README.md

@@ -10,7 +10,7 @@
 
 > Context-efficient API references for LLM toolchains — structured, on-demand, not always-on.
 
-**libcontext** inspects any installed Python package via static AST analysis (no code execution) and generates compact Markdown API references. It integrates with Claude Code (via a `/lib` skill) and VS Code Copilot (via an MCP server) to provide **progressive disclosure** — only loading API context when you actually need it, avoiding context window pollution.
+**libcontext** inspects any installed Python package via static AST analysis (no code execution) and generates compact Markdown API references. It integrates with Claude Code, GitHub Copilot (via a `/lib` skill), and VS Code / Cursor (via an MCP server) to provide **progressive disclosure** — only loading API context when you actually need it, avoiding context window pollution.
 
 ## Why This Exists
 
@@ -78,7 +78,7 @@ libctx inspect requests   libctx inspect requests     libctx inspect requests
   (no signatures)           for one module              across all modules
 ```
 
-The `/lib` skill (Claude Code) and MCP server (VS Code / Cursor) automate this workflow — the AI assistant decides what to inspect based on the task at hand.
+The `/lib` skill (Claude Code, GitHub Copilot) and MCP server (Claude Code, VS Code, Cursor) automate this workflow — the AI assistant decides what to inspect based on the task at hand.
 
 ### Direct CLI Usage
 
@@ -303,7 +303,7 @@ All async operations use httpx internally.
 | `diff.py` | API diff between two package versions with breaking change detection |
 | `cache.py` | Persistent disk cache with mtime/file-count invalidation and LRU eviction |
 | `cli.py` | CLI entry point — `inspect`, `install`, `diff`, and `cache` subcommands |
-| `mcp_server.py` | MCP server for VS Code / Cursor integration (optional) |
+| `mcp_server.py` | MCP server for Claude Code / VS Code / Cursor integration (optional) |
 
 ## Development
 

{libcontext-0.5.0 → libcontext-0.6.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "libcontext"
-version = "0.5.0"
+version = "0.6.1"
 description = "Generate optimized LLM context from Python library APIs — CLI, skill, and MCP server"
 readme = "README.md"
 license = "MIT"

{libcontext-0.5.0 → libcontext-0.6.1}/src/libcontext/collector.py

@@ -47,8 +47,20 @@ def _get_installed_package_names() -> list[str]:
     names: set[str] = set()
 
     if sys.version_info >= (3, 11):
-        for import_name in importlib.metadata.packages_distributions():
-            names.add(import_name)
+        try:
+            for import_name in importlib.metadata.packages_distributions():
+                names.add(import_name)
+        except (ImportError, Exception):
+            # packages_distributions() may fail when the environment
+            # contains distributions with broken metadata or when a
+            # mixed Python installation causes an ImportError inside
+            # stdlib modules (e.g. csv).  Fall through to the
+            # distributions()-based collection below which is more
+            # resilient.
+            logger.debug(
+                "packages_distributions() failed; falling back to distributions() only",
+                exc_info=True,
+            )
 
     seen_distributions: set[str] = set()
     for dist in importlib.metadata.distributions():

{libcontext-0.5.0 → libcontext-0.6.1}/tests/test_collector.py

@@ -676,26 +676,66 @@ def test_suggest_similar_packages_uses_top_level_names() -> None:
     assert "PIL" in suggestions
 
 
+_PKGS_DISTS_PATH = "libcontext.collector.importlib.metadata.packages_distributions"
+
+
+def test_get_installed_package_names_handles_import_error() -> None:
+    """packages_distributions() raising ImportError is caught gracefully."""
+    dists = [
+        _make_mock_dist("requests"),
+    ]
+    err = ImportError("cannot import name '__version__' from '_csv'")
+    with patch(_PKGS_DISTS_PATH, side_effect=err, create=True):  # noqa: SIM117
+        with patch(_DISTS_PATH, return_value=dists):
+            names = _get_installed_package_names()
+
+    # Should still collect names from distributions() fallback
+    assert "requests" in names
+
+
+def test_get_installed_package_names_handles_generic_exception() -> None:
+    """packages_distributions() raising any Exception is caught gracefully."""
+    dists = [
+        _make_mock_dist("flask"),
+    ]
+    err = RuntimeError("broken metadata")
+    with patch(_PKGS_DISTS_PATH, side_effect=err, create=True):  # noqa: SIM117
+        with patch(_DISTS_PATH, return_value=dists):
+            names = _get_installed_package_names()
+
+    assert "flask" in names
+
+
+def test_suggest_similar_packages_resilient_to_import_error() -> None:
+    """suggest_similar_packages works even if packages_distributions() fails."""
+    dists = [
+        _make_mock_dist("requests"),
+        _make_mock_dist("flask"),
+    ]
+    err = ImportError("csv import broken")
+    with patch(_PKGS_DISTS_PATH, side_effect=err, create=True):  # noqa: SIM117
+        with patch(_DISTS_PATH, return_value=dists):
+            suggestions = suggest_similar_packages("reqeusts")
+
+    assert "requests" in suggestions
+
+
 def test_collect_package_error_includes_suggestions() -> None:
     """PackageNotFoundError from collect_package includes suggestions."""
     dists = [
         _make_mock_dist("click"),
         _make_mock_dist("flask"),
     ]
-    with (
-        patch(_DISTS_PATH, return_value=dists),
-        pytest.raises(PackageNotFoundError, match="Did you mean"),
-    ):
-        collect_package("clck")
+    with patch(_DISTS_PATH, return_value=dists):  # noqa: SIM117
+        with pytest.raises(PackageNotFoundError, match="Did you mean"):
+            collect_package("clck")
 
 
 def test_collect_package_error_no_suggestions() -> None:
     """PackageNotFoundError without suggestions shows install hint."""
-    with (
-        patch(_DISTS_PATH, return_value=[]),
-        pytest.raises(PackageNotFoundError, match="Make sure it is installed"),
-    ):
-        collect_package("totally_nonexistent_pkg_xyz_999")
+    with patch(_DISTS_PATH, return_value=[]):  # noqa: SIM117
+        with pytest.raises(PackageNotFoundError, match="Make sure it is installed"):
+            collect_package("totally_nonexistent_pkg_xyz_999")
 
 
 # ---------------------------------------------------------------------------