Metadata-Version: 1.1
Name: TracSQL
Version: 0.3
Summary: A Trac plugin for querying the project database
Home-page: http://github.com/mrjbq7/tracsql
Author: John Benediktsson
Author-email: mrjbq7@gmail.com
License: UNKNOWN
Download-URL: http://github.com/mrjbq7/tracsql/zipball/master#egg=TracSQL-0.3
Description: # TracSQL
        
        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 your raw queries may need to be
        written differently according to which SQL database is being used).
        
        
        ## Installation
        
        The TracSQL plugin can be installed using standard:
        
        ```
        $ pip 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:
        
        ```ini
        [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:
        
        ```ini
        [tracsql]
        database = sqlite:db/external.db
        ```
        
        # Examples
        
        Some screensots, showing a few of the features:
        
        ![SQL Query](https://github.com/trac-hacks/tracsql/raw/master/docs/sql-query.png)
        
        ![SQL Schema](https://github.com/trac-hacks/tracsql/raw/master/docs/sql-schema.png)
        
Platform: UNKNOWN
