Metadata-Version: 2.3
Name: find-exe
Version: 0.2.0
Summary: Find matching executables
Project-URL: Homepage, https://ofek.dev/find-exe/
Project-URL: Sponsor, https://github.com/sponsors/ofek
Project-URL: Changelog, https://ofek.dev/find-exe/changelog/
Project-URL: Tracker, https://github.com/ofek/find-exe/issues
Project-URL: Source, https://github.com/ofek/find-exe
Author-email: Ofek Lev <oss@ofek.dev>
License-Expression: MIT
License-File: LICENSE.txt
Keywords: binary,cli,executable,path,which
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
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 :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# find-exe

| | |
| --- | --- |
| CI/CD | [![CI - Test](https://github.com/ofek/find-exe/actions/workflows/test.yml/badge.svg)](https://github.com/ofek/find-exe/actions/workflows/test.yml) [![CD - Build](https://github.com/ofek/find-exe/actions/workflows/build.yml/badge.svg)](https://github.com/ofek/find-exe/actions/workflows/build.yml) [![Coverage](https://img.shields.io/codecov/c/gh/ofek/find-exe?token=0CYRLWA98C)](https://app.codecov.io/gh/ofek/find-exe) |
| Docs | [![Docs](https://github.com/ofek/find-exe/actions/workflows/docs.yml/badge.svg)](https://github.com/ofek/find-exe/actions/workflows/docs.yml) |
| Package | [![PyPI - Version](https://img.shields.io/pypi/v/find-exe.svg?logo=pypi&label=PyPI&logoColor=gold)](https://pypi.org/project/find-exe/) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/find-exe.svg?logo=python&label=Python&logoColor=gold)](https://pypi.org/project/find-exe/) |
| Meta | [![Hatch project](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg)](https://github.com/ofek/find-exe) [![linting - Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff) [![types - Mypy](https://img.shields.io/badge/types-Mypy-blue.svg)](https://github.com/python/mypy) [![License - MIT](https://img.shields.io/badge/license-MIT-9400d3.svg)](https://spdx.org/licenses/) [![GitHub Sponsors](https://img.shields.io/github/sponsors/ofek?logo=GitHub%20Sponsors&style=social)](https://github.com/sponsors/ofek) |

-----

This provides a library and CLI (`find-exe`) to find all executables given certain criteria.

```pycon
>>> import find_exe
>>> find_exe.with_prefix("py")
['/usr/bin/python', ...]
```

## Installation

```console
pip install find-exe
```

## Documentation

The [documentation](https://ofek.dev/find-exe/) is made with [Material for MkDocs](https://github.com/squidfunk/mkdocs-material) and is hosted by [GitHub Pages](https://docs.github.com/en/pages).

## License

`find-exe` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.
