whichowns 0.0.1__tar.gz

whichowns-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kyle O'Malley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

whichowns-0.0.1/PKG-INFO

@@ -0,0 +1,23 @@
+Metadata-Version: 2.4
+Name: whichowns
+Version: 0.0.1
+Summary: Find which package manager owns a command.
+Author: Kyle O'Malley
+Author-email: Kyle O'Malley <j.kyle.omalley@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Project-URL: Homepage, https://github.com/jkomalley/whichowns
+Project-URL: Repository, https://github.com/jkomalley/whichowns
+Project-URL: Issues, https://github.com/jkomalley/whichowns/issues
+Description-Content-Type: text/markdown
+
+# whichowns
+
+Find which package manager owns a command.
+
+## Install
+
+```sh
+uv tool install whichowns
+```

whichowns-0.0.1/README.md

@@ -0,0 +1,9 @@
+# whichowns
+
+Find which package manager owns a command.
+
+## Install
+
+```sh
+uv tool install whichowns
+```

whichowns-0.0.1/pyproject.toml

@@ -0,0 +1,72 @@
+[project]
+name = "whichowns"
+version = "0.0.1"
+description = "Find which package manager owns a command."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+dependencies = []
+
+[[project.authors]]
+name = "Kyle O'Malley"
+email = "j.kyle.omalley@gmail.com"
+
+[project.urls]
+Homepage = "https://github.com/jkomalley/whichowns"
+Repository = "https://github.com/jkomalley/whichowns"
+Issues = "https://github.com/jkomalley/whichowns/issues"
+
+[project.scripts]
+whichowns = "whichowns.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.13.6,<0.14.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pre-commit>=4.7.0",
+    "pytest>=9.2.0",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.17.3",
+    "ty>=0.0.96",
+]
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "D203",
+    "D213",
+    "COM812",
+    "ISC001",
+    "FIX002",
+    "TD002",
+    "TD003",
+    "TRY003",
+    "CPY001",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["S101"]
+
+[tool.ty.environment]
+python-platform = "all"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+strict = true
+markers = ["integration: end-to-end tests with package managers; deselected by default"]
+addopts = [
+    "-ra",
+    "-m",
+    "not integration",
+]
+
+[tool.coverage.run]
+source = ["whichowns"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+exclude_also = ["if __name__ == .__main__."]

whichowns-0.0.1/pyproject.toml.orig

@@ -0,0 +1,78 @@
+[project]
+name = "whichowns"
+version = "0.0.1"
+description = "Find which package manager owns a command."
+readme = "README.md"
+authors = [
+    { name = "Kyle O'Malley", email = "j.kyle.omalley@gmail.com" }
+]
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/jkomalley/whichowns"
+Repository = "https://github.com/jkomalley/whichowns"
+Issues = "https://github.com/jkomalley/whichowns/issues"
+
+[project.scripts]
+whichowns = "whichowns.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.13.6,<0.14.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pre-commit>=4.7.0",
+    "pytest>=9.2.0",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.17.3",
+    "ty>=0.0.96",
+]
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "D203",   # one-blank-line-before-class (conflicts with D211)
+    "D213",   # multi-line-summary-second-line (conflicts with D212)
+    "COM812", # missing trailing comma (conflicts with formatter)
+    "ISC001", # single-line implicit string concatenation (conflicts with formatter)
+    "FIX002", # line contains TODO
+    "TD002",  # missing author in TODO
+    "TD003",  # missing issue link in TODO
+    "TRY003", # avoid specifying long messages outside the exception class
+    "CPY001", # missing copyright notice
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = [
+    "S101",   # use of assert (pytest relies on it)
+]
+
+# ty skips code it considers unreachable on the host platform, so checking on
+# Linux alone would silently skip macOS-only branches.
+[tool.ty.environment]
+python-platform = "all"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+strict = true
+markers = [
+    "integration: end-to-end tests with package managers; deselected by default",
+]
+addopts = [
+    "-ra",
+    "-m", "not integration",
+]
+
+[tool.coverage.run]
+source = ["whichowns"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+exclude_also = [
+    "if __name__ == .__main__.",
+]

whichowns-0.0.1/src/whichowns/__init__.py

@@ -0,0 +1 @@
+"""Find which package manager owns a command."""

whichowns-0.0.1/src/whichowns/__main__.py

@@ -0,0 +1,8 @@
+"""Run whichowns with `python -m whichowns`."""
+
+import sys
+
+from whichowns.cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

whichowns-0.0.1/src/whichowns/cli.py

@@ -0,0 +1,43 @@
+"""Command-line interface: arguments, output and exit codes."""
+
+import argparse
+import sys
+
+from whichowns.locate import locate
+from whichowns.managers import find_owner
+
+PROG = "whichowns"
+
+
+def main(argv: list[str] | None = None) -> int:
+    """Report which package manager owns a command.
+
+    Args:
+        argv: Arguments without the program name, or None to use sys.argv.
+
+    Returns:
+        0 if the command was found, 1 if not. Usage errors and --help exit
+        directly through argparse.
+
+    """
+    # Without an explicit prog, `python -m whichowns` shows "__main__.py".
+    parser = argparse.ArgumentParser(
+        prog=PROG, description="Find which package manager owns a command."
+    )
+    parser.add_argument("command", help="command name, or path to an executable")
+    parser.add_argument("-v", action="store_true", help="also show the resolved path")
+    args = parser.parse_args(argv)
+
+    location = locate(args.command)
+    if location is None:
+        sys.stderr.write(f"{PROG}: {args.command}: command not found\n")
+        return 1
+
+    owner = find_owner(location)
+    if owner is None:
+        sys.stdout.write(f"{args.command}: unmanaged\n")
+    else:
+        sys.stdout.write(f"{args.command}: {owner.package} ({owner.manager})\n")
+    if args.v:
+        sys.stdout.write(f"{location.resolved}\n")
+    return 0

whichowns-0.0.1/src/whichowns/locate.py

@@ -0,0 +1,29 @@
+"""Find a command on PATH and resolve its symlinks."""
+
+import shutil
+from pathlib import Path
+
+from whichowns.models import Location
+
+
+def locate(command: str) -> Location | None:
+    """Find a command by name on PATH, or check a path directly.
+
+    Args:
+        command: A command name, or a path to an executable (anything containing "/").
+
+    Returns:
+        The command's location, or None if it isn't found or isn't executable.
+
+    """
+    match = shutil.which(command)
+    if match is None:
+        return None
+    # which() can return relative paths, "..", and symlinked directories, but
+    # detectors compare against canonical paths, such as those in dpkg's file
+    # lists. Only the directory is resolved: the command itself may be a symlink
+    # that a package owns. Removing ".." as text would be wrong after a
+    # symlinked directory.
+    found = Path(match)
+    path = found.parent.resolve() / found.name
+    return Location(command=command, path=path, resolved=path.resolve())

whichowns-0.0.1/src/whichowns/managers/__init__.py

@@ -0,0 +1,27 @@
+"""Detector order and owner lookup."""
+
+from collections.abc import Iterable
+
+from whichowns.models import Detector, Location, Owner
+
+DETECTORS: tuple[Detector, ...] = ()
+
+
+def find_owner(
+    location: Location, detectors: Iterable[Detector] = DETECTORS
+) -> Owner | None:
+    """Ask each detector in turn which package manager owns a command.
+
+    Args:
+        location: Where the command was found.
+        detectors: Detectors to try, in order.
+
+    Returns:
+        The first owner a detector reports, or None if none match.
+
+    """
+    for detect in detectors:
+        owner = detect(location)
+        if owner is not None:
+            return owner
+    return None

whichowns-0.0.1/src/whichowns/models.py

@@ -0,0 +1,35 @@
+"""Data types shared by command lookup and the package manager detectors."""
+
+from collections.abc import Callable
+from dataclasses import dataclass
+from pathlib import Path
+from typing import TypeAlias
+
+
+@dataclass(frozen=True)
+class Location:
+    """Where a command was found.
+
+    Attributes:
+        command: The argument exactly as given.
+        path: The PATH match, or the given path, in its real directory.
+            Not followed if it's a symlink itself.
+        resolved: The final target after following every symlink.
+
+    """
+
+    command: str
+    path: Path
+    resolved: Path
+
+
+@dataclass(frozen=True)
+class Owner:
+    """The package manager and package that own a command."""
+
+    manager: str
+    package: str
+
+
+# The `type` statement needs Python 3.12, and whichowns supports 3.11.
+Detector: TypeAlias = Callable[[Location], Owner | None]