psycopg2cffi

An implementation of the psycopg2 module using cffi. The module is currently compatible with Psycopg 2.5.

Installation

You can install psycopg2cffi from PyPI:

pip install psycopg2cffi

Or from source:

python setup.py install

Installation requirements are the same as for psycopg2 - you must have libpq headers, pg_config somewhere on your $PATH, Python development headers (python-dev or similar), and ffi-dev for cffi. Installation was tested on Ubuntu 12.04, Ubuntu 14.04, CentOS (RHEL 5.0), OS X 10.8 - 10.10. It should be possible to make it work on Windows, but I did not test it.

This module works under CPython 2.6+, CPython 3.2+, PyPy 2 and PyPy 3 (PyPy version should be at least 2.0, which is ancient history now).

To use this package with Django or SQLAlchemy invoke a compatibility hook (for example, from settings.py in case of Django, or from a psycopg2.py file in site-packages of your virtual env):

from psycopg2cffi import compat
compat.register()

This will map psycopg2cffi to psycopg2, so now any code that does import psycopg2 will use psycopg2cffi.

Submit issues to https://github.com/chtd/psycopg2cffi/issues

If you notice that psycopg2cffi under PyPy is noticeably slower than psycopg2 under CPython, submit this to the issues too - it should not be the case.

This is a port of (Michael van Tellingen port https://github.com/mvantellingen/psycopg2-ctypes of Alex Gaynor’s RPython port (https://bitbucket.org/alex_gaynor/pypy-postgresql/overview) of psycopg2 to Python + ctypes) to cffi.

The main motivation for a port was speed - the writeup with benchmarks is here: http://chtd.ru/blog/bystraya-rabota-s-postgres-pod-pypy/?lang=en

Development

To run tests, install pytest and run them with:

py.test psycopg2cffi

Note that for cffi>=1.0 you need to run python setup.py develop to rebuild _libpq.so (if you changed bindings). And for cffi<1.0 (only PyPy 2.5 and below) you need to run python setup.py install once to generate psycopg2cffi/_config.py, otherwise each import will run config and notify tests will fail.

You can also run Django tests. You need to checkout Django source, add psycopg2 compat as described above, and, from the root of the Django checkout:

PYTHONPATH=`pwd` ./tests/runtests.py \
    --settings=psycopg2cffi.tests.psycopg2_tests.testconfig

In case of problems with Django tests, see official Django docs https://docs.djangoproject.com/en/dev/internals/contributing/writing-code/unit-tests/#running-the-unit-tests

Release notes

2.7.5 (31 October 2016)

Windows wheels support added by ryoyoko (#69).

Bugfixes:

Non-ascii notice messages fixed by asterite3 (#72)
AsIs with non-text/bytes fixed by jinty (#64)
Silent failures in copy_from and copy_to fixed by gobbledygook88 (#62)
Infinite recursion error fixed in errorcodes.lookup (#68)
Typos in README fixed by PavloKapyshin (#66)

Fix issue #31 - bigint on 32-bit
Fix issue #32 - register_type and unicode

2.6.0 (24 Jan 2015)

Python 3 support
A bit faster reading of int, long, float, double fields

2.5.1 (14 May 2014)

Small bugfixes

2.5.0 (3 Sep 2013)

Bugfixes and a lot of compatibility work by Daniele Varrazzo

Older releases lack release notes, first release of psycopg2cffi around Nov 2012.

Release files for psycopg2cffi 2.7.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for psycopg2cffi 2.7.5
File	Size	Uploaded
psycopg2cffi-2.7.5.tar.gz	62.7 kB	Oct 31, 2016	Details

Release files / psycopg2cffi-2.7.5.tar.gz

Download URL	psycopg2cffi-2.7.5.tar.gz
Size	62.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`a36a4c74060123232abed6fa8bbc7355b322b99fc22b60191128aa20d147e290`
BLAKE2b-256 checksum How to use checksums	`6d1c3ca26d4345150331181b7ed8c3c06043a3bd730d3ddd02bcec357187c0c9`
Upload date	Oct 31, 2016
Uploaded using Trusted Publishing? What is trusted publishing?	No