6 releases (3 breaking)

0.4.0 Oct 2, 2024
0.3.1 May 16, 2024
0.3.0 Mar 6, 2024
0.2.0 Mar 6, 2024
0.1.0 Oct 31, 2023

#1127 in Parser implementations

Download history 1224/week @ 2024-08-18 1231/week @ 2024-08-25 1398/week @ 2024-09-01 1238/week @ 2024-09-08 1214/week @ 2024-09-15 1756/week @ 2024-09-22 1835/week @ 2024-09-29 1752/week @ 2024-10-06 2587/week @ 2024-10-13 2539/week @ 2024-10-20 2061/week @ 2024-10-27 2272/week @ 2024-11-03 2204/week @ 2024-11-10 1974/week @ 2024-11-17 2542/week @ 2024-11-24 2680/week @ 2024-12-01

9,560 downloads per month
Used in 42 crates (via hayagriva)

MIT/Apache

205KB
4.5K SLoC

Citationberg

Crates.io Documentation Build status

Dinkelberg meme: Dad from the TV show The Fairly Odd Parents exclaiming Citationberg

A library for parsing CSL styles.

[dependencies]
citationberg = "0.4"

Citationberg deserializes CSL styles from XML into Rust structs. It supports CSL 1.0.2.

This crate is not a CSL processor, so you are free to choose whatever data model and data types you need for your bibliographic needs. If you need to render citations, you can use Hayagriva which uses this crate under the hood.

Parse your style like this:

use std::fs;
use citationberg::Style;

let string = fs::read_to_string("tests/independent/ieee.csl")?;
let style = citationberg::Style::from_xml(&string)?;

let Style::Independent(independent) = style else {
    panic!("IEEE is an independent style");
};

assert_eq!(independent.info.title.value, "IEEE");

Be sure to check out the CSL styles and locales repositories into sibling folders of citationberg if you want to run the tests.

Safety

This crate forbids unsafe code.

License

This crate is dual-licensed under the MIT and Apache 2.0 licenses.

Dependencies

~1.5–2.2MB
~42K SLoC