1jW > d Z ddlZddlZddlZddlZddlZddlmZm Z ddl
m Z m Z m
Z
mZmZmZmZmZmZmZmZ ddlmZ ddlmZmZ ddlm Z m Z m Z m Z m Z m!Z!m"Z"m#Z# ddl$m%Z%m&Z&m'Z'm(Z( d gZ) ej* e+ Z,eee- ee- f Z.d
e-d e/fd Z0 d!d
e-de-de-dee- d e-f
dZ1de-de-d ee- fdZ2 G d de3 Z4 G d de3 Z5 ed G d d Z6 G d d Z7 e7 Z8 G d d Z9dS )"z)Handles all VCS (version control) support N) dataclassfield) AnyDictIterableIteratorListLiteralMappingOptionalTupleTypeUnion)SpinnerInterface)
BadCommandInstallationError)
HiddenTextask_path_exists
backup_dir display_pathhide_url
hide_valueis_installable_dirrmtree) CommandArgscall_subprocessformat_command_args make_commandvcsnamereturnc x t j | j }|sdS |g dt j z v S )z3
Return true if the name looks like a URL.
F)httphttpsfileftp)urllibparseurlsplitschemer all_schemes)r r* s r/builddir/build/BUILD/cloudlinux-venv-1.0.11/venv/lib/python3.11/site-packages/pip/_internal/vcs/versioncontrol.pyis_urlr- 2 sB \
"
"4
(
(
/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/ r0 r1 r2 egg_project_namereqs r, make_vcs_requirement_urlr: < 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)r; r<
orig_location
last_locations r, (find_path_to_project_root_from_repo_rootrG N s M **
7??8,, } $ $
NN&
4 !**
w 8,, t
7??8Y / //r. c e Zd ZdS )RemoteNotFoundErrorN)__name__
__module__ __qualname__ r. r, rI rI k s Dr. rI c $ e Zd Zdef fd Z xZS )RemoteNotValidErrorurlc X t | || _ d S N)super__init__rP )selfrP __class__s r, rT z RemoteNotValidError.__init__p s&
r. )rJ rK rL strrT
__classcell__rV s @r, rO rO o sD C r. rO T)frozenc e Zd ZU dZed ed< dZee ed< e e
Z e ed< dZ
ee ed< d efd
Zed ee fd Zd e fd Zd efd
Zded d fdZdS )
RevOptionsz
Encapsulates a VCS-specific revision to install, along with any VCS
install options.
Args:
vc_class: a VersionControl subclass.
rev: the name of the revision to install.
extra_args: a list of extra options.
VersionControlvc_classNr0 )default_factory
extra_args branch_namer! c 2 d| j j d| j dS )Nz )r^ r r0 rU s r, __repr__zRevOptions.__repr__ s" Edm 0EEEEEEr. c 6 | j | j j S | j S rR )r0 r^ default_arg_revrd 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.
)rh r^ get_base_rev_argsr` )rU argsr0 s r, to_argszRevOptions.to_args s@ l ? DM33C88 8D r. c * | j sdS d| j dS )N z (to revision )r0 rd 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.
r` )r^ make_rev_optionsr` )rU r0 s r, make_newzRevOptions.make_new s! }--cdo-NNNr. )rJ rK rL __doc__r __annotations__r0 r rW r listr` r ra re propertyrh rl rq ru rM r. r, r\ r\ u s$ #$$$$ C# #eD 9 9 9J 999!%K# %%%F# F F F F # X
,C , , , , OC OL O O O O O Or. r\ 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 )
VcsSupportr] _registry)sshgithgbzrsftpsvnr! Nc t j j | j t d S rR )r' r( uses_netlocextendschemesrS rT )rU rV s r, rT zVcsSupport.__init__ s< '' 555
r. c 4 | j S rR )r| __iter__rd s r, r zVcsSupport.__iter__ s ~&&(((r. c N t | j S rR )rx r| valuesrd s r, backendszVcsSupport.backends s DN))++,,,r. c $ d | j D S )Nc g | ] }|j
S rM )r@ ).0backends r,
z'VcsSupport.dirnames.. s ===G===r. )r rd s r, dirnameszVcsSupport.dirnames s ==t}====r. c R g }| j D ] }| |j |S rR )r r r )rU 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)hasattrrA rB rJ r r| debug)rU 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 rR )r| rU r s r,
unregisterzVcsSupport.unregister s' 4> ! !t$$$ " !r. r; 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)r| r get_repository_rootrA r r maxlen)rU r; 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 )lowerr| getr s r, get_backendzVcsSupport.get_backend s' zz||~!!$'''r. )r! N)rJ rK rL r| r rW rw r rT r r ry r r r r+ r r r r r r r rX rY s @r, r{ r{ 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. r{ 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
dCde 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'e#d df
d(Z$dede d&ed dfd)Z%dede d&ed dfd*Z&e
ded+e e d efd, Z'dede d'e#d dfd-Z(d ede d'e#d dfd.Z)e
d ed efd/ Z*e
d ed efd0 Z+e
dDd4e,ee ef d5ed6e e d7d8d9e e-e# d:e e d;e e.ee/f ded efd? Z1e
d@ed efdA Z2e
d ed e e fdB Z3dS )Er] rn rM .r
unset_environNrg
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. r; 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.
NrM r r; 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. r1 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}
+)r2 )get_remote_urlr r r r r: )r r r1 r/ revisionr2 r9 s r, get_src_requirementz"VersionControl.get_src_requirement s %%h// ( ( 2 2 0 (//X//H//99%%h//&x r?
splitdriver sepbool)r r drivetails r, _is_local_repositoryz#VersionControl._is_local_repository\ s> 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)).
NNrM )r r r* s r, get_netloc_and_authz"VersionControl.get_netloc_and_authe s & |##r. c t j | \ }}}}}d|vrt d|d | dd d }| || \ }}d}d|v r.| dd \ }}|st d|d t j ||||d f }|||fS )
z
Parse the repository URL to use, and return the URL, revision,
and auth info to use.
Returns: (url, rev, (username, password)).
r zSorry, zk is a malformed VCS url. The format is +://, e.g. svn+http://myrepo/svn/MyApp#egg=MyApp Nr6 zThe URL zm has an empty revision (after @) which is not supported. Include a revision after @ or remove @ from the URL.rn ) r' r( r)
ValueErrorsplitr rsplitr
urlunsplit) r rP r* r r? queryfrag user_passr0 s r, get_url_rev_and_authz#VersionControl.get_url_rev_and_authz s -3L,A,A#,F,F)eT f =# = = =
c1%%a( 3 3FF C C $;; C++ID#
'0s 0 0 0
l%%vvtUB&GHHC""r. usernamepasswordc g S )zM
Return the RevOptions "extra arguments" to use in obtain().
rM )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).
Nrs )r secretr r rt r )
rU rP
secret_urlr0 r r secret_passwordr r` 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( unquoterstrip)rP 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 verbosityc t )a
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.
verbosity: verbosity level.
r )rU r rP r r s r, fetch_newzVersionControl.fetch_new s
"!r. c t )z}
Switch the repo at ``dest`` to point to ``URL``.
Args:
rev_options: a RevOptions object.
r rU r rP 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 s
"!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
}|dk rt- j d |dk rRt dt | t1 | | |||| dS |dk rht3 | } t dt | | t5 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.
:param verbosity: verbosity level.
)r 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 %sz
What to do? r r ar z Deleting %sr zBacking up %s to %sr zSwitching %s %s to %s%s) r r> r? existsr rq is_repository_directoryr r r rA r repo_nametitler r r0 infor rB r r sysexitr r shutilmover )
rU r rP r r rev_display existing_urlpromptresponsedest_dirs
r, obtainzVersionControl.obtain s0 33C88[w~~d## NN4kYN G G G F!,,.. ' ' - - % F ..t44L sz::
?N((** && ..t[_EE HKK*$T** # KKc;7777KK FGGG NN0 T""
UFF NNB
FF 9 I
##>6!9#>#>q JJ s?? HRLLL s?? NN=,t*<*< = = = 4LLL NN4kYN G G G F s??!$''H NN0,t2D2Dh O O O Kh ' ' ' NN4kYN G G G 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.
:param verbosity: verbosity level.
)rP r N)r> r? r r r )rU r; rP r s r, unpackzVersionControl.unpackC sF 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_urlO r r. c t )zR
Return the current commit id of the files at the given location.
r r s r, r zVersionControl.get_revisionY s
"!r. TraiseFcmd show_stdoutcwd
on_returncodez"Literal["raise", "warn", "ignore"]extra_ok_returncodes command_desc
extra_environspinnerlog_failed_cmd stdout_onlyc
h t | j g|R }|t | } t |||||||| j || |
S # t
$ r t
d| j d 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
N)r r r r r r r r zCannot find command z - invalid PATHz - 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 r NotADirectoryErrorr FileNotFoundErrorPermissionError) r r r r r r r r r r r s r, run_commandzVersionControl.run_command` s7 & 38*c*** .s33L" " +%9 ) + ! / - '
" Q Q Q OCH O O OPP P r? r join)r r? s r, r z&VersionControl.is_repository_directory sG
4dCKRRRw~~bgll4 = =>>>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. r ) TNr NNNNTF)4rJ rK rL r r@ r r r
rW rw r rg r classmethodr r r r r staticmethodr rj r r r\ rt r r AuthInfor r r r r r intr r r r r r r r r r r r r r$ r r rM r. r, r] r] sO
DGI !GU38_!!!%'M5c?'''%)OXc])))A3 A4 A A A [A
[ * * * * * [* 3 c c [. "s "tCy " " " \" S LP
A
A3-
A4<[4I
A
A
A
A [
A ; ; ; ; ; [; $$"%$ sE(3-# 677 8$ $ $ [$( #s #uS(3-5Q/R # # # [#: 3-+3J+? \
1z
1eJ
E8<&*59.2 # !7 7
49k)
*7 7 c] 7
< 7 'x} 5
7 sm7 S 127 *+7 7 7
7 7 7 [7r ?3 ?4 ? ? ? [?
3
8C=
[
r. r] rR ):rv loggingr> r r urllib.parser' dataclassesr r 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 r __all__ getLoggerrJ rA rW r* r r- r: rG ExceptionrI rO r\ r{ r r] rM r. r, r7 s / /
( ( ( ( ( ( ( ( 8 7 7 7 7 7 B B B B B B B B '
8 $ $ #
- .H H H H H H IM +.8@
$00 !0
c]0 0 0 0: ) ) $3O 3O 3O 3O 3O 3O 3O 3OlM( M( M( M( M( M( M( M(` jllq q q q q q q q q qr.