pqi-ffi-0.1.0.0: README.md

# pqi-ffi

[![Hackage](https://img.shields.io/hackage/v/pqi-ffi.svg)](https://hackage.haskell.org/package/pqi-ffi)
[![Continuous Haddock](https://img.shields.io/badge/haddock-master-blue)](https://nikita-volkov.github.io/pqi-ffi/)

The FFI adapter for [`pqi`](https://github.com/nikita-volkov/pqi),
backed by [`postgresql-libpq`](https://hackage.haskell.org/package/postgresql-libpq)
(a binding to the C `libpq` library).

`Pqi.Ffi.adapter` produces `Pqi.Connection` values whose fields close over a
C-backed `PGconn`, each a near-mechanical delegation to the matching
`Database.PostgreSQL.LibPQ` function. The only work is converting between
this family's portable types (OIDs as `Word32`, indices as `Int32`, the
shared enums) and `postgresql-libpq`'s C-specific newtypes.

This adapter is the **fidelity reference** for the `pqi` family: it is the
oracle against which all other adapters are tested. The
[`pqi-conformance`](https://github.com/nikita-volkov/pqi-conformance) suite
runs every operation on both the candidate adapter and this one, asserts
byte-identical output, and thereby defines what "correct" means for the family.