o

�k�`	�@s0dd
lm
Z

Gdd�de
�ZGdd�de
�ZdS)�)
�	Interfacec@seZ
dZd
Zdd�ZdS)�ISystemInfoProviderzjProvider of system information, displayed in the "About Trac"
    page and in internal error reports.
    c
C�d
S)z�Yield a sequence of `(name, version)` tuples describing the
        name and version information of external packages used by a
        component.
        N�rrr�*/usr/lib/python3/dist-packages/trac/api.py�get_system_info�z#ISystemInfoProvider.get_system_infoN)�__name__�
__module__�__qualname__�__doc__rrrrrrs
rc@s(eZ
dZd
Zdd�Zdd�Zdd�ZdS)	�IEnvironmentSetupParticipanta�
Extension point interface for components that need to participate in
    the creation and upgrading of Trac environments, for example to create
    additional database tables.

    Please note that `IEnvironmentSetupParticipant` instances are called in
    arbitrary order. If your upgrades must be ordered consistently, please
    implement the ordering in a single `IEnvironmentSetupParticipant`. See
    the database upgrade infrastructure in Trac core for an example.
    c
Cr)z.Called when a new Trac environment is created.Nrrrrr�environment_created(rz0IEnvironmentSetupParticipant.environment_createdc
Cr)z�Called when Trac checks whether the environment needs to be
        upgraded.

        Should return `True` if this participant needs an upgrade to
        be performed, `False` otherwise.
        Nrrrrr�environment_needs_upgrade+rz6IEnvironmentSetupParticipant.environment_needs_upgradec
Cr)a�
Actually perform an environment upgrade.

        Implementations of this method don't need to commit any
        database transactions. This is done implicitly for each
        participant if the upgrade succeeds without an error being
        raised.

        However, if the `upgrade_environment` consists of small,
        restartable, steps of upgrade, it can decide to commit on its
        own after each successful step.
        Nrrrrr�upgrade_environment3rz0IEnvironmentSetupParticipant.upgrade_environmentN)r	r
rrrrrrrrrr
s


r
N)�	trac.corerrr
rrrr�<module>
s