# pgRDF

pgRDF is a Rust-native PostgreSQL extension for RDF storage, SPARQL 1.1 query
and update, SHACL validation, and OWL 2 RL or RDFS materialization inside
PostgreSQL.

## What this package contains

This PGXN package is the source distribution for `pgrdf`. It contains the
extension source, SQL fragments, build metadata, and the `Makefile` / `META.json`
surface expected by PGXN.

## Build model

The PGXN install path is source-based. `make` shells out to `cargo pgrx package`,
so the target machine needs:

- PostgreSQL 14, 15, 16, or 17 development files
- `pg_config` for the target PostgreSQL installation
- Rust 1.91 or newer
- `cargo-pgrx` 0.16
- a one-time `cargo pgrx init`

See `INSTALL.md` for the exact commands.

## Documentation

Full project documentation lives at:

- https://pgrdf.styk.tv/

Project sources, issues, and binary release artifacts live at:

- https://github.com/styk-tv/pgRDF

The GitHub Releases page publishes the existing prebuilt binary matrix
(`pgrdf-<version>-pg<PG_MAJOR>-glibc-<arch>.tar.gz` plus `SHA256SUMS`). Those
binary artifacts are separate from this PGXN source package.

## Current extension surface

- RDF storage inside PostgreSQL
- SPARQL 1.1 query and update
- SHACL Core validation
- OWL 2 RL and RDFS materialization
- PostgreSQL 14 through 17 support

## Install

Typical install flow:

```bash
pgxn install pgrdf --pg_config /path/to/pg_config
psql -d yourdb -c 'CREATE EXTENSION pgrdf;'
```

If you are building directly from an extracted archive, use the same
`PG_CONFIG=/path/to/pg_config make && make install` flow described in
`INSTALL.md`.