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/dgZ0e1e2Z3dd Z4d ddZ5dd Z6G dd de7Z8G dd de9Z:G dd d e9Z;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|| jdS )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 fddZd 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_netlocextendschemesgetattrrP 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 ).0backendr# 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 |ds td|j d S |j| jkrD| | j|j< td|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
td||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 d8ddZe 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 d9d2d3Z!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.
NNotImplementedError)r( r# r# r$ rE 8 s z VersionControl.get_base_rev_argsc C s t | ||dS )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 jjp$t|S )zy
posix absolute paths start with os.path.sep,
win32 ones start with drive (like c:\folder)
)r- r.
splitdrivern sepbool)rc ZrepoZdrivetailr# 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||ddd }| ||\}}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# )usernamepasswordr# 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 | dS )zi
Normalize a URL for comparison by unquoting it and removing any
trailing slash.
/)rQ Zunquoterstripr 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 rt
d| j
t|| | ||jst
dt|| j | | ||| n
t
d dS t
d| j| j t|| d}nt
d|| j| j d}t
d | j| td
|d |d }|d
kr$td |dkrXt
dt| t| | ||| dS |dkrt|}t
dt|| t|| | ||| dS |dkrt
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 )siwbz0Directory %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 ar 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_nametitler r r( infor r3 r! r sysexitr r shutilZmover ) r> r r r Z rev_displayZ existing_urlpromptZresponseZdest_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_revisionTraisec
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_returncodeextra_ok_returncodes command_desc
extra_environ
unset_environspinnerlog_failed_cmdzCCannot find command %r - do you have %r installed and in your PATH?N)r r! r
r OSErrorerrnoZENOENTr ) rc cmdZ show_stdoutcwdr r r r r r er# r# r$ run_command\ s&
zVersionControl.run_commandc C s, t d|| j| j tjtj|| jS )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