Skip to main content

Automate installation of standalone python CLIs

Project description

Automate installation of standalone python CLIs

Version on pypi Tested with Github Actions Test code codecov Python versions tested (link to github project)

Overview

pickley allows to install and keep up-to-date standalone pip-installable python CLIs such as tox, hatch, etc.

It is similar to pipx, main difference being installed CLIs automatically self-upgrade as you use them.

It can work out of the box, without any configuration:

  • pickley is portable, it will run and install other CLIs in the same folder it’s running from (drop it in ~/.local/bin or /usr/local/bin for example)

  • All pypi packages with console_scripts entry point(s) can be immediately installed

  • Latest non-prerelease pypi version will be installed by default

  • Any specification acceptable to pip install can be stated, for example:

    pickley install tox  # track latest version
    
    pickley install 'tox>0a0'  # track pre-releases as well
    
    pickley install 'tox<4'  # track latest version that is strictly less than v4
    
    pickley install tox==3.24.3  # pin to a specific version
    
    pickley install tox~=3.28  # track version range
    
    pickley install git+https://...@some-branch  # track a git branch

With some configuration, the following becomes possible:

  • You can pin what version to install, what python to use etc, per pypi package

  • You can define bundle-s: names that install several pypi packages at once, for example: you could define a bundle:dev to install tox pipenv pre-commit

  • You can use a custom pypi server index (pip’s default is respected by default)

  • You can use the symlink delivery method, which will use symlinks instead of self-upgrading wrapper

Example

Once you have pickley, you can get other python CLIs and use them as standalone programs, for example:

# One-liner to grab pickley, and drop it in ~/.local/bin
$ curl -fsSL https://raw.githubusercontent.com/codrsquad/pickley/main/src/pickley/bstrap.py | /usr/bin/python3 -

# Double-check you do have ~/.local/bin in your PATH
$ which -a pickley
~/.local/bin/pickley

$ pickley base
~/.local/bin

$ pickley install install tox 'hatch<2'
Installed tox v4.21.2 in 1 second 4 ms
Installed hatch v1.12.0 in 1 second 791 ms

$ which tox
~/.local/bin/tox

$ tox --version
4.21.2 from .../.pk/tox-4.21.2/...

$ pickley list
| Package | Version | PM | Python           |
----------|---------|----|-------------------
| hatch   | 1.12.0  | uv | /usr/bin/python3 |
| tox     | 4.21.2  | uv | /usr/bin/python3 |
| uv      | 0.4.20  | uv | /usr/bin/python3 |

$ pickley list -v
| Package | Version | PM | Python           | Delivery | Track   |
----------|---------|----|------------------|----------|----------
| hatch   | 1.12.0  | uv | /usr/bin/python3 | wrap     | hatch<2 |
| tox     | 4.21.2  | uv | /usr/bin/python3 | wrap     | tox     |
| uv      | 0.4.20  | uv | /usr/bin/python3 | wrap     | uv      |

Configuration

See config

Features

  • Any pypi package that has console_scripts entry point can be installed and kept up-to-date

  • Aims to work with zero configuration (but configuration is possible):

    • entirely portable, installations are performed in the same folder where pickley resides, drop it in ~/.local/bin and all the stuff you install with it will also be there

    • latest non pre-release version from pypi is used

Commands

  • install: Install specified package(s)

  • uninstall: Uninstall specified package(s)

  • upgrade: Upgrade specified package(s)

  • check: Exit with code 0 if specified package(s) are up-to-date

  • list: List installed packages via pickley, in folder where it resides (not globally)

  • base: Print the base folder where pickley resides

  • config: Show current configuration

  • describe: Describe a package spec (version and entrypoints)

  • diagnostics: Show diagnostics info

  • run: Run a python CLI (auto-install it if needed)

  • bootstrap: Install pickley itself in target base folder

Installation

Install latest version in ~/.local/bin

If you have uv, you can use it to bootstrap pickley, for example in ~/.local/bin:

$ uvx pickley bootstrap ~/.local/bin

Handy one-line using bash:

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/codrsquad/pickley/main/get-pickley)"

Handy one-liner using python (see --help, the script accepts a few options):

$ curl -fsSL https://raw.githubusercontent.com/codrsquad/pickley/main/src/pickley/bstrap.py | /usr/bin/python3 - --help

If you happen to have uv already installed (anywhere), you can run:

$ uvx pickley bootstrap ~/.local/bin

Install from source

Run (you will need tox):

git clone https://github.com/codrsquad/pickley.git
cd pickley
uv venv
uv pip install -r requirements.txt -r tests/requirements.txt -e .
.venv/bin/pickley --help

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pickley-4.5.9.tar.gz (46.2 kB view details)

Uploaded Source

Built Distribution

pickley-4.5.9-py3-none-any.whl (38.4 kB view details)

Uploaded Python 3

File details

Details for the file pickley-4.5.9.tar.gz.

File metadata

  • Download URL: pickley-4.5.9.tar.gz
  • Upload date:
  • Size: 46.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for pickley-4.5.9.tar.gz
Algorithm Hash digest
SHA256 3822df76b7b9b37dfd83be235065f8f3bbcba70d3ffb6f022bf532c471363519
MD5 b338074104428337cf107981b2912f9e
BLAKE2b-256 18b98507bda970231578cee6ed7416566510ab056a0b1cf2c955a26671f996c7

See more details on using hashes here.

Provenance

The following attestation bundles were made for pickley-4.5.9.tar.gz:

Publisher: release.yml on codrsquad/pickley

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pickley-4.5.9-py3-none-any.whl.

File metadata

  • Download URL: pickley-4.5.9-py3-none-any.whl
  • Upload date:
  • Size: 38.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for pickley-4.5.9-py3-none-any.whl
Algorithm Hash digest
SHA256 7d302820b157d47a05cd9b4342eec70d5b7bace5619876175ba00bdd4b512523
MD5 194f6e0cccc88c946bbe58596db2aeba
BLAKE2b-256 75da607515f25b76ae88e49b618c16242c94f2e00b3c667ca64b650a19176da5

See more details on using hashes here.

Provenance

The following attestation bundles were made for pickley-4.5.9-py3-none-any.whl:

Publisher: release.yml on codrsquad/pickley

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page