Q[ d Z ddlmZ ddlZddlZddlZddlZddlZddl m
Z
m Z m Z ddl
mZmZ ddlmZmZmZ ddlmZ ddlmZmZ dd lmZmZm Z m Z m Z m Z m Z m!Z! dd
l"m#Z#m$Z$m%Z%m&Z& d gZ' ej( e) Z*e+ee, ee, f Z-d&dZ. d'd(dZ/d)dZ0 G d de1 Z2 G d d e1 Z3 ed G d d! Z4 G d" d# Z5 e5 Z6 G d$ d% Z7dS )*z)Handles all VCS (version control) support ) annotationsN)IterableIteratorMapping) dataclassfield)AnyLiteralOptional)SpinnerInterface)
BadCommandInstallationError)
HiddenTextask_path_exists
backup_dir display_pathhide_url
hide_valueis_installable_dirrmtree) CommandArgscall_subprocessformat_command_args make_commandvcsnamestrreturnboolc 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.10/venv/lib/python3.11/site-packages/pip/_internal/vcs/versioncontrol.pyis_urlr+ - sB \
"
"4
(
(
/F u 555G GG repo_urlrev project_namesubdir
str | Nonec 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/ r0 egg_project_namereqs r* make_vcs_requirement_urlr9 7 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_rootrF I s M **
7??8,, } $ $
NN&
4 !**
w 8,, t
7??8Y / //r, c e Zd ZdS )RemoteNotFoundErrorN)__name__
__module__ __qualname__ r, r* rH rH f s Dr, rH c e Zd Zd fd Z xZS )RemoteNotValidErrorurlr c X t | || _ d S N)super__init__rO )selfrO __class__s r* rS z RemoteNotValidError.__init__k s&
r, )rO r )rI rJ rK rS
__classcell__rU s @r* rN rN j s= r, rN T)frozenc e Zd ZU dZded< dZded< ee Zded < dZ ded
< dd
Z
e dd Z ddZ
ddZddZdS )
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.
type[VersionControl]vc_classNr1 r. )default_factoryr
extra_args branch_namer r c 2 d| j j d| j dS )Nz )r\ r r. rT s r* __repr__zRevOptions.__repr__ s" Edm 0EEEEEEr, c 6 | j | j j S | j S rQ )r. r\ default_arg_revrb 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.
)rf r\ get_base_rev_argsr^ )rT argsr. s r* to_argszRevOptions.to_args s@ l ? DM33C88 8D r, c * | j sdS d| j dS )N z (to revision )r. rb 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^ )rT r. s r* make_newzRevOptions.make_new s! }--cdo-NNNr, )r r )r r1 )r r )r. r r rZ )rI rJ rK __doc____annotations__r. r listr^ r_ rc propertyrf rj ro rs rL r, r* rZ rZ p s #"""C #eD 9 9 9J9999 "K""""F F F F X
, , , , O O O O O Or, rZ c e Zd ZU i Zded< g dZd fd ZddZed d
Z ed d Z
ed d
Z d dZ d dZ
d dZd!dZd"dZ xZS )#
VcsSupportzdict[str, VersionControl] _registry)sshgithgbzrsftpsvnr Nonec t j j | j t d S rQ )r% r& uses_netlocextendschemesrR rS )rT rU s r* rS zVcsSupport.__init__ s< '' 555
r,
Iterator[str]c 4 | j S rQ )rz __iter__rb s r* r zVcsSupport.__iter__ s ~&&(((r, list[VersionControl]c N t | j S rQ )rv rz valuesrb s r* backendszVcsSupport.backends s DN))++,,,r, list[str]c $ d | j D S )Nc g | ] }|j
S rL )r? ).0backends r*
z'VcsSupport.dirnames.. s ===G===r, )r rb s r* dirnameszVcsSupport.dirnames s ==t}====r, c R g }| j D ] }| |j |S rQ )r r r )rT r r s r* r) zVcsSupport.all_schemes s4 } , ,G NN7? + + + +r, clsr[ c 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@ rA rI r rz debug)rT r s r* registerzVcsSupport.register sx sF## NN3S\ B B B F 84> ) )'*suuDN38 $ LL5sx @ @ @ @ @ * )r, r r c , || j v r
| j |= d S d S rQ )rz rT r s r*
unregisterzVcsSupport.unregister s' 4> ! !t$$$ " !r, r: VersionControl | Nonec 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)rz r get_repository_rootr@ r r maxlen)rT 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 )lowerrz getr s r* get_backendzVcsSupport.get_backend s' zz||~!!$'''r, )r r )r r )r r )r r )r r[ r r )r r r r )r: r r r )r( r r r )r r r r )rI rJ rK rz ru r rS r rw r r r) r r r r r rV rW s @r* ry ry s7 +-I----888G ) ) ) ) - - - X- > > > X> X A A A A% % % %2 2 2 2. ( ( ( ( ( ( ( (r, ry c N e Zd ZU dZdZdZdZded< dZded< dZ ded< e
dVd
Z e
dWd Z e
dXd Z
e
dYd ZedZd Zd[dZe
d\d]d Ze
d^d Ze
d_d# Ze
d`d% Zedad* Zdbd-Zedcd. Ze
ddd1 Zded6Z dfded8Z dfded9Z e
dgd; Z dhd<Z did=Z e
djd> Z e
djd? Z!e
dkdldR Z"e
dmdT Z#e
dWdU Z$dS )nVersionControlrl rL ztuple[str, ...]r
unset_environNr1 re
remote_urlr r r 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.
NrL 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, 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}
+)r0 )get_remote_urlr r r r r9 )r r r/ r- revisionr0 r8 s r* get_src_requirementz"VersionControl.get_src_requirement s %%h// ( ( 2 2 0 (//X//H//99%%h//&x
splitdriver sepr )r r drivetails r* _is_local_repositoryz#VersionControl._is_local_repositoryW s> g((.. trw{++:tE{{:r, netlocr( )tuple[str, tuple[str | None, str | None]]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)).
NNrL )r r r( s r* get_netloc_and_authz"VersionControl.get_netloc_and_auth` s & |##r, tuple[str, str | None, AuthInfo]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 Nr5 zThe URL zm has an empty revision (after @) which is not supported. Include a revision after @ or remove @ from the URL.rl ) r% r& r'
ValueErrorsplitr rsplitr
urlunsplit) r rO r( r r> queryfrag user_passr. s r* get_url_rev_and_authz#VersionControl.get_url_rev_and_authu s -3L,A,A#,F,F)eT f =# = = =
c1%%a( 3 3FF C C $;; C++ID#
'0s 0 0 0
l%%vvtUB&GHHC""r, usernamepasswordHiddenText | Noner c g S )zM
Return the RevOptions "extra arguments" to use in obtain().
rL )r r s r*
make_rev_argsz VersionControl.make_rev_args s
r, r tuple[HiddenText, RevOptions]c | |j \ }}}|\ }}d}|t | }| || }| || } t | | fS )zq
Return the URL and RevOptions object to use in obtain(),
as a tuple (url, rev_options).
Nrq )r secretr r rr r )
rT rO
secret_urlr. 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)rO 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 verbosityintr c 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 rT r rO r r s r* fetch_newzVersionControl.fetch_new s
"!r, 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 s
"!r, c | | \ }}t j | s| |||| dS | }| | r)| | }| ||j rt d| j
t | | | ||j sIt 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 rKt 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 ro is_repository_directoryr r r r@ r repo_nametitler r r. infor rA r r sysexitr r shutilmover )
rT r rO r r rev_display existing_urlpromptresponsedest_dirs
r* obtainzVersionControl.obtain s8 33C88[w~~d## NN4kYN G G G F!,,.. ' ' - - % F ..t44L sz::
?N((** && ..t[_EE HKK*$T** # KKc;)KLLLLKK 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;)K D D D D D ?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.
)rO r N)r= r> r r r )rT r: rO r s r* unpackzVersionControl.unpackH 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_urlT r r, c t )zR
Return the current commit id of the files at the given location.
r r s r* r zVersionControl.get_revision^ s
"!r, TraiseFcmdlist[str] | CommandArgs show_stdoutcwd
on_returncode"Literal['raise', 'warn', 'ignore']extra_ok_returncodesIterable[int] | None command_desc
extra_environMapping[str, Any] | NonespinnerSpinnerInterface | Nonelog_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_commande s7 & 38*c*** .s33L" " +%9 ) + ! / - '
" Q Q Q OCH O O OPP P c t d|| j | j t j t j || j S )zL
Return whether a directory path is a repository directory.
z Checking in %s for %s (%s)...)r@ r r? r r= 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 r r r )r: r r r1 )r r r r )r r r/ r r r )r. r r r )rO r r r r r r )r. r1 r^ r r rZ )r r r r )r r r( r r r )rO r r r )r r1 r r r r )rO r r r )rO r r r )r r r r r r )
r r rO r r rZ r r r r )r )r r r r1 r r )r r rO r r r r r )r: r rO r r r r r )r: r r r ) TNr NNNNTF)r r r! r r" r1 r# r$ r% r& r' r1 r( r) r* r+ r, r r- r r r )r> r r r )%rI rJ rK r r? r
r ru r re classmethodr r r r staticmethodrh r rr r r r r r r r r r r r r r r r r2 r r rL r, r* r r sw
DGI !G!!!!%'M''''"&O&&&&A A A [A [ * * * [* [. " " " \" FJ
A
A
A
A [
A ; ; ; [; $ $ $ [$( # # # [#: \
1
1
1
1 5 5 5 \5 B B B [B " " " "&
"
"
"
"
"(
"
"
"
"
" " " " ["WE WE WE WEr
<
<
<
< " " " [" " " " [" ! rG s / / " " " " " "
7 7 7 7 7 7 7 7 7 7 ( ( ( ( ( ( ( ( 8 7 7 7 7 7 B B B B B B B B '
8 $ $ #
- .H H H H FJ $0 0 0 0: ) ) $3O 3O 3O 3O 3O 3O 3O 3OlM( M( M( M( M( M( M( M(` jll{ { { { { { { { { {r,