Class Environment

Initialize the Trac environment.

@param path:   the absolute path to the Trac environment
@param create: if `True`, the environment is created and populated with
               default data; otherwise, the environment is expected to
               already exist.
@param options: A list of `(section, name, value)` tuples that define
                configuration options

Overrides: object.__init__

Simple SQLite-specific backup of the database.

@param dest: Destination file; if not specified, the backup is stored in

a file called db_name.trac_version.bak

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).

Overrides: core.ComponentManager.component_activated

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.

Return a database connection from the connection pool (deprecated)

Use with_transaction for obtaining a writable database connection and get_read_db for anything else.

Generator that yields information about all known users, i.e. users that have logged in to this Trac environment and possibly set their name and email.

This function generates one tuple for every user, of the form (username, name, email) ordered alpha-numerically by username.

@param cnx: the database connection; if ommitted, a new connection is

retrieved

Return a database connection for read purposes.

See trac.db.api.get_read_db for detailed documentation.

Return the version control repository with the given name, or the
default repository if `None`.

The standard way of retrieving repositories is to use the methods
of `RepositoryManager`. This method is retained here for backward
compatibility.

@param reponame: the name of the repository
@param authname: the user name for authorization (not used anymore,
                 left here for compatibility with 0.11)

Return the current version of the database. If the optional argument initial is set to True, the version of the database used at the time of creation will be returned.

In practice, for database created before 0.11, this will return False which is "older" than any db version number.

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 enironment.

Overrides: core.ComponentManager.is_component_enabled

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

Decorator for transaction functions.

See trac.db.api.with_transaction for detailed documentation.

base_url_for_redirect

Value:

<BoolOption [trac] "use_base_url_for_redirect">

abs_href

Get Method:

_get_abs_href(self)

Set Method:

'The application URL'

href

Get Method:

_get_href(self)

Set Method:

'The application root path'

setup_participants

Get Method:

unreachable.extensions(component) - Return a list of components that declare to implement the extension point interface.

system_info_providers

Get Method:

unreachable.extensions(component) - Return a list of components that declare to implement the extension point interface.