zk//: 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 /builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/pip/_internal/vcs/versioncontrol.pyis_urlr+ - sB \
"
"4
(
(
/F u 555G GG repo_urlrev project_namesubdir
str | Nonec t j |d }| 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=)r% r& quotereplace)r- r. r/ r0
quoted_revegg_project_namereqs r* make_vcs_requirement_urlr< 7 sm ##C--J#++C55
;
;
;
;)9
;
;C
) (((( 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_rootrI J s M **
7??8,, } $ $
NN&
4 !**
w 8,, t
7??8Y / //r, c e Zd ZdS )RemoteNotFoundErrorN)__name__
__module__ __qualname__ r, r* rK rK g s Dr, rK c e Zd Zd fd Z xZS )RemoteNotValidErrorurlr c X t | || _ d S N)super__init__rR )selfrR __class__s r* rV z RemoteNotValidError.__init__l s&
r, )rR r )rL rM rN rV
__classcell__rX s @r* rQ rQ k s= r, rQ 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. rW s r* __repr__zRevOptions.__repr__ s" Edm 0EEEEEEr, c 6 | j | j j S | j S rT )r. r_ default_arg_revre 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.
)ri r_ get_base_rev_argsra )rW argsr. s r* to_argszRevOptions.to_args s@ l ? DM33C88 8D r, c * | j sdS d| j dS )N z (to revision )r. re 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.
ra )r_ make_rev_optionsra )rW r. s r* make_newzRevOptions.make_new s! }--cdo-NNNr, )r r )r r1 )r r )r. r r r] )rL rM rN __doc____annotations__r. r listra rb rf propertyri rm rr rv rO r, r* r] r] q s #"""C #eD 9 9 9J9999 "K""""F F F F X
, , , , O O O O O Or, r] 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 rT )r% r& uses_netlocextendschemesrU rV )rW rX s r* rV zVcsSupport.__init__ s< '' 555
r,
Iterator[str]c 4 | j S rT )r} __iter__re s r* r zVcsSupport.__iter__ s ~&&(((r, list[VersionControl]c N t | j S rT )ry r} valuesre s r* backendszVcsSupport.backends s DN))++,,,r, list[str]c $ d | j D S )Nc g | ] }|j
S rO )rB ).0backends r*
z'VcsSupport.dirnames.. s ===G===r, )r re s r* dirnameszVcsSupport.dirnames s ==t}====r, c R g }| j D ] }| |j |S rT )r r r )rW 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)hasattrrC rD rL r r} debug)rW 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 rT )r} rW 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)r} r get_repository_rootrC r r maxlen)rW 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 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 )rL rM rN r} rx r rV r rz r r r) r r r r r rY rZ s @r* r| r| s7 +-I----888G ) ) ) ) - - - X- > > > X> X A A A A% % % %2 2 2 2. ( ( ( ( ( ( ( (r, r| 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 )nVersionControlro rO ztuple[str, ...]r
unset_environNr1 rh
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.
NrO 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 r< )r r r/ r- revisionr0 r; s r* get_src_requirementz"VersionControl.get_src_requirement s %%h// ( ( 2 2 0 (//X//H//99%%h//&x s ur, ra CommandArgs | Noner] c * t | ||pg S )z
Return a RevOptions object.
Args:
rev: the name of a revision to install.
extra_args: a list of extra options.
rt )r] )r r. ra s r* ru z VersionControl.make_rev_optionsK s #sz/?R@@@@r, repoc t j | \ }}| t j j pt | S )zs
posix absolute paths start with os.path.sep,
win32 ones start with drive (like c:\folder)
)r@ rA
splitdriver sepr )r r drivetails r* _is_local_repositoryz#VersionControl._is_local_repositoryX 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)).
NNrO )r r r( s r* get_netloc_and_authz"VersionControl.get_netloc_and_autha s & |##r, tuple[str, str | None, AuthInfo]c t j | \ }}}}}d|vrt d|d | dd d }| || \ }}d}d|v rM| dd \ }}|st d|d t j | }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.ro )
r% r& r'
ValueErrorsplitr rsplitr unquote
urlunsplit) r rR r( r rA queryfrag user_passr. s r* get_url_rev_and_authz#VersionControl.get_url_rev_and_authv s$ -3L,A,A#,F,F)eT f =# = = =
c1%%a( 3 3FF C C $;; C++ID#
'0s 0 0 0
,&&s++Cl%%vvtUB&GHHC""r, usernamepasswordHiddenText | Noner c g S )zM
Return the RevOptions "extra arguments" to use in obtain().
rO )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).
Nrt )r secretr r ru r )
rW rR
secret_urlr. r r secret_passwordr ra 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.
r3 )r% r& r rstrip)rR 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 rW r rR 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@ rA existsr rr is_repository_directoryr r r rC r repo_nametitler r r. infor rD r r sysexitr r shutilmover )
rW r rR 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.
)rR r N)r@ rA r
r r )rW r= rR r s r* unpackzVersionControl.unpackJ 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_urlV 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_commandg s7 & 38*c*** .s33L" " +%9 ) + ! / - '
" Q Q Q OCH O O OPP P >>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 )rR r r r r r r )r. r1 ra r r r] )r r r r )r r r( r r r )rR r r r )r r1 r r r r )rR r r r )rR r r r )r r r r r r )
r r rR r r r] r r r r )r )r r r r1 r r )r r rR r r r r r )r= r rR 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 )rA r r r )%rL rM rN r rB r r rx r rh classmethodr r r r staticmethodrk r ru r r r r r r r r r r r r r r r r4 r r rO 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
<
<
<
< " " " [" " " " [" ! r r r1 )8rw
__future__r loggingr@ r r urllib.parser% collections.abcr r r dataclassesr r typingr 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__ getLoggerrL rC tupler AuthInfor+ r< rI ExceptionrK rQ r] r| r r rO r, r* rI 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,