# Papyri

Papyri is a [OCI Distribution Spec](https://github.com/opencontainers/distribution-spec)
compliant container registry that is consumable as a Rust library for use with
[axum](https://github.com/tokio-rs/axum). An example server is provided for
illistrative purposes and a full-featured standalone container registry might
be implemented in the future. This library is intended to be used in
[Ayllu](https://ayllu-forge.org) but may be useful elsewhere.

Note that this code has only been tested for use with Podman.

## OCI Distribution Test

The distribution spec contains a compliance test that is package in the form of a container.
Build the container provided [here](https://github.com/opencontainers/distribution-spec/tree/main/conformance)
and then run `scripts/conformance_test.sh`. Results are saved in the `results/` directory.

## Running the Example

First add a new insecure registry to your `/etc/containers/registries.conf`.

```toml
[[registry]]
location = "localhost:8700"
insecure = true
```

Then run the example server:

```sh
cargo run --example=server
```
And finally interact with the dev server:

```sh
podman login localhost:8700
podman tag alpine:3 localhost:8700/alpine:3
podman push localhost:8700/alpine:3
podman pull localhost:8700/alpine:3
```