Skip to content

Tutorials

Step-by-step guides for learning MRRC. Each tutorial builds on previous concepts.

Choose Your Path

MRRC provides both Python and Rust APIs. Choose based on your needs:

If you... Start with
Are a Python developer Python Tutorials
Are a Rust developer Rust Tutorials
Want maximum performance Rust (native) or Python with threading
Are migrating from pymarc Python Tutorials + Migration Guide

Python Tutorials

For Python developers. Covers the PyO3 bindings with pymarc-compatible API.

  1. Reading Records - Load MARC files and iterate over records
  2. Writing Records - Create and save MARC records
  3. Format Conversion - Convert between JSON, XML, and other formats
  4. Querying Fields - Use the Query DSL for complex field matching
  5. Concurrency - Parallel processing with threading

Rust Tutorials

For Rust developers. Covers the native API with builder patterns and traits.

  1. Reading Records - Parse MARC files with MarcReader
  2. Writing Records - Build records with the builder pattern
  3. Format Conversion - Serialize to JSON, XML, BIBFRAME, and more
  4. Querying Fields - Use query types for field filtering
  5. Concurrency - Parallel processing with Rayon

Prerequisites

Before starting the tutorials:

  • Python: Install with pip install mrrc or uv add mrrc
  • Rust: Add to Cargo.toml with cargo add mrrc

See Installation for detailed setup instructions.

Next Steps

After completing the tutorials: