Skip to content
  • David D Lowe's avatar
    c7e2045f
    Recommend pipx instead of pip for installation · c7e2045f
    David D Lowe authored
    On newer Linux distributions, using pip would give an error like this
    one:
    
        $ pip install --user hledger-utils
        error: externally-managed-environment
    
        脳 This environment is externally managed
        鈺扳攢> To install Python packages system-wide, try apt install
            python3-xyz, where xyz is the package you are trying to
            install.
    
            If you wish to install a non-Debian-packaged Python package,
            create a virtual environment using python3 -m venv path/to/venv.
            Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
            sure you have python3-full installed.
    
            If you wish to install a non-Debian packaged Python application,
            it may be easiest to use pipx install xyz, which will manage a
            virtual environment for you. Make sure you have pipx installed.
    
            See /usr/share/doc/python3.11/README.venv for more information.
    
        note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
        hint: See PEP 668 for the detailed specification.
    
    Let's recommend installing hledger-utils with pipx instead. This will
    create a virtual environment just for the commands that ship with
    hledger-utils, and it will install them in ~/.local/bin/ by default.
    c7e2045f
    Recommend pipx instead of pip for installation
    David D Lowe authored
    On newer Linux distributions, using pip would give an error like this
    one:
    
        $ pip install --user hledger-utils
        error: externally-managed-environment
    
        脳 This environment is externally managed
        鈺扳攢> To install Python packages system-wide, try apt install
            python3-xyz, where xyz is the package you are trying to
            install.
    
            If you wish to install a non-Debian-packaged Python package,
            create a virtual environment using python3 -m venv path/to/venv.
            Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
            sure you have python3-full installed.
    
            If you wish to install a non-Debian packaged Python application,
            it may be easiest to use pipx install xyz, which will manage a
            virtual environment for you. Make sure you have pipx installed.
    
            See /usr/share/doc/python3.11/README.venv for more information.
    
        note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
        hint: See PEP 668 for the detailed specification.
    
    Let's recommend installing hledger-utils with pipx instead. This will
    create a virtual environment just for the commands that ship with
    hledger-utils, and it will install them in ~/.local/bin/ by default.
Loading