Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/frostming/onepm
Picks the right package manager for you
https://github.com/frostming/onepm
efficiency package-manager python
Last synced: 1 day ago
JSON representation
Picks the right package manager for you
- Host: GitHub
- URL: https://github.com/frostming/onepm
- Owner: frostming
- License: mit
- Created: 2022-06-20T07:48:26.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-11T08:01:16.000Z (4 months ago)
- Last Synced: 2025-01-31T11:12:14.659Z (8 days ago)
- Topics: efficiency, package-manager, python
- Language: Python
- Homepage: https://pypi.org/project/onepm
- Size: 84 KB
- Stars: 45
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: changelogithub.config.json
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# onepm
Picks the right package manager for you.
Don't make me think about which package manager to use when I clone a project from other people. OnePM will pick the right package manager by searching for the lock files and/or the project settings in `pyproject.toml`.
This project is created in the same spirit as [@antfu/ni](https://www.npmjs.com/package/@antfu/ni).
Supported package managers: [pip], [pipenv], [poetry], [pdm], [uv]
[pip]: https://pypi.org/project/pip/
[pipenv]: https://pypi.org/project/pipenv/
[poetry]: https://pypi.org/project/poetry/
[pdm]: https://pypi.org/project/pdm/
[uv]: https://pypi.org/project/uv/
## Install onepm
Install with `pipx`:
```bash
pipx install onepm
```
Or use pdm global install:
```bash
pdm add -g onepm
```
## Provided Shortcuts
### `pi` - install
```bash
pi
# (venv) pip install . or pip install -r requirements.txt
# pipenv install
# poetry install
# pdm install
```
```bash
pi requests
# (venv) pip install requests
# pipenv install requests
# poetry add requests
# pdm add requests
```
### `pu` - update
```bash
pu
# not available for pip
# pipenv update
# poetry update
# pdm update
```
### `pr` - run
```bash
pr ...args
# (venv) ...args
# pipenv run ...args
# poetry run ...args
# pdm run ...args
```
### `pun` - uninstall
```bash
pun requests
# pip uninstall requests
# pipenv uninstall requests
# poetry remove requests
# pdm remove requests
```
### `pa` - Alias for the package manager
```bash
pa
# pip
# pipenv
# poetry
# pdm
```
If the package manager agent is pip, **OnePM will enforce an activated virtualenv, or a `.venv` under the current directory**.
## Shims for Package Managers
OnePM also provides shim for the package managers like [corepack](https://nodejs.org/api/corepack.html),
so you don't need to install package managers yourself. To enable it, install OnePM with `shims` extra:
```bash
pipx install --include-deps onepm[shims]
```
OnePM reads the `package-manager` field under `[tool.onepm]` table in `pyproject.toml`, and install the required package manager with the correct version in an isolated environment.
```toml
[tool.onepm]
package-manager = "poetry"
```
Or you can restrict the version range:
```toml
[tool.onepm]
package-manager = "poetry>=1.1.0"
```
_For Python package management, OnePM is all you need._
## OnePM Management Commands
- `onepm install`: Install the package manager configured in project file
- `onepm use $SPEC`: Use the package manager given by the requirement spec
- `onepm update|up`: Update the package manager used in the project
- `onepm cleanup [$NAME]`: Clean up installations of specified package manager or all
- `onepm list|ls $NAME`: List all installed versions of the given package manager