📁 File Manager Pro
v10.0.2 | PHP: 8.1.34
Server: LiteSpeed
2026-06-27 21:05:20
📂
/
/
usr
/
lib
/
python3.8
/
site-packages
/
pip
/
_internal
/
vcs
/
__pycache__
✏️
Editing: versioncontrol.cpython-38.pyc
U ��.e~S � @ s� d Z ddlmZ ddlZddlZddlZddlZddlZddlm Z ddl m Z ddl mZ ddlmZ ddlmZmZmZmZmZmZ dd lmZmZ dd lm Z dd l m Z e �r dd l m Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z) dd l*m+Z+ ddlm,Z, ddlm-Z- e'e%e. e%e. f Z/dgZ0e�1e2�Z3dd� Z4d dd�Z5dd� Z6G dd� de7�Z8G dd� de9�Z:G dd � d e9�Z;e;� Z<G d d � d e9�Z=dS ) z)Handles all VCS (version control) support� )�absolute_importN)� pkg_resources)�parse)� BadCommand)�samefile)�ask_path_exists� backup_dir� display_path�hide_url� hide_value�rmtree)�call_subprocess� make_command)�MYPY_CHECK_RUNNING)�get_url_scheme) �Any�Dict�Iterable�List�Mapping�Optional�Text�Tuple�Type�Union)�SpinnerInterface)� HiddenText)� CommandArgs�vcsc C s* t | �}|dkrdS |ddddgtj kS )z3 Return true if the name looks like a URL. NFZhttpZhttps�fileZftp)r r � all_schemes)�name�scheme� r# �D/usr/lib/python3.8/site-packages/pip/_internal/vcs/versioncontrol.py�is_url0 s r% c C s. t �|�}d�| ||�}|r*|d�|�7 }|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 Z to_filename�format)�repo_url�rev� project_name�subdirZegg_project_name�reqr# r# r$ �make_vcs_requirement_url; s r, c C s` | }t j�t j�| d��sD| }t j�| �} | |krt�d|� dS qt|| �rRdS t j�| |�S )z� Find the path to `setup.py` by searching up the filesystem from `location`. Return the path to `setup.py` relative to `repo_root`. Return None if `setup.py` is in `repo_root` or cannot be found. zsetup.pyzGCould not find setup.py for directory %s (tried all parent directories)N) �os�path�exists�join�dirname�logger�warningr �relpath)�locationZ repo_rootZ orig_locationZ last_locationr# r# r$ �!find_path_to_setup_from_repo_rootK s � r6 c @ s e Zd ZdS )�RemoteNotFoundErrorN)�__name__� __module__� __qualname__r# r# r# r$ r7 f s r7 c @ sF e Zd ZdZddd�Zdd� Zedd� �Zd d � Zd d � Z d d� Z dS )� RevOptionsz� Encapsulates a VCS-specific revision to install, along with any VCS install options. Instances of this class should be treated as if immutable. Nc C s( |dkr 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)� extra_argsr( �vc_classZ branch_name)�selfr= r( r< r# r# r$ �__init__s s zRevOptions.__init__c C s d� | jj| j�S )Nz<RevOptions {}: rev={!r}>)r& r= r! r( �r> r# r# r$ �__repr__� s zRevOptions.__repr__c C s | j d kr| jjS | j S �N)r( r= �default_arg_revr@ r# r# r$ �arg_rev� s zRevOptions.arg_revc C s0 g }| j }|dk r"|| j�|�7 }|| j7 }|S )z< Return the VCS-specific command arguments. N)rD r= �get_base_rev_argsr< )r> �argsr( r# r# r$ �to_args� s zRevOptions.to_argsc C s | j s dS d�| j �S )N� z (to revision {}))r( r& r@ r# r# r$ � to_display� s zRevOptions.to_displayc C s | j j|| jd�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< )r> r( r# r# r$ �make_new� s zRevOptions.make_new)NN) r8 r9 r: �__doc__r? rA �propertyrD rG rI rL r# r# r# r$ r; j s � r; c s| e Zd Zi ZddddddgZ� fdd�Zd d � Zed d � �Zed d� �Z edd� �Z dd� Z dd� Z dd� Z dd� Z� ZS )� VcsSupportZsshZgitZhgZbzrZsftpZsvnc s: t j�| j� tt dd �r(t j�| j� tt| ��� d S )N� uses_fragment) � urllib_parseZ uses_netloc�extend�schemes�getattrrP �superrO r? r@ �� __class__r# r$ r? � s zVcsSupport.__init__c C s | j �� S rB )� _registry�__iter__r@ r# r# r$ rY � s zVcsSupport.__iter__c C s t | j�� �S rB )�listrX �valuesr@ r# r# r$ �backends� s zVcsSupport.backendsc C s dd� | j D �S )Nc S s g | ] }|j �qS r# )r1 )�.0�backendr# r# r$ � <listcomp>� s z'VcsSupport.dirnames.<locals>.<listcomp>)r\ r@ r# r# r$ �dirnames� s zVcsSupport.dirnamesc C s g }| j D ]}|�|j� q |S rB )r\ rR rS )r> rS r^ r# r# r$ r � s zVcsSupport.all_schemesc C sH t |d�s t�d|j� d S |j| jkrD|� | j|j< t�d|j� d S )Nr! zCannot register VCS %szRegistered VCS backend: %s)�hasattrr2 r3 r8 r! rX �debug)r> �clsr# r# r$ �register� s zVcsSupport.registerc C s || j kr| j |= d S rB )rX �r> r! r# r# r$ � unregister� s zVcsSupport.unregisterc C s6 | j �� D ]&}|�|�r t�d||j� | S q dS )zv Return a VersionControl object if a repository of that type is found at the given directory. z Determine that %s uses VCS: %sN)rX r[ �controls_locationr2 rb r! )r> r5 Z vcs_backendr# r# r$ �get_backend_for_dir� s � z VcsSupport.get_backend_for_dirc C s |� � }| j�|�S )z9 Return a VersionControl object or None. )�lowerrX �getre r# r# r$ � get_backend� s zVcsSupport.get_backend)r8 r9 r: rX rS r? rY rN r\ r` r rd rf rh rk � __classcell__r# r# rV r$ rO � s rO c @ s8 e Zd ZdZdZdZdZdZdZe dd� �Z e dd� �Z e dd � �Z e d d � �Z ed d � �Ze d8dd��Ze dd� �Zdd� Ze dd� �Ze dd� �Zedd� �Zdd� Zed d � �Ze d d � �Zd d!� Zd"d#� Zd$d%� Ze d&d'� �Z d(d)� Z d*d+� Z e d,d-� �Z e d.d/� �Z e d9d2d3��Z!e d4d5� �Z"e d6d7� �Z#dS ):�VersionControlrH r# Nc C s |� � �d�| j�� S )z� Return whether the vcs prefix (e.g. "git+") should be added to a repository's remote url when used in a requirement. z{}:)ri � startswithr& r! )rc Z remote_urlr# r# r$ �should_add_vcs_url_prefix s z(VersionControl.should_add_vcs_url_prefixc C s dS )z~ Return the path to setup.py, relative to the repo root. Return None if setup.py is in the repo root. Nr# �rc r5 r# r# r$ �get_subdirectory s z VersionControl.get_subdirectoryc C s | � |�S )zR Return the revision string that should be used in a requirement. )� get_revision)rc �repo_dirr# r# r$ �get_requirement_revision s z'VersionControl.get_requirement_revisionc C sV | � |�}|dkrdS | �|�r.d�| j|�}| �|�}| �|�}t||||d�}|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} Nz{}+{})r* )�get_remote_urlro r& r! rt rq r, )rc rs r) r' Zrevisionr* r+ r# r# r$ �get_src_requirement s �z"VersionControl.get_src_requirementc C s t �dS )z� Return the base revision arguments for a vcs command. Args: rev: the name of a revision to install. Cannot be None. N��NotImplementedError)r( r# r# r$ rE 8 s z VersionControl.get_base_rev_argsc C s t | ||d�S )z� Return a RevOptions object. Args: rev: the name of a revision to install. extra_args: a list of extra options. rJ )r; )rc r( r< r# r# r$ rK B s z VersionControl.make_rev_optionsc C s& t j�|�\}}|�t jj�p$t|�S )zy posix absolute paths start with os.path.sep, win32 ones start with drive (like c:\folder) )r- r. � splitdrivern �sep�bool)rc ZrepoZdrive�tailr# r# r$ �_is_local_repositoryN s z#VersionControl._is_local_repositoryc C s t �dS )z� Export the repository at the url to the destination location i.e. only download the files, without vcs informations :param url: the repository URL starting with a vcs prefix. Nrw �r> r5 �urlr# r# r$ �exportX s zVersionControl.exportc C s |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)). )NNr# )rc �netlocr" r# r# r$ �get_netloc_and_authb s z"VersionControl.get_netloc_and_authc C s� t �|�\}}}}}d|kr*td�|���|�dd�d }| �||�\}}d}d|krf|�dd�\}}t �||||df�}|||fS )z� Parse the repository URL to use, and return the URL, revision, and auth info to use. Returns: (url, rev, (username, password)). �+zvSorry, {!r} is a malformed VCS url. The format is <vcs>+<protocol>://<url>, e.g. svn+http://myrepo/svn/MyApp#egg=MyApp� N�@rH )rQ Zurlsplit� ValueErrorr& �splitr� �rsplitZ urlunsplit) rc r r" r� r. ZqueryZfrag� user_passr( r# r# r$ �get_url_rev_and_authu s ��z#VersionControl.get_url_rev_and_authc C s g S )zM Return the RevOptions "extra arguments" to use in obtain(). r# )�username�passwordr# r# r$ � make_rev_args� s z VersionControl.make_rev_argsc C sT | � |j�\}}}|\}}d}|dk r.t|�}| �||�}| j||d�} t|�| fS )z� Return the URL and RevOptions object to use in obtain() and in some cases export(), as a tuple (url, rev_options). NrJ )r� �secretr r� rK r ) r> r Z secret_urlr( r� r� Zsecret_passwordr� r< � rev_optionsr# r# r$ �get_url_rev_options� s z"VersionControl.get_url_rev_optionsc C s t �| ��d�S )zi Normalize a URL for comparison by unquoting it and removing any trailing slash. �/)rQ Zunquote�rstrip�r r# r# r$ � normalize_url� s z VersionControl.normalize_urlc C s | � |�| � |�kS )zV Compare two repo URLs for identity, ignoring incidental differences. )r� )rc Zurl1Zurl2r# r# r$ � compare_urls� s zVersionControl.compare_urlsc C s t �dS )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. Nrw �r> �destr r� r# r# r$ � fetch_new� s zVersionControl.fetch_newc C s t �dS )z} Switch the repo at ``dest`` to point to ``URL``. Args: rev_options: a RevOptions object. Nrw r� r# r# r$ �switch� s zVersionControl.switchc C s t �dS )z� Update an already-existing repo to the given ``rev_options``. Args: rev_options: a RevOptions object. Nrw r� r# r# r$ �update� s zVersionControl.updatec C s t �dS )z� Return whether the id of the current commit equals the given name. Args: dest: the repository directory. name: a string name. Nrw )rc r� r! r# r# r$ �is_commit_id_equal� s z!VersionControl.is_commit_id_equalc C s� | � |�\}}tj�|�s,| �|||� dS |�� }| �|�r�| �|�}| �||j �r�t � d| j � � t|�|� | �||j�s�t �dt|�| j |� | �|||� n t �d� dS t �d| j| j t|�|� d}nt �d|| j| j � d}t �d | j|� td |d |d �}|d k�r$t�d� |dk�rXt �dt|�� t|� | �|||� dS |dk�r�t|�}t �dt|�|� t�||� | �|||� dS |dk�r�t �d| j t|�||� | � |||� 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 )�s�i�w�bz0Directory %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? %sr r� �a���r� z Deleting %sr� zBacking up %s to %sr� zSwitching %s %s to %s%s) r� r- r. r/ r� rI �is_repository_directoryru r� r� r2 rb � repo_name�titler r� r( �infor� r3 r! r �sys�exitr r �shutilZmover� ) r> r� r r� Z rev_displayZ existing_url�promptZresponseZdest_dirr# r# r$ �obtain� s� �� ��� � �zVersionControl.obtainc C s& t j�|�rt|� | j||d� 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� r~ r# r# r$ �unpack? s zVersionControl.unpackc C s t �dS )z� Return the url used at location Raises RemoteNotFoundError if the repository does not have a remote url configured. Nrw rp r# r# r$ ru K s z VersionControl.get_remote_urlc C s t �dS )zR Return the current commit id of the files at the given location. Nrw rp r# r# r$ rr U s zVersionControl.get_revisionT�raisec C s| t | jf|�� }z t|||||||| j|| d� W S tk rv } z(| jtjkrdtd| j| jf ��n� W 5 d} ~ X Y nX dS )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 )� on_returncode�extra_ok_returncodes� command_desc� extra_environ� unset_environ�spinner�log_failed_cmdzCCannot find command %r - do you have %r installed and in your PATH?N)r r! r r� �OSError�errnoZENOENTr ) rc �cmdZ show_stdout�cwdr� r� r� r� r� r� �er# r# r$ � run_command\ s& � ��zVersionControl.run_commandc C s, t �d|| j| j� tj�tj�|| j��S )zL Return whether a directory path is a repository directory. z Checking in %s for %s (%s)...)r2 rb r1 r! r- r. r/ r0 )rc r. r# r# r$ r� � s �z&VersionControl.is_repository_directoryc C s | � |�S )a6 Check if a location is controlled by the vcs. 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. )r� rp r# r# r$ rg � s z VersionControl.controls_location)NN)TNr� NNNNT)$r8 r9 r: r! r1 r� rS r� rC � classmethodro rq rt rv � staticmethodrE rK r} r� r� r� r� r� r� r� r� r� r� r� r� r� ru rr r� r� rg r# r# r# r$ rm � sr ] � ' rm )N)>rM Z __future__r r� Zloggingr- r� r� Z pip._vendorr Z pip._vendor.six.moves.urllibr rQ Zpip._internal.exceptionsr Zpip._internal.utils.compatr Zpip._internal.utils.miscr r r r r r Z pip._internal.utils.subprocessr r Zpip._internal.utils.typingr Zpip._internal.utils.urlsr �typingr r r r r r r r r r Zpip._internal.utils.uir r r �strZAuthInfo�__all__Z getLoggerr8 r2 r% r, r6 � Exceptionr7 �objectr; rO r rm r# r# r# r$ �<module> s< 0 HG
💾 Save Changes
❌ Cancel