feat: Add 'pipx run' entry point

[matthewfeickert]

• Allows for running the equivalent of python -m id with pipx run id.

Example:

$ docker run --rm -ti python:3.12 /bin/bash
root@c4f607410d2e:/# python -m pip install pipx
root@c4f607410d2e:/# python -m pipx ensurepath
Success! Added /root/.local/bin to the PATH environment variable.

Consider adding shell completions for pipx. Run 'pipx completions' for instructions.

You will need to open a new terminal or re-login for the PATH changes to take effect.

Otherwise pipx is ready to go! ✨ 🌟 ✨
root@c4f607410d2e:/# . ~/.bashrc 
root@c4f607410d2e:/# pipx run --no-cache --spec git+https://github.com/matthewfeickert/id.git@feat/add-pipx-run-entrypoint id --help
⚠️  id is already on your PATH and installed at /usr/bin/id. Downloading and running anyway.
usage: id [-h] [-V] [-v] [-d] audience

a tool for generating OIDC identities

positional arguments:
  audience       the OIDC audience to use

options:
  -h, --help     show this help message and exit
  -V, --version  show program's version number and exit
  -v, --verbose  run with additional debug logging; supply multiple times to increase verbosity (default: 0)
  -d, --decode   decode the OIDC token into JSON (default: False)
root@c4f607410d2e:/#

[matthewfeickert]

c.f. https://github.com/pypa/build/blob/3c25681123fa1b3af58855eb43204f0de006561a/pyproject.toml#L83-L84 as an example elsewhere.

[woodruffw]

Thank you for linking this! I have no idea pipx run had its own entrypoint namespace, so this was helpful.

[matthewfeickert]

I only learned about it from @henryiii in the last 12 hours. :)

[matthewfeickert]

This isn't strictly required as one could imagine just using

"id.__main__:main"

in pyproject.toml but this allows for subtle decoupling between entrypoint and main if desired, like build has.

[woodruffw]

@di might have a different opinion, but IMO it's okay to have this just be main instead -- I don't think we have a plan/foreseen need for decoupling the two, so YAGNI applies 🙂

[di]

I'm ok with it just being main as well!

[matthewfeickert]

@woodruffw @di This is ready for review. Let me know if you have any questions, and if this isn't of interest feel free to just close it.

[woodruffw]

Thank you @matthewfeickert, this is great! I left one comment about the entrypoint (which @di can override).

[woodruffw]

/gcbrun

[matthewfeickert]

Force pushed to cleanup linting — sorry missed that. I'll wait for Dustin's feedback before making any final changes to pyproject.toml and __main__.py to avoid having to keep making you hit /gcbrun over and over.

[di]

/gcbrun