Module analysis

FlacCompagnon analyses produced in-process or imported from a saved report.

Aède describes what a file contains by reading its structure; it does not decode. A decoder answers questions no structural read can: is this FLAC a re-encoded MP3, was it upsampled, where does its spectrum stop, how loud is it really, and — the decisive one — does the audio still match the MD5 the encoder wrote in STREAMINFO.

FlacCompagnon does that pass through aede analyze; its saved reports can also be imported later.

Acoustic values are never merged into Aède’s own. They sit beside them, attributed to their source, because a verdict carries the method that produced it: overwriting effective_bit_depth — read from the wasted-bits counts of the frames — with a figure obtained by decoding would leave the catalog unable to say where the number came from, and unable to notice that the two disagree. Noticing is the point.

Modules

export

Reconstruct scoped FlacCompagnon reports from retained source entries.

Structs

Attachment

What became of a batch of records handed to merge_into.

FileAnalysis

One file, as FlacCompagnon measured it.

Report

What a report file turned out to hold.

Enums

ImportError

Anything that can stop a report from being read.

Constants

FLACCOMPAGNON_FORMAT

The report format this reader understands.

RESULT_DATE_FIELD

Exact per-entry measurement date retained when Aède rewrites reused results.

Functions

looks_like_a_report

true when a file announces itself as a report, on a glance at its head.

merge_into

Stores records in the catalog, attaching each to the file it describes.

parse_report

Parse a report already held in memory, including a newly produced analysis.

parse_report_at

Parse a report with its file date as fallback for entries without an exact date.

read_report

Reads a FlacCompagnon report.

reconcile

Attaches the records that were still waiting for their file.