U
��.e~S � @ s� d Z ddlmZ ddlZddlZddlZddlZddlZddlm Z ddl
m Z ddl
mZ ddlmZ ddlmZmZmZmZmZmZ dd lmZmZ dd
lm Z dd l m Z e �r dd l m Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z) dd
l*m+Z+ ddlm,Z, ddlm-Z- e'e%e. e%e. f Z/dgZ0e�1e2�Z3dd� Z4d dd�Z5dd� Z6G dd� de7�Z8G dd� de9�Z:G dd � d e9�Z;e;� Z)r& r= r! r( �r> r# r# r$ �__repr__� s zRevOptions.__repr__c C s | j d kr| jjS | j S �N)r( r= �default_arg_revr@ r# r# r$ �arg_rev� s
zRevOptions.arg_revc C s0 g }| j }|dk r"|| j�|�7 }|| j7 }|S )z<
Return the VCS-specific command arguments.
N)rD r= �get_base_rev_argsr< )r> �argsr( r# r# r$ �to_args� s
zRevOptions.to_argsc C s | j s
dS d�| j �S )N� z (to revision {}))r( r& r@ r# r# r$ �
to_display� s zRevOptions.to_displayc C s | j j|| jd�S )z�
Make a copy of the current instance, but with a new rev.
Args:
rev: the name of the revision for the new object.
�r< )r= �make_rev_optionsr< )r> r( r# r# r$ �make_new� s zRevOptions.make_new)NN) r8 r9 r: �__doc__r? rA �propertyrD rG rI rL r# r# r# r$ r; j s
�
r; c s| e Zd Zi ZddddddgZ� fdd�Zd d
� Zed d � �Zed
d� �Z edd� �Z
dd� Z dd� Z dd� Z
dd� Z� ZS )�
VcsSupportZsshZgitZhgZbzrZsftpZsvnc s: t j�| j� tt dd �r(t j�| j� tt| ��� d S )N�
uses_fragment) � urllib_parseZ uses_netloc�extend�schemes�getattrrP �superrO r? r@ �� __class__r# r$ r? � s zVcsSupport.__init__c C s
| j �� S rB )� _registry�__iter__r@ r# r# r$ rY � s zVcsSupport.__iter__c C s t | j�� �S rB )�listrX �valuesr@ r# r# r$ �backends� s zVcsSupport.backendsc C s dd� | j D �S )Nc S s g | ]
}|j �qS r# )r1 )�.0�backendr# r# r$ �
� s z'VcsSupport.dirnames..)r\ r@ r# r# r$ �dirnames� s zVcsSupport.dirnamesc C s g }| j D ]}|�|j� q
|S rB )r\ rR rS )r> rS r^ r# r# r$ r � s
zVcsSupport.all_schemesc C sH t |d�s t�d|j� d S |j| jkrD|� | j|j< t�d|j� d S )Nr! zCannot register VCS %szRegistered VCS backend: %s)�hasattrr2 r3 r8 r! rX �debug)r> �clsr# r# r$ �register� s
zVcsSupport.registerc C s || j kr| j |= d S rB )rX �r> r! r# r# r$ �
unregister� s
zVcsSupport.unregisterc C s6 | j �� D ]&}|�|�r
t�d||j� | S q
dS )zv
Return a VersionControl object if a repository of that type is found
at the given directory.
z Determine that %s uses VCS: %sN)rX r[ �controls_locationr2 rb r! )r> r5 Z vcs_backendr# r# r$ �get_backend_for_dir� s
�
z VcsSupport.get_backend_for_dirc C s |� � }| j�|�S )z9
Return a VersionControl object or None.
)�lowerrX �getre r# r# r$ � get_backend� s zVcsSupport.get_backend)r8 r9 r: rX rS r? rY rN r\ r` r rd rf rh rk �
__classcell__r# r# rV r$ rO � s
rO c @ s8 e Zd ZdZdZdZdZdZdZe dd� �Z
e dd� �Z e dd � �Z e d
d � �Z
ed d
� �Ze d8dd��Ze dd� �Zdd� Ze dd� �Ze dd� �Zedd� �Zdd� Zed d � �Ze d d � �Zd d!� Zd"d#� Zd$d%� Ze d&d'� �Z d(d)� Z d*d+� Z e d,d-� �Z e d.d/� �Z e d9d2d3��Z!e d4d5� �Z"e d6d7� �Z#dS ):�VersionControlrH r# Nc C s |� � �d�| j�� S )z�
Return whether the vcs prefix (e.g. "git+") should be added to a
repository's remote url when used in a requirement.
z{}:)ri �
startswithr& r! )rc Z
remote_urlr# r# r$ �should_add_vcs_url_prefix s z(VersionControl.should_add_vcs_url_prefixc C s dS )z~
Return the path to setup.py, relative to the repo root.
Return None if setup.py is in the repo root.
Nr# �rc r5 r# r# r$ �get_subdirectory s z VersionControl.get_subdirectoryc C s
| � |�S )zR
Return the revision string that should be used in a requirement.
)� get_revision)rc �repo_dirr# r# r$ �get_requirement_revision s z'VersionControl.get_requirement_revisionc C sV | � |�}|dkrdS | �|�r.d�| j|�}| �|�}| �|�}t||||d�}|S )aC
Return the requirement string to use to redownload the files
currently at the given repository directory.
Args:
project_name: the (unescaped) project name.
The return value has a form similar to the following:
{repository_url}@{revision}#egg={project_name}
Nz{}+{})r* )�get_remote_urlro r& r! rt rq r, )rc rs r) r' Zrevisionr* r+ r# r# r$ �get_src_requirement s
�z"VersionControl.get_src_requirementc C s t �dS )z�
Return the base revision arguments for a vcs command.
Args:
rev: the name of a revision to install. Cannot be None.
N��NotImplementedError)r( r# r# r$ rE 8 s z VersionControl.get_base_rev_argsc C s t | ||d�S )z�
Return a RevOptions object.
Args:
rev: the name of a revision to install.
extra_args: a list of extra options.
rJ )r; )rc r( r< r# r# r$ rK B s
z VersionControl.make_rev_optionsc C s& t j�|�\}}|�t jj�p$t|�S )zy
posix absolute paths start with os.path.sep,
win32 ones start with drive (like c:\folder)
)r- r. �
splitdrivern �sep�bool)rc ZrepoZdrive�tailr# r# r$ �_is_local_repositoryN s z#VersionControl._is_local_repositoryc C s t �dS )z�
Export the repository at the url to the destination location
i.e. only download the files, without vcs informations
:param url: the repository URL starting with a vcs prefix.
Nrw �r> r5 �urlr# r# r$ �exportX s zVersionControl.exportc C s |dfS )aZ
Parse the repository URL's netloc, and return the new netloc to use
along with auth information.
Args:
netloc: the original repository URL netloc.
scheme: the repository URL's scheme without the vcs prefix.
This is mainly for the Subversion class to override, so that auth
information can be provided via the --username and --password options
instead of through the URL. For other subclasses like Git without
such an option, auth information must stay in the URL.
Returns: (netloc, (username, password)).
)NNr# )rc �netlocr" r# r# r$ �get_netloc_and_authb s z"VersionControl.get_netloc_and_authc C s� t �|�\}}}}}d|kr*td�|���|�dd�d }| �||�\}}d}d|krf|�dd�\}}t �||||df�}|||fS )z�
Parse the repository URL to use, and return the URL, revision,
and auth info to use.
Returns: (url, rev, (username, password)).
�+zvSorry, {!r} is a malformed VCS url. The format is +://, e.g. svn+http://myrepo/svn/MyApp#egg=MyApp� N�@rH )rQ Zurlsplit�
ValueErrorr& �splitr� �rsplitZ
urlunsplit) rc r r" r� r. ZqueryZfrag� user_passr( r# r# r$ �get_url_rev_and_authu s ��z#VersionControl.get_url_rev_and_authc C s g S )zM
Return the RevOptions "extra arguments" to use in obtain().
r# )�username�passwordr# r# r$ �
make_rev_args� s z VersionControl.make_rev_argsc
C sT | � |j�\}}}|\}}d}|dk r.t|�}| �||�}| j||d�} t|�| fS )z�
Return the URL and RevOptions object to use in obtain() and in
some cases export(), as a tuple (url, rev_options).
NrJ )r� �secretr r� rK r
)
r> r Z
secret_urlr( r� r� Zsecret_passwordr� r< � rev_optionsr# r# r$ �get_url_rev_options� s z"VersionControl.get_url_rev_optionsc C s t �| ��d�S )zi
Normalize a URL for comparison by unquoting it and removing any
trailing slash.
�/)rQ Zunquote�rstrip�r r# r# r$ �
normalize_url� s z VersionControl.normalize_urlc C s | � |�| � |�kS )zV
Compare two repo URLs for identity, ignoring incidental differences.
)r� )rc Zurl1Zurl2r# r# r$ � compare_urls� s zVersionControl.compare_urlsc C s t �dS )z�
Fetch a revision from a repository, in the case that this is the
first fetch from the repository.
Args:
dest: the directory to fetch the repository to.
rev_options: a RevOptions object.
Nrw �r> �destr r� r# r# r$ � fetch_new� s
zVersionControl.fetch_newc C s t �dS )z}
Switch the repo at ``dest`` to point to ``URL``.
Args:
rev_options: a RevOptions object.
Nrw r� r# r# r$ �switch� s zVersionControl.switchc C s t �dS )z�
Update an already-existing repo to the given ``rev_options``.
Args:
rev_options: a RevOptions object.
Nrw r� r# r# r$ �update� s zVersionControl.updatec C s t �dS )z�
Return whether the id of the current commit equals the given name.
Args:
dest: the repository directory.
name: a string name.
Nrw )rc r� r! r# r# r$ �is_commit_id_equal� s z!VersionControl.is_commit_id_equalc C s� | � |�\}}tj�|�s,| �|||� dS |�� }| �|�r�| �|�}| �||j �r�t
� d| j �
� t|�|� | �||j�s�t
�dt|�| j |� | �|||� n
t
�d� dS t
�d| j| j t|�|� d}nt
�d|| j| j � d}t
�d | j|� td
|d |d �}|d
k�r$t�d� |dk�rXt
�dt|�� t|� | �|||� dS |dk�r�t|�}t
�dt|�|� t�||� | �|||� dS |dk�r�t
�d| j t|�||� | � |||� dS )a
Install or update in editable mode the package represented by this
VersionControl object.
:param dest: the repository directory in which to install or update.
:param url: the repository URL starting with a vcs prefix.
Nz)%s in %s exists, and has correct URL (%s)zUpdating %s %s%sz$Skipping because already up-to-date.z %s %s in %s exists with URL %s)z%(s)witch, (i)gnore, (w)ipe, (b)ackup )�s�i�w�bz0Directory %s already exists, and is not a %s %s.)z(i)gnore, (w)ipe, (b)ackup )r� r� r� z+The plan is to install the %s repository %szWhat to do? %sr r� �a�����r� z Deleting %sr� zBacking up %s to %sr� zSwitching %s %s to %s%s) r� r- r. r/ r� rI �is_repository_directoryru r� r� r2 rb � repo_name�titler r� r( �infor� r3 r! r �sys�exitr r �shutilZmover� ) r> r� r r� Z rev_displayZ existing_url�promptZresponseZdest_dirr# r# r$ �obtain� s�
��
���
�
�zVersionControl.obtainc C s& t j�|�rt|� | j||d� dS )z�
Clean up current location and download the url repository
(and vcs infos) into location
:param url: the repository URL starting with a vcs prefix.
r� N)r- r. r/ r r� r~ r# r# r$ �unpack? s zVersionControl.unpackc C s t �dS )z�
Return the url used at location
Raises RemoteNotFoundError if the repository does not have a remote
url configured.
Nrw rp r# r# r$ ru K s z VersionControl.get_remote_urlc C s t �dS )zR
Return the current commit id of the files at the given location.
Nrw rp r# r# r$ rr U s zVersionControl.get_revisionT�raisec
C s| t | jf|�� }z t|||||||| j|| d�
W S tk
rv }
z(|
jtjkrdtd| j| jf ��n� W 5 d}
~
X Y nX dS )z�
Run a VCS subcommand
This is simply a wrapper around call_subprocess that adds the VCS
command name, and checks that the VCS is available
)�
on_returncode�extra_ok_returncodes� command_desc�
extra_environ�
unset_environ�spinner�log_failed_cmdzCCannot find command %r - do you have %r installed and in your PATH?N)r r! r
r� �OSError�errnoZENOENTr ) rc �cmdZ show_stdout�cwdr� r� r� r� r� r� �er# r# r$ � run_command\ s& �
��zVersionControl.run_commandc C s, t �d|| j| j� tj�tj�|| j��S )zL
Return whether a directory path is a repository directory.
z Checking in %s for %s (%s)...)r2 rb r1 r! r- r. r/ r0 )rc r. r# r# r$ r� � s �z&VersionControl.is_repository_directoryc C s
| � |�S )a6
Check if a location is controlled by the vcs.
It is meant to be overridden to implement smarter detection
mechanisms for specific vcs.
This can do more than is_repository_directory() alone. For example,
the Git override checks that Git is actually available.
)r� rp r# r# r$ rg � s z VersionControl.controls_location)NN)TNr� NNNNT)$r8 r9 r: r! r1 r� rS r� rC � classmethodro rq rt rv � staticmethodrE rK r} r� r� r� r� r� r� r� r� r� r� r� r� r� ru rr r� r� rg r# r# r# r$ rm � sr
]
� '
rm )N)>rM Z
__future__r r� Zloggingr- r� r� Z pip._vendorr Z pip._vendor.six.moves.urllibr rQ Zpip._internal.exceptionsr Zpip._internal.utils.compatr Zpip._internal.utils.miscr r r r
r r Z pip._internal.utils.subprocessr
r Zpip._internal.utils.typingr Zpip._internal.utils.urlsr �typingr r r r r r r r r r Zpip._internal.utils.uir r r �strZAuthInfo�__all__Z getLoggerr8 r2 r% r, r6 � Exceptionr7 �objectr; rO r rm r# r# r# r$ � s< 0
HG