index.toml-adapter-python 0.1.0__py3-none-any.whl

index_toml_adapter_python/__init__.py

@@ -0,0 +1,5 @@
+"""Python workspace adapter."""
+
+from .adapter import PythonWorkspaceAdapter
+
+__all__ = ["PythonWorkspaceAdapter"]

index_toml_adapter_python/adapter.py

@@ -0,0 +1,137 @@
+"""Discover uv workspace members and explicitly local Python requirements."""
+
+from pathlib import Path
+from urllib.parse import unquote, urlsplit
+
+from index_toml_contracts import read_workspace_toml
+from index_toml_contracts.workspace import (
+    WorkspaceDependency, WorkspaceDiagnostic, WorkspaceMember, WorkspaceSnapshot,
+)
+from packaging.requirements import Requirement
+from packaging.utils import canonicalize_name
+
+
+def _group_requirements(groups, name, chain=()):
+    if name in chain:
+        raise ValueError(f"Dependency group cycle: {' -> '.join((*chain, name))}")
+    for entry in groups[name]:
+        if isinstance(entry, str):
+            yield entry
+        elif isinstance(entry, dict) and set(entry) == {"include-group"}:
+            target = canonicalize_name(entry["include-group"])
+            yield from _group_requirements(groups, target, (*chain, name))
+        else:
+            raise ValueError(f"Invalid dependency group entry in {name!r}: {entry!r}")
+
+
+class PythonWorkspaceAdapter:
+    name = "python"
+    ecosystem = "pypi"
+    normalize_name = staticmethod(canonicalize_name)
+
+    def discover(self, root: Path) -> WorkspaceSnapshot:
+        root = root.resolve()
+        manifest = "pyproject.toml"
+        try:
+            root_doc = read_workspace_toml(root / manifest)
+            uv = root_doc.get("tool", {}).get("uv", {})
+            workspace = uv.get("workspace", {})
+            if "workspace" not in uv and "project" not in root_doc:
+                raise ValueError("Expected a Python project or uv workspace")
+            excluded = {
+                path.resolve() for pattern in workspace.get("exclude", []) for path in root.glob(pattern)
+            }
+            directories = {
+                path.resolve() for pattern in workspace.get("members", [])
+                for path in root.glob(pattern) if path.is_dir()
+            } - excluded
+            if "project" in root_doc and (uv.get("package") is not False or "workspace" not in uv):
+                directories.add(root)
+            documents = {}
+            members = []
+            by_name = {}
+            for directory in sorted(directories):
+                manifest = (directory / "pyproject.toml").relative_to(root).as_posix()
+                doc = root_doc if directory == root else read_workspace_toml(root / manifest)
+                name = doc["project"]["name"]
+                identity = self.normalize_name(name)
+                member = WorkspaceMember(name, identity, directory.relative_to(root).as_posix(), manifest)
+                if identity in by_name:
+                    raise ValueError(f"Ambiguous Python distribution {name!r}: {by_name[identity].manifest}")
+                by_name[identity] = member
+                documents[member.path] = doc
+                members.append(member)
+
+            edges = []
+            paths = set(documents)
+            inherited = uv.get("sources", {})
+            for member in members:
+                manifest = member.manifest
+                doc = documents[member.path]
+                project = doc["project"]
+                sources = {canonicalize_name(key): (root, value) for key, value in inherited.items()}
+                directory = root / member.path
+                sources.update({
+                    canonicalize_name(key): (directory, value)
+                    for key, value in doc.get("tool", {}).get("uv", {}).get("sources", {}).items()
+                })
+                requirements = {"runtime": project.get("dependencies", [])}
+                requirements.update({
+                    f"extra:{key}": value for key, value in project.get("optional-dependencies", {}).items()
+                })
+                groups = {
+                    canonicalize_name(key): value for key, value in doc.get("dependency-groups", {}).items()
+                }
+                requirements.update({
+                    f"group:{key}": _group_requirements(groups, key) for key in groups
+                })
+                legacy = doc.get("tool", {}).get("uv", {}).get("dev-dependencies", [])
+                if legacy:
+                    requirements["uv:dev"] = legacy
+                for category, entries in sorted(requirements.items()):
+                    for entry in entries:
+                        req = Requirement(entry)
+                        identity = self.normalize_name(req.name)
+                        base, values = sources.get(identity, (directory, []))
+                        if req.url:
+                            url = urlsplit(req.url)
+                            if url.scheme not in {"", "file"} or url.netloc not in {"", "localhost"}:
+                                continue
+                            path = unquote(url.path)
+                            if Path(path.lstrip("/")).drive:
+                                path = path.lstrip("/")
+                            base, values = directory, [{"path": path}]
+                        if isinstance(values, dict):
+                            values = [values]
+                        for source in values:
+                            target = self._target(root, base, source, identity, by_name, paths)
+                            if target is not None:
+                                conditions = [str(req.marker) if req.marker else "", source.get("marker", "")]
+                                edges.append(WorkspaceDependency(
+                                    member.path, target, category, manifest, entry,
+                                    " and ".join(f"({condition})" for condition in conditions if condition) or None,
+                                ))
+            return WorkspaceSnapshot(tuple(members), tuple(edges))
+        except (OSError, ValueError, KeyError, TypeError, AttributeError) as error:
+            return WorkspaceSnapshot(diagnostics=(WorkspaceDiagnostic("python_manifest_error", manifest, str(error)),))
+
+    @staticmethod
+    def _target(root, base, source, identity, by_name, paths):
+        if source.get("workspace") is True:
+            if identity not in by_name:
+                raise ValueError(f"Unresolved workspace dependency {identity!r}")
+            return by_name[identity].path
+        if "path" in source:
+            directory = (base / source["path"]).resolve()
+            if not directory.is_relative_to(root):
+                return None
+            target = directory.relative_to(root).as_posix()
+            if target in paths:
+                if by_name.get(identity) is None or by_name[identity].path != target:
+                    raise ValueError(f"Local source {target!r} does not declare {identity!r}")
+                return target
+            if directory.is_dir():
+                raise ValueError(f"Local dependency {identity!r} at {target!r} is not a workspace member")
+            if not directory.is_file():
+                raise ValueError(f"Local dependency {identity!r} has a missing path {target!r}")
+        return None

index_toml_adapter_python-0.1.0.dist-info/METADATA

@@ -0,0 +1,14 @@
+Metadata-Version: 2.3
+Name: index.toml-adapter-python
+Version: 0.1.0
+Summary: Workspace discovery adapter for Python
+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: Programming Language :: Python :: 3.15
+Requires-Dist: index-toml-contracts>=0.1.0,<0.2
+Requires-Dist: packaging>=24,<27
+Requires-Python: >=3.10, <3.16
+Project-URL: Repository, https://github.com/groupsum/index.toml

index_toml_adapter_python-0.1.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+index_toml_adapter_python/__init__.py,sha256=5Al8OgKPKKRhTRAtBrLTXih0ViFjDYLEeGGqlY24wxA,115
+index_toml_adapter_python/adapter.py,sha256=HrqYYZ7eHC9wL7E-Gz8UFsXXRphDw215F7i1-bAUoao,6972
+index_toml_adapter_python-0.1.0.dist-info/WHEEL,sha256=3OmCxFA0ffBIsX4x0o8CdfSvZAOvO3mzEG8U_z5TvV4,80
+index_toml_adapter_python-0.1.0.dist-info/METADATA,sha256=539GHZXk1FzedQf1naaR57wymOwPBMlzc4zbq6iKVa0,599
+index_toml_adapter_python-0.1.0.dist-info/RECORD,,

index_toml_adapter_python-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.13.8
+Root-Is-Purelib: true
+Tag: py3-none-any