Installing jpterm on Debian Bookworm

[chriscroome]

I'm posting this here as the JMESPath Terminal community repo doesn't have issues or discussions enabled, I hope that is OK?

The next version of Debian, Bookworm, can't be used to run the original version of jpterm, due to the version of Python, also the use of pip is strongly discouraged, the suggested alternative is pipx, so I would suggest that this could be added to the documentation at some point, to get the community version up and running on Bookworm for one user:

pipx install git+https://github.com/jmespath-community/[email protected]
⚠️  Note: jpterm was already on your PATH at /usr/local/bin/jpterm
  installed package jmespath-community-terminal 1.1.1, installed using Python 3.11.2
  These apps are now globally available
    - jpterm
done! ✨ 🌟 ✨

which jpterm
/home/chris/.local/bin/jpterm

jpterm --version
jmespath-term 1.1.1

Or for all users (note steps included for removing the old version):

sudo -i
export PIPX_HOME=/opt
export PIPX_BIN_DIR=/usr/local/bin
pipx install git+https://github.com/jmespath-community/[email protected]
⚠️  File exists at /usr/local/bin/jpterm and points to /usr/local/bin/jpterm, not /opt/venvs/jmespath-community-terminal/bin/jpterm. Not modifying.
  installed package jmespath-community-terminal 1.1.1, installed using Python 3.11.2
    - jpterm (symlink missing or pointing to unexpected location)
done! ✨ 🌟 ✨

pip uninstall jmespath-terminal --break-system-packages
Found existing installation: jmespath-terminal 0.2.1
Uninstalling jmespath-terminal-0.2.1:
  Would remove:
    /usr/local/bin/jpterm
    /usr/local/lib/python3.11/dist-packages/jmespath_terminal-0.2.1.dist-info/*
    /usr/local/lib/python3.11/dist-packages/jpterm.py
Proceed (Y/n)? y
  Successfully uninstalled jmespath-terminal-0.2.1
WARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv

pip uninstall setuptools --break-system-packages
Found existing installation: setuptools 57.0.0
Uninstalling setuptools-57.0.0:
  Would remove:
    /usr/local/lib/python3.11/dist-packages/_distutils_hack/*
    /usr/local/lib/python3.11/dist-packages/distutils-precedence.pth
    /usr/local/lib/python3.11/dist-packages/pkg_resources/*
    /usr/local/lib/python3.11/dist-packages/setuptools-57.0.0.dist-info/*
    /usr/local/lib/python3.11/dist-packages/setuptools/*
Proceed (Y/n)? y
  Successfully uninstalled setuptools-57.0.0
WARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv

pipx install git+https://github.com/jmespath-community/[email protected] --force
Installing to existing venv 'jmespath-community-terminal'
  installed package jmespath-community-terminal 1.1.1, installed using Python 3.11.2
  These apps are now globally available
    - jpterm
done! ✨ 🌟 ✨

which jpterm
/usr/local/bin/jpterm

/usr/local/bin/jpterm --version
jmespath-term 1.1.1