pkgwho 0.1.1__tar.gz

pkgwho-0.1.1/.gitignore

@@ -0,0 +1,27 @@
+# Python bytecode and caches
+__pycache__/
+*.py[cod]
+*$py.class
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Packaging and virtual environments
+build/
+dist/
+*.egg-info/
+.venv/
+venv/
+ENV/
+
+# Local configuration and secrets
+.env
+.env.*
+!.env.example
+
+# Editor and operating system files
+.vscode/
+.idea/
+.DS_Store

pkgwho-0.1.1/AGENTS.md

@@ -0,0 +1,30 @@
+# Repository Guidelines
+
+## Project Structure
+- `src/pkgwho/`: Python package and CLI implementation.
+- `tests/`: pytest tests (`test_*.py`).
+- Root metadata and user documentation: `pyproject.toml`, `README.md`.
+
+## Development
+- Create the development environment with `uv venv --python 3.12`.
+- Install the package and development tools with
+  `uv pip install --python .venv/bin/python -e ".[dev]"`.
+- Run the CLI with `pkgwho COMMAND`; use `pkgwho --help` for options.
+- Check type hints with
+  `uv run --python .venv/bin/python mypy src/pkgwho`.
+- Run pytest with elevated permissions:
+  `uv run --python .venv/bin/python pytest`.
+- Python 3.10 or newer is supported. Use type hints and 4-space indentation.
+- Use elevated permissions when a required development or system operation
+  cannot be completed with normal permissions.
+
+## Implementation Principles
+- Query package managers with `subprocess` argument lists; do not use
+  `shell=True`.
+- Treat executable paths as supporting evidence and prefer manager databases.
+- Show uninstall commands, but never uninstall packages automatically.
+- Use semantic commit messages with a Conventional Commit type, such as
+  `feat: add snap detection`, `fix: handle missing package tools`, or
+  `docs: clarify package search`.
+- Create commits with elevated permissions.
+- Update `release-notes.md` in the same commit whenever bumping the version.

pkgwho-0.1.1/LICENSE.txt

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026-present Toshihiro Kamiya <kamiya@mbj.nifty.com>
+
+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.

pkgwho-0.1.1/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.5
+Name: pkgwho
+Version: 0.1.1
+Summary: Identify the packages that provide commands and fonts on Linux
+Project-URL: Documentation, https://github.com/tos-kamiya/pkgwho#readme
+Project-URL: Issues, https://github.com/tos-kamiya/pkgwho/issues
+Project-URL: Source, https://github.com/tos-kamiya/pkgwho
+Project-URL: Changelog, https://github.com/tos-kamiya/pkgwho/blob/main/release-notes.md
+Author-email: Toshihiro Kamiya <kamiya@mbj.nifty.com>
+License-Expression: MIT
+License-File: LICENSE.txt
+Keywords: command,font,linux,package manager,package ownership
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+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 :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: System :: Installation/Setup
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest>=7; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# pkgwho
+
+Find which package manager installed a command or font on Linux, or search
+installed packages by name. pkgwho checks dpkg/apt, Snap, Flatpak, pipx, uv
+tools, Cargo, and Homebrew, and suggests how to remove packages. It never
+uninstalls anything automatically.
+
+## Installation
+
+Install directly from GitHub with [pipx](https://pipx.pypa.io/):
+
+```console
+pipx install git+https://github.com/tos-kamiya/pkgwho.git
+```
+
+## Usage
+
+Pass one or more search terms. By default, pkgwho searches commands, packages,
+and fonts for each term:
+
+```console
+pkgwho git snap flatpak
+pkgwho /usr/local/bin/my-command
+```
+
+The exit status is nonzero if any query has no result in the selected search
+types. In combined mode, a query succeeds if any of the searches finds a result.
+
+### `--type {command,package,font,all}`
+
+Choose what to search. The default is `all`.
+
+| Type | Search |
+| --- | --- |
+| `command` | Resolve a command in `PATH` or a file path and identify its package owner. |
+| `package` | Find installed package names by case-insensitive partial match, including libraries. |
+| `font` | Find installed font family or full names by case- and punctuation-insensitive partial match. |
+| `all` | Search all three independently. A package may appear in more than one result. |
+
+```console
+pkgwho --type command git
+pkgwho --type package chrome
+pkgwho --type font "Noto Sans"
+```
+
+Command searches report `unknown` when no supported manager claims the file.
+They also report matching PATH entries in Bash, Zsh, and Fish configuration,
+including Fish's `fish_user_paths`. These entries are not proof of installation;
+configuration files are read but never executed or modified.
+
+Font searches require Fontconfig's `fc-list`. Results include the font file and,
+when found in the dpkg or Homebrew formula database, its package and suggested
+uninstall command. Unowned files are still shown. An unavailable `fc-list` is
+reported and causes a nonzero exit status in font-only mode.
+
+### `--no-limit`
+
+Text output shows up to 20 matches per search. Use `--no-limit` to display all
+matches:
+
+```console
+pkgwho --type package nvidia --no-limit
+```
+
+### `--json`
+
+Emit a JSON array for one or more queries:
+
+```console
+pkgwho git unknown-tool --json
+```
+
+In combined mode, each array element contains `query`, `command`, `package`,
+and `font` fields. In single-type mode, each element contains that search's
+result directly. JSON includes all matches without the text output's default
+20-match limit.
+
+### `-o FILE`, `--output FILE`
+
+Write the selected output format to a file instead of standard output. Existing
+files are overwritten:
+
+```console
+pkgwho git --json --output results.json
+```
+
+### `-h`, `--help`
+
+Show command-line usage and exit.
+
+### `--version`
+
+Show the installed pkgwho version and exit.
+
+## Supported managers
+
+- **dpkg/apt**: queries dpkg's file ownership database.
+- **Snap**: checks commands exposed in `/snap/bin` against installed snaps.
+- **Flatpak**: recognizes application launchers exported in Flatpak's
+  `exports/bin` directories.
+- **pipx**: maps exposed applications from `pipx list` to their environments.
+- **uv**: maps exposed executables from `uv tool list` to installed tools.
+- **Cargo**: maps binaries from `cargo install --list` to installed crates.
+- **Homebrew**: queries installed formulae and matches files listed by Homebrew.
+
+## License
+
+`pkgwho` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.

pkgwho-0.1.1/README.md

@@ -0,0 +1,108 @@
+# pkgwho
+
+Find which package manager installed a command or font on Linux, or search
+installed packages by name. pkgwho checks dpkg/apt, Snap, Flatpak, pipx, uv
+tools, Cargo, and Homebrew, and suggests how to remove packages. It never
+uninstalls anything automatically.
+
+## Installation
+
+Install directly from GitHub with [pipx](https://pipx.pypa.io/):
+
+```console
+pipx install git+https://github.com/tos-kamiya/pkgwho.git
+```
+
+## Usage
+
+Pass one or more search terms. By default, pkgwho searches commands, packages,
+and fonts for each term:
+
+```console
+pkgwho git snap flatpak
+pkgwho /usr/local/bin/my-command
+```
+
+The exit status is nonzero if any query has no result in the selected search
+types. In combined mode, a query succeeds if any of the searches finds a result.
+
+### `--type {command,package,font,all}`
+
+Choose what to search. The default is `all`.
+
+| Type | Search |
+| --- | --- |
+| `command` | Resolve a command in `PATH` or a file path and identify its package owner. |
+| `package` | Find installed package names by case-insensitive partial match, including libraries. |
+| `font` | Find installed font family or full names by case- and punctuation-insensitive partial match. |
+| `all` | Search all three independently. A package may appear in more than one result. |
+
+```console
+pkgwho --type command git
+pkgwho --type package chrome
+pkgwho --type font "Noto Sans"
+```
+
+Command searches report `unknown` when no supported manager claims the file.
+They also report matching PATH entries in Bash, Zsh, and Fish configuration,
+including Fish's `fish_user_paths`. These entries are not proof of installation;
+configuration files are read but never executed or modified.
+
+Font searches require Fontconfig's `fc-list`. Results include the font file and,
+when found in the dpkg or Homebrew formula database, its package and suggested
+uninstall command. Unowned files are still shown. An unavailable `fc-list` is
+reported and causes a nonzero exit status in font-only mode.
+
+### `--no-limit`
+
+Text output shows up to 20 matches per search. Use `--no-limit` to display all
+matches:
+
+```console
+pkgwho --type package nvidia --no-limit
+```
+
+### `--json`
+
+Emit a JSON array for one or more queries:
+
+```console
+pkgwho git unknown-tool --json
+```
+
+In combined mode, each array element contains `query`, `command`, `package`,
+and `font` fields. In single-type mode, each element contains that search's
+result directly. JSON includes all matches without the text output's default
+20-match limit.
+
+### `-o FILE`, `--output FILE`
+
+Write the selected output format to a file instead of standard output. Existing
+files are overwritten:
+
+```console
+pkgwho git --json --output results.json
+```
+
+### `-h`, `--help`
+
+Show command-line usage and exit.
+
+### `--version`
+
+Show the installed pkgwho version and exit.
+
+## Supported managers
+
+- **dpkg/apt**: queries dpkg's file ownership database.
+- **Snap**: checks commands exposed in `/snap/bin` against installed snaps.
+- **Flatpak**: recognizes application launchers exported in Flatpak's
+  `exports/bin` directories.
+- **pipx**: maps exposed applications from `pipx list` to their environments.
+- **uv**: maps exposed executables from `uv tool list` to installed tools.
+- **Cargo**: maps binaries from `cargo install --list` to installed crates.
+- **Homebrew**: queries installed formulae and matches files listed by Homebrew.
+
+## License
+
+`pkgwho` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.

pkgwho-0.1.1/pyproject.toml

@@ -0,0 +1,82 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pkgwho"
+dynamic = ["version"]
+description = "Identify the packages that provide commands and fonts on Linux"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE.txt"]
+keywords = ["package manager", "package ownership", "command", "font", "linux"]
+authors = [
+  { name = "Toshihiro Kamiya", email = "kamiya@mbj.nifty.com" },
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: Implementation :: CPython",
+  "Programming Language :: Python :: Implementation :: PyPy",
+  "Topic :: System :: Installation/Setup",
+  "Topic :: System :: Systems Administration",
+  "Topic :: Utilities",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = ["mypy>=1.0.0", "pytest>=7"]
+
+[project.scripts]
+pkgwho = "pkgwho.cli:main"
+
+[project.urls]
+Documentation = "https://github.com/tos-kamiya/pkgwho#readme"
+Issues = "https://github.com/tos-kamiya/pkgwho/issues"
+Source = "https://github.com/tos-kamiya/pkgwho"
+Changelog = "https://github.com/tos-kamiya/pkgwho/blob/main/release-notes.md"
+
+[tool.hatch.version]
+path = "src/pkgwho/__about__.py"
+
+[tool.hatch.build.targets.sdist]
+exclude = ["/dev-notes"]
+
+[tool.hatch.envs.types]
+extra-dependencies = [
+  "mypy>=1.0.0",
+]
+[tool.hatch.envs.types.scripts]
+check = "mypy --install-types --non-interactive {args:src/pkgwho tests}"
+
+[tool.mypy]
+python_version = "3.10"
+files = ["src/pkgwho"]
+
+[tool.coverage.run]
+source_pkgs = ["pkgwho", "tests"]
+branch = true
+parallel = true
+omit = [
+  "src/pkgwho/__about__.py",
+]
+
+[tool.coverage.paths]
+pkgwho = ["src/pkgwho", "*/pkgwho/src/pkgwho"]
+tests = ["tests", "*/pkgwho/tests"]
+
+[tool.coverage.report]
+exclude_lines = [
+  "no cov",
+  "if __name__ == .__main__.:",
+  "if TYPE_CHECKING:",
+]

pkgwho-0.1.1/release-notes.md

@@ -0,0 +1,51 @@
+# Changelog
+
+## 0.1.1 - 2026-11-16
+
+- Exclude development notes from source distributions.
+- Remove the obsolete handoff document.
+
+## 0.1.0 - 2026-11-16
+
+- Separate command, package, and font searches with `--type command`,
+  `--type package`, and `--type font`; `--type all` searches all three.
+- Remove `--apps-only`; package searches now include libraries and other
+  non-application packages.
+- Add package search results to the combined JSON output.
+
+## 0.0.7 - 2026-11-16
+
+- Remove the `--font` alias; use `--type font` for font searches.
+- Prepare package metadata for distribution on PyPI.
+
+## 0.0.6 - 2026-11-16
+
+- Search installed fonts by family or full name using Fontconfig, showing font
+  files and their dpkg or Homebrew package owners when available.
+- Search commands and fonts by default; use `--type command`, `--type font`,
+  or `--type all` to select the search scope.
+- Support JSON output and display limits for font search results.
+
+## 0.0.5 - 2026-10-19
+
+- Report shell configuration sources that add a resolved command's directory
+  to PATH, including Bash, Zsh, Fish, and Fish's persistent `fish_user_paths`.
+- Distinguish PATH configuration records from evidence of package ownership.
+
+## 0.0.4 - 2026-10-07
+
+- Add JSON output for one or more commands.
+- Add `-o` / `--output` to save results to a file.
+
+## 0.0.3 - 2026-10-07
+
+- Add package detection for pipx, uv tools, Cargo, and Homebrew.
+- Search installed package names across all supported package managers.
+
+## 0.0.2 - 2026-10-07
+
+- Add application-only filtering and a match limit to package search results.
+- Add `--apps-only true|false` to choose whether to include non-application
+  packages.
+- Include Debian package sections in search results to improve default
+  filtering.

pkgwho-0.1.1/src/pkgwho/__about__.py

@@ -0,0 +1,4 @@
+# SPDX-FileCopyrightText: 2026-present Toshihiro Kamiya <kamiya@mbj.nifty.com>
+#
+# SPDX-License-Identifier: MIT
+__version__ = "0.1.1"

pkgwho-0.1.1/src/pkgwho/__init__.py

@@ -0,0 +1,3 @@
+# SPDX-FileCopyrightText: 2026-present Toshihiro Kamiya <kamiya@mbj.nifty.com>
+#
+# SPDX-License-Identifier: MIT