Metadata-Version: 2.4
Name: arcana-tarot
Version: 0.2.0
Summary: Implementation of the Arcana Land tarot deck specification
Keywords: tarot,tarot-deck,esoterica,tarot-spread,cards
Author-Email: Adam Fidel <adam@arcana.land>
License-Expression: MIT
License-File: LICENSE
Project-URL: Homepage, https://arcana.land
Project-URL: Repository, https://github.com/arcanaland/libarcana
Project-URL: Issues, https://github.com/arcanaland/libarcana/issues
Requires-Python: >=3.12
Description-Content-Type: text/markdown

# libarcana

`libarcana` is C++ library implementing Arcana Land's [Tarot Deck spec](https://github.com/arcanaland/specifications).

## Building

Builds use a Fedora container via podman invoked by `just` (>= 1.32).

```bash
just build-image && just build && just test
```

## Build options

| Option | Default | Notes |
|---|---|---|
| `ARCANA_BUILD_TESTS` | on at top level | Off automatically when a subproject. |
| `ARCANA_INSTALL` | on at top level | Install lib in a staged prefix. |
| `ARCANA_FETCH_REFERENCE_DECKS` | `ON` | Downloads [reference-decks](https://github.com/arcanaland/reference-decks) for tests. |
| `ARCANA_REFERENCE_DECKS_TAG` | pinned SHA | Commit to test against. |
| `ARCANA_REFERENCE_DECKS_DIR` | empty | Local path that overrides  `ARCANA_FETCH_REFERENCE_DECKS`. |
| `ARCANA_BUILD_PYTHON` | `OFF` | Builds the Python binding. |

