f c " d Z ddlZddlZddlZddlZddlZddlmZm Z m
Z
m Z m Z m
Z
mZmZmZmZmZ ddlmZ ddlmZmZ ddlmZmZmZm Z m Z m Z m Z m Z ddl!m"Z"m#Z#m$Z$ ddl%m&Z& erdd lm'Z' d
gZ( ej) e* Z+eee, ee, f Z-d e,d e.fd
Z/ d de,de,de,dee, d e,f
dZ0de,de,d ee, fdZ1 G d de2 Z3 G d de2 Z4 G d d Z5 G d d Z6 e6 Z7 G d d Z8dS )!z)Handles all VCS (version control) support N)
TYPE_CHECKINGAnyDictIterableIteratorListMappingOptionalTupleTypeUnion)SpinnerInterface)
BadCommandInstallationError)
HiddenTextask_path_exists
backup_dir display_pathhide_url
hide_valueis_installable_dirrmtree) CommandArgscall_subprocess make_command)get_url_scheme)Literalvcsnamereturnc N t | }|dS |g dt j z v S )z3
Return true if the name looks like a URL.
NF)httphttpsfileftp)r r all_schemes)r schemes /builddir/build/BUILDROOT/alt-python311-pip-21.3.1-4.el9.x86_64/opt/alt/python311/lib/python3.11/site-packages/pip/_internal/vcs/versioncontrol.pyis_urlr) 4 s4 D
!
!F
~u 555G GG repo_urlrev project_namesubdirc Z | dd }| d| d| }|r|d| z
}|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=)replace)r+ r, r- r. egg_project_namereqs r( make_vcs_requirement_urlr6 > sV $++C55
4
4
4
4"2
4
4C
) (((( Jr* location repo_rootc N | }t | sS| }t j | } | |k r t d| dS t | St j || rdS t j | | S )z
Find the the Python project's root by searching up the filesystem from
`location`. Return the path to project root relative to `repo_root`.
Return None if the project root is `repo_root`, or cannot be found.
zOCould not find a Python project for directory %s (tried all parent directories)N)r ospathdirnameloggerwarningsamefilerelpath)r7 r8
orig_location
last_locations r( (find_path_to_project_root_from_repo_rootrC P s M **
7??8,, } $ $
NN&
4 !**
w 8,, t
7??8Y / //r* c e Zd ZdS )RemoteNotFoundErrorN)__name__
__module__ __qualname__ r* r( rE rE m s Dr* rE c $ e Zd Zdef fd Z xZS )RemoteNotValidErrorurlc X t | || _ d S N)super__init__rL )selfrL __class__s r( rP z RemoteNotValidError.__init__r s&
r* )rF rG rH strrP
__classcell__rR s @r( rK rK q sD C r* rK c e Zd ZdZ dded dee dee ddfdZdefd Z e
dee fd
Z defd Z defd Z
dedd fd
ZdS )
RevOptionsz
Encapsulates a VCS-specific revision to install, along with any VCS
install options.
Instances of this class should be treated as if immutable.
Nvc_classVersionControlr,
extra_argsr c F |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)rZ r, rX branch_name)rQ rX r, rZ s r( rP zRevOptions.__init__ s2 J$
*.r* c 2 d| j j d| j dS )Nz )rX r r, rQ s r( __repr__zRevOptions.__repr__ s" Edm 0EEEEEEr* c 6 | j | j j S | j S rN )r, rX default_arg_revr_ s r( arg_revzRevOptions.arg_rev s 8 =0 0xr* c j g }| j }| || j | z
}|| j z
}|S )z<
Return the VCS-specific command arguments.
)rc rX get_base_rev_argsrZ )rQ argsr, s r( to_argszRevOptions.to_args s@ l ? DM33C88 8D r* c * | j sdS d| j dS )N z (to revision )r, r_ s r(
to_displayzRevOptions.to_display s$ x 2+++++r* c D | j || j 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.
rZ )rX make_rev_optionsrZ )rQ r, s r( make_newzRevOptions.make_new s! }--cdo-NNNr* NN)rF rG rH __doc__r r
rS r rP r` propertyrc rg rl rp rI r* r( rW rW w s ",0 / /'(/ c]/ [) /
/ / / /(F# F F F F # X
,C , , , , OC OL O O O O O Or* rW c X e Zd ZU i Zeedf ed< g dZd fd Zde e fdZ
e de d fd Z
e de e fd Ze de e fd
Zd ed ddfd Zd
eddfdZdeded fdZdeded fdZd
eded fdZ xZS )
VcsSupportrY _registry)sshgithgbzrsftpsvnr Nc t j j | j t d S rN )urllibparse uses_netlocextendschemesrO rP )rQ rR s r( rP zVcsSupport.__init__ s< '' 555
r* c 4 | j S rN )rv __iter__r_ s r( r zVcsSupport.__iter__ s ~&&(((r* c N t | j S rN )listrv valuesr_ s r( backendszVcsSupport.backends s DN))++,,,r* c $ d | j D S )Nc g | ] }|j
S rI )r< ).0backends r(
z'VcsSupport.dirnames.. s ===G===r* )r r_ s r( dirnameszVcsSupport.dirnames s ==t}====r* c R g }| j D ] }| |j |S rN )r r r )rQ r r s r( r& zVcsSupport.all_schemes s4 } , ,G NN7? + + + +r* clsc t |d s"t d|j d S |j | j vr9 | | j |j < t d|j d S d S )Nr zCannot register VCS %szRegistered VCS backend: %s)hasattrr= r> rF r rv debug)rQ r s r( registerzVcsSupport.register sx sF## NN3S\ B B B F 84> ) )'*suuDN38 $ LL5sx @ @ @ @ @ * )r* r c , || j v r
| j |= d S d S rN )rv rQ r s r(
unregisterzVcsSupport.unregister s' 4> ! !t$$$ " !r* r7 c i }| j D ]@}| | }|st d||j |||< A|sdS t
|t }|| 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)rv r get_repository_rootr= r r maxlen)rQ r7 vcs_backends vcs_backend repo_pathinner_most_repo_paths r( get_backend_for_dirz VcsSupport.get_backend_for_dir s
>0022 2 2K#77AAI
LL98[EU V V V&1L # # 4 #0022 # #K,,,"""" -tr* c ^ | }| j | S )r )lowerrv getr s r( get_backendzVcsSupport.get_backend s' zz||~!!$'''r* )r N)rF rG rH rv r rS __annotations__r rP r r rs r r r r& r r r r
r r r rT rU s @r( ru ru s -/ItC))*///888G )(3- ) ) ) ) -$ /0 - - - X- >$s) > > > X> T#Y X AD!1 2 At A A A A%s %t % % % %2C 2H=M4N 2 2 2 2.S X>N5O ( (1A(B ( ( ( ( ( ( ( (r* ru c e Zd ZU dZdZdZdZeedf e d< dZ
eedf e d< dZ e e e d< e
ded efd
Ze
d ed e e fd Ze
d
ed efd Ze
d
eded efd Zeded ee fd Zdeded efdZe
dBde e de e d efd Ze
ded efd Ze
deded eeee e e e f f fd Ze
ded eee e e f fd Z ed e e d e e d efd Z de d ee ef fd!Z eded efd" Z!e
d#ed$ed efd% Z"dede d&ed dfd'Z#dede d&ed dfd(Z$dede d&ed dfd)Z%e
ded*e e d efd+ Z&dede d dfd,Z'd ede d dfd-Z(e
d ed efd. Z)e
d ed efd/ Z*e
dCd3e+ee ef d4ed5e e d6d7d8e e,e- d9e e d:e e.ee/f d;e e0 d Z1e
d?ed efd@ Z2e
d ed e e fdA Z3dS )DrY ri rI .r
unset_environNrb
remote_urlr c b | | j d S )z
Return whether the vcs prefix (e.g. "git+") should be added to a
repository's remote url when used in a requirement.
:)r
startswithr )r r s r( should_add_vcs_url_prefixz(VersionControl.should_add_vcs_url_prefix s/ ##%%00CH @@@@r* r7 c dS )z
Return the path to Python project root, relative to the repo root.
Return None if the project root is in the repo root.
NrI r r7 s r( get_subdirectoryz VersionControl.get_subdirectory s tr* repo_dirc , | | S )zR
Return the revision string that should be used in a requirement.
) get_revision)r r s r( get_requirement_revisionz'VersionControl.get_requirement_revision' s
)))r* r- c | | }| | r | j d| }| | }| | }t |||| }|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}
+)r. )get_remote_urlr r r r r6 )r r r- r+ revisionr. r5 s r( get_src_requirementz"VersionControl.get_src_requirement. s %%h// ( ( 2 2 0 (//X//H//99%%h//&x g((.. trw{++:tE{{:r* netlocr' c
|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)).
rq rI )r r r' s r( get_netloc_and_authz"VersionControl.get_netloc_and_auths s & |##r* c t j | \ }}}}}d|vr"t d | | dd d }| || \ }}d}d|v r=| dd \ }}|s"t d | t j ||||df }|||fS )z
Parse the repository URL to use, and return the URL, revision,
and auth info to use.
Returns: (url, rev, (username, password)).
r zvSorry, {!r} is a malformed VCS url. The format is +://, e.g. svn+http://myrepo/svn/MyApp#egg=MyApp Nr2 zyThe URL {!r} has an empty revision (after @) which is not supported. Include a revision after @ or remove @ from the URL.ri )
r~ r urlsplit
ValueErrorformatsplitr rsplitr
urlunsplit) r rL r' r r; queryfrag user_passr, s r( get_url_rev_and_authz#VersionControl.get_url_rev_and_auth s -3L,A,A#,F,F)eT f ==CVC[[
c1%%a( 3 3FF C C $;; C++ID#
'006s
l%%vvtUB&GHHC""r* usernamepasswordc g S )zM
Return the RevOptions "extra arguments" to use in obtain().
rI )r r s r(
make_rev_argsz VersionControl.make_rev_args s r* c | |j \ }}}|\ }}d}|t | }| || }| || } t | | fS )zq
Return the URL and RevOptions object to use in obtain(),
as a tuple (url, rev_options).
Nrn )r secretr r ro r )
rQ rL
secret_urlr, r r secret_passwordr rZ rev_optionss
r( get_url_rev_optionsz"VersionControl.get_url_rev_options s
&*%>%>sz%J%J"
C$-!/)- &!/22H''(;;
++CJ+GG
##[00r* c f t j | d S )zi
Normalize a URL for comparison by unquoting it and removing any
trailing slash.
/)r~ r unquoterstriprL s r(
normalize_urlz VersionControl.normalize_url s( |##C((//444r* url1url2c Z | | | | k S )zV
Compare two repo URLs for identity, ignoring incidental differences.
)r )r r r s r( compare_urlszVersionControl.compare_urls s+
&&#*;*;D*A*AAAr* r c t )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.
r rQ r rL r s r( fetch_newzVersionControl.fetch_new
"!r* c t )z}
Switch the repo at ``dest`` to point to ``URL``.
Args:
rev_options: a RevOptions object.
r r s r( switchzVersionControl.switch
"!r* c t )z
Update an already-existing repo to the given ``rev_options``.
Args:
rev_options: a RevOptions object.
r r s r( updatezVersionControl.update r r* r c t )z
Return whether the id of the current commit equals the given name.
Args:
dest: the repository directory.
name: a string name.
r )r r r s r( is_commit_id_equalz!VersionControl.is_commit_id_equal r r* c | | \ }}t j | s| ||| dS | }| | r'| | }| ||j rt d| j
t | | | ||j sGt dt | | j | | ||| nt d dS t d| j | j t | | d}n)t d|| j | j d}t d | j | t+ d
|d |d }|d
k rt/ j d |dk rPt dt | t3 | | ||| dS |dk rft5 | }t dt | | t7 j || | ||| dS |dk rIt d| j t | || | ||| dS 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? {}r r ar z Deleting %sr zBacking up %s to %sr zSwitching %s %s to %s%s) r r: r; existsr rl is_repository_directoryr r r r= r repo_nametitler r r, infor r> r r r sysexitr r shutilmover ) rQ r rL r rev_display existing_urlpromptresponsedest_dirs r( obtainzVersionControl.obtain s* 33C88[w~~d## NN4k 2 2 2 F!,,.. ' ' - - % F ..t44L sz::
?N((** && ..t[_EE HKK*$T** # KKc;7777KK FGGG NN0 T""
UFF NNB
FF 9 I
##4#;#;F1I#F#Fq RR s?? HRLLL s?? NN=,t*<*< = = = 4LLL NN4k 2 2 2 F s??!$''H NN0,t2D2Dh O O O Kh ' ' ' NN4k 2 2 2 F s?? KK) T""
KKc; / / / / / ?r* c t j | rt | | || 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 )rQ r7 rL s r( unpackzVersionControl.unpackM sD 7>>( # # 8 H# &&&&&r* c t )z
Return the url used at location
Raises RemoteNotFoundError if the repository does not have a remote
url configured.
r r s r( r z VersionControl.get_remote_urlX r r* c t )zR
Return the current commit id of the files at the given location.
r r s r( r zVersionControl.get_revisionb s
"!r* TraiseFcmd show_stdoutcwd
on_returncodez"Literal["raise", "warn", "ignore"]extra_ok_returncodes command_desc
extra_environspinnerlog_failed_cmd stdout_onlyc
t | j g|R } t |||||||| j || |
S # t $ r! t d| j d| j d t $ r t d| j d w xY w)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
)r r r r r r r r zCannot find command z - do you have z installed and in your PATH?zNo permission to execute z - install it locally, globally (ask admin), or check your PATH. See possible solutions at https://pip.pypa.io/en/latest/reference/pip_freeze/#fixing-permission-denied.)r r r r FileNotFoundErrorr PermissionError) r r r r r r r r r r r s r( run_commandzVersionControl.run_commandi s & 38*c*** " +%9 ) + ! / - '
! >>r* c 4 | | 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 s r( r z"VersionControl.get_repository_root s$ & &x 0 0 Otr* rq ) TNr NNNNTF)4rF rG rH r r< r r r rS r r rb r
classmethodr r r r r staticmethodr re r r rW ro r r AuthInfor r r r r r r r r r r r r r r
r intr r r r# r r rI r* r( rY rY
s-
DGI !GU38_!!!%'M5c?'''%)OXc])))A3 A4 A A A [A
[ * * * * * [* 3 c c [. "s "tCy " " " \" S LP
;
;3-
;4<[4I
;
;
;
; [
; ; ; ; ; ; [; $$"%$ sE(3-# 677 8$ $ $ [$( #s #uS(3-5Q/R # # # [#: 3-+3J+? \
1z
1eJ
E8<&*59.2 # !3 3
49k)
*3 3 c] 3
< 3 'x} 5
3 sm3 S 123 *+3 3 3
3 3 3 [3j ?3 ?4 ? ? ? [?
3
8C=
[
r* rY rN )9rr loggingr: r r urllib.parser~ typingr r r r r r r r
r r r
pip._internal.cli.spinnersr pip._internal.exceptionsr r pip._internal.utils.miscr r r r r r r r pip._internal.utils.subprocessr r r pip._internal.utils.urlsr r __all__ getLoggerrF r= rS r) r r) r6 rC ExceptionrE rK rW ru r rY rI r* r( r6 s{ / /
8 7 7 7 7 7 B B B B B B B B V U U U U U U U U U 3 3 3 3 3 3 '
8 $ $ #
- .H H H H H H IM +.8@
$00 !0
c]0 0 0 0: ) ) @O @O @O @O @O @O @O @OFM( M( M( M( M( M( M( M(` jllh h h h h h h h h hr*