R`iY 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$m%Z% ddl&m'Z' erdd lm(Z( d
gZ) ejT e+ Z,eee- ee- f Z.d e-d e/fd
Z0 d de-de-de-dee- d e-f
dZ1de-de-d ee- fdZ2 G d de3 Z4 G d de3 Z5 G d d Z6 G d d Z7 e7 Z8 G d d Z9y)!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_subprocessformat_command_args make_command)get_url_scheme)Literalvcsnamereturnc L t | }|y|g dt j z v S )z3
Return true if the name looks like a URL.
F)httphttpsfileftp)r r all_schemes)r schemes /builddir/build/BUILDROOT/alt-python312-pip-23.3.1-3.el8.x86_64/opt/alt/python312/lib/python3.12/site-packages/pip/_internal/vcs/versioncontrol.pyis_urlr* 9 s+ D
!F
~ 5G GG repo_urlrev project_namesubdirc R |j 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_urlr7 C sH $++C5
JauE"2!3
4C
x(( Jr+ location repo_rootc 0 | }t | sI| }t j j | } | |k( rt j d| yt | sIt j j
|| ryt j 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)r8 r9
orig_location
last_locations r) (find_path_to_project_root_from_repo_rootrD U s M *
77??8, } $
NN&
!*
ww 8,
77??8Y //r+ c e Zd Zy)RemoteNotFoundErrorN)__name__
__module__ __qualname__ r+ r) rF rF r s r+ rF c $ e Zd Zdef fd Z xZS )RemoteNotValidErrorurlc 2 t | | || _ y N)super__init__rM )selfrM __class__s r) rQ z RemoteNotValidError.__init__w s
r+ )rG rH rI strrQ
__classcell__rS s @r) rL rL v s C r+ rL c e Zd ZdZ dded dee dee ddfdZdefd Z e
dee fd
Z defd Z defd Z
dedd fd
Zy)
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 D |g }|| _ || _ || _ d| _ y)z
Args:
vc_class: a VersionControl subclass.
rev: the name of the revision to install.
extra_args: a list of extra options.
N)r[ r- rY branch_name)rR rY r- r[ s r) rQ zRevOptions.__init__ s, J$
*.r+ c P d| j j d| j dS )Nz )rY r r- rR s r) __repr__zRevOptions.__repr__ s& dmm 0 0 1|1EEr+ c ^ | j | j j S | j S rO )r- rY default_arg_revr` s r) arg_revzRevOptions.arg_rev s% 88 ==00 0xxr+ c g }| j }| || j j | z
}|| j z
}|S )z<
Return the VCS-specific command arguments.
)rd rY get_base_rev_argsr[ )rR argsr- s r) to_argszRevOptions.to_args sC ll ? DMM33C8 8D r+ c < | j syd| j dS )N z (to revision )r- r` s r)
to_displayzRevOptions.to_display s xx z++r+ c P | j 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[ )rY make_rev_optionsr[ )rR r- s r) make_newzRevOptions.make_new s" }}--cdoo-NNr+ NN)rG rH rI __doc__r r
rT r rQ ra propertyrd rh rm rq rJ r+ r) rX rX | s ",0 /'(/ c]/ [) /
/(F# F #
,C , OC OL Or+ rX c 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 )
VcsSupportrZ _registry)sshgithgbzrsftpsvnr! Nc t j j j | j t
| y rO )urllibparse uses_netlocextendschemesrP rQ )rR rS s r) rQ zVcsSupport.__init__ s, '' 5
r+ c 6 | j j S rO )rw __iter__r` s r) r zVcsSupport.__iter__ s ~~&&((r+ c H t | j j S rO )listrw valuesr` s r) backendszVcsSupport.backends s DNN))+,,r+ c T | j D cg c] }|j c}S c c}w rO )r r= )rR backends r) dirnameszVcsSupport.dirnames s" /3}}=}G}===s %c b g }| j D ] }|j |j |S rO )r r r )rR r r s r) r' zVcsSupport.all_schemes s* }}G NN7?? + %r+ clsc t |d s!t j d|j y |j | j
vr? | | j
|j < t j
d|j y y )Nr zCannot register VCS %szRegistered VCS backend: %s)hasattrr> r? rG r rw debug)rR r s r) registerzVcsSupport.register s^ sF# NN3S\\ B 884>> )'*uDNN388 $ LL5sxx @ *r+ r c < || j v r| j |= y y rO )rw rR r s r)
unregisterzVcsSupport.unregister s 4>> !t$ "r+ r8 c i }| j j D ]< }|j | }|st j d||j
|||< > |syt
|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)rw r get_repository_rootr> r r maxlen)rR r8 vcs_backends vcs_backend repo_pathinner_most_repo_paths r) get_backend_for_dirz VcsSupport.get_backend_for_dir sz
>>002K#77AI LL98[EUEU V&1L # 3 #>002K,,,"" 3 r+ c X |j }| j j | S )r )lowerrw getr s r) get_backendzVcsSupport.get_backend s$ zz|~~!!$''r+ )r! N)rG rH rI rw r rT __annotations__r rQ r r rt r r r r' r r r r
r r r rU rV s @r) rv rv s -/ItC))*/8G )(3- ) -$ /0 - - >$s) > > T#Y AD!1 2 At A%s %t %2C 2H=M4N 2.S X>N5O ( (1A(B (r+ rv 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
d@de 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
dAd1e,ee ef d2ed3e e d4d5d6e e-e# d7e e d8e e.ee/f d9e e0 d:ed;ed efd< Z1e
d=ed efd> Z2e
d ed e e fd? Z3y)BrZ rj rJ .r
unset_environNrc
remote_urlr! c \ |j j | 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+ ##%00CHH:Q @@@r+ r8 c y)z
Return the path to Python project root, relative to the repo root.
Return None if the project root is in the repo root.
NrJ r r8 s r) get_subdirectoryz VersionControl.get_subdirectory$ s r+ repo_dirc $ | j | 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 | j | }| j | r| j d| }| j | }| j | }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 r7 )r r r. r, revisionr/ r6 s r) get_src_requirementz"VersionControl.get_src_requirement3 sl %%h/ ( ( 2 ((1XJ/H//9%%h/&x+://, e.g. svn+http://myrepo/svn/MyApp#egg=MyApp Nr3 zyThe URL {!r} has an empty revision (after @) which is not supported. Include a revision after @ or remove @ from the URL.rj )
r r urlsplit
ValueErrorformatsplitr rsplitr
urlunsplit) r rM r( r r< queryfrag user_passr- s r) get_url_rev_and_authz#VersionControl.get_url_rev_and_auth s -3LL,A,A#,F)eT f ==CVC[
c1%a( 3 3FF C $; C+ID#'006s
ll%%vvtUB&GHC""r+ usernamepasswordc g S )zM
Return the RevOptions "extra arguments" to use in obtain().
rJ )r r s r)
make_rev_argsz VersionControl.make_rev_args s r+ c | j |j \ }}}|\ }}d}| t | }| j || }| j || } t | | fS )zq
Return the URL and RevOptions object to use in obtain(),
as a tuple (url, rev_options).
Nro )r secretr r rp r )
rR rM
secret_urlr- r r secret_passwordr r[ rev_optionss
r) get_url_rev_optionsz"VersionControl.get_url_rev_options su
&*%>%>szz%J"
C$-!/)- &!/2H''(;
++CJ+G
#[00r+ c ^ t j j | j d S )zi
Normalize a URL for comparison by unquoting it and removing any
trailing slash.
/)r r unquoterstrip)rM s r)
normalize_urlz VersionControl.normalize_url s$ ||##C(//44r+ url1url2c H | j | | j | k( S )zV
Compare two repo URLs for identity, ignoring incidental differences.
)r )r r r s r) compare_urlszVersionControl.compare_urls s%
&#*;*;D*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 )rR r rM 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 rR r rM 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 | j | \ }}t j j | s| j |||| y|j }| j
| r| j | }| j ||j rt j d| j j t | | | j ||j s?t j# dt | | j | | j% ||| yt j# d yt j' d| j( | j t | | d}n.t j' d|| j( | j d }t j' d
| j( | t+ d j- |d |d
}|dk( rt/ j0 d |dk( r@t j' dt | t3 | | j |||| y|dk( rWt5 | } t j' dt | | t7 j8 || | j |||| y|dk( r@t j# d| j t | || | j; ||| yy)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 %szWhat to do? {}r r ar z Deleting %sr zBacking up %s to %sr zSwitching %s %s to %s%s) r r; r< existsr rm is_repository_directoryr r r r> r repo_nametitler r r- infor r? r r r sysexitr r shutilmover )
rR r rM r r rev_display existing_urlpromptresponsedest_dirs
r) obtainzVersionControl.obtain sw 33C8[ww~~d# NN4kYN G !,,. ' ' - ..t4L szz: ?NN((* & ..t[__EKK*$T* # KKc;7 KK FG NN0 T"
UF NNB
FF 9 II
##4#;#;F1I#Fq R s? HHRL s? NN=,t*< = 4L NN4kYN G s?!$'H NN0,t2Dh O KKh ' NN4kYN G s? KK) T"
KKc; / r+ c t j j | r t | | j ||| y)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.
)rM r N)r; r< r r r
)rR r8 rM r s r) unpackzVersionControl.unpackV s. 77>>( # 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_urlb r r+ c t )zR
Return the current commit id of the files at the given location.
r r s r) r zVersionControl.get_revisionl s
"!r+ cmd show_stdoutcwd
on_returncodez"Literal["raise", "warn", "ignore"]extra_ok_returncodes command_desc
extra_environspinnerlog_failed_cmd stdout_onlyc
2 t | j g| }| t | } 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 r FileNotFoundErrorr PermissionError) r r r r r r r r r r r s r) run_commandzVersionControl.run_commands s & 388*c* .s3L " +%9 ) + ! / / - '
! &sxxl/88, :<
+CHH< 8- .
s A ABr< c t j d|| j | j t j
j
t j
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 sE
4dCKKRww~~bggll4 =>>r+ c * | j | r|S y)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 0Or+ rr ) TNraiseNNNNTF)4rG rH rI r r= r r r rT r r rc r
classmethodr r r r r staticmethodr rf r r rX rp r r AuthInfor r r r r r intr r r r r
r r r r
r r r r r r r rJ r+ r) rZ rZ s
DGI !GU38_!%'M5c?'%)OXc])A3 A4 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 # !5
49k)
*5 5 c] 5
< 5 'x} 5
5 sm5 S 125 *+5 5 5
5 5n ?3 ?4 ? ?
3
8C=
r+ rZ rO ):rs 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 r pip._internal.utils.urlsr r __all__ getLoggerrG r> rT r& r r* r7 rD ExceptionrF rL rX rv r rZ rJ r+ r) r3 sE /
8 B 4 '
8 $ #
- .H H H IM+.8@
$00 !0
c]0: ) ) @O @OFM( M(` lo or+