U
|
H=®dne ã @ s¼ d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl m
|
Z
|
ddl m Z ddlmZmZmZ ddlmZmZ ddlmZ dd lmZmZmZmZm Z m Z dd
|
l m Z m Z m!Z!m"Z" dd l#m$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/m0Z0m1Z1m2Z2 ddlm3Z3 ddl m4Z4 e.e,e5 e,e5 f Z6dgZ7e 8e9¡Z:dd Z;d"ddZ<d#ddZ=dd Z>G dd de?Z@G d d d eAZBG d d d eAZCeC ZDG d d! d!eAZEdS )$z)Handles all VCS (version control) supporté )Úabsolute_importN)Ú pkg_resources)Úparse)Ú
|
BadCommandÚInstallationErrorÚSubProcessError)Úconsole_to_strÚsamefile)Úsubprocess_logger)Úask_path_existsÚ
|
backup_dirÚ display_pathÚhide_urlÚ
|
hide_valueÚrmtree)Úformat_command_argsÚ make_commandÚ make_subprocess_output_errorÚreveal_command_args)ÚMYPY_CHECK_RUNNING)Úget_url_scheme) ÚDictÚIterableÚIteratorÚListÚOptionalÚTextÚTupleÚTypeÚUnionÚMappingÚAny)Ú
|
HiddenText)Ú CommandArgsÚvcsc C s* t | }|dkrdS |ddddgtj kS )z3
|
Return true if the name looks like a URL.
|
NFÚhttpÚhttpsÚfileÚftp)r r$ Ú all_schemes)ÚnameÚscheme© r, úWD:\z\workplace\VsCode\pyvenv\venv\Lib\site-packages\pip/_internal/vcs/versioncontrol.pyÚis_url8 s r. c C s. t |¡}d | ||¡}|r*|d |¡7 }|S )zº
|
Return the URL for a VCS requirement.
|
|
Args:
|
repo_url: the remote VCS url, with any needed VCS prefix (e.g. "git+").
|
project_name: the (unescaped) project name.
|
z {}@{}#egg={}z&subdirectory={})r Ú to_filenameÚformat)Úrepo_urlÚrevÚ project_nameÚsubdirÚegg_project_nameÚreqr, r, r- Úmake_vcs_requirement_urlC s
|
|
r7 Tc
|
C s^ |dkr g }t j}tj ¡ }|r*| |¡ d}t| }z.tjt | tj
|
tj
|
|d} | j rb| j ¡ W n6 t k
|
r }
|
z|rt d|
|
|¡ W 5 d}
|
~
|
X Y nX g } d} | jr¸t| j ¡ } | s¾qÞ| ¡ } | | d ¡ || q z | ¡ W 5 | jrü| j ¡ X | jo| j|k} | rT|s>|r>t| || | jd}t |¡ d | j|¡}t|d | ¡S ) zõ
|
Args:
|
extra_ok_returncodes: an iterable of integer return codes that are
|
acceptable, in addition to 0. Defaults to None, which means [].
|
log_failed_cmd: if false, failed commands are not logged,
|
only raised.
|
NT)ÚstdoutÚstderrÚcwdz#Error %s while executing command %sÚ
|
)Úcmd_argsr: ÚlinesÚ exit_statuszSCommand errored out with exit status {}: {} Check the logs for full command output.Ú )r
|
ÚdebugÚosÚenvironÚcopyÚupdater Ú
|
subprocessÚPopenr ÚPIPEÚstdinÚcloseÚ ExceptionÚcriticalr8 r ÚreadlineÚrstripÚappendÚwaitÚ
|
returncoder Úerrorr0 r Újoin)Úcmdr: Ú extra_environÚextra_ok_returncodesÚlog_failed_cmdÚlog_subprocessÚenvÚshowing_subprocessÚ command_descÚprocÚexcÚ
|
all_outputÚlineÚproc_had_errorÚmsgÚexc_msgr, r, r- Úcall_subprocessT sp
|
|
û ÿ
|
ÿ ü
|
ÿ ýrb c C s` | }t j t j | d¡¡sD| }t j | ¡} | |krt d|¡ dS qt|| rRdS t j | |¡S )zÔ
|
Find the path to `setup.py` by searching up the filesystem from `location`.
|
Return the path to `setup.py` relative to `repo_root`.
|
Return None if `setup.py` is in `repo_root` or cannot be found.
|
zsetup.pyzGCould not find setup.py for directory %s (tried all parent directories)N) rA ÚpathÚexistsrR ÚdirnameÚloggerÚwarningr Úrelpath)ÚlocationÚ repo_rootÚ orig_locationÚ last_locationr, r, r- Ú!find_path_to_setup_from_repo_rootª s ý
|
rm c @ s e Zd ZdS )ÚRemoteNotFoundErrorN)Ú__name__Ú
|
__module__Ú __qualname__r, r, r, r- rn Æ s rn c @ sF e Zd ZdZdddZdd Zedd Zd d
|
Zd d Z d d Z
|
dS )Ú
|
RevOptionsz¢
|
Encapsulates a VCS-specific revision to install, along with any VCS
|
install options.
|
|
Instances of this class should be treated as if immutable.
|
Nc C s( |dkr g }|| _ || _|| _d| _dS )z©
|
Args:
|
vc_class: a VersionControl subclass.
|
rev: the name of the revision to install.
|
extra_args: a list of extra options.
|
N)Ú
|
extra_argsr2 Úvc_classÚ branch_name)Úselfrt r2 rs r, r, r- Ú__init__Ó s zRevOptions.__init__c C s d | jj| j¡S )Nz<RevOptions {}: rev={!r}>)r0 rt r* r2 ©rv r, r, r- Ú__repr__è s zRevOptions.__repr__c C s | j d kr| jjS | j S ©N)r2 rt Údefault_arg_revrx 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)r| rt Úget_base_rev_argsrs )rv Úargsr2 r, r, r- Úto_argsô s
|
zRevOptions.to_argsc C s | j s
|
dS d | j ¡S )Nr? z (to revision {}))r2 r0 rx 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.
|
©rs )rt Úmake_rev_optionsrs )rv r2 r, r, r- Úmake_new s zRevOptions.make_new)NN) ro rp rq Ú__doc__rw ry Úpropertyr| r r r r, r, r, r- rr Ê s
|
ü
|
|
rr c s e Zd Zi ZddddddgZ fddZd d
|
Zed d Zed d Z edd Z
|
dd Z dd Z dd Z dd Zdd Z ZS )Ú
|
VcsSupportÚsshÚgitÚhgÚbzrÚsftpÚsvnc s: t j | j¡ tt dd r(t j | j¡ tt| ¡ d S )NÚ uses_fragment) Ú urllib_parseÚ uses_netlocÚextendÚschemesÚgetattrr Úsuperr rw rx ©Ú __class__r, r- rw s zVcsSupport.__init__c C s
|
| j ¡ S rz )Ú _registryÚ__iter__rx r, r, r- r ! s zVcsSupport.__iter__c C s t | j ¡ S rz )Úlistr Úvaluesrx r, r, r- Úbackends% s zVcsSupport.backendsc C s dd | j D S )Nc S s g | ]
|
}|j qS r, )re )Ú.0Úbackendr, r, r- Ú
|
<listcomp>- s z'VcsSupport.dirnames.<locals>.<listcomp>)r rx r, r, r- Údirnames* s zVcsSupport.dirnamesc C s g }| j D ]}| |j¡ q
|
|S rz )r r r )rv r r r, r, r- r) / s
|
zVcsSupport.all_schemesc C sH t |ds t d|j¡ d S |j| jkrD| | j|j< t d|j¡ d S )Nr* zCannot register VCS %szRegistered VCS backend: %s)Úhasattrrf rg ro r* r r@ )rv Úclsr, r, r- Úregister7 s
|
zVcsSupport.registerc C s || j kr| j |= d S rz )r ©rv r* r, r, r- Ú
|
unregister@ s
|
zVcsSupport.unregisterc C sX i }| j ¡ D ],}| |¡}|s"qt d||j¡ |||< q|sDdS t|td}|| S )zv
|
Return a VersionControl object if a repository of that type is found
|
at the given directory.
|
z Determine that %s uses VCS: %sN)Úkey)r r Úget_repository_rootrf r@ r* ÚmaxÚlen)rv ri Ú vcs_backendsÚ vcs_backendÚ repo_pathÚinner_most_repo_pathr, r, r- Úget_backend_for_dirE s
|
ÿ
|
z VcsSupport.get_backend_for_dirc C s& | j ¡ D ]}||jkr
|
| S q
|
dS )ú9
|
Return a VersionControl object or None.
|
N)r r r )rv r+ r© r, r, r- Úget_backend_for_scheme^ s
|
|
z!VcsSupport.get_backend_for_schemec C s | ¡ }| j |¡S )r )Úlowerr Úgetr¢ r, r, r- Ú get_backendh s zVcsSupport.get_backend)ro rp rq r r rw r r
r r r) r¡ r£ r¬ r® r± Ú __classcell__r, r, r r- r s
|
|
|
|
|
r c @ s@ e Zd ZdZdZdZdZdZdZe dd Z
|
e dd Z e dd Z e d
|
d Z ed d Zdd Ze d9ddZe dd Zdd Ze dd Ze dd Zedd Zd d Zed d Ze d d! Zd"d# Zd$d% Zd&d' Z e d(d) Z d*d+ Z d,d- Z e d.d/ Z e d0d1 Z!e d:d3d4Z"e d5d6 Z#e d7d8 Z$dS );ÚVersionControlr? 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{}:)r¯ Ú
|
startswithr0 r* )r Ú
|
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, ©r ri 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)r Ú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{}+{})r4 )Úget_remote_urlr¶ r0 r* r» r¸ r7 )r rº r3 r1 Úrevisionr4 r6 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)r2 r, r, r- r} ´ s z VersionControl.get_base_rev_argsc C s dS )aZ
|
Return true if the commit hash checked out at dest matches
|
the revision in url.
|
|
Always return False, if the VCS does not support immutable commit
|
hashes.
|
|
This method does not check if there are local uncommitted changes
|
in dest after checkout, as pip currently has no use case for that.
|
Fr, )rv ÚurlÚdestr, r, r- Úis_immutable_rev_checkout¿ s z(VersionControl.is_immutable_rev_checkoutc 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.
|
r )rr )r r2 rs r, r, r- r Í 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)
|
)rA rc Ú
|
splitdriver´ ÚsepÚbool)r ÚrepoÚdriveÚtailr, r, r- Ú_is_local_repositoryÙ 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.
|
Nr¿ ©rv ri rÁ r, r, r- Úexportã 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, )r Únetlocr+ r, r, r- Úget_netloc_and_authí s z"VersionControl.get_netloc_and_authc C s t |¡\}}}}}d|kr*td |¡| dd¡d }| ||¡\}}d}d|krx| dd¡\}}|sxtd |¡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 <vcs>+<protocol>://<url>, e.g. svn+http://myrepo/svn/MyApp#egg=MyAppé Nú@zyThe URL {!r} has an empty revision (after @) which is not supported. Include a revision after @ or remove @ from the URL.r? ) r ÚurlsplitÚ
|
ValueErrorr0 ÚsplitrÎ Úrsplitr Ú
|
urlunsplit) r rÁ r+ rÍ rc ÚqueryÚfragÚ user_passr2 r, r, r- Úget_url_rev_and_auth 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).
|
Nr )rÚ Úsecretr rÝ r r )
|
rv rÁ Ú
|
secret_urlr2 rÙ rÛ Úsecret_passwordrÜ rs Ú 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.
|
ú/)r ÚunquoterM ©rÁ r, r, r- Ú normalize_url8 s z VersionControl.normalize_urlc C s | |¡| |¡kS )zV
|
Compare two repo URLs for identity, ignoring incidental differences.
|
)ræ )r Úurl1Úurl2r, r, r- Ú compare_urlsA 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.
|
Nr¿ ©rv r rÁ rá r, r, r- Ú fetch_newI s
|
zVersionControl.fetch_newc C s t dS )z}
|
Switch the repo at ``dest`` to point to ``URL``.
|
|
Args:
|
rev_options: a RevOptions object.
|
Nr¿ rê r, r, r- ÚswitchU s zVersionControl.switchc C s t dS )z
|
Update an already-existing repo to the given ``rev_options``.
|
|
Args:
|
rev_options: a RevOptions object.
|
Nr¿ rê r, r, r- rD _ 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.
|
Nr¿ )r r r* r, r, r- Úis_commit_id_equali 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 kr&t d¡ |dkrZt
|
dt|¡ t| | |||¡ dS |dkrt|}t
|
dt||¡ t ||¡ | |||¡ dS |dkrÌ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? {}r rÐ Úaéÿÿÿÿrð z Deleting %srñ zBacking up %s to %srî zSwitching %s %s to %s%s) râ rA rc rd rë r Úis_repository_directoryr¼ ré rÞ rf r@ Ú repo_nameÚtitler rí r2 ÚinforD rg r* r r0 ÚsysÚexitr r ÚshutilÚmoverì ) rv r rÁ rá Ú rev_displayÚ existing_urlÚpromptÚresponseÚdest_dirr, r, r- Úobtainu 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)rA rc rd 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.
|
Nr¿ r· r, r, r- r¼ ß s z VersionControl.get_remote_urlc C s t dS )zR
|
Return the current commit id of the files at the given location.
|
Nr¿ r· r, r, r- r¹ ê s zVersionControl.get_revisionTc
|
C sn t | jf| }zt|||||dW S tk
|
rh } z&|jtjkrVtdjf t 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
|
)rT rU rV zWCannot find command {cls.name!r} - do you have {cls.name!r} installed and in your PATH?N) r r* rb ÚOSErrorÚerrnoÚENOENTr r0 Úlocals)r rS r: rT rU rV Ú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)...)rf r@ re r* rA rc rd rR )r rc r, r, r- rô s ÿz&VersionControl.is_repository_directoryc C s | |¡r|S dS )ay
|
Return the "root" (top-level) directory controlled by the vcs,
|
or `None` if the directory is not in any.
|
|
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.
|
N)rô r· r, r, r- r¥ s
|
z"VersionControl.get_repository_root)NN)NNNT)%ro rp rq r* re rõ r Ú unset_environr{ Ú classmethodr¶ r¸ r» r¾ Ú staticmethodr} rà r rÊ rÌ rÎ rÚ rÝ râ ræ ré rë rì rD rí r r r¼ r¹ r rô r¥ r, r, r, r- r³ t sl
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
^
|
|
|
ú
|
r³ )N)NNNT)Fr Ú
|
__future__r r ÚloggingrA rú rE rø Ú pip._vendorr Z pip._vendor.six.moves.urllibr r Úpip._internal.exceptionsr r r Úpip._internal.utils.compatr r Úpip._internal.utils.loggingr
|
Úpip._internal.utils.miscr r r r r r Ú pip._internal.utils.subprocessr r r r Úpip._internal.utils.typingr Úpip._internal.utils.urlsr Útypingr r r r r r r r r r r! r" r# ÚstrZAuthInfoÚ__all__Ú getLoggerro rf r. r7 rb rm rJ rn Úobjectrr r r$ r³ r, r, r, r- Ú<module> sH 4
|
|
û
|
V I^
|
