Struct AuthorityMarcReader 

pub struct AuthorityMarcReader<R: Read> { /* private fields */ }

Reader for ISO 2709 binary MARC Authority records.

AuthorityMarcReader reads Authority record data and converts it to AuthorityRecord instances. It reuses the same binary format as bibliographic records but organizes fields by their functional role (heading, tracings, notes, etc.).

Backends

The reader automatically detects the input source:

• File paths → RustFile backend (parallel-safe)
• Bytes/BytesIO → CursorBackend (parallel-safe)
• Python file objects → PythonFile (sequential, requires GIL)

Implementations

impl<R: Read> AuthorityMarcReader<R>

pub fn new(reader: R) -> Self

Create a new Authority MARC reader.

Arguments

• reader - Any source implementing std::io::Read

pub fn with_recovery_mode(self, mode: RecoveryMode) -> Self

Set the recovery mode for handling malformed records.

The recovery mode determines how the reader handles truncated or malformed Authority records:

• Strict: Return errors immediately (default)
• Lenient: Attempt to recover and salvage valid data
• Permissive: Be very lenient, accepting partial data

pub fn with_validation_level(self, level: ValidationLevel) -> Self

Set the validation level. See crate::MarcReader::with_validation_level for semantics.

pub fn with_source(self, name: impl Into<String>) -> Self

Attach a source identifier (filename or stream id) to errors raised by this reader. Populates source_name on every emitted error where applicable. Use AuthorityMarcReader::from_path when constructing from a filesystem path to set this automatically.

pub fn with_max_errors(self, n: usize) -> Self

Cap the number of recovered errors tolerated in one stream before the reader raises crate::MarcError::FatalReaderError and halts.

See crate::MarcReader::with_max_errors for semantics; passing 0 disables the cap (unbounded accumulation). Default when not set is crate::recovery::DEFAULT_MAX_ERRORS.

impl AuthorityMarcReader<BufReader<File>>

pub fn from_path(path: impl AsRef<Path>) -> Result<Self>

Open path for reading and create an AuthorityMarcReader whose errors include the path as their source_name. Reads go through a 64 KiB buffer, so the per-record read loop does not issue per-record syscalls.

Errors

Returns the underlying std::io::Error if the file cannot be opened.

impl<R: Read> AuthorityMarcReader<R>

pub fn read_record(&mut self) -> Result<Option<AuthorityRecord>>

Read the next Authority record from the stream.

Returns Ok(None) when the end of file is reached.

Errors

Returns an error if the binary data is malformed or an I/O error occurs.

pub fn iter_with_errors( &mut self, ) -> impl Iterator<Item = Result<(AuthorityRecord, Arc<Vec<MarcError>>)>> + '_

Iterate over records paired with accumulated parse errors. See crate::MarcReader::iter_with_errors for semantics.

Trait Implementations

impl<R: Debug + Read> Debug for AuthorityMarcReader<R>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.