# Reldbase

Reldbase is a C++ interface to PostgreSQL, based on "The Third Manifesto",
as described in <cite>Databases, Types, and the Relational Model: The
Third Manifesto</cite>, Third Edition (2007) by C. J. Date and Hugh
Darwen and <cite>Database Explorations</cite> (2010) by the same authors.
It is based on work done in Python as part of the
[Pyrseas](https://github.com/perseas/Pyrseas) project and then
implemented in C++ as part of [Perseid](https://codeberg.org/perseas/perseid).

It provides a set of library modules:

- **reltypes** binds `attribute` and `reltuple` together: a relational
  attribute is a name and a type, and a tuple is a set of attributes
  (its heading) with associated values.

- **reldb** is a low-level database connection wrapper that executes
  SQL statements and presents result rows as tuples, parameterizing
  queries with tuple values.

## Documentation

```{toctree}
:maxdepth: 2
:caption: API Reference

api/index
```

```{toctree}
:maxdepth: 2
:caption: Developer Guide

devel/installation
devel/testing
```