__ __ __ __ _____ _ _ _____ _ _ _ | \/ | \ \ / / | __ \ (_) | | / ____| | | | | | \ / |_ __\ V / | |__) | __ ___ ____ _| |_ ___ | (___ | |__ ___| | | | |\/| | '__|> < | ___/ '__| \ \ / / _` | __/ _ \ \___ \| '_ \ / _ \ | | | | | | |_ / . \ | | | | | |\ V / (_| | || __/ ____) | | | | __/ | | |_| |_|_(_)_/ \_\ |_| |_| |_| \_/ \__,_|\__\___| |_____/|_| |_|\___V 2.1 if you need WebShell for Seo everyday contact me on Telegram Telegram Address : @jackleetFor_More_Tools:
a
�)g�w � @ s� d dl mZmZmZ eZdZdZdZd dl Z d dl
Z
d dl Z d dl Z d dl
Z
d dlZd dlZd dlZd dlmZ dZzd dlmZ dZW n ey� d Ze�� ZY n0 d d
lmZ d d lm Z m Z m Z d d l m Z d d
l!m"Z" ddd�Z#e
�$d�Z%e
j&e
j'e
j(e
j)e
j*e
j+e
j&d�Z,dd� Z-dd� Z.dd� Z/dd� Z0dd � Z1d d � Z2d.d d �Z3d!d"� Z4d#d$� Z5d/d%d&�Z6d'd(� Z7G d)d*� d*�Z8d+d,� Z9e:d-k�r�e9� dS )0� )�absolute_import�division�print_functiona�
---
module: pip
short_description: Manages Python library dependencies
description:
- "Manage Python library dependencies. To use this module, one of the following keys is required: C(name)
or C(requirements)."
version_added: "0.7"
options:
name:
description:
- The name of a Python library to install or the url(bzr+,hg+,git+,svn+) of the remote package.
- This can be a list (since 2.2) and contain version specifiers (since 2.7).
type: list
elements: str
version:
description:
- The version number to install of the Python library specified in the I(name) parameter.
type: str
requirements:
description:
- The path to a pip requirements file, which should be local to the remote system.
File can be specified as a relative path if using the chdir option.
type: str
virtualenv:
description:
- An optional path to a I(virtualenv) directory to install into.
It cannot be specified together with the 'executable' parameter
(added in 2.1).
If the virtualenv does not exist, it will be created before installing
packages. The optional virtualenv_site_packages, virtualenv_command,
and virtualenv_python options affect the creation of the virtualenv.
type: path
virtualenv_site_packages:
description:
- Whether the virtual environment will inherit packages from the
global site-packages directory. Note that if this setting is
changed on an already existing virtual environment it will not
have any effect, the environment must be deleted and newly
created.
type: bool
default: "no"
version_added: "1.0"
virtualenv_command:
description:
- The command or a pathname to the command to create the virtual
environment with. For example C(pyvenv), C(virtualenv),
C(virtualenv2), C(~/bin/virtualenv), C(/usr/local/bin/virtualenv).
type: path
default: virtualenv
version_added: "1.1"
virtualenv_python:
description:
- The Python executable used for creating the virtual environment.
For example C(python3.5), C(python2.7). When not specified, the
Python version used to run the ansible module is used. This parameter
should not be used when C(virtualenv_command) is using C(pyvenv) or
the C(-m venv) module.
type: str
version_added: "2.0"
state:
description:
- The state of module
- The 'forcereinstall' option is only available in Ansible 2.1 and above.
type: str
choices: [ absent, forcereinstall, latest, present ]
default: present
extra_args:
description:
- Extra arguments passed to pip.
type: str
version_added: "1.0"
editable:
description:
- Pass the editable flag.
type: bool
default: 'no'
version_added: "2.0"
chdir:
description:
- cd into this directory before running the command
type: path
version_added: "1.3"
executable:
description:
- The explicit executable or pathname for the pip executable,
if different from the Ansible Python interpreter. For
example C(pip3.3), if there are both Python 2.7 and 3.3 installations
in the system and you want to run pip for the Python 3.3 installation.
- Mutually exclusive with I(virtualenv) (added in 2.1).
- Does not affect the Ansible Python interpreter.
- The setuptools package must be installed for both the Ansible Python interpreter
and for the version of Python specified by this option.
type: path
version_added: "1.3"
umask:
description:
- The system umask to apply before installing the pip package. This is
useful, for example, when installing on systems that have a very
restrictive umask by default (e.g., "0077") and you want to pip install
packages which are to be used by all users. Note that this requires you
to specify desired umask mode as an octal string, (e.g., "0022").
type: str
version_added: "2.1"
extends_documentation_fragment:
- action_common_attributes
attributes:
check_mode:
support: full
diff_mode:
support: none
platform:
platforms: posix
notes:
- Python installations marked externally-managed (as defined by PEP668) cannot be updated by pip versions >= 23.0.1 without the use of
a virtual environment or setting the environment variable ``PIP_BREAK_SYSTEM_PACKAGES=1``.
- The virtualenv (U(http://www.virtualenv.org/)) must be
installed on the remote host if the virtualenv parameter is specified and
the virtualenv needs to be created.
- Although it executes using the Ansible Python interpreter, the pip module shells out to
run the actual pip command, so it can use any pip version you specify with I(executable).
By default, it uses the pip version for the Ansible Python interpreter. For example, pip3 on python 3, and pip2 or pip on python 2.
- The interpreter used by Ansible
(see R(ansible_python_interpreter, ansible_python_interpreter))
requires the setuptools package, regardless of the version of pip set with
the I(executable) option.
requirements:
- pip
- virtualenv
- setuptools
author:
- Matt Wright (@mattupstate)
ad
- name: Install bottle python package
ansible.builtin.pip:
name: bottle
- name: Install bottle python package on version 0.11
ansible.builtin.pip:
name: bottle==0.11
- name: Install bottle python package with version specifiers
ansible.builtin.pip:
name: bottle>0.10,<0.20,!=0.11
- name: Install multi python packages with version specifiers
ansible.builtin.pip:
name:
- django>1.11.0,<1.12.0
- bottle>0.10,<0.20,!=0.11
- name: Install python package using a proxy
ansible.builtin.pip:
name: six
environment:
http_proxy: 'http://127.0.0.1:8080'
https_proxy: 'https://127.0.0.1:8080'
# You do not have to supply '-e' option in extra_args
- name: Install MyApp using one of the remote protocols (bzr+,hg+,git+,svn+)
ansible.builtin.pip:
name: svn+http://myrepo/svn/MyApp#egg=MyApp
- name: Install MyApp using one of the remote protocols (bzr+,hg+,git+)
ansible.builtin.pip:
name: git+http://myrepo/app/MyApp
- name: Install MyApp from local tarball
ansible.builtin.pip:
name: file:///path/to/MyApp.tar.gz
- name: Install bottle into the specified (virtualenv), inheriting none of the globally installed modules
ansible.builtin.pip:
name: bottle
virtualenv: /my_app/venv
- name: Install bottle into the specified (virtualenv), inheriting globally installed modules
ansible.builtin.pip:
name: bottle
virtualenv: /my_app/venv
virtualenv_site_packages: yes
- name: Install bottle into the specified (virtualenv), using Python 2.7
ansible.builtin.pip:
name: bottle
virtualenv: /my_app/venv
virtualenv_command: virtualenv-2.7
- name: Install bottle within a user home directory
ansible.builtin.pip:
name: bottle
extra_args: --user
- name: Install specified python requirements
ansible.builtin.pip:
requirements: /my_app/requirements.txt
- name: Install specified python requirements in indicated (virtualenv)
ansible.builtin.pip:
requirements: /my_app/requirements.txt
virtualenv: /my_app/venv
- name: Install specified python requirements and custom Index URL
ansible.builtin.pip:
requirements: /my_app/requirements.txt
extra_args: -i https://example.com/pypi/simple
- name: Install specified python requirements offline from a local directory with downloaded packages
ansible.builtin.pip:
requirements: /my_app/requirements.txt
extra_args: "--no-index --find-links=file:///my_downloaded_packages_dir"
- name: Install bottle for Python 3.3 specifically, using the 'pip3.3' executable
ansible.builtin.pip:
name: bottle
executable: pip3.3
- name: Install bottle, forcing reinstallation if it's already installed
ansible.builtin.pip:
name: bottle
state: forcereinstall
- name: Install bottle while ensuring the umask is 0022 (to ensure other users can use it)
ansible.builtin.pip:
name: bottle
umask: "0022"
become: True
a�
cmd:
description: pip command used by the module
returned: success
type: str
sample: pip2 install ansible six
name:
description: list of python modules targeted by pip
returned: success
type: list
sample: ['ansible', 'six']
requirements:
description: Path to the requirements file
returned: success, if a requirements file was provided
type: str
sample: "/srv/git/project/requirements.txt"
version:
description: Version of the package specified in 'name'
returned: success, if a name and version were provided
type: str
sample: "2.5.1"
virtualenv:
description: Path to the virtualenv
returned: success, if a virtualenv path was provided
type: str
sample: "/tmp/virtualenv"
N)� LooseVersion)� RequirementTF�� to_native)�
AnsibleModule�
is_executable�missing_required_lib)�get_best_parsable_locale)�PY3z0import setuptools; print(setuptools.__version__)zJimport pkg_resources; print(pkg_resources.get_distribution("pip").version)��
setuptools�pipz(svn|git|hg|bzr)\+)z>=z<=�>�<�==z!=z~=c C s t �t| �S )z(Test whether a name is a vcs url or not.)�re�match�_VCS_RE��name� r �7/usr/lib/python3.9/site-packages/ansible/modules/pip.py� _is_vcs_url3 s r c C s | � � �tt�� �� S )z?Test whether the name is a package name or a version specifier.)�lstrip�
startswith�tuple�op_dict�keysr r r r �_is_package_name8 s r! c C s� g }| D ]}|� |�d�� q|} g }g }d}| D ]N}t|�rZ|sZ|rV|�d�|�� g }d|v rfd}|rvd|v rvd}|�|� q2|�d�|�� |S )a� Recover package names as list from user's raw input.
:input: a mixed and invalid list of names or version specifiers
:return: a list of valid package name
eg.
input: ['django>1.11.1', '<1.11.3', 'ipaddress', 'simpleproject>1.1.0', '<2.0.0']
return: ['django>1.11.1,<1.11.3', 'ipaddress', 'simpleproject>1.1.0,<2.0.0']
input: ['django>1.11.1,<1.11.3,ipaddress', 'simpleproject>1.1.0,<2.0.0']
return: ['django>1.11.1,<1.11.3', 'ipaddress', 'simpleproject>1.1.0,<2.0.0']
�,F�[T�])�extend�splitr! �append�join)�names�tmpZone_lineZ
name_partsZ
package_namesZ in_bracketsr r r r �_recover_package_name= s& r+ c C sV |d }| � |�\}}}|dkr8| jd||| f d� |�� �� }dd� |D �}|S )Nz --helpr z Could not get output from %s: %s��msgc S s g | ]}|� d �r|�qS )z--�r )�.0�xr r r �
<listcomp>i � z$_get_cmd_options.<locals>.<listcomp>)� run_command� fail_json�stripr& )�module�cmdZthiscmd�rc�stdout�stderr�wordsZ cmd_optionsr r r �_get_cmd_optionsb s r< c C s� |ddg }t | �}|||d�}| j|||d�\}}}|dkrr|dg }| j||d�\}}}|dkrrt| |||� d�|�||fS ) z.Return results of pip command to get packages.�listz--format=freeze)�LANG�LC_ALL� LC_MESSAGES)�cwdZenviron_updater Zfreeze�rA � )r r3 �_failr( ) r6 r �chdirZcommand�localeZlang_envr8 �out�errr r r �
_get_packagesm s
rI c C sL |D ]B}d|v r|� d�\}}t�|�}nq||jkr|�|�r dS qdS )z+Return whether or not package is installed.r TF)r& �Package�canonicalize_name� package_name�is_satisfied_by)r6 ZreqZinstalled_pkgsZ pkg_command�pkg�pkg_nameZ pkg_versionr r r � _is_present s rP c C s. d}t r d}d }|d ur2tj�|�r*|}qT|f}n"|d u rT|d u rTt� rTtjddg}|d u �r|d u r�g }|D ] }| �|d|�}|d urn q�qn| jdd� |� d� nrtj� |d �}|d
d f}|D ]0}tj� ||�}tj�
|�r�t |�r�|} �qq�| jd | d
d� |� d d� t |t
��s*|g}|S )N)Zpip2r )Zpip3z-mz pip.__main__Fz<Unable to find any of %s to use. pip needs to be installed.z, r, �binr r z*Unable to find pip in the virtualenv, %s, z under any of these names: %s. z+Make sure pip is present in the virtualenv.)r
�os�path�isabs�_have_pip_module�sys�
executable� get_bin_pathr4 r( �existsr
�
isinstancer= ) r6 �envrW Zcandidate_pip_basenamesr �opt_dirs�basenameZvenv_dir� candidater r r �_get_pip� sF
�
�� r_ c C s� zddl m} W n ty& d} Y n0 | rVzt| d��}W q� tyR d}Y q�0 n2ddl}z|�d� W n ty� d}Y n0 d}|S )zjReturn True if the `pip` module can be found using the current Python interpreter, otherwise return False.r )� find_specNr FT)�importlib.utilr` � ImportError�bool� Exception�imp� find_module)r` �foundre r r r rU � s
rU c C s: d}|r|d|f 7 }|r(|d|f 7 }| j ||d� d S )N� z
stdout: %sz
:stderr: %s)r7 r- )r4 )r6 r7 rG rH r- r r r rD � s rD c C sh |rd| g}ng }| � dd|�}|du r0d}n4| �|dt| g�\}}}|rTd}nd||�� f }|S )a This is only needed for special packages which do not show up in pip freeze
pip and setuptools fall into this category.
:returns: a string containing the version number if the package is
installed. None if the package is not installed.
z%s/binZpythonFNz-cz%s==%s)rX r3 �_SPECIAL_PACKAGE_CHECKERSr5 ) r6 �packager[ r\ Z
python_bin�
formatted_depr8 rG rH r r r �_get_package_info� s rl c s2 � j r� jdd� t�� jd �}tj�|d �|d krN� �|d d�|d< � jd rd|� d� n t
� |d �}d|v r�|� d� � jd }t � fd d
�d D ��s�|r�|� d | � q�t r�|� d t
j � n� jd r� jd
d� |� |� � j||d�\}} }
|| 7 }||
7 }|dk�r*t� |||� ||fS )NT��changed�virtualenv_commandr �virtualenv_site_packagesz--system-site-packagesz--no-site-packages�virtualenv_pythonc 3 s | ]}|� j d v V qdS )ro N)�params)r/ �ex�r6 r r � <genexpr>" r2 z#setup_virtualenv.<locals>.<genexpr>)Zpyvenvz-m venvz-p%sz_virtualenv_python should not be used when using the venv module or pyvenv as virtualenv_commandr, rB )�
check_mode� exit_json�shlexr& rr rR rS r] rX r' r< �anyr
rV rW r4 r3 rD ) r6 r[ rE rG rH r7 Zcmd_optsrq r8 Zout_venvZerr_venvr rt r �setup_virtualenv s6
�
rz c @ sL e Zd ZdZe�d�Zddd�Zedd� �Z dd � Z
e d
d � �Z d d
� Z
dS )rJ z�Python distribution package metadata wrapper.
A wrapper class for Requirement, which provides
API to parse package name, version specifier,
test whether a package is already satisfied.
z[-_.]+Nc
C s� d| _ || _d | _|r@|�� }|d �� r.dnd}|�||f�}zJt�|�| _| jjdkrrd|v rrd| _d| j_nt �
| jj�| _d| _ W n$ t y� } z W Y d }~n
d }~0 0 d S )NFr r rC Z
distributer T) �_plain_packagerL � _requirementr �isdigitr( r �parseZ project_namerJ rK �
ValueError)�selfZ name_stringZversion_string� separator�er r r �__init__I s
zPackage.__init__c C s | j rt| jj�S dS )NF)r{ rc r| �specs�r� r r r �has_version_specifier^ s z Package.has_version_specifierc sX | j s
dS z| jjj� dd�W S tyR t� �� t� fdd�| jjD �� Y S 0 d S )NFT)Z prereleasesc 3 s$ | ] \}}t | � t|��V qd S �N)r r )r/ �opZver��version_to_testr r ru l s �z*Package.is_satisfied_by.<locals>.<genexpr>)r{ r| Z specifier�contains�AttributeErrorr �allr� )r� r� r r� r rM d s �zPackage.is_satisfied_byc C s t j�d| ��� S )N�-)rJ �_CANONICALIZE_RE�sub�lowerr r r r rK q s zPackage.canonicalize_namec C s | j rt| j�S | jS r� )r{ r r| rL r� r r r �__str__v s
zPackage.__str__)N)�__name__�
__module__� __qualname__�__doc__r �compiler� r� �propertyr� rM � staticmethodrK r� r r r r rJ ? s
rJ c ! C s� t dgddgddgg d�d�} tt t ddt| �� �d �t d
dd �t dd �t dd �t d
d �t ddd�t d
dd�t dd �t dd �t ddd�t d
d �t d
d �t dd �d�
ddggddgddggdd�}ts�|jtd�td� |jd }|jd }|jd }|jd }|jd }|jd }|jd }|jd } d}
| �rD|�rDt j
� || �} |�r�t |t
��s�zt
|d �}W n. t�y� |jd tt�� d! �d"� Y n0 d } |d u�r�t �|�} �z|d#k�r�|d u�r�|jd$d%� |d u �r�t�� }d&} d&}
| �r"t j
�t j
� | d'd(���s"d}
t|| ||
| �\}
} t|| |jd �}|| | }d }| �rXt j
� | d'�}d}|�r�|D ] }|�rft|��rfd} �q��qfd)d*� t|�D �}|d u�r�t|�d!k�r�|jd+d%� |d, j�r�|jd-d%� t t|d, �|�|d,< |jd. �r*g }|�r |� d/�}d0|v�r*|� d0� d/� |�}|�r@|� t � |�� |�r\|� d1d2� |D �� n&|�rr|� d3|g� n|j!dd4gd5� |j"�r�|�s�|�s�|d#k�s�|�s�|j!dd6� t#|||�\}}}|
|7 }
| |7 } d}|�r�d7d*� |
� d8�D �}|�$d9��rTd:|v �sd|v �rTd;D ]<}||v �rt%||| �}|d u�r|� |� |
d<| 7 }
�q|D ]>}t&||||�} |dk�rz| �r�|d=k�rX| �rXd} �q��qX|j!|||
| d>� d } |�s�|�r�t#|||�\} } } |j'|||d?�\} }}|
|7 }
| |7 } | d!k�r |d=k�r d@|v �s4d@|v �r n| d,k�r4t(|||
| � |d=k�rHdA|v }n.| d u �r\dB|v }nt#|||�\} } } | | k}|�p~|
}|j!||||||| |
| dC� W | d u�r�t �| � n| d u�r�t �| � 0 d S )DN�installZ uninstallz-y�-U)r� r� z--force-reinstall)�present�absent�latestZforcereinstall�strr� )�type�default�choicesr= )r� �elements)r� rS rc F)r� r� �
virtualenv)
�stater �version� requirementsr� rp ro rq �
extra_args�editablerE rW �umaskr r� rW T)Z
argument_specZrequired_one_ofZmutually_exclusiveZsupports_check_moder )r- � exceptionr� r� r� rE r� � z umask must be an octal integer� )r- �detailsr� z)version is incompatible with state=latestr, rh rQ Zactivatec S s g | ] }t |��qS r )rJ )r/ rN r r r r1 � r2 zmain.<locals>.<listcomp>z�'version' argument is ambiguous when installing multiple package distributions. Please specify version restrictions next to each package in 'name' argument.r z�The 'version' argument conflicts with any version specifier provided along with a package name. Please keep the version specifier, but remove the 'version' argument.r� rC z-ec s s | ]}t |�V qd S r� r �r/ �pr r r ru � r2 zmain.<locals>.<genexpr>z-rz)No valid name or requirements file found.)rn �warningsrm c S s( g | ] }|� d �s|� d�s|r|�qS )z
You are usingzYou should considerr. r� r r r r1
r2 �
z freezer r z%s
r� )rn r7 r9 r: )� path_prefixrA z
not installedzSuccessfully uninstalledzSuccessfully installed) rn r7 r r� r� r� r� r9 r: ))�dictr r= r �HAS_SETUPTOOLSr4 r �SETUPTOOLS_IMP_ERRrr rR rS r( rZ �intrd r rV �exc_infor� �tempfileZ
gettempdirrY rz r_ r r+ �lenr� rJ r& r' r% rx rw rv rI �endswithrl rP r3 rD )!Z state_mapr6 r� r r� r� r� rE r� r[ Z venv_createdZ old_umaskrH rG r r7 r� Zhas_vcsrN ZpackagesZ args_listZpkg_cmdZout_pipZerr_piprn Zpkg_listrk rj Z
is_presentZout_freeze_before�_r8 Zout_freeze_afterr r r �main| s0 �
��
�
�
� �
�
��
�
�
r� �__main__)NN)N);Z
__future__r r r r� Z
__metaclass__Z
DOCUMENTATIONZEXAMPLESZRETURNrR r rV r� �operatorrx � traceback�typesZ#ansible.module_utils.compat.versionr r� Z
pkg_resourcesr r� rb �
format_excZansible.module_utils._textr Zansible.module_utils.basicr r
r Z"ansible.module_utils.common.localer Zansible.module_utils.sixr
ri r� r �ge�le�gt�lt�eq�ner r r! r+ r< rI rP r_ rU rD rl rz rJ r� r� r r r r �<module> s` a �
�%
;
6= F