marc-rs

A Rust library for parsing and writing MARC21, UNIMARC, and MARC XML bibliographic records.

Features

• Support for MARC21, UNIMARC, and MARC XML formats
• Multiple character encodings (UTF-8, MARC-8, ISO-8859-*, ISO-5426)
• Parse multiple records from a single buffer
• Write single or multiple records
• Optional Serde support for serialization/deserialization
• Comprehensive field type enums organized by category

Installation

Add this to your Cargo.toml:

[dependencies]
marc-rs = "0.1.0"

# Optional: Enable Serde support
marc-rs = { version = "0.1.0", features = ["serde"] }

Usage

Parsing MARC21 Records

use marc_rs::{parse, FormatEncoding, MarcFormat, Encoding};

let data = b"..."; // MARC binary data
let format_encoding = FormatEncoding::new(MarcFormat::Marc21, Encoding::Marc8);
let records = parse(data, format_encoding)?;

for record in records {
    println!("Record with {} fields", record.data_fields.len());
}

Writing MARC XML

use marc_rs::{write, FormatEncoding, Record};
use std::io::stdout;

let records = vec![/* your records */];
let format_encoding = FormatEncoding::marc_xml();
write(&records, format_encoding, &mut stdout())?;

Using Field Enums

use marc_rs::{MainEntry, Title, Subject, MarcFormat};

// Tags depend on the format
let format = MarcFormat::Marc21;
let main_entry_tag = MainEntry::PersonalName.tag(format); // "100" in MARC21, "700" in UNIMARC
let title_tag = Title::TitleStatement.tag(format); // "245" in MARC21, "200" in UNIMARC
let subject_tag = Subject::SubjectTopicalTerm.tag(format); // "650" in MARC21, "606" in UNIMARC

Serde Support

With the serde feature enabled, you can serialize/deserialize directly to/from MARC formats:

use marc_rs::{Record, FormatEncoding, MarcFormat, Encoding, serde_marc};
use std::fs::File;

// Deserialize from bytes
let data = b"..."; // MARC binary data
let format = FormatEncoding::new(MarcFormat::Marc21, Encoding::Marc8);
let record = serde_marc::from_slice(data, format)?;

// Deserialize from reader
let file = File::open("record.mrc")?;
let record = serde_marc::from_reader(file, format)?;

// Deserialize from string (for XML)
let xml = r#"<?xml version="1.0"?><record>...</record>"#;
let xml_format = FormatEncoding::marc_xml();
let record = serde_marc::from_str(xml, xml_format)?;

// Serialize to bytes
let bytes = serde_marc::to_vec(&record, format)?;

// Serialize to writer
let mut output = Vec::new();
serde_marc::to_writer(&record, format, &mut output)?;

// Serialize to string (for XML)
let xml_string = serde_marc::to_string(&record, xml_format)?;

// Multiple records
let records = serde_marc::from_slice_many(data, format)?;
let bytes = serde_marc::to_records(&records, format)?;

// Or use JSON for cross-format serialization
use serde_json;
let json = serde_json::to_string(&record)?;
let deserialized: Record = serde_json::from_str(&json)?;

Format Support

MARC21

• Binary format parsing and writing
• XML format parsing and writing
• Default encoding: MARC-8

UNIMARC

• Binary format parsing and writing
• XML format parsing and writing
• Default encoding: UTF-8

MARC XML

• Full XML parsing with collection support
• XML writing with automatic collection wrapping for multiple records

Character Encodings

Supported encodings:

• UTF-8
• MARC-8 (fallback to ISO-8859-1)
• ISO-8859-1 (Latin-1)
• ISO-8859-2 (Latin-2)
• ISO-8859-5 (Cyrillic)
• ISO-8859-7 (Greek)
• ISO-8859-15 (Latin-9)
• ISO-5426 (Extension of the Latin alphabet for bibliographic information interchange)

Field Categories

The library provides enums for different field categories:

• Main Entry (1XX): Personal names, corporate names, meeting names, uniform titles
• Title (20X-24X): Title statements, varying forms, former titles
• Edition (25X): Edition statements, cartographic data, computer file characteristics
• Physical Description (3XX): Physical descriptions, playing time, publication frequency
• Series (4XX): Series statements and added entries
• Notes (5XX): General notes, contents notes, summary, etc.
• Subject Access (6XX): Subject headings, topical terms, geographic names
• Added Entries (70X-75X): Personal names, corporate names, uniform titles
• Linking Entries (76X-78X): Series entries, translation entries, related entries
• Control Fields (00X): Control numbers, fixed-length data elements

Command Line Tool

The crate includes a command-line viewer tool to inspect MARC files:

# Build the viewer (requires serde feature)
cargo build --bin marc-viewer --features serde

# View a MARC file (auto-detect format, plain output)
cargo run --bin marc-viewer --features serde -- path/to/file.mrc

# Specify format explicitly
cargo run --bin marc-viewer --features serde -- path/to/file.mrc marc21

# Specify format and encoding
cargo run --bin marc-viewer --features serde -- path/to/file.mrc unimarc utf8

# Output in JSON format
cargo run --bin marc-viewer --features serde -- path/to/file.mrc marc21 utf8 json

# Output in XML format
cargo run --bin marc-viewer --features serde -- path/to/file.mrc marc21 utf8 xml

# Output in MARC21 binary format
cargo run --bin marc-viewer --features serde -- path/to/file.mrc marc21 utf8 marc > output.mrc

# Output in UNIMARC binary format
cargo run --bin marc-viewer --features serde -- path/to/file.mrc unimarc utf8 unimarc > output.mrc

The viewer supports five output formats:

• plain (default): Human-readable text format with leader, control fields, and data fields
• json: JSON serialization using serde_json
• xml: MARC XML format using serde_marc
• marc or marc21: MARC21 binary format using serde_marc (outputs to stdout)
• unimarc: UNIMARC binary format using serde_marc (outputs to stdout)

The plain format displays:

• File information and detected format
• Leader information
• All control fields (001-009)
• All data fields with indicators and subfields

References

• MARC 21 Format for Bibliographic Data
• MARC XML Schema
• UNIMARC Manual

License

MIT OR Apache-2.0