Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
lib
/
python3
/
dist-packages
/
trac
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: env.cpython-310.pyc
o �k�`Ѱ � @ s d Z ddlmZ ddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z mZ ddlmZ ddlmZ ddlmZ dd lmZmZmZ dd lmZmZ dd l m Z m Z dd l m Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z& dd l'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z- ddl.m/Z/m0Z0m1Z1m2Z2 ddl3m4Z4 ddl5m6Z6 ddl7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z>m?Z? ddl@mAZA ddlBmCZC ddlDmEZE ddlFmGZGmHZHmIZImJZJmKZKmLZL ddlMmNZNmOZO ddlPmQZQ ddlRmSZS g d�ZTdZUG dd � d e+eV�ZWG d d � d e(e)�ZXi ZYeC�Z� Z[d$d d!�Z\G d"d#� d#e(�Z]dS )%z(Trac Environment model and related APIs.� )�contextmanagerN)�RawConfigParser)�PIPE�Popen)�mkdtemp)�urlsplit)�log)�AdminCommandError�IAdminCommandProvider� get_dir_list)� IEnvironmentSetupParticipant�ISystemInfoProvider)� CacheManager�cached)� BoolOption� ChoiceOption� ConfigSection� Configuration� IntOption�Option� PathOption)� Component�ComponentManager�ExtensionPoint� TracBaseError� TracError� implements)�DatabaseManager�QueryContextManager�TransactionContextManager�parse_connection_uri)� copy_tables)�load_components)�as_bool�backup_config_file�copytree� create_file� get_pkginfo� is_path_below�lazy�makedirs)� close_fds)� threading)�pytz)�exception_to_unicode�path_to_unicode�printerr� printferr� printfout�printout)�_�N_)�Chrome)�Href)� Environmentr �open_environmentzTrac Environment Version 1c @ s e Zd ZdZdS )� BackupErrorz<Exception raised during an upgrade when the DB backup fails.N)�__name__� __module__� __qualname__�__doc__� r? r? �*/usr/lib/python3/dist-packages/trac/env.pyr: > s r: c s e Zd ZdZee� dZee�Zee �Z e dd�Z e dddd�Zed d dd �Zed d d d�Zed dd d�Zed ddd�Zedddd�Zedddd�Zedddd �Zedd dd �Zedd d d!�Zedd"ed#�d$�Z edd%d&d'�Z e d(d)e j e j! d*d d+�Z"ed(d,d-d.�Z#e d(d/e j$e j% d0d d+�Z&ed(d1d2d3�Z'd g dfd4d5�Z(d6d7� Z)e*d8d9� �Z+e,d:d;� �Z-e,d<d=� �Z.d>d?� Z/d@dA� Z0dBdC� Z1e*dDdE� �Z2dFdG� Z3� fdHdI�Z4e5d�dJdK��Z6dLdM� Z7e*dNdO� �Z8e,dPdQ� �Z9e,dRdS� �Z:d�dTdU�Z;g dfdVdW�Z<e*dXdY� �Z=e*dZd[� �Z>e*d\d]� �Z?d^d_� Z@e*d`da� �ZAe*dbdc� �ZBddde� ZCe*dfdg� �ZDe*dhdi� �ZEe*djdk� �ZFe*dldm� �ZGe*dndo� �ZHe*dpdq� �ZIe*drds� �ZJdtdu� ZKdvdw� ZLd�dxdy�ZMeNdzd{� �ZOeNd|d}� �ZPd~d� ZQd�d�d��ZRd�d�� ZSd�d�d��ZTe*d�d�� �ZUe*d�d�� �ZVd�d�� ZW� ZXS )�r8 a� Trac environment manager. Trac stores project information in a Trac environment. It consists of a directory structure containing among other things: * a configuration file, * project-specific templates and plugins, * the wiki and ticket attachments files, * the SQLite database file (stores tickets, wiki pages...) in case the database backend is SQLite T� componentsa Enable or disable components provided by Trac and plugins. The component to enable/disable is specified by the option name. The enabled state is determined by the option value: setting the value to `enabled` or `on` will enable the component, any other value (typically `disabled` or `off`) will disable the component. The option name is either the fully qualified name of the component or the module/package prefix of the component. The former enables/disables a specific component, while the latter enables/disables any component in the specified package/module. Consider the following configuration snippet: {{{#!ini [components] trac.ticket.report.ReportModule = disabled acct_mgr.* = enabled }}} The first option tells Trac to disable the [TracReports report module]. The second option instructs Trac to enable all components in the `acct_mgr` package. The trailing wildcard is required for module/package matching. To view the list of active components, go to the ''Plugins'' section of ''About Trac'' (requires `CONFIG_VIEW` [TracPermissions permission]). See also: TracPlugins �inherit� plugins_dir� a+ Path to the //shared plugins directory//. Plugins in that directory are loaded in addition to those in the directory of the environment `plugins`, with this one taking precedence. Non-absolute paths are relative to the Environment `conf` directory. �trac�base_urlz�Base URL of the Trac site. This is used to produce documents outside of the web browsing context, such as URLs in notification e-mails that point to Trac resources. �use_base_url_for_redirectFa� Optionally use `[trac] base_url` for redirects. In some configurations, usually involving running Trac behind a HTTP proxy, Trac can't automatically reconstruct the URL that is used to access it. You may need to use this option to force Trac to use the `base_url` setting also for redirects. This introduces the obvious limitation that this environment will only be usable when accessible from that URL, as redirects are frequently used. �secure_cookiesz�Restrict cookies to HTTPS connections. When true, set the `secure` flag on all cookies so that they are only sent to the server on HTTPS connections. Use this if your Trac instance is only accessible through HTTPS. �anonymous_session_lifetime�90z�Lifetime of the anonymous session, in days. Set the option to 0 to disable purging old anonymous sessions. (''since 1.0.17'')�project�namez My ProjectzName of the project.�descrzMy example projectz!Short description of the project.�urlaw URL of the project web site. This is usually the domain in which the `base_url` resides. For example, the project URL might be !https://myproject.com, with the Trac site (`base_url`) residing at either !https://trac.myproject.com or !https://myproject.com/trac. The project URL is added to the footer of notification e-mails. �adminz.E-Mail address of the project's administrator.�admin_trac_url�.z�Base URL of a Trac instance where errors in this Trac should be reported. This can be an absolute or relative URL, or '.' to reference this Trac instance. An empty value will disable the reporting buttons. �footerznVisit the Trac open source project at<br /><a href="https://trac.edgewall.org/">https://trac.edgewall.org/</a>z!Page footer text (right-aligned).�iconzcommon/trac.icoz URL of the icon of the project.�logging�log_typezbLogging facility to use. Should be one of (`none`, `file`, `stderr`, `syslog`, `winlog`).)�case_sensitive�log_fileztrac.logz�If `log_type` is `file`, this should be a path to the log-file. Relative paths are resolved relative to the `log` directory of the environment.� log_levelzpLevel of verbosity in log. Should be one of (`CRITICAL`, `ERROR`, `WARNING`, `INFO`, `DEBUG`). � log_formatNa� Custom logging format. If nothing is set, the following will be used: `Trac[$(module)s] $(levelname)s: $(message)s` In addition to regular key names supported by the [http://docs.python.org/library/logging.html Python logger library] one could use: - `$(path)s` the path for the current environment - `$(basename)s` the last path component of the current environment - `$(project)s` the project name Note the usage of `$(...)s` instead of `%(...)s` as the latter form would be interpreted by the !ConfigParser itself. Example: `($(thread)d) Trac[$(basename)s:$(module)s] $(levelname)s: $(message)s` c C sh t �| � tj�tj�|��| _d| _d| _|r*| �||� | j D ]}|� � q!dS | � � | � � dS )a Initialize the Trac environment. :param path: the absolute path to the Trac environment :param create: if `True`, the environment is created and otherwise, the environment is expected to already exist. :param options: A list of `(section, name, value)` tuples that define configuration options :param default_data: if `True` (the default), the environment is populated with default data when created. N) r �__init__�os�path�normpath�normcaser �config�create�setup_participants�environment_created�verify� setup_config)�selfr\ r` �options� default_data�setup_participantr? r? r@ rZ � s � zEnvironment.__init__c C s d| j j| jf S )Nz<%s %r>)� __class__r; r\ �re r? r? r@ �__repr__ s zEnvironment.__repr__c C s t j�| j�S )z3The environment name. :since: 1.2 )r[ r\ �basenamerj r? r? r@ rL � zEnvironment.namec C s | S )z�Property returning the `Environment` object, which is often required for functions and methods that take a `Component` instance. r? rj r? r? r@ �env s zEnvironment.envc C s6 g }| j D ] }|�|�� pg � qtt|�dd� d�S )z�List of `(name, version)` tuples describing the name and version information of external packages used by Trac and plugins. c S s | d dk| d � � fS )Nr �Trac)�lower)�argsr? r? r@ �<lambda>* s z)Environment.system_info.<locals>.<lambda>)�key)�system_info_providers�extend�get_system_info�sorted�set)re �info�providerr? r? r@ � system_info! s �zEnvironment.system_infoc c sZ � d| j fV dtjfV dtjfV td ur dtjfV t| d�r+| j| jfV d S d S )Nro �Python� setuptoolsr- �webfrontend_version) � trac_version�sys�versionr} � __version__r- �hasattr� webfrontendr~ rj r? r? r@ rv . s � �zEnvironment.get_system_infoc C s | |_ | j|_| j|_dS )a Initialize additional member variables for components. Every component activated through the `Environment` object gets three member variables: `env` (the environment object), `config` (the environment configuration) and `log` (a logger object).N)rn r_ r )re � componentr? r? r@ �component_activated7 s z Environment.component_activatedc C s& |}t |t�s|jd |j }|�� S )NrQ )� isinstance�strr< r; rp )re � name_or_classrL r? r? r@ �_component_nameB s zEnvironment._component_namec C s6 i }| j �� D ]\}}|�d��� }t|�||< q|S )Nz.*)�components_sectionrf �rstriprp r# )re �_rulesrL �valuer? r? r@ �_component_rulesH s z Environment._component_rulesc C sx | � |�}| j}|}|r)|�|�}|dur|S |�d�}|dk r!n|d|� }|s |�d�r:|�d� r:|�d� p;dS )a� Implemented to only allow activation of components that are not disabled in the configuration. This is called by the `ComponentManager` base class when a component is about to be activated. If this method returns `False`, the component does not get activated. If it returns `None`, the component only gets activated if it is located in the `plugins` directory of the environment. NrQ r �trac.z trac.test.z trac.tests.)r� r� �get�rfind� startswith)re �cls�component_name�rules�cname�enabled�idxr? r? r@ �is_component_enabledP s& � � ��z Environment.is_component_enabledc s d| j | �|�< t� �|� dS )z Enable a component or module.TN)r� r� �super�enable_component�re r� �ri r? r@ r� m s z Environment.enable_componentc c s� � zdV W dS t y' } z| j�d|t|�� |r � W Y d}~dS d}~w tyH } z| j�d|t|dd�� |r=� W Y d}~dS d}~ww )am Traps any runtime exception raised when working with a component and logs the error. :param component: the component responsible for any error that could happen inside the context :param reraise: if `True`, an error is logged but not suppressed. By default, errors are suppressed. NzComponent %s failed with %sT�� traceback)r r �warningr. � Exception�error)re r� �reraise�er? r? r@ �component_guardr s( � ��� ����zEnvironment.component_guardc C s� z$t tj�| jd�dd��}|�� �� }W d � n1 s w Y W n ty< } z ttd| jt |�d���d}~ww |t krIttd|d���dS ) zSVerify that the provided path points to a valid Trac environment directory.�VERSION�utf-8��encodingNz+No Trac environment found at %(path)s %(e)s)r\ r� z(Unknown Trac environment type '%(type)s')�type) �openr[ r\ �join�readliner� r� r r4 r. �_VERSION)re �f�tagr� r? r? r@ rc � s& � �� �����zEnvironment.verifyc C s t | ��� S )a� Return an object (typically a module) containing all the backend-specific exception types as attributes, named according to the Python Database API (http://www.python.org/dev/peps/pep-0249/). To catch a database exception, use the following pattern:: try: with env.db_transaction as db: ... except env.db_exc.IntegrityError as e: ... )r �get_exceptionsrj r? r? r@ �db_exc� s zEnvironment.db_excc C � t | �S )a Return a context manager (`~trac.db.api.QueryContextManager`) which can be used to obtain a read-only database connection. Example:: with env.db_query as db: cursor = db.cursor() cursor.execute("SELECT ...") for row in cursor.fetchall(): ... Note that a connection retrieved this way can be "called" directly in order to execute a query:: with env.db_query as db: for row in db("SELECT ..."): ... :warning: after a `with env.db_query as db` block, though the `db` variable is still defined, you shouldn't use it as it might have been closed when exiting the context, if this context was the outermost context (`db_query` or `db_transaction`). If you don't need to manipulate the connection itself, this can even be simplified to:: for row in env.db_query("SELECT ..."): ... )r rj r? r? r@ �db_query� s "zEnvironment.db_queryc C r� )ad Return a context manager (`~trac.db.api.TransactionContextManager`) which can be used to obtain a writable database connection. Example:: with env.db_transaction as db: cursor = db.cursor() cursor.execute("UPDATE ...") Upon successful exit of the context, the context manager will commit the transaction. In case of nested contexts, only the outermost context performs a commit. However, should an exception happen, any context manager will perform a rollback. You should *not* call `commit()` yourself within such block, as this will force a commit even if that transaction is part of a larger transaction. Like for its read-only counterpart, you can directly execute a DML query on the `db`:: with env.db_transaction as db: db("UPDATE ...") :warning: after a `with env.db_transaction` as db` block, though the `db` variable is still available, you shouldn't use it as it might have been closed when exiting the context, if this context was the outermost context (`db_query` or `db_transaction`). If you don't need to manipulate the connection itself, this can also be simplified to:: env.db_transaction("UPDATE ...") )r rj r? r? r@ �db_transaction� s &zEnvironment.db_transactionc C sD ddl m} || ��|� t| ��|� |du r t�| j� dS dS )zClose the environment.r )�RepositoryManagerN)�trac.versioncontrol.apir� �shutdownr r )re �tidr� r? r? r@ r� � s �zEnvironment.shutdownc C sp t j�| j�}t j�|�sttd|d���t j�| j�r(t �| j�r(ttd���t j�| j�s5t �| j� t �| j� t �| j � t �| j � t �| j � t t j� | jd�td � t t j� | jd�d� t �| j� t| j�}|D ] \}}}|�|||� qr|�� | �� tdd � |D ��s�| j�| � | j�� t | jd � | �� t| �}|�� |r�|�� d S d S ) a� Create the basic directory structure of the environment, initialize the database and populate the configuration file with default values. If options contains ('inherit', 'file'), default values will not be loaded; they are expected to be provided by that file or other options. :raises TracError: if the base directory of `path` does not exist. :raises TracError: if `path` exists and is not empty. zDBase directory '%(env)s' does not exist. Please create it and retry.)rn z"Directory exists and is not empty.r� � �READMEzcThis directory contains a Trac environment. Visit https://trac.edgewall.org/ for more information. c s s" � | ] \}}}||fd kV qdS ))rB �fileNr? )�.0�section�optionr� r? r? r@ � <genexpr>( s � �z%Environment.create.<locals>.<genexpr>�.sampleN) r[ r\ �dirname�existsr r4 �listdir�mkdir� htdocs_dir�log_dirrC � templates_dirr& r� r� �conf_dirr �config_file_pathrx �saverd �anyr_ � set_defaults�_update_sample_configr �init_db�insert_default_data) re rf rg �base_dirr_ r� rL r� �dbmr? r? r@ r` � sH � � � �zEnvironment.createc C � t | ��d�S )zLReturns the current version of the database. :since 1.0.2: �database_version�r �get_database_versionrj r? r? r@ r� 7 s �z Environment.database_versionc C r� )z�Returns the version of the database at the time of creation. In practice, for a database created before 0.11, this will return `False` which is "older" than any db version number. :since 1.0.2: �initial_database_versionr� rj r? r? r@ �database_initial_version@ s �z$Environment.database_initial_versionc C s ddl m}m} t|��d|�S )z9Returns the version of Trac. :since: 1.2 r )�corer� r� )rE r� r� r' r� )re r� r� r? r? r@ r L s zEnvironment.trac_versionc C sP t | jd| ji�| _| jjsttd| jd���| �� | j}t | |o$|f� dS )z Load the configuration file.�envnamez/The configuration file is not found at %(path)s�r\ N) r r� rL r_ r� r r4 � setup_log�shared_plugins_dirr" )re rC r? r? r@ rd T s ��zEnvironment.setup_configc C s t j�| jd�S )zPath of the trac.ini file.ztrac.ini)r[ r\ r� r� rj r? r? r@ r� _ s z Environment.config_file_pathc C s& t j�| j�st j�| j| j�S | jS )zPath to the log file.)r[ r\ �isabsrW r� r� rj r? r? r@ � log_file_pathd s zEnvironment.log_file_pathc G s2 | j }|D ] }tj �||�}qtj �tj �|��S �N)r\ r[ r� r^ �realpath)re �dirsr\ �dirr? r? r@ �_get_path_to_dirk s z Environment._get_path_to_dirc C s | � dd�S )zKAbsolute path to the attachments directory. :since: 1.3.1 �files� attachments�r� rj r? r? r@ �attachments_dirq s zEnvironment.attachments_dirc C � | � d�S )zEAbsolute path to the conf directory. :since: 1.0.11 �confr� rj r? r? r@ r� y � zEnvironment.conf_dirc C r� )zEAbsolute path to the files directory. :since: 1.3.2 r� r� rj r? r? r@ � files_dir� r� zEnvironment.files_dirc C r� )zGAbsolute path to the htdocs directory. :since: 1.0.11 �htdocsr� rj r? r? r@ r� � r� zEnvironment.htdocs_dirc C r� )zDAbsolute path to the log directory. :since: 1.0.11 r r� rj r? r? r@ r� � r� zEnvironment.log_dirc C r� )zHAbsolute path to the plugins directory. :since: 1.0.11 �pluginsr� rj r? r? r@ rC � r� zEnvironment.plugins_dirc C r� )zJAbsolute path to the templates directory. :since: 1.0.11 � templatesr� rj r? r? r@ r� � r� zEnvironment.templates_dirc C s> | � | j| j| j| j�\| _}| j�|� | j�d| j� dS )z"Initialize the logging sub-system.z_-------------------------------- environment startup [Trac %s] --------------------------------N) � create_loggerrU r� rX rY r � addHandlerry r )re � log_handlerr? r? r@ r� � s �� �zEnvironment.setup_logc C s\ dt �| j�d���� }|r$|�dd��d| j��d| j��d| j�}tj |||||d�S ) NzTrac.%sr� z$(z%(z%(path)sz %(basename)sz %(project)s)�format) �hashlib�sha1r\ �encode� hexdigest�replacerL � project_namer �logger_handler_factory)re rU rW rX rY �log_idr? r? r@ r� � s � � �zEnvironment.create_loggerc C s |r| j S t| j�S )a Returns information about all known users, i.e. users that have logged in to this Trac environment and possibly set their name and email. By default this function returns an iterator that yields one tuple for every user, of the form (username, name, email), ordered alpha-numerically by username. When `as_dict` is `True` the function returns a dictionary mapping username to a (name, email) tuple. :since 1.2: the `as_dict` parameter is available. )�_known_users_dict�iter� _known_users)re �as_dictr? r? r@ �get_known_users� s zEnvironment.get_known_usersc C r� )Na� SELECT DISTINCT s.sid, n.value, e.value FROM session AS s LEFT JOIN session_attribute AS n ON (n.sid=s.sid AND n.authenticated=1 AND n.name = 'name') LEFT JOIN session_attribute AS e ON (e.sid=s.sid AND e.authenticated=1 AND e.name = 'email') WHERE s.authenticated=1 ORDER BY s.sid )r� rj r? r? r@ r� � s zEnvironment._known_usersc C s dd� | j D �S )Nc S s" i | ] }|d |d |d f�qS )r � � r? )r� �ur? r? r@ � <dictcomp>� s " z1Environment._known_users_dict.<locals>.<dictcomp>)r� rj r? r? r@ r� � s z Environment._known_users_dictc C s | ` | `dS )z Clear the known_users cache.N)r� r� rj r? r? r@ � invalidate_known_users_cache� s z(Environment.invalidate_known_users_cachec C s t | ��|�S )z�Create a backup of the database. :param dest: Destination file; if not specified, the backup is stored in a file called db_name.trac_version.bak )r �backup)re �destr? r? r@ r � rm zEnvironment.backupc C s� | j D ]M}z/| j|dd�� |�� r$| j�d|� W d � W dS W d � n1 s.w Y W q tyP } zttd|jj |jj t |�d���d}~ww dS )z4Return whether the environment needs to be upgraded.T�r� z,Component %s requires an environment upgradeNz;Unable to check for upgrade of %(module)s.%(name)s: %(err)s)�modulerL �errF) ra r� �environment_needs_upgrader r� r� r r4 ri r< r; r. )re � participantr� r? r? r@ � needs_upgrade� s, �� �����zEnvironment.needs_upgradec C s g }| j D ]"}| j|dd�� |�� r|�|� W d � n1 s"w Y q|s,dS |rGz| �|� W n tyF } zt|�|�d}~ww |D ]1}| j�d|� | j|dd�� |� � W d � n1 shw Y t | �}|j dkrz|� � qI| � � | `dS )z�Upgrade database. :param backup: whether or not to backup before upgrading :param backup_dest: name of the backup file :return: whether the upgrade was performed Tr Nzupgrading %s...zsqlite::memory:)ra r� r �appendr r� r: r ry �upgrade_environmentr �connection_urir� r� r� )re r � backup_dest� upgradersr r� r� r? r? r@ �upgrade� s: � �� �� � �zEnvironment.upgradec C s t t| jj�j�S )zThe application root path)r7 r �abs_href�baser\ rj r? r? r@ �href s zEnvironment.hrefc C s | j s | j�d� t| j �S )zThe application URLzQ[trac] base_url option not set in configuration, generated links may be incorrect)rF r r� r7 rj r? r? r@ r " s zEnvironment.abs_hrefc C s� t j�| jd �}t j�|�sd S t|�}|�� z|�� W n ty> } z| j � d|t |dd�� W Y d }~d S d }~ww | j � d|� d S )Nr� z/Couldn't write sample configuration file (%s)%sTr� zRWrote sample configuration file with the new settings and their default values: %s) r[ r\ r� r� �isfiler r� r� �EnvironmentErrorr r� r. ry )re �filenamer_ r� r? r? r@ r� * s ����z!Environment._update_sample_config)Fr� )FN)Yr; r< r= r> r r �requiredr rt r ra r r� r r� r rF r �base_url_for_redirectrH r rI r� �project_description� project_url� project_admin�project_admin_trac_urlr5 �project_footer� project_iconr r � LOG_TYPES�LOG_TYPE_ALIASESrU rW � LOG_LEVELS�LOG_LEVEL_ALIASESrX rY rZ rk r) rL �propertyrn r{ rv r� r� r� r� r� r r� rc r� r� r� r� r` r� r� r rd r� r� r� r� r� r� r� r� rC r� r� r� r r r� r� r r r r r r r� � __classcell__r? r? r� r@ r8 B s �!� �� ����� �� �� �� �� # '9 " r8 Fc C s@ | st �d�} | sttd���|r\t�? t�| �}|r/|j�� r/|j � d� |� � t| = d}|du r<t� | t | ��}nt|��� W d � |S W d � |S 1 sUw Y |S t| �}z|�� }W n- ty| } z |j �dt|�� � d}~w ty� } z |j �dt|dd�� � d}~ww |r�ttd| d ���|S ) a� Open an existing environment object, and verify that the database is up to date. :param env_path: absolute path to the environment directory; if omitted, the value of the `TRAC_ENV` environment variable is used :param use_cache: whether the environment should be cached for subsequent invocations of this function :return: the `Environment` object �TRAC_ENVzjMissing environment variable "TRAC_ENV". Trac requires this variable to point to a valid Trac environment.z1Reloading environment due to configuration changeNz/Exception caught while checking for upgrade: %sTr� zPThe Trac Environment needs to be upgraded. Run: trac-admin "%(path)s" upgrader� )r[ �getenvr r4 �env_cache_lock� env_cacher� r_ �parse_if_neededr ry r� � setdefaultr9 r �reset_metadatar8 r r� r. r� )�env_path� use_cachern r r� r? r? r@ r9 ? sZ � �!� �!�!� �� ����r9 c @ sv e Zd ZdZee� dd� Zddd�Zdd� Zd d � Z dd d �Z dd d�Z dd� Z dd� Z dd� Zdd� Zdd� ZdS )�EnvironmentAdminz;trac-admin command provider for environment administration.c c sP � ddd| j | jfV dddd | jfV ddd d | jfV d d d d | jfV d S ) N� convert_dbz<dburi> [new_env]a Convert database Converts the database backend in the environment in which the command is run (in-place), or in a new copy of the environment. For an in-place conversion, the data is copied to the database specified in <dburi> and the [trac] database setting is changed to point to the new database. The new database must be empty, which for an SQLite database means the file should not exist. The data in the existing database is left unmodified. For a database conversion in a new copy of the environment, the environment in which the command is executed is copied and the [trac] database setting is changed in the new environment. The existing environment is left unmodified. Be sure to create a backup (see `hotcopy`) before converting the database, particularly when doing an in-place conversion. �deployz <directory>z2Extract static resources from Trac and all plugins�hotcopyz<backupdir> [--no-database]z�Make a hot backup copy of an environment The database is backed up to the 'db' directory of the destination, unless the --no-database option is specified. r z [--no-backup]a= Upgrade database to current version The database is backed up to the directory specified by [trac] backup_dir (the default is 'db'), unless the --no-backup option is specified. The shorthand alias -b can also be used to specify --no-backup. )�_complete_convert_db�_do_convert_db� _do_deploy� _do_hotcopy� _do_upgraderj r? r? r@ �get_admin_commands} s" ���� �z#EnvironmentAdmin.get_admin_commandsNc C s |r| � ||�S | �|�S r� )�_do_convert_db_in_new_env�_do_convert_db_in_place)re �dburir0 r? r? r@ r7 � s z EnvironmentAdmin._do_convert_dbc C s t |�dkr t|d �S d S )Nr r )�lenr )re rq r? r? r@ r6 � s �z%EnvironmentAdmin._complete_convert_dbc C s� t j�|�}t j�|d�}t j�|d�}t| j�}|jD ]7}t|�� p$g �}|s)q |D ]'\}} | s2q+t j�| �} t j�||�}t j� | �rRt || �rRt t d| d���q+q t |dd� t |dd� tt d�� |jD ]A}t|�� pqg �}|svqitd|j|jjf � |D ]&\}} | s�q�t j�| �} td | � t j� | �r�t j�||�}t| |dd� q�qit |dd� tt d �� | jtjtd �} d D ]8} t j�|d | �}|jd| dd�} |j| | dd�}t|ddd�� }|�|� W d � n1 s�w Y q�d S )Nr� zcgi-binz�Resources cannot be deployed to a target directory that is equal to or below the source directory '%(source)s'. Please choose a different target directory and try again.)�sourceT)� overwritezCopying resources from:z %s.%sz zCreating scripts.)rn � executable�repr)�cgi�fcgi�wsgir� z deploy_trac.)�text�wr� r� )r[ r\ r] r� r6 rn �template_providers�list�get_htdocs_dirsr� r( r r4 r* r3 r< ri r; r% r� rB rC � load_template�render_template_stringr� �write)re r �target� chrome_target� script_target�chromerz �pathsrs �rootr@ �data�script�templaterG �outr? r? r@ r8 � sj ���� � �� ���zEnvironmentAdmin._do_deployc C s� |dvrt td|d�dd��tj�|�r ttdt|�d���ttdt| jj�t|�d �� | jj � d d �}|� d d �\}}g }|dkretj� | jjtj� |��}|d |d |d |d g}|re|�|� | jj�y}|d|�d� d � z t| jj|d |d� W n; tjy� } z.d } ttd�� |jd D ]\} } } | | v r�td| � q�td| t| �f � q�W Y d }~nd }~ww d} |dkr�|s�ttd�� tj� |d d | �} | j�| � W d � n1 s�w Y ttd �� | S ) N)Nz --no-databasezInvalid argument '%(arg)s')�argT�� show_usagez+hotcopy can't overwrite existing '%(dest)s')r z!Hotcopying %(src)s to %(dst)s ...)�src�dstrE �database�:r �sqlitez-journalz -stmtjrnlz-shmz-walzUPDATE �systemz! SET name=NULL WHERE name IS NULL)�symlinks�skipz<The following errors happened while copying the environment:r z %sz %s: '%s'zBacking up database ...�dbz%s-db-backup.sqlz Hotcopy done.)r r4 r[ r\ r� r r/ r3 rn r_ r� �splitr� r] r r� �quoter% �shutil�Errorr0 rq r )re r �no_db�db_str�prefix�db_pathrc rd r� �retvalr\ r] r � sql_backupr? r? r@ r9 � sb � � � � � ��� � � � z EnvironmentAdmin._do_hotcopyc C s� |dvr t td�dd��| j�� sttd�� d S z | jj|d u d� W n$ ty; } z ttd�� |jd �d }~w t yH ttd �� � w ttd t | jj �d �� d S ) N)Nz-bz --no-backupzInvalid argumentsTrZ z-Database is up to date, no upgrade necessary.)r zTThe pre-upgrade backup failed. Use '--no-backup' to upgrade without doing a backup. r z8The upgrade failed. Please fix the issue and try again. zsUpgrade done. You may want to upgrade the Trac documentation now by running: trac-admin "%(path)s" wiki upgrader� ) r r4 rn r r3 r r: r0 rq r� r/ r\ )re � no_backupr� r? r? r@ r: s$ � � �z EnvironmentAdmin._do_upgradec C s� zt �|� W n ty Y nw t j�|�s t j�|�r$td|� dS | �||�}t| j �}|j }|� � }t|�� � }| � |||||� | � |� d S )Nz/Cannot create Trac environment: %s: File existsr )r[ �rmdir�OSErrorr\ r� �lexistsr1 � _create_envr rn r �get_connection� _copy_tables�_copy_directories)re � dst_dburir0 �dst_envr� � src_dburi�src_db�dst_dbr? r? r@ r< 7 s" �� z*EnvironmentAdmin._do_convert_db_in_new_envc C s8 t | j�}|j}||krtd|� dS tdtj�| jj�d�}z[| �||�}|� � }t |�� � }| � |||||� ~~|� � d }t |�\}} |dkrttj� | jj| d �} tj�| �} tj�| �sgt�| � t�tj� || d �| � W t�|� nt�|� w t| jdtt�� � � | j�dd |� | j�� d S ) Nz9Source database and destination database are the same: %sr z convert_db-)rk r� r` r\ z.convert_db-%drE r^ )r rn r r1 r r[ r\ r� rs rt ru r� r r� �isdirr* rg �copy�rmtreer$ �int�timer_ rx r� ) re rw r� ry r0 rx rz r{ �schema�params�dbpath�dbdirr? r? r@ r= I s> �� �z(EnvironmentAdmin._do_convert_db_in_placec s t � � � �| jjd� t� fdd�� �� D ��}||d< tdd� |�� D ��}G dd� dt�}||d|d �}|� � t � |j � t �| jj |j � ttjd d |d fttttd ��}|jdd�\}}W d � n1 skw Y |jdkr}td||f ��t|�S )Nr� c 3 s0 � | ]}� � |�D ] \}}||f|fV q qd S r� )�items�r� r� rL r� ��parserr? r@ r� m s � ��z/EnvironmentAdmin._create_env.<locals>.<genexpr>)rE r^ c s s" � | ] \\}}}|||fV qd S r� r? r� r? r? r@ r� q s � c @ s e Zd ZdZdZdd� ZdS )z8EnvironmentAdmin._create_env.<locals>.MigrateEnvironmentTFc s0 | � |�� t� fdd�dD ��sdS t�| |�S )Nc 3 s � | ]}� � |�V qd S r� )r� )r� �mod�rL r? r@ r� z s � z`EnvironmentAdmin._create_env.<locals>.MigrateEnvironment.is_component_enabled.<locals>.<genexpr>)r� ztracopt.F)r� r� r8 r� r� r? r� r@ r� x s � zMEnvironmentAdmin._create_env.<locals>.MigrateEnvironment.is_component_enabledN)r; r< r= �abstractr r� r? r? r? r@ �MigrateEnvironmentt s r� T)r` rf z-mztrac.admin.consoler )�stdin�stdout�stderrr+ rD )�inputr z-upgrade command failed (stdout %r, stderr %r))r �readrn r� �dict�sectionsrw r� r8 r� r[ rp rC rg r% r r� rB r r+ � communicate� returncoder ) re r0 r> rf r� rn �procr� r� r? r� r@ rs j s8 �� �� � �z EnvironmentAdmin._create_envc C s t | j|||||� d S r� )r! rn )re rx rz r{ ry rw r? r? r@ ru � s z EnvironmentAdmin._copy_tablesc C s� t d� | jj| jj| jj| jjfD ]2}tj�|�}tj� |j|�}t d|dd� tj� |�r4t � |� tj� |�r@t � ||� t d� qd S )NzCopying directories:z %s directory... F)�newlinezdone.)r2 rn r� r� r� rC r[ r\ rl r� r| rg r~ r% )re rx r\ rL r] r? r? r@ rv � s � �z"EnvironmentAdmin._copy_directoriesr� )r; r< r= r> r r r; r7 r6 r8 r9 r: r< r= rs ru rv r? r? r? r@ r2 v s + 7 4!% r2 )NF)^r> � contextlibr r� �os.pathr[ r} rg r� r� � configparserr � subprocessr r �tempfiler � urllib.parser rE r �trac.admin.apir r r �trac.apir r � trac.cacher r � trac.configr r r r r r r � trac.corer r r r r r � trac.db.apir r r r �trac.db.convertr! � trac.loaderr" � trac.utilr# r$ r% r& r' r( r) r* �trac.util.compatr+ �trac.util.concurrencyr, �trac.util.datefmtr- �trac.util.textr. r/ r0 r1 r2 r3 �trac.util.translationr4 r5 �trac.web.chromer6 � trac.web.hrefr7 �__all__r� � RuntimeErrorr: r8 r, �Lockr+ r9 r2 r? r? r? r@ �<module> sT $ ( ~ 7
Save
Cancel