pycode-kg 0.19.2__tar.gz → 0.19.3__tar.gz

{pycode_kg-0.19.2 → pycode_kg-0.19.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycode-kg
-Version: 0.19.2
+Version: 0.19.3
 Summary: A tool to build a searchable knowledge graph from Python repositories
 License-Expression: Elastic-2.0
 License-File: LICENSE
@@ -31,8 +31,6 @@ Requires-Dist: kgmodule-utils[semantic] (>=0.3.1)
 Requires-Dist: markdown (>=3.6) ; extra == "all"
 Requires-Dist: markdown (>=3.6) ; extra == "viz3d"
 Requires-Dist: mcp (>=1.0.0)
-Requires-Dist: mypy (>=1.10.0) ; extra == "all"
-Requires-Dist: mypy (>=1.10.0) ; extra == "dev"
 Requires-Dist: numpy (>=1.24.0)
 Requires-Dist: pandas (>=2.0.0)
 Requires-Dist: param (>=2.0.0) ; extra == "all"
@@ -66,6 +64,8 @@ Requires-Dist: torch (>=2.5.1)
 Requires-Dist: trame-vtk (>=2.0.0) ; extra == "all"
 Requires-Dist: trame-vtk (>=2.0.0) ; extra == "viz3d"
 Requires-Dist: transformers (>=4.40.0,<4.57)
+Requires-Dist: ty (>=0.0.41) ; extra == "all"
+Requires-Dist: ty (>=0.0.41) ; extra == "dev"
 Project-URL: Homepage, https://github.com/Flux-Frontiers/pycode_kg
 Project-URL: Repository, https://github.com/Flux-Frontiers/pycode_kg
 Description-Content-Type: text/markdown
@@ -77,7 +77,7 @@ Description-Content-Type: text/markdown
 
 [![Python](https://img.shields.io/badge/python-3.12%20%7C%203.13-blue.svg)](https://www.python.org/)
 [![License: Elastic-2.0](https://img.shields.io/badge/License-Elastic%202.0-blue.svg)](https://www.elastic.co/licensing/elastic-license)
-[![Version](https://img.shields.io/badge/version-0.19.1-blue.svg)](https://github.com/Flux-Frontiers/pycode_kg/releases)
+[![Version](https://img.shields.io/badge/version-0.19.3-blue.svg)](https://github.com/Flux-Frontiers/pycode_kg/releases)
 [![CI](https://github.com/Flux-Frontiers/pycode_kg/actions/workflows/ci.yml/badge.svg)](https://github.com/Flux-Frontiers/pycode_kg/actions/workflows/ci.yml)
 [![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
 [![DOI](https://zenodo.org/badge/1202379010.svg)](https://zenodo.org/badge/latestdoi/1202379010)

{pycode_kg-0.19.2 → pycode_kg-0.19.3}/README.md

@@ -5,7 +5,7 @@
 
 [![Python](https://img.shields.io/badge/python-3.12%20%7C%203.13-blue.svg)](https://www.python.org/)
 [![License: Elastic-2.0](https://img.shields.io/badge/License-Elastic%202.0-blue.svg)](https://www.elastic.co/licensing/elastic-license)
-[![Version](https://img.shields.io/badge/version-0.19.1-blue.svg)](https://github.com/Flux-Frontiers/pycode_kg/releases)
+[![Version](https://img.shields.io/badge/version-0.19.3-blue.svg)](https://github.com/Flux-Frontiers/pycode_kg/releases)
 [![CI](https://github.com/Flux-Frontiers/pycode_kg/actions/workflows/ci.yml/badge.svg)](https://github.com/Flux-Frontiers/pycode_kg/actions/workflows/ci.yml)
 [![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
 [![DOI](https://zenodo.org/badge/1202379010.svg)](https://zenodo.org/badge/latestdoi/1202379010)

{pycode_kg-0.19.2 → pycode_kg-0.19.3}/pyproject.toml

@@ -7,7 +7,7 @@
 #
 # Quick install (pip)
 # -------------------
-#   pip install -e ".[dev]"             core + dev tools (pytest, ruff, mypy, etc.)
+#   pip install -e ".[dev]"             core + dev tools (pytest, ruff, ty, etc.)
 #   pip install -e ".[viz]"             core + Streamlit/Plotly/PyVis visualizer
 #   pip install -e ".[viz3d]"           core + PyVista 3D visualizer
 #   pip install -e ".[kgdeps]"          core + KG integrations (doc-kg, agent-kg)
@@ -48,7 +48,7 @@ packages = [{ include = "pycode_kg", from = "src" }]
 
 [tool.poetry.group.dev.dependencies]
 detect-secrets = ">=1.5.0"
-mypy = ">=1.10.0"
+ty = "^0.0.41"
 pdoc = ">=14.0.0"
 pre-commit = ">=4.5.1"
 pylint = ">=4.0.5"
@@ -61,7 +61,7 @@ ruff = ">=0.4.0"
 # ---------------------------------------------------------------------------
 [project]
 name = "pycode-kg"
-version = "0.19.2"
+version = "0.19.3"
 description = "A tool to build a searchable knowledge graph from Python repositories"
 readme = "README.md"
 license = "Elastic-2.0"
@@ -95,7 +95,7 @@ dependencies = [
 [project.optional-dependencies]
 dev = [
     "detect-secrets>=1.5.0",
-    "mypy>=1.10.0",
+    "ty>=0.0.41",
     "pdoc>=14.0.0",
     "pre-commit>=4.5.1",
     "pylint>=4.0.5",
@@ -126,7 +126,6 @@ kgdeps = [
 all = [
     "detect-secrets>=1.5.0",
     "markdown>=3.6",
-    "mypy>=1.10.0",
     "param>=2.0.0",
     "pdoc>=14.0.0",
     "plotly>=5.14.0",
@@ -141,6 +140,7 @@ all = [
     "ruff>=0.4.0",
     "streamlit>=1.35.0",
     "trame-vtk>=2.0.0",
+    "ty>=0.0.41",
 ]
 
 [project.urls]
@@ -177,12 +177,19 @@ target-version = "py312"
 select = ["E", "F", "W", "I", "UP"]
 ignore = ["E501"]
 
-[tool.mypy]
-python_version        = "3.12"
-strict                = false
-ignore_missing_imports = true
-mypy_path             = "src"
-explicit_package_bases = true
+[tool.ty.environment]
+python-version = "3.12"
+root = ["src"]
+
+[tool.ty.rules]
+# Be lenient about third-party stubs (mirrors mypy's ignore_missing_imports).
+unresolved-import = "ignore"
+# viz3d.py carries `# ty: ignore` suppressions for param/PyQt5/pyvista false
+# positives. Those libraries live in the optional viz/viz3d extras, so in the
+# lean CI install the imports are Unknown, the errors don't fire, and the
+# ignores look "unused". Don't fail the build on that — the suppressions are
+# still honored locally where the extras (and the errors) are present.
+unused-ignore-comment = "ignore"
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

{pycode_kg-0.19.2 → pycode_kg-0.19.3}/src/pycode_kg/__init__.py

@@ -32,7 +32,7 @@ KGModule SDK (build new domain KGs)::
     from pycode_kg import KGModule, KGExtractor, PyCodeKGExtractor, NodeSpec, EdgeSpec
 """
 
-__version__ = "0.19.2"
+__version__ = "0.19.3"
 __author__ = "Eric G. Suchanek, PhD"
 
 # Low-level primitives (locked v0 contract)

{pycode_kg-0.19.2 → pycode_kg-0.19.3}/src/pycode_kg/graph.py

@@ -78,14 +78,16 @@ class CodeGraph:
         """Extracted nodes (calls :meth:`extract` if needed)."""
         if self._nodes is None:
             self.extract()
-        return self._nodes  # type: ignore[return-value]
+        assert self._nodes is not None
+        return self._nodes
 
     @property
     def edges(self) -> list[Edge]:
         """Extracted edges (calls :meth:`extract` if needed)."""
         if self._edges is None:
             self.extract()
-        return self._edges  # type: ignore[return-value]
+        assert self._edges is not None
+        return self._edges
 
     def result(self) -> tuple[list[Node], list[Edge]]:
         """Return the extracted nodes and edges as a tuple.
@@ -120,6 +122,6 @@ class CodeGraph:
         if extracted:
             return (
                 f"CodeGraph(repo_root={self.repo_root!r}, "
-                f"nodes={len(self._nodes)}, edges={len(self._edges)})"  # type: ignore[arg-type]
+                f"nodes={len(self._nodes)}, edges={len(self._edges)})"  # ty: ignore[invalid-argument-type]
             )
         return f"CodeGraph(repo_root={self.repo_root!r}, not yet extracted)"

{pycode_kg-0.19.2 → pycode_kg-0.19.3}/src/pycode_kg/snapshots.py

@@ -284,7 +284,7 @@ class SnapshotManager(_BaseSnapshotManager):
     # capture — backwards-compat wrapper
     # ------------------------------------------------------------------
 
-    def capture(  # type: ignore[override]
+    def capture(  # ty: ignore[invalid-method-override]
         self,
         version: str | None = None,
         branch: str | None = None,

{pycode_kg-0.19.2 → pycode_kg-0.19.3}/src/pycode_kg/viz3d.py

@@ -228,7 +228,7 @@ def _remove_highlight_actors(plotter: pv.Plotter) -> None:
     """Remove any leftover pink highlight or outline actors from the plotter."""
     for name in list(plotter.actors.keys()):
         if "highlight" in name.lower() or "bounds" in name.lower() or "outline" in name.lower():
-            plotter.remove_actor(name, reset_camera=False)  # type: ignore[arg-type]
+            plotter.remove_actor(name, reset_camera=False)  # ty: ignore[invalid-argument-type]
 
 
 # ---------------------------------------------------------------------------
@@ -256,7 +256,7 @@ class DocstringPopup(QDialog):
         self.setWindowTitle(title)
         self.setMinimumSize(600, 400)
         self.on_close_callback = on_close_callback
-        self.setWindowModality(Qt.NonModal)  # type: ignore[attr-defined]
+        self.setWindowModality(Qt.NonModal)  # ty: ignore[unresolved-attribute]
 
         if parent:
             geo = parent.screen().geometry()
@@ -269,10 +269,10 @@ class DocstringPopup(QDialog):
         layout.addWidget(browser)
 
         close_btn = QPushButton("Close", self)
-        close_btn.clicked.connect(self.close)  # type: ignore[arg-type]
+        close_btn.clicked.connect(self.close)  # ty: ignore[invalid-argument-type]
         layout.addWidget(close_btn)
 
-    def closeEvent(self, event):
+    def closeEvent(self, event):  # ty: ignore[invalid-method-override]
         """Trigger the close callback if set."""
         if self.on_close_callback:
             self.on_close_callback()
@@ -311,9 +311,9 @@ def create_kg_visualization(
 
     plotter.clear_actors()
     plotter.enable_anti_aliasing("msaa")
-    plotter.enable_terrain_style()  # type: ignore[call-arg]
-    plotter.set_background("white", top="lightblue")  # type: ignore[arg-type]
-    plotter.add_axes(  # type: ignore[call-arg]
+    plotter.enable_terrain_style()  # ty: ignore[missing-argument]
+    plotter.set_background("white", top="lightblue")  # ty: ignore[invalid-argument-type]
+    plotter.add_axes(  # ty: ignore[missing-argument]
         interactive=False,
         viewport=(0.75, 0.75, 1.0, 1.0),
     )
@@ -457,7 +457,7 @@ def create_kg_visualization(
         )
 
     # -- Ground plane: auto-sized to scene bounds, added after all meshes
-    plotter.add_floor(  # type: ignore[call-arg]
+    plotter.add_floor(  # ty: ignore[missing-argument]
         face="-z",
         color="lightgray",
         opacity=0.85,
@@ -485,10 +485,10 @@ def create_kg_visualization(
         f"Faces: {total_faces}"
     )
 
-    plotter.reset_camera()  # type: ignore[call-arg]
+    plotter.reset_camera()  # ty: ignore[missing-argument]
     # Front-elevated perspective: mostly looking along +Y, tilted ~25° down,
     # with a slight rightward rotation so the scene reads with depth.
-    plotter.view_vector((0.0, 1.0, 0.35), viewup=(0, 0, 1))  # type: ignore[call-arg, arg-type]
+    plotter.view_vector((0.0, 1.0, 0.35), viewup=(0, 0, 1))  # ty: ignore[invalid-argument-type]
     plotter.camera.zoom(1.6)
     plotter.render()
 
@@ -512,40 +512,40 @@ class KGVisualizer(param.Parameterized):
     watched parameters trigger graph reload or UI updates automatically.
     """
 
-    db_path: str = param.String(default=DEFAULT_DB, doc="SQLite database path")
-    layout_name: str = param.Selector(
+    db_path: str = param.String(default=DEFAULT_DB, doc="SQLite database path")  # ty: ignore[invalid-assignment]
+    layout_name: str = param.Selector(  # ty: ignore[invalid-assignment]
         objects=["allium", "funnel"], default="allium", doc="3-D layout strategy"
     )
-    save_path: str = param.String(default=DEFAULT_SAVE, doc="Save path stem")
-    save_format: str = param.Selector(
+    save_path: str = param.String(default=DEFAULT_SAVE, doc="Save path stem")  # ty: ignore[invalid-assignment]
+    save_format: str = param.Selector(  # ty: ignore[invalid-assignment]
         objects=["html", "png", "jpg"], default="html", doc="Export format"
     )
 
     # Node kind visibility
-    show_methods: bool = param.Boolean(default=True, doc="Render method nodes")
-    show_symbols: bool = param.Boolean(default=False, doc="Render symbol stub nodes")
+    show_methods: bool = param.Boolean(default=True, doc="Render method nodes")  # ty: ignore[invalid-assignment]
+    show_symbols: bool = param.Boolean(default=False, doc="Render symbol stub nodes")  # ty: ignore[invalid-assignment]
     # Edge visibility
-    show_calls: bool = param.Boolean(default=True, doc="Render CALLS edges")
-    show_imports: bool = param.Boolean(default=True, doc="Render IMPORTS edges")
-    show_inherits: bool = param.Boolean(default=True, doc="Render INHERITS edges")
-    show_contains: bool = param.Boolean(default=True, doc="Render CONTAINS edges")
+    show_calls: bool = param.Boolean(default=True, doc="Render CALLS edges")  # ty: ignore[invalid-assignment]
+    show_imports: bool = param.Boolean(default=True, doc="Render IMPORTS edges")  # ty: ignore[invalid-assignment]
+    show_inherits: bool = param.Boolean(default=True, doc="Render INHERITS edges")  # ty: ignore[invalid-assignment]
+    show_contains: bool = param.Boolean(default=True, doc="Render CONTAINS edges")  # ty: ignore[invalid-assignment]
     # Layout spacing (funnel only)
-    node_spacing: float = param.Number(default=2.0, bounds=(0.5, 10.0), doc="Funnel node spacing")
+    node_spacing: float = param.Number(default=2.0, bounds=(0.5, 10.0), doc="Funnel node spacing")  # ty: ignore[invalid-assignment]
 
     # Status / title
-    status: str = param.String(default="Ready", doc="Status bar text")
-    window_title: str = param.String(default=f"PyCodeKG 3D v{__version__}", doc="Window title")
+    status: str = param.String(default="Ready", doc="Status bar text")  # ty: ignore[invalid-assignment]
+    window_title: str = param.String(default=f"PyCodeKG 3D v{__version__}", doc="Window title")  # ty: ignore[invalid-assignment]
 
     # Stats
-    num_modules: int = param.Integer(default=0)
-    num_classes: int = param.Integer(default=0)
-    num_functions: int = param.Integer(default=0)
-    num_methods: int = param.Integer(default=0)
-    num_faces: int = param.Integer(default=0)
+    num_modules: int = param.Integer(default=0)  # ty: ignore[invalid-assignment]
+    num_classes: int = param.Integer(default=0)  # ty: ignore[invalid-assignment]
+    num_functions: int = param.Integer(default=0)  # ty: ignore[invalid-assignment]
+    num_methods: int = param.Integer(default=0)  # ty: ignore[invalid-assignment]
+    num_faces: int = param.Integer(default=0)  # ty: ignore[invalid-assignment]
 
     # Module selector data
-    available_modules: list[str] = param.List(default=[], doc="Available module names")
-    selected_modules: list[str] = param.ListSelector(
+    available_modules: list[str] = param.List(default=[], doc="Available module names")  # ty: ignore[invalid-assignment]
+    selected_modules: list[str] = param.ListSelector(  # ty: ignore[invalid-assignment]
         default=[], objects=[], doc="Selected module names"
     )
 
@@ -563,7 +563,7 @@ class KGVisualizer(param.Parameterized):
         self.actor_to_node: dict[str, dict] = {}
         self._load_graph()
 
-    @param.depends("db_path", watch=True)
+    @param.depends("db_path", watch=True)  # ty: ignore[invalid-argument-type]
     def _load_graph(self) -> None:
         """Reload nodes and edges from the SQLite database."""
         from pycode_kg.layout3d import LayoutEdge, LayoutNode
@@ -717,7 +717,7 @@ class MainWindow(QMainWindow):
 
         self.vtk_plotter: QtInteractor = QtInteractor(self)
         self.visualizer: KGVisualizer = KGVisualizer(
-            plotter=self.vtk_plotter,
+            plotter=self.vtk_plotter,  # ty: ignore[invalid-argument-type]
             db_path=db_path,
             save_path=save_path,
         )
@@ -957,7 +957,7 @@ class MainWindow(QMainWindow):
         btn_row.addWidget(self.reset_settings_button)
 
         self.status_display = QLabel("Ready")
-        self.status_display.setTextInteractionFlags(Qt.TextBrowserInteraction)  # type: ignore[attr-defined]
+        self.status_display.setTextInteractionFlags(Qt.TextBrowserInteraction)  # ty: ignore[unresolved-attribute]
         self.status_display.setStyleSheet(
             "font-weight:bold; font-size:13px; background-color:white; color:black;"
         )
@@ -1004,22 +1004,22 @@ class MainWindow(QMainWindow):
         self.module_selector.itemSelectionChanged.connect(self.update_selected_modules)
 
         self.cb_methods.stateChanged.connect(
-            lambda s: setattr(self.visualizer, "show_methods", s == Qt.Checked)  # type: ignore[attr-defined]
+            lambda s: setattr(self.visualizer, "show_methods", s == Qt.Checked)  # ty: ignore[unresolved-attribute]
         )
         self.cb_symbols.stateChanged.connect(
-            lambda s: setattr(self.visualizer, "show_symbols", s == Qt.Checked)  # type: ignore[attr-defined]
+            lambda s: setattr(self.visualizer, "show_symbols", s == Qt.Checked)  # ty: ignore[unresolved-attribute]
         )
         self.cb_contains.stateChanged.connect(
-            lambda s: setattr(self.visualizer, "show_contains", s == Qt.Checked)  # type: ignore[attr-defined]
+            lambda s: setattr(self.visualizer, "show_contains", s == Qt.Checked)  # ty: ignore[unresolved-attribute]
         )
         self.cb_calls.stateChanged.connect(
-            lambda s: setattr(self.visualizer, "show_calls", s == Qt.Checked)  # type: ignore[attr-defined]
+            lambda s: setattr(self.visualizer, "show_calls", s == Qt.Checked)  # ty: ignore[unresolved-attribute]
         )
         self.cb_imports.stateChanged.connect(
-            lambda s: setattr(self.visualizer, "show_imports", s == Qt.Checked)  # type: ignore[attr-defined]
+            lambda s: setattr(self.visualizer, "show_imports", s == Qt.Checked)  # ty: ignore[unresolved-attribute]
         )
         self.cb_inherits.stateChanged.connect(
-            lambda s: setattr(self.visualizer, "show_inherits", s == Qt.Checked)  # type: ignore[attr-defined]
+            lambda s: setattr(self.visualizer, "show_inherits", s == Qt.Checked)  # ty: ignore[unresolved-attribute]
         )
 
         self.visualize_button.clicked.connect(self.on_visualize_clicked)
@@ -1345,7 +1345,7 @@ class MainWindow(QMainWindow):
                 pass
         gc.collect()
 
-    def closeEvent(self, event) -> None:
+    def closeEvent(self, event) -> None:  # ty: ignore[invalid-method-override]
         """Handle window close with cleanup."""
         with warnings.catch_warnings():
             warnings.simplefilter("ignore")