pgbouncer 0.0.8

Dependencies

• Python 2.6+

• pgbouncer

• python-fixtures (https://launchpad.net/python-fixtures or http://pypi.python.org/pypi/fixtures)

• testtools (http://pypi.python.org/pypi/testtools)

Testing Dependencies

In addition to the above, the tests also depend on:

• psycopg2 (http://pypi.python.org/pypi/psycopg2)

• subunit (http://pypi.python.org/pypi/python-subunit) (optional)

• testresources (http://pypi.python.org/pypi/testresources)

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

To run the tests, run either:

$ bin/py pgbouncer/tests.py

or:

$ bin/py -m testtools.run pgbouncer.tests.test_suite