Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Plugin to perform SQL queries on the project database for Trac.
Python HTML CSS
Tree: 3990c329d2

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
docs
tracsql
COPYRIGHT
LICENSE
README
setup.py

README

=============
   TracSQL
=============


Description
===========

The TracSQL project is a plugin for the Trac project management tool.

A "SQL" tab is added to the Trac project.  Inside this tab, the plugin
supports interacting with the project database.

Some features include:

* perform queries on the project database
* view results as raw or formatted (and hyper-linked) output
* export result set in CSV
* browse the database schema (including table and index information)

This plugin supports Trac installations with SQLite, MySQL, and PostgreSQL
database backends (although the queries will need to be written differently
according to which SQL database is being used).


Installation
============

The TracSQL plugin can be installed using standard::

    $ easy_install tracsql

Or, grab the sources and build using::

    $ python setup.py install


Configuration
=============

It is configured in the ``trac.ini`` file by enabling and configuring::

    [components]
    tracsql.* = enabled

The ``TRAC_ADMIN`` permission is used to control access to the query pages.

By default, the TracSQL plugin connects to the project database.  To use an
external database, set the ``database`` parameter in the ``tracsql`` section
of the ``trac.ini`` file to a valid database connection string::

    [tracsql]
    database = sqlite:db/external.db
Something went wrong with that request. Please try again.