community.general.pipx_info module – Rretrieves information about applications installed with pipx
Note
This module is part of the community.general collection (version 5.8.3).
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_info
.
New in community.general 5.6.0
Synopsis
Retrieve details about Python applications installed in isolated virtualenvs using pipx.
Parameters
Parameter |
Comments |
---|---|
Path to the If not specified, the module will use |
|
Include dependent packages in the output. Choices:
|
|
Include injected packages in the output. Choices:
|
|
Returns the raw output of The raw output is not affected by include_deps or include_injected. Choices:
|
|
Name of an application installed with |
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 shellPATH
, but it must be loadable by Python as a module.Please note that
pipx
requires Python 3.6 or above.See also the
pipx
documentation at https://pypa.github.io/pipx/.
Examples
- name: retrieve all installed applications
community.general.pipx_info: {}
- name: retrieve all installed applications, include dependencies and injected packages
community.general.pipx_info:
include_deps: true
include_injected: true
- name: retrieve application tox
community.general.pipx_info:
name: tox
include_deps: true
- name: retrieve application ansible-lint, include dependencies
community.general.pipx_info:
name: ansible-lint
include_deps: true
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
The list of installed applications Returned: success |
|
The dependencies of the installed application, when include_deps=true. Returned: success Sample: |
|
The injected packages for the installed application, when include_injected=true. Returned: success Sample: |
|
The name of the installed application. Returned: success Sample: |
|
The version of the installed application. Returned: success Sample: |
|
Command executed to obtain the list of installed applications. Returned: success Sample: |
|
The raw output of the Returned: success |
Collection links
Issue Tracker Repository (Sources) Submit a bug report Request a feature Communication