|
Server : Apache System : Linux iad1-shared-b8-43 6.6.49-grsec-jammy+ #10 SMP Thu Sep 12 23:23:08 UTC 2024 x86_64 User : dh_edsupp ( 6597262) PHP Version : 8.2.26 Disable Function : NONE Directory : /lib/python3/dist-packages/trac/versioncontrol/__pycache__/ |
Upload File : |
o
�k�`�� � @ s� d dl Zd dlmZmZ d dlmZ d dlmZmZm Z d dl
m Z m Z d dl
T d dlmZmZmZ d dlmZmZ d d lmZmZ d d
lmZmZ d d lm Z m Z m Z d d l m Z d d
l!m"Z" d dl#m$Z$m%Z%m&Z& dd� Z'G dd� de(�Z)G dd� de(�Z*G dd� de+�Z,G dd� de+�Z-G dd� de+�Z.G dd � d e/�Z0G d d � d e/�Z1G d d � d e�Z2G d!d"� d"e�Z3G d#d$� d$e4ed%�Z5G d&d'� d'e4ed%�Z6G d(d)� d)e4ed%�Z7G d*d+� d+e7�Z8dS ),� N)�ABCMeta�abstractmethod)�datetime)�AdminCommandError�IAdminCommandProvider� get_dir_list)�
ConfigSection�Option)�*)�IResourceManager�Resource�ResourceNotFound)�as_bool� native_path)�
get_thread_id� threading)�time_now�utc)�exception_to_unicode�printout�
to_unicode��_)�IRequestFilter)�Chrome�ITemplateProvider� add_warningc C s | p
| dt d�fv S )z3Check whether `reponame` is the default repository.� (default)r ��reponame� r �9/usr/lib/python3/dist-packages/trac/versioncontrol/api.py�
is_default" � r" c @ � e Zd ZdZdS )�InvalidRepositoryz.Exception raised when a repository is invalid.N��__name__�
__module__� __qualname__�__doc__r r r r! r% ' � r% c @ r$ )�InvalidConnectorz8Exception raised when a repository connector is invalid.Nr& r r r r! r, + r+ r, c @ s$ e Zd ZdZdZdd� Zdd� ZdS )�IRepositoryConnectorz6Provide support for a specific version control system.Nc C � dS )a} Return the types of version control systems that are supported.
Yields `(repotype, priority)` pairs, where `repotype` is used to
match against the repository's `type` attribute.
If multiple provider match a given type, the `priority` is used to
choose between them (highest number is highest priority).
If the `priority` returned is negative, this indicates that the
connector for the given `repotype` indeed exists but can't be
used for some reason. The `error` property can then be used to
store an error message or exception relevant to the problem detected.
Nr r r r r! �get_supported_types4 � z(IRepositoryConnector.get_supported_typesc C r. )zLReturn a Repository instance for the given repository type and dir.
Nr )�
repos_type� repos_dir�paramsr r r! �get_repositoryC r0 z#IRepositoryConnector.get_repository)r' r( r) r* �errorr/ r4 r r r r! r- / s
r- c @ s e Zd ZdZdd� ZdS )�IRepositoryProviderz,Provide known named instances of Repository.c C r. )a� Generate repository information for known repositories.
Repository information is a key,value pair, where the value is
a dictionary which must contain at the very least either of
the following entries:
- `'dir'`: the repository directory which can be used by the
connector to create a `Repository` instance. This
defines a "real" repository.
- `'alias'`: the name of another repository. This defines an
alias to another (real) repository.
Optional entries:
- `'type'`: the type of the repository (if not given, the
default repository type will be used).
- `'description'`: a description of the repository (can
contain WikiFormatting).
- `'hidden'`: if set to `'true'`, the repository is hidden
from the repository index (default: `'false'`).
- `'sync_per_request'`: if set to `'true'`, the repository will be
synchronized on every request (default:
`'false'`).
- `'url'`: the base URL for checking out the repository.
Nr r r r r! �get_repositoriesK r0 z$IRepositoryProvider.get_repositoriesN)r' r( r) r* r7 r r r r! r6 H s r6 c @ s e Zd ZdZdd� Zdd� ZdS )�IRepositoryChangeListenerz#Listen for changes in repositories.c C r. )z8Called after a changeset has been added to a repository.Nr )�repos� changesetr r r! �changeset_addedo r0 z)IRepositoryChangeListener.changeset_addedc C r. )z�Called after a changeset has been modified in a repository.
The `old_changeset` argument contains the metadata of the changeset
prior to the modification. It is `None` if the old metadata cannot
be retrieved.
Nr )r9 r: �
old_changesetr r r! �changeset_modifiedr r0 z,IRepositoryChangeListener.changeset_modifiedN)r' r( r) r* r; r= r r r r! r8 l s r8 c @ s� e Zd ZdZeee� dZdd� Zdd� Z dd� Z
d d
� Z d d � Z d
d� Z
dd� Zd"dd�Zdd� Zdd� Zdd� Zd"dd�Zd d � Zd d � Zd d!� ZdS )#�DbRepositoryProviderz6Component providing repositories registered in the DB.)�alias� description�dir�hidden�name�sync_per_request�type�urlc C s� i }| j �dd�dd� | jD �� �D ]\}}}|dur$||�|i �|< qi }|�� D ]#\}}d|v rEd|v s;d|v rE||d < |||d < t|�d
��|d
< q+t|�� �S ) z;Retrieve repositories specified in the repository DB table.z9SELECT id, name, value FROM repository WHERE name IN (%s)�,c s s � | ]}d | V qdS )z'%s'Nr )�.0�eachr r r! � <genexpr>� s � z8DbRepositoryProvider.get_repositories.<locals>.<genexpr>NrC rA r? �idrD ) �env�db_query�join�repository_attrs�
setdefault�itemsr �get�iter)�selfr9 rK rC �value� reponames�infor r r! r7 � s ��� z%DbRepositoryProvider.get_repositoriesc c sb � ddd| j | jfV ddd| j| jfV ddd | j| jfV d
d d d
�| j� | j| j fV d S )Nzrepository addz<repos> <dir> [type]zAdd a source repositoryzrepository aliasz<name> <target>z Create an alias for a repositoryzrepository removez<repos>zRemove a source repositoryzrepository setz<repos> <key> <value>zeSet an attribute of a repository
The following keys are supported: %s
z, )
�
_complete_add�_do_add�_complete_alias� _do_alias�_complete_repos�
_do_removerN rO �
_complete_set�_do_set�rT r r r! �get_admin_commands� s& ����
�
�z'DbRepositoryProvider.get_admin_commandsc C s t | j�}dd� |�� D �S )Nc S s g | ]}|pd �qS )r r )rH r r r r! �
<listcomp>� s z6DbRepositoryProvider.get_reponames.<locals>.<listcomp>)�RepositoryManagerrL �get_all_repositories)rT �rmr r r! �
get_reponames� s
�z"DbRepositoryProvider.get_reponamesc C s8 t |�dkr
t|d d�S t |�dkrt| j��� S d S )N� ���T� )�lenr rc rL r/ �rT �argsr r r! rX � s
�z"DbRepositoryProvider._complete_addc C � t |�dkr
| �� S d S )Nrg �rj rf rk r r r! rZ � � �z$DbRepositoryProvider._complete_aliasc C rm )N� rn rk r r r! r\ � ro z$DbRepositoryProvider._complete_reposc C s* t |�dkr
| �� S t |�dkr| jS d S )Nrp rg )rj rf rO rk r r r! r^ � s
�z"DbRepositoryProvider._complete_setNc C s | � |tj�|�|� d S �N)�add_repository�os�path�abspath)rT r rA �type_r r r! rY � s z DbRepositoryProvider._do_addc C s | � ||� d S rq )� add_alias)rT r �targetr r r! r[ � � z DbRepositoryProvider._do_aliasc C s | � |� d S rq )�remove_repository)rT r r r r! r] � s z DbRepositoryProvider._do_removec C s� || j vr
ttd|d���|dkrtj�|�}| �|||i� |s#d}|dkr1ttd|d�� d S |dkr?ttd|d�� d S d S ) NzInvalid key "%(key)s"��keyrA r z0You should now run "repository resync %(name)s".�rC rE z1You may have to run "repository resync %(name)s".)rO r r rs rt ru �modify_repositoryr )rT r r| rU r r r! r_ � s
� ��z DbRepositoryProvider._do_setc C s� t j�|�s ttd���t|�rd}t| j�}|r'||�� vr'ttd|d���| jj � }|�
|�}|� d|d|f|d|p=dfg� W d � n1 sKw Y |� � dS ) zAdd a repository.�)The repository directory must be absolute� z/The repository type '%(type)s' is not supported)rE �<INSERT INTO repository (id, name, value) VALUES (%s, %s, %s)rA rE N)
rs rt �isabs� TracErrorr r" rc rL r/ �db_transaction�get_repository_id� executemany�reload_repositories)rT r rA rv re �dbrK r r r! rr � s&
�
�� � z#DbRepositoryProvider.add_repositoryc C s� t |�rd}t |�r d}t| j�}|�� }||vr#ttd|p dd���d|| v r3ttd|p/dd���| jj�}|�|�}|�d|dd f|d|fg� W d � n1 sUw Y |� � d S )
zCreate an alias repository.r� z#Repository "%(repo)s" doesn't existr ��repor? z.Cannot create an alias to the alias "%(repo)s"r� rA N)
r" rc rL rd r� r r� r� r� r� )rT r rx re � repositoriesr� rK r r r! rw � s0
� �
�� � z DbRepositoryProvider.add_aliasc s� t � �rd� t| j�}|�� }t� fdd�|�� D ��r&ttd� p"dd���| jj� }|� � �}|d|f� |d|f� |d |f� W d
� n1 sLw Y |�
� d
S ) zRemove a repository.r� c 3 � � | ]
}� |� d �kV qdS �r? N�rR �rH r9 r r r! rJ � � �z9DbRepositoryProvider.remove_repository.<locals>.<genexpr>z8Cannot remove the repository "%(repos)s" used in aliasesr �r9 z"DELETE FROM repository WHERE id=%sz#DELETE FROM revision WHERE repos=%sz&DELETE FROM node_change WHERE repos=%sN) r" rc rL rd �any�valuesr� r r� r� r� )rT r re r� r� rK r r r! rz s"
��
� z&DbRepositoryProvider.remove_repositoryc
sn t � �rd� |�d� �}t |�rd}t| j�}� |kr6|�� }t� fdd�|�� D ��r6ttd� p2dd���| jj �o}|�
� �}� |krT|d|f�rTttd |pPdd
���|� � D ]I\}} || j vrbqX|d v rlt | �rld} |d v rxt
| �rvd
nd} |dkr�tj�t| ��s�ttd���|d| ||f� |d||f�s�|d||| f� qXW d � n1 s�w Y |�� dS )z"Modify attributes of a repository.r� rC c 3 r� r� r� r� r r r! rJ r� z9DbRepositoryProvider.modify_repository.<locals>.<genexpr>z8Cannot rename the repository "%(repos)s" used in aliasesr r� zQSELECT id FROM repository WHERE name='name' AND
value=%sz)The repository "%(name)s" already exists.r} )r? rC )rB rD �1NrA r z6UPDATE repository SET value=%s WHERE id=%s AND name=%sz4SELECT value FROM repository WHERE id=%s AND name=%szqINSERT INTO repository (id, name, value)
VALUES (%s, %s, %s)
)r" rR rc rL rd r� r� r� r r� r� rQ rO r rs rt r� r r� )
rT r �changes� new_reponamere r� r� rK �k�vr r r! r~ s\
��
��
����� � z&DbRepositoryProvider.modify_repositoryrq )r' r( r) r* �
implementsr6 r rO r7 ra rf rX rZ r\ r^ rY r[ r] r_ rr rw rz r~ r r r r! r> { s&
r> c @ s e Zd ZdZeeeee� dZ dZ
dZ e e
�Ze e�Ze e�Zedd�Zeddd d
�Zd d � Zd
d� Zdd� Zdd� Zd:dd�Zdd� Zdd� Z dd� Z d d � Z d d � Z d d!� Z d"d#� Z!d$d%� Z"d&d'� Z#d(d)� Z$d*d+� Z%d,d-� Z&d.d/� Z'd0d1� Z(d2d3� Z)d:d4d5�Z*d6d7� Z+d8d9� Z,dS );rc z Version control system manager.r: �source�
repositoryr� a One of the methods for registering repositories is to
populate the `[repositories]` section of `trac.ini`.
This is especially suited for setting up aliases, using a
[TracIni#GlobalConfiguration shared configuration], or specifying
repositories at the time of environment creation.
See [TracRepositoryAdmin#ReposTracIni TracRepositoryAdmin] for
details on the format of this section, and look elsewhere on the
page for information on other repository providers.
�versioncontrol�default_repository_type�svnz�Default repository connector type.
This is used as the default repository type for repositories
defined in the [TracIni#repositories-section repositories] section
or using the "Repositories" admin panel.
c C s i | _ t�� | _d | _d | _d S rq )�_cacher �Lock�_lock� _connectors�_all_repositoriesr` r r r! �__init__d s
zRepositoryManager.__init__c C s |t | j�ur�| �� �� D ]{}t|�d��sq
t� }|d p d}z
| �|d �}|�� W nO t y6 Y q
t
yS } zt |t d|t
|�d�� W Y d }~n.d }~w ty| } z t |t d|t
|�d�� | j�d|t|dd �� W Y d }~nd }~ww | j�d
|t� | � q
|S ) NrD rC r zdCan't synchronize with repository "%(name)s" (%(error)s). Look in the Trac log for more information.�rC r5 z�Failed to sync with repository "%(name)s": %(error)s; repository information may be out of date. Look in the Trac log for more information including mitigation strategies.z�Failed to sync with repository "%s"; You may be able to reduce the impact of this issue by configuring the sync_per_request option; see https://trac.edgewall.org/wiki/TracRepositoryAdmin#ExplicitSync for more detail: %sT)� tracebackz-Synchronized '%s' repository in %0.2f seconds)r rL rd r� r rR r r4 �syncr, r� r r r � Exception�logr5 r rW )rT �req�handler� repo_info�start� repo_namer� �er r r! �pre_process_requestl sH �����
���
�z%RepositoryManager.pre_process_requestc C s
|||fS rq r )rT r� �template�data�metadatar r r! �post_process_request� s
z&RepositoryManager.post_process_requestc c s � | j V | jV | jV d S rq )�changeset_realm� source_realm�repository_realmr` r r r! �get_resource_realms� s � z%RepositoryManager.get_resource_realmsNc K s& |j | jkr |j}|o
|j}|j}|rtd||d�S td|d�S |j | jkr}|j}|o-|j}|j}d}|dkr^| �|�}|�|j|j�} | j rLtd�}
n| j
rStd�}
|jr]td |jd�}n td
�}
|jrjd |j }|rrtd |d
�nd} td|
||| d�S |j | j kr�|js�td�S td|jd
�S d S )Nz Changeset %(rev)s in %(repo)s)�revr� zChangeset %(rev)s�r� r� �summary� directory�filez at version %(rev)srt z@%sz in %(repo)sr� z(%(kind)s %(id)s%(at_version)s%(in_repo)s)�kindrK �
at_version�in_repozDefault repositoryzRepository %(repo)s) �realmr� �parentrK r r� r4 �get_node�version�isdir�isfiler� ) rT �resource�format�kwargsr� r rK r� r9 �noder� r� r r r! �get_resource_description� sD
�
� �z*RepositoryManager.get_resource_descriptionc K s~ |j | jkr|j}|�|j|r|jpd �S |j | jkr/|j}|j|r%|jp&d |j|jp,d d�S |j | jkr=|�|jp;d �S d S )Nr� ) r� r� r� r: rK r� �browserr� r� )rT r� �hrefr� r� r r r! �get_resource_url� s � �z"RepositoryManager.get_resource_urlc C s� |j | jkr
|j}n|jj}t| j��|�}|sdS |j | jkr4z |�|j� W dS t y3 Y dS w |j | j
krPz |� |j|j � W dS t
yO Y dS w |j | jkrXdS d S )NFT)r� r� rK r� rc rL r4 r� �
get_changeset�NoSuchChangesetr� r� r� �
NoSuchNode)rT r� r r9 r r r! �resource_exists� s. � � �z!RepositoryManager.resource_existsc c s� � | j }i }|D ]}|�d�r |�|�r ddi||dd� < q|D ]$}|�|�}d|vr0|d7 }|�d�rE||v rE||�|dd� i �d < q!|D ] }d|v rg|�dd
�\}}||v rg|d krg|�|�|| |< qH|�� D ] \}}||fV qldS ) z�Retrieve repositories specified in TracIni.
The `[repositories]` section can be used to specify a list
of repositories.
z.dirrD FN����.z.aliasi����r? rp )�repositories_section�endswithrR rP �rsplitrQ ) rT r� rV �optionr? rC �detailr rW r r r! r7 � s. ��
�� �z"RepositoryManager.get_repositoriesc C � g S rq r r` r r r! �get_htdocs_dirs s z!RepositoryManager.get_htdocs_dirsc C s ddl m} |dd�gS )Nr )�resource_filenameztrac.versioncontrol� templates)�
pkg_resourcesr� )rT r� r r r! �get_templates_dirs s z$RepositoryManager.get_templates_dirsc C s dd� | j D �}t|�S )z.Return the list of supported repository types.c S s. h | ]}|� � p g D ]
\}}|d kr
|�q
qS )r )r/ )rH � connectorrv �prior r r! � <setcomp> s
��z8RepositoryManager.get_supported_types.<locals>.<setcomp>)�
connectors�list)rT �typesr r r! r/
s �z%RepositoryManager.get_supported_typesc C s� t j�t j�t|��d�}g }| �� �� D ])\}}t|�d��}|r>t j�t j�|�d�}|�|�r>| � |�}|r>|�
|� q|S )z�Retrieve the repositories based on the given directory.
:param directory: the key for identifying the repositories.
:return: list of `Repository` instances.
r� rA ) rs rt rN �normcaser rd rQ rR �
startswithr4 �append)rT r� r� r �repoinforA r9 r r r! �get_repositories_by_dir s
�z)RepositoryManager.get_repositories_by_dirc C s| | j j�0}|d|f�D ]
\}| W d � S |d�d d d }|d|d|f� |W d � S 1 s7w Y dS )z�Return a unique id for the given repository name.
This will create and save a new id if none is found.
Note: this should probably be renamed as we're dealing
exclusively with *db* repository ids here.
z8SELECT id FROM repository WHERE name='name' AND value=%sNz+SELECT COALESCE(MAX(id), 0) FROM repositoryr rp r� rC )rL r� )rT r r� rK r r r! r� $ s
���$�z#RepositoryManager.get_repository_idc C s> |pd}| � � �|i �}d|v r |d }| � � �|i �}t|�d��}|s'dS |�d�p.| j}| jj�b | j�N t� }|| jv rF| j| }ni }| j|< |�|�}|sut j
� |�sct j
� | jj
|�}| �
|�}|�|||�� �}|||< |W d � W d � S 1 s�w Y W d � dS 1 s�w Y dS )a Retrieve the appropriate `Repository` for the given
repository name.
:param reponame: the key for specifying the repository.
If no name is given, take the default
repository.
:return: if no corresponding repository was defined,
simply return `None`.
:raises InvalidConnector: if the repository connector cannot be
opened.
:raises InvalidRepository: if the repository cannot be opened.
r� r? rA NrE )rd rR r r� rL r� r� r r� rs rt r� rN �_get_connectorr4 �copy) rT r r� �rdir�rtype�tidr� r9 r� r r r! r4 7 s:
���"�z RepositoryManager.get_repositoryc C s� g }|r |� d�d nd}| �� D ]}|� d�d }|�|�r(|�t|�|f� q|r<|�� |d \}}||d� }nd}|| �|�|�d�pIdfS )a9 Retrieve a matching `Repository` for the given `path`.
:param path: the eventually scoped repository-scoped path
:return: a `(reponame, repos, path)` triple, where `path` is
the remaining part of `path` once the `reponame` has
been truncated, if needed.
�/rh Nr� )�striprd r� r� rj �sortr4 �rstrip)rT rt �matchesr �stripped_reponame�lengthr r r! �get_repository_by_patha s
�
�z(RepositoryManager.get_repository_by_pathc C s< |r |j j| j| jfv r|j jr|j jjS |j}|sdS dS )z�Recover the appropriate repository from the current context.
Lookup the closest source or changeset resource in the context
hierarchy and return the name of its associated repository.
N)r� r� r� r� r� rK )rT �contextr r r! �get_default_repositoryx s
��
�z(RepositoryManager.get_default_repositoryc C sv | j s8i }| jD ],}|�� pg D ]#\}}||v r | j�d|� q||d< d|vr/| �|�|d< |||< qq|| _ | j S )z?Return a dictionary of repository information, indexed by name.z$Discarding duplicate repository '%s'rC rK )r� � providersr7 r� �warningr� )rT �all_repositories�providerr rW r r r! rd � s
�
� z&RepositoryManager.get_all_repositoriesc C sX t � }| �� D ] }z| �|�}W n ty Y qw |dur#|�|� qt|dd� d�S )zXReturn a sorted list of all real repositories (i.e. excluding
aliases).
Nc S � | j S rq r ��rr r r! �<lambda>� � z9RepositoryManager.get_real_repositories.<locals>.<lambda>r{ )�setrd r4 r� �add�sorted)rT r� r r9 r r r! �get_real_repositories� s �
�z'RepositoryManager.get_real_repositoriesc C s@ | j � i | _d| _W d � n1 sw Y | j�� dS )z+Reload the repositories from the providers.N)r� r� r� �config�touchr` r r r! r� � s
�z%RepositoryManager.reload_repositoriesc s� | j �d||pd|� | �|�}g }|r|�� � ntj�|�}| �|�}|r)d� n|� � r8� fdd�| �� D �}|sN| j � d� pA|� t
d|pJt
d�d�gS g }t |d d
� d �D ]�}|j p^d}|�
� |D ]�}g } |d kr�z|�|�}
W n" ty� } z|�t| �� | j � d
|||� W Y d} ~ qed} ~ ww | �|
� z|�|�} W n9 ty� z |�|� |�|�} W n# ty� } z|�t| �� | j � d
|||� W Y d} ~ Y qed} ~ ww Y nw | j �d|||� | jD ]}
t|
|�|| g| �R � q�qeqX|S )z�Notify repositories and change listeners about repository events.
The supported events are the names of the methods defined in the
`IRepositoryChangeListener` interface.
z-Event %s on repository '%s' for changesets %rr Nc s g | ]
}|� � � kr|�qS r )�get_base)rH r ��baser r! rb � s �z,RepositoryManager.notify.<locals>.<listcomp>z)Found no repositories matching '%s' base.z Repository '%(repo)s' not foundr� c S r� rq r r� r r r! r � r z*RepositoryManager.notify.<locals>.<lambda>r{ r= zMNo changeset '%s' found in repository '%s'. Skipping subscribers for event %sz-Event %s on repository '%s' for revision '%s')r� �debugr4 r rs rt ru r� r r� r r r r� �sync_changesetr� r� r r� �change_listeners�getattr)rT �eventr �revsr9 r� rA �errorsr� rl r< r� r: �listenerr r
r! �notify� s�
�
�
�
� ��
����� �
�� zRepositoryManager.notifyc C sj |r3|t � ks J �| j� | j�|i �}|�� D ]\}}|�� qW d � dS 1 s,w Y dS dS )z>Free `Repository` instances bound to a given thread identifierN)r r� r� �poprQ �close)rT r� r� r r9 r r r! �shutdown� s
�"��zRepositoryManager.shutdownc C s� | � |�dd� \}}|sdS d}d|v r |�dd�\}}z|�||�}W n ttfy1 Y dS w |�� }|r>t|�� �S dS )a� Read the file specified by `path`
:param path: the repository-scoped path. The repository revision may
specified by appending `@` followed by the revision,
otherwise the HEAD revision is assumed.
:return: the file content as a `str` string. `None` is returned if
the file is not found.
:since: 1.2.2
rp N�@)r� �splitr� r� r� � get_contentr �read)rT rt r9 r� r� �contentr r r! �read_file_by_path� s � �z#RepositoryManager.read_file_by_pathc C s� | j du r4i | _ | jD ](}|�� pg D ] \}}||f}|| j v r+|| j | d kr+d}|r2|| j |< qq || j v rR| j | \}}|dkrF|S ttd|t|j�d���ttd|d���)z�Retrieve the appropriate connector for the given repository type.
Note that the self._lock must be held when calling this method.
Nrp r z8Unsupported version control system "%(name)s": %(error)sr� z�Unsupported version control system "%(name)s": Can't find an appropriate component, maybe the corresponding plugin was not enabled? r} )r� r� r/ r, r r r5 )rT r� r� rv r� �keepr r r! r� s6
��
����z RepositoryManager._get_connectorrq )-r' r( r) r* r� r r r6 r r� r� r� �ExtensionPointr- r� r� r8 r r r� r r� r� r� r� r� r� r� r� r7 r� r� r/ r� r� r4 r� r� rd r r� r r r r� r r r r! rc @ sR ��
� $
$ *
D rc c @ s e Zd Zdd� ZdS )r� c C s t �| td|d�td�� d S )Nz&No changeset %(rev)s in the repositoryr� zNo such changeset)r
r� r �rT r� r r r! r� 6 s ��zNoSuchChangeset.__init__N�r' r( r) r� r r r r! r� 5 s r� c @ s e Zd Zddd�ZdS )r� Nc C s> |d u r t d||d�}nt d|||d�}t�| |t d�� d S )Nz$No node %(path)s at revision %(rev)s)rt r� z-%(msg)s: No node %(path)s at revision %(rev)s)�msgrt r� z No such node)r r
r� )rT rt r� r" r r r! r� > s �zNoSuchNode.__init__rq r! r r r r! r� = s r� c @ s` e Zd ZdZdZdZejZe dd� �Z
dd� Z dd � Z e
d
d � �Zd d
� ZdBdd�ZdCdd�Zdd� Zdd� Zdd� Ze
dd� �Zdd � Zd d � ZdBd d �Ze
dBd!d"��Ze
d#d$� �Ze d%d&� �Ze
d'd(� �Z e d)d&� �Z e
dDd+d,��Z e
dDd-d.��Z d/d0� Z e
d1d2� �Z!e
dEd3d4��Z"e
d5d6� �Z#e
d7d8� �Z$d9d:� Z%d;d<� Z&e
=dFd>d?��Z'd@dA� Z(e(Z)dS )G�
RepositoryzABase class for a repository provided by a version control system.Fr� c C s t | j| j�S rq )r r� r r` r r r! r� P � zRepository.resourcec C s* || _ || _|d | _|d | _|| _dS )au Initialize a repository.
:param name: a unique name identifying the repository, usually a
type-specific prefix followed by the path to the
repository.
:param params: a `dict` of parameters for the repository. Contains
the name of the repository under the key "name" and
the surrogate key that identifies the repository in
the database under the key "id".
:param log: a logger instance.
:raises InvalidRepository: if the repository cannot be opened.
rC rK N)rC r3 r rK r� )rT rC r3 r� r r r! r� T s
zRepository.__init__c C s d| j j| j| j| jf S )Nz
<%s %r %r %r>)� __class__r' rK rC �scoper` r r r! �__repr__h s �zRepository.__repr__c C r. )z'Close the connection to the repository.Nr r` r r r! r l � zRepository.closec C r� )z�Return the name of the base repository for this repository.
This function returns the name of the base repository to which scoped
repositories belong. For non-scoped repositories, it returns the
repository name.
r} r` r r r! r q s zRepository.get_baseNc C r. )z�Clear any data that may have been cached in instance properties.
`youngest_rev` can be specified as a way to force the value
of the `youngest_rev` property (''will change in 0.12'').
Nr )rT � youngest_revr r r! �clearz � zRepository.clearc C r. )ac Perform a sync of the repository cache, if relevant.
If given, `rev_callback` must be a callable taking a `rev` parameter.
The backend will call this function for each `rev` it decided to
synchronize, once the synchronization changes are committed to the
cache. When `clean` is `True`, the cache is cleaned first.
Nr )rT � rev_callback�cleanr r r! r� � � zRepository.syncc C r. )a Resync the repository cache for the given `rev`, if relevant.
Returns a "metadata-only" changeset containing the metadata prior to
the resync, or `None` if the old values cannot be retrieved (typically
when the repository is not cached).
Nr r r r r! r
� � zRepository.sync_changesetc C r� )a Generate a list of interesting places in the repository.
`rev` might be used to restrict the list of available locations,
but in general it's best to produce all known locations.
The generated results must be of the form (category, name, path, rev).
r r r r r! �get_quickjump_entries� r. z Repository.get_quickjump_entriesc C r. )a2 Return the repository URL for the given path and revision.
The returned URL can be `None`, meaning that no URL has been specified
for the repository, an absolute URL, or a scheme-relative URL starting
with `//`, in which case the scheme of the request should be prepended.
Nr �rT rt r� r r r! � get_path_url� r/ zRepository.get_path_urlc C r. )z?Retrieve a Changeset corresponding to the given revision `rev`.Nr r r r r! r� � r( zRepository.get_changesetc C r. )z�Return a globally unique identifier for the ''rev'' changeset.
Two changesets from different repositories can sometimes refer to
the ''very same'' changeset (e.g. the repositories are clones).
Nr r r r r! �get_changeset_uid� r0 z Repository.get_changeset_uidc c sJ � | j }|r#| �|�}|j|k rdS |j|k r|V | �|�}|sdS dS )zMGenerate Changeset belonging to the given time period (start, stop).
N)r) r� �date� previous_rev)rT r� �stopr� �chgsetr r r! �get_changesets� s �
�zRepository.get_changesetsc C s( z | � ||� W dS ty Y dS w )z�Tell if there's a node at the specified (path,rev) combination.
When `rev` is `None`, the latest revision is implied.
TF)r� r� r1 r r r! �has_node� s �zRepository.has_nodec C r. )aX Retrieve a Node from the repository at the given path.
A Node represents a directory or a file at a given revision in the
repository.
If the `rev` parameter is specified, the Node corresponding to that
revision is returned, otherwise the Node corresponding to the youngest
revision is returned.
Nr r1 r r r! r� � s
zRepository.get_nodec C r. )z4Return the oldest revision stored in the repository.Nr r` r r r! �get_oldest_rev� r( zRepository.get_oldest_revc C � | � � S rq )r: r` r r r! r � � zRepository.<lambda>c C r. )z/Return the youngest revision in the repository.Nr r` r r r! �get_youngest_rev� r( zRepository.get_youngest_revc C r; rq )r= r` r r r! r � r< r� c C r. )z�Return the revision immediately preceding the specified revision.
If `path` is given, filter out ancestor revisions having no changes
below `path`.
In presence of multiple parents, this follows the first parent.
Nr �rT r� rt r r r! r5 � � zRepository.previous_revc C r. )z�Return the revision immediately following the specified revision.
If `path` is given, filter out descendant revisions having no changes
below `path`.
In presence of multiple children, this follows the first child.
Nr r> r r r! �next_rev� r? zRepository.next_revc C s | � |�}|dur |gS g S )z3Return a list of parents of the specified revision.N)r5 )rT r� r� r r r! � parent_revs� s
zRepository.parent_revsc C r. )zjProvides a total order over revisions.
Return `True` if `rev1` is an ancestor of `rev2`.
Nr )rT �rev1�rev2r r r! �rev_older_than� r+ zRepository.rev_older_thanc C r. )a Retrieve all the revisions containing this path.
If given, `rev` is used as a starting point (i.e. no revision
''newer'' than `rev` should be returned).
The result format should be the same as the one of Node.get_history()
Nr )rT rt r� �limitr r r! �get_path_history r. zRepository.get_path_historyc C r. )z7Return a canonical representation of path in the repos.Nr )rT rt r r r! �normalize_path r( zRepository.normalize_pathc C r. )a� Return a (unique) canonical representation of a revision.
It's up to the backend to decide which string values of `rev`
(usually provided by the user) should be accepted, and how they
should be normalized. Some backends may for instance want to match
against known tags or branch names.
In addition, if `rev` is `None` or '', the youngest revision should
be returned.
:raise NoSuchChangeset: If the given `rev` isn't found.
Nr r r r r! �
normalize_rev s zRepository.normalize_revc C � | � |�}|dur
t|�S |S )z�Return a compact string representation of a revision in the
repos.
:raise NoSuchChangeset: If the given `rev` isn't found.
:since 1.2: Always returns a string or `None`.
N�rH �str�rT r� �norm_revr r r! � short_rev% s
zRepository.short_revc C rI )aA Return a string representation of a revision in the repos for
displaying to the user.
This can be a shortened revision string, e.g. for repositories
using long hashes.
:raise NoSuchChangeset: If the given `rev` isn't found.
:since 1.2: Always returns a string or `None`.
NrJ rL r r r! � display_rev/ s
zRepository.display_revrp c C r. )af Generates changes corresponding to generalized diffs.
Generator that yields change tuples (old_node, new_node, kind, change)
for each node change between the two arbitrary (path,rev) pairs.
The old_node is assumed to be None when the change is an ADD,
the new_node is assumed to be None when the change is a DELETE.
Nr )rT �old_path�old_rev�new_path�new_rev�ignore_ancestryr r r! � get_changes< s zRepository.get_changesc C s d|| j �dd��v S )z<Return True if view permission is granted on the repository.� BROWSER_VIEWr� r� )r� �child�rT �permr r r! � is_viewableI r# zRepository.is_viewablerq )NF)r� )NN)rp )*r' r( r) r* �has_linear_changesetsr& rc r� r� �propertyr� r� r' r r r r* r� r
r0 r2 r� r3 r8 r9 r� r: �
oldest_revr= r) r5 r@ rA rD rF rG rH rN rO rU rZ �can_viewr r r r! r# G sd
� r# )� metaclassc @ s e Zd ZdZdZdZejZe dd� �Z
dZ dZ dd� Z
d d
� Zed d � �Zd+dd�Zedd� �Zed,dd��Zdd� Zedd� �Zedd� �Zedd� �Ze d d � �Zed d � �Ze d d � �Zd!d"� Ze d#d � �Z ed$d%� �Z e d&d � �Z e d'd � �Z e d(d � �Z d)d*� Z!e!Z"dS )-�NodezERepresents a directory or file in the repository at a given revision.rA r� c C s t | j| j| j| jj�S rq )r r� rt r� r9 r� r` r r r! r� X s z
Node.resourceNc C s< |t jt jfv sJ d| ��|| _t|�| _|| _|| _d S )NzUnknown node kind %s)r` � DIRECTORY�FILEr9 r rt r� r� )rT r9 rt r� r� r r r! r� d s �
z
Node.__init__c C s> d| j j| jf }| jd ur|dt| j� 7 }d| jj|f S )Nz%s:%sr �<%s %r>)r9 rC rt r� rK r% r' �rT rC r r r! r' l s
z
Node.__repr__c C r. )z�Return a stream for reading the content of the node.
This method will return `None` for directories.
The returned object must support a `read([len])` method.
Nr r` r r r! r r r/ zNode.get_contentTc C r; )a� Return a stream for reading the content of the node, with some
standard processing applied.
:param keyword_substitution: if `True`, meta-data keywords
present in the content like ``$Rev$`` are substituted
(which keyword are substituted and how they are
substituted is backend specific)
:param eol_hint: which style of line ending is expected if
`None` was explicitly specified for the file itself in
the version control backend (for example in Subversion,
if it was set to ``'native'``). It can be `None`,
``'LF'``, ``'CR'`` or ``'CRLF'``.
)r )rT �keyword_substitution�eol_hintr r r! �get_processed_content{ s zNode.get_processed_contentc C r. )z�Generator that yields the immediate child entries of a directory.
The entries are returned in no particular order.
If the node is a file, this method returns `None`.
Nr r` r r r! � get_entries� r/ zNode.get_entriesc C r. )a� Provide backward history for this Node.
Generator that yields `(path, rev, chg)` tuples, one for each revision
in which the node was changed. This generator will follow copies and
moves of a node (if the underlying version control system supports
that), which will be indicated by the first element of the tuple
(i.e. the path) changing.
Starts with an entry for the current revision.
:param limit: if given, yield at most ``limit`` results.
Nr )rT rE r r r! � get_history� �
zNode.get_historyc C s( d}| � d�D ]
}|rd}q| S dS )zzReturn the change event corresponding to the previous revision.
This returns a `(path, rev, chg)` tuple.
Trg FN)ri )rT �skip�pr r r! � get_previous� s �zNode.get_previousc C r. )z�Provide detailed backward history for the content of this Node.
Retrieve an array of revisions, one `rev` for each line of content
for that node.
Only expected to work on (text) FILE nodes, of course.
Nr r` r r r! �get_annotations� r. zNode.get_annotationsc C r. )z�Returns the properties (meta-data) of the node, as a dictionary.
The set of properties depends on the version control system.
Nr r` r r r! �get_properties� r+ zNode.get_propertiesc C r. )zUThe length in bytes of the content.
Will be `None` for a directory.
Nr r` r r r! �get_content_length� r+ zNode.get_content_lengthc C r; rq )rp r` r r r! r � r< z
Node.<lambda>c C r. )zgThe MIME type corresponding to the content, if known.
Will be `None` for a directory.
Nr r` r r r! �get_content_type� r+ zNode.get_content_typec C r; rq )rq r` r r r! r � r< c C s | j �d�d S )Nr� rh )rt r r` r r r! �get_name� ry z
Node.get_namec C r; rq )rr r` r r r! r � r< c C s d S rq r r` r r r! �get_last_modified� s zNode.get_last_modifiedc C r; rq )rs r` r r r! r � r< c C � | j tjkS rq )r� r` ra r` r r r! r � � c C rt rq )r� r` rb r` r r r! r � ru c C s | j rdnd|| j�v S )z6Return True if view permission is granted on the node.rV � FILE_VIEW)r� r� rX r r r! rZ � s �zNode.is_viewable)TNrq )#r' r( r) r* ra rb rc r� r� r\ r� � created_rev� created_pathr� r' r r rg rh ri rm rn ro rp �content_lengthrq � content_typerr rC rs �
last_modifiedr� r� rZ r^ r r r r! r` P sL
r` c @ s� e Zd ZdZdZdZdZdZdZeeefZ eefZ
e e
Z e j
Zedd� �Zd d
� Zd d � Zd
d� Zedd� �Zdd� Zdd� Zdd� Zdd� ZeZdS )� Changesetz>Represents a set of changes committed at once in a repository.r r� �delete�edit�movec C s t | j| j| jjd�S )N)r� )r r� r� r9 r� r` r r r! r� � r# zChangeset.resourcec C s* || _ || _|p d| _|pd| _|| _d S )Nr� )r9 r� �message�authorr4 �rT r9 r� r� r� r4 r r r! r� � s
zChangeset.__init__c C s" d| j j| jf }d| jj|f S )Nz%s@%src )r9 rC r� r% r' rd r r r! r' s zChangeset.__repr__c C r� )ad Returns the properties (meta-data) of the node, as a dictionary.
The set of properties depends on the version control system.
Warning: this used to yield 4-elements tuple (besides `name` and
`text`, there were `wikiflag` and `htmlclass` values).
This is now replaced by the usage of IPropertyRenderer (see #1601).
r r` r r r! ro r? zChangeset.get_propertiesc C r. )aS Generator that produces a tuple for every change in the changeset.
The tuple will contain `(path, kind, change, base_path, base_rev)`,
where `change` can be one of Changeset.ADD, Changeset.COPY,
Changeset.DELETE, Changeset.EDIT or Changeset.MOVE,
and `kind` is one of Node.FILE or Node.DIRECTORY.
The `path` is the targeted path for the `change` (which is
the ''deleted'' path for a DELETE change).
The `base_path` and `base_rev` are the source path and rev for the
action (`None` and `-1` in the case of an ADD change).
Nr r` r r r! rU rj zChangeset.get_changesc C r� )a Yield branches to which this changeset belong.
Each branch is given as a pair `(name, head)`, where `name` is
the branch name and `head` a flag set if the changeset is a head
for this branch (i.e. if it has no children changeset).
r r` r r r! � get_branches! r+ zChangeset.get_branchesc C r� )zSYield tags associated with this changeset.
.. versionadded :: 1.0
r r` r r r! �get_tags) � zChangeset.get_tagsc C r� )zZYield bookmarks associated with this changeset.
.. versionadded :: 1.1.5
r r` r r r! �
get_bookmarks0 r� zChangeset.get_bookmarksc C s d|| j �v S )z;Return True if view permission is granted on the changeset.�CHANGESET_VIEW)r� rX r r r! rZ 7 r$ zChangeset.is_viewableN)r' r( r) r* �ADD�COPY�DELETE�EDIT�MOVE� DIFF_CHANGES�
OTHER_CHANGES� ALL_CHANGESrc r� r� r\ r� r� r' ro r rU r� r� r� rZ r^ r r r r! r| � s.
r| c s* e Zd ZdZd� fdd� Zdd� Z� ZS )�EmptyChangesetzeChangeset that contains no changes. This is typically used when the
changeset can't be retrieved.Nc s0 |d u r t dddtd�}t� �|||||� d S )Ni� rp )�tzinfo)r r �superr� r� �r% r r! r� B s zEmptyChangeset.__init__c C s t g �S rq )rS r` r r r! rU G s zEmptyChangeset.get_changes)NNN)r' r( r) r* r� rU �
__classcell__r r r� r! r� > s r� )9�os.pathrs �abcr r r �
trac.adminr r r � trac.configr r � trac.core�
trac.resourcer r r
� trac.utilr r �trac.util.concurrencyr r �trac.util.datefmtr r �trac.util.textr r r �trac.util.translationr � trac.web.apir �trac.web.chromer r r r" r� r% r, � Interfacer- r6 r8 � Componentr> rc r� r� �objectr# r` r| r� r r r r! �<module> sF $ F x
V