marc-rs 0.1.0

# 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`:

```toml
[dependencies]
marc-rs = "0.1.0"

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

## Usage

### Parsing MARC21 Records

```rust
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

```rust
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

```rust
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:

```rust
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:

```bash
# 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](https://www.loc.gov/marc/bibliographic/)
- [MARC XML Schema](https://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd)
- [UNIMARC Manual](https://www.transition-bibliographique.fr/unimarc/manuel-unimarc-format-bibliographique/)

## License

MIT OR Apache-2.0