citum_store 0.83.0

Citum style and locale storage layer — registry, cache, and resolver chain
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# citum_store

Platform-aware storage layer for user-installed Citum styles and locales.
Provides a `StoreResolver` that searches XDG data directories for custom
styles and locales, falling back to embedded builtins when nothing local
matches.

Supports YAML, JSON, and CBOR formats. With the `http` feature, the
resolver chain can also fetch styles from remote registries on demand
(using `rustls` only — no system OpenSSL dependency).

## Usage

A `StoreResolver` resolves a style URI against a single data directory
and returns a parsed `Style` (the resolver handles format detection
and YAML/JSON/CBOR parsing under the hood):

```rust
use citum_store::{StoreFormat, StoreResolver};
use std::path::PathBuf;

let store_dir = PathBuf::from(std::env::var("HOME")? + "/.local/share/citum");
let resolver = StoreResolver::new(store_dir, StoreFormat::Yaml);

let style = resolver.resolve_style("my-custom-style")?;
```

For the standard XDG + embedded-fallback chain (and HTTP fetches when
the `http` feature is on), use `build_standard_chain`, which composes
the platform-appropriate resolvers automatically:

```rust
use citum_store::build_standard_chain;

let chain = build_standard_chain()?;
let style = chain.resolve_style("apa-7th")?;
```

## Project

Part of [Citum](https://github.com/citum/citum-core), a modern citation
engine in Rust.

## License

Dual-licensed under [MIT](../../LICENSE) or [Apache-2.0](../../LICENSE-APACHE)
at your option.