community.general.pipx – Manages applications installed with pipx

Note

This plugin is part of the community.general collection (version 3.8.1).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.pipx.

New in version 3.8.0: of community.general

Synopsis

Manage Python applications installed in isolated virtualenvs using pipx.

Parameters

Parameter	Choices/Defaults	Comments
executable path		Path to the `pipx` installed in the system. If not specified, the module will use `python -m pipx` to run the tool, using the same Python interpreter as ansible itself.
force boolean	Choices: no ← yes	Force modification of the application's virtual environment. See `pipx` for details. Only used when state=install, state=upgrade, state=upgrade_all, or state=inject.
include_injected boolean	Choices: no ← yes	Upgrade the injected packages along with the application. Only used when state=upgrade or state=upgrade_all.
index_url string		Base URL of Python Package Index. Only used when state=install, state=upgrade, or state=inject.
inject_packages list / elements=string		Packages to be injected into an existing virtual environment. Only used when state=inject.
install_deps boolean	Choices: no ← yes	Include applications of dependent packages. Only used when state=install or state=upgrade.
name string		The name of the application to be installed. It must to be a simple package name. For passing package specifications or installing from URLs or directories, please use the source option.
python string		Python version to be used when creating the application virtual environment. Must be 3.6+. Only used when state=install, state=reinstall, or state=reinstall_all.
source string		If the application source, such as a package with version specifier, or an URL, directory or any other accepted specification. See `pipx` documentation for more details. When specified, the `pipx` command will use source instead of name.
state string	Choices: present absent install ← uninstall uninstall_all inject upgrade upgrade_all reinstall reinstall_all	Desired state for the application. The states `present` and `absent` are aliases to `install` and `uninstall`, respectively.

Notes

Note

This module does not install the pipx python package, however that can be easily done with the module ansible.builtin.pip.
This module does not require pipx to be in the shell PATH, but it must be loadable by Python as a module.
Please note that pipx requires Python 3.6 or above.
This first implementation does not verify whether a specified version constraint has been installed or not. Hence, when using version operators, pipx module will always try to execute the operation, even when the application was previously installed. This feature will be added in the future.
See also the pipx documentation at https://pypa.github.io/pipx/.

Examples

- name: Install tox
  community.general.pipx:
    name: tox

- name: Install tox from git repository
  community.general.pipx:
    name: tox
    source: git+https://github.com/tox-dev/tox.git

- name: Upgrade tox
  community.general.pipx:
    name: tox
    state: upgrade

- name: Reinstall black with specific Python version
  community.general.pipx:
    name: black
    state: reinstall
    python: 3.7

- name: Uninstall pycowsay
  community.general.pipx:
    name: pycowsay
    state: absent

Authors

Alexei Znamensky (@russoz)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/pipx_module.html

Docs

Docs4dev

Title here