Metadata-Version: 1.0
Name: pgbouncer
Version: 0.0.2
Summary: Fixture to bring up temporary pgbouncer instance.
Home-page: https://launchpad.net/python-pgbouncer
Author: Launchpad Developers
Author-email: launchpad-dev@lists.launchpad.net
License: UNKNOWN
Description: ************************************************
        python-pgbouncer: Python glue to drive pgbouncer
        ************************************************
        
            Copyright (c) 2011, Canonical Ltd
        
            This program is free software: you can redistribute it and/or modify
            it under the terms of the GNU Affero General Public License as published by
            the Free Software Foundation, either version 3 of the License, or
            (at your option) any later version.
        
            This program is distributed in the hope that it will be useful,
            but WITHOUT ANY WARRANTY; without even the implied warranty of
            MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
            GNU Affero General Public License for more details.
        
            You should have received a copy of the GNU Affero General Public License
            along with this program.  If not, see <http://www.gnu.org/licenses/>.
          
        python-pgbouncer provides a python interface to setup and run a pgbouncer
        instance.
        
        Dependencies
        ============
        
        * Python 2.6+
        
        * pgbouncer
        
        * python-fixtures (https://launchpad.net/python-fixtures or
          http://pypi.python.org/pypi/fixtures)
        
        Testing Dependencies
        ====================
        
        * subunit (http://pypi.python.org/pypi/python-subunit) (optional)
        
        * testtools (http://pypi.python.org/pypi/testtools)
        
        * van.pg (http://pypi.python.org/pypi/van.pg)
        
        Usage
        =====
        
        Create a PGBouncerFixture - a context manager with an extended protocol
        supporting access to logs etc. Customise it with database definitions, user
        credentials, and then when you enter the context it will create a transient
        pgbouncer setup in a temporary directory and run it for the duration that the
        context is open.
        
        For instance::
        
         >>> from pgbouncer import PGBouncerFixture
         >>> bouncer = PGBouncerFixture()
         >>> bouncer.databases['mydb'] = 'host=hostname dbname=foo'
         >>> bouncer.users['user1'] = 'credentials'
         >>> with bouncer:
         ...     # Can now connect to bouncer.host port=bouncer.port user=user1
        
        Any settings required for pgbouncer to work will be given sane defaults.
        
        
        Installation
        ============
        
        Either run setup.py in an environment with all the dependencies available, or
        add the working directory to your PYTHONPATH.
        
        
        Development
        ===========
        
        Upstream development takes place at https://launchpad.net/python-pgbouncer.
        To setup a working area for development, if the dependencies are not
        immediately available, you can use ./bootstrap.py to create bin/buildout, then
        bin/py to get a python interpreter with the dependencies available.
        
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
