Модуль community.general.python_requirements_info — отображение пути к Python и проверка версий зависимостей

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в плейбуке, укажите: community.general.python_requirements_info.

Краткое описание
Параметры
Атрибуты
Примеры
Возвращаемые значения

Краткое описание

Получение сведений о доступных требованиях Python на целевом узле, включая список необходимых библиотек и сбор их версий.

Параметры

Параметр	Комментарии
dependencies list / elements=string	Список версий или имён модулей, для которых нужно проверить наличие установки. Поддерживаемые операторы: `<`, `>`, `<=`, `>=` или `==`. Допустимыми спецификациями являются имя модуля без дополнительных условий, например `ansible`, модуль с указанием конкретной версии, например `boto3==1.6.1`, или частичная версия, например `requests>2`. По умолчанию: `[]`

Параметр

Комментарии

dependencies

list / elements=string

Список версий или имён модулей, для которых нужно проверить наличие установки. Поддерживаемые операторы: <, >, <=, >= или ==.

Допустимыми спецификациями являются имя модуля без дополнительных условий, например ansible, модуль с указанием конкретной версии, например boto3==1.6.1, или частичная версия, например requests>2.

По умолчанию: []

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная Это действие не изменяет состояние.	Может выполняться в режиме `check_mode` и возвращать прогноз статуса изменений, не изменяя целевой узел.
diff_mode	Поддержка: не применимо Это действие не изменяет состояние.	В режиме diff возвращает сведения об изменениях (или о том, что, возможно, необходимо изменить в `check_mode`).

Примеры

- name: Show python lib/site paths
  community.general.python_requirements_info:

- name: Check for modern boto3 and botocore versions
  community.general.python_requirements_info:
    dependencies:
      - boto3>1.6
      - botocore<2

Возвращаемые значения

Общие возвращаемые значения описаны здесь. Ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
mismatched dictionary	Словарь зависимостей, версии которых не соответствуют заданным требованиям. Возвращается: всегда Пример: `{"botocore": {"desired": "botocore>2", "installed": "1.10.60"}}`
not_found list / elements=string	Список пакетов, которые не удалось импортировать и которые не установлены. Возвращается: всегда Пример: `["boto4", "requests"]`
python string	Путь к используемому интерпретатору Python. Возвращается: всегда Пример: `"/usr/local/opt/python@2/bin/python2.7"`
python_system_path list / elements=string	Список путей, по которым Python ищет модули. Возвращается: всегда Пример: `["/usr/local/opt/python@2/site-packages/", "/usr/lib/python/site-packages/"]`
python_version string	Версия Python. Возвращается: всегда Пример: `"2.7.15 (default, May 1 2018, 16:44:08)\n[GCC 4.2.1 Compatible Apple LLVM 9.1.0 (clang-902.0.39.1)]"`
python_version_info dictionary добавлено в community.general 4.2.0	Разбивка версии Python на компоненты. Возвращается: всегда
major integer	Компонент `major` версии интерпретатора Python. Возвращается: всегда Пример: `3`
micro integer	Компонент `micro` версии интерпретатора Python. Возвращается: всегда Пример: `10`
minor integer	Компонент `minor` версии интерпретатора Python. Возвращается: всегда Пример: `8`
releaselevel string	Компонент `releaselevel` версии интерпретатора Python. Возвращается: всегда Пример: `"final"`
serial integer	Компонент `serial` версии интерпретатора Python. Возвращается: всегда Пример: `0`
valid dictionary	Словарь зависимостей, версии которых соответствуют заданным требованиям. Если версия не указана, то `desired` — `null`. Возвращается: всегда Пример: `{"boto3": {"desired": null, "installed": "1.7.60"}, "botocore": {"desired": "botocore<2", "installed": "1.10.60"}}`

Авторы

Will Thames (@willthames)
Ryan Scott Brown (@ryansb)

Ссылки на коллекцию

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