Struct MimeConfig 

pub struct MimeConfig { /* private fields */ }

Runtime configuration for MIME detectors.

Supported keys

Logical keys and environment-style keys are both accepted by MimeConfig::from_config. Environment variables use the same names as the environment-style keys.

Field	Logical key	Environment key	Default	Format
Default MIME detector	mime.detector.default	QUBIT_MIME_DETECTOR_DEFAULT	repository	Provider id, alias, or auto
MIME detector fallbacks	mime.detector.fallbacks	QUBIT_MIME_DETECTOR_FALLBACKS	empty	List split on , or ;
Media stream classifier	mime.media.stream.classifier.default	QUBIT_MEDIA_STREAM_CLASSIFIER_DEFAULT	ffprobe	Classifier selector
Precise detection switch	mime.enable.precise.detection	QUBIT_MIME_ENABLE_PRECISE_DETECTION	true	Boolean
Precise detection patterns	mime.precise.detection.patterns	QUBIT_MIME_PRECISE_DETECTION_PATTERNS	webm,ogg	Extension list
Ambiguous MIME mapping	mime.ambiguous.mime.mapping	QUBIT_MIME_AMBIGUOUS_MIME_MAPPING	webm:video/webm,audio/webm;ogg:video/ogg,audio/ogg	ext:video,audio entries split on ;

Detector fallback selection is performed by MimeDetectorRegistry, not by this config object. The config only stores the default selector and ordered fallback names.

Implementations

impl MimeConfig

pub fn load() -> Self

Loads configuration from environment variables and defaults.

Returns

Configuration used by default detector instances.

pub fn from_config(config: &Config) -> MimeResult<Self>

Creates MIME configuration from a config object.

Values are read with environment-friendly options, so both logical keys such as mime.detector.default and environment-style keys such as QUBIT_MIME_DETECTOR_DEFAULT are accepted. List values may be provided as arrays or as scalar strings split on , and ;; empty items are ignored.

Examples

Configure a preferred native detector and a repository fallback:

use qubit_config::Config;
use qubit_mime::{
    CONFIG_MIME_DETECTOR_DEFAULT,
    CONFIG_MIME_DETECTOR_FALLBACKS,
    MimeConfig,
    MimeResult,
};

let mut source = Config::new();
source.set(CONFIG_MIME_DETECTOR_DEFAULT, "file")?;
source.set(CONFIG_MIME_DETECTOR_FALLBACKS, "repository")?;

let config = MimeConfig::from_config(&source)?;
assert_eq!("file", config.mime_detector_default());
assert_eq!(
    ["repository".to_owned()].as_slice(),
    config.mime_detector_fallbacks(),
);

Parameters

• config: Configuration object containing logical keys or environment variable style keys.

Returns

Parsed MIME configuration.

Errors

Returns MimeError::Config when a present configuration value cannot be converted to the expected type.

pub fn from_env() -> MimeResult<Self>

Creates MIME configuration from process environment variables.

Returns

Parsed MIME configuration.

Errors

Returns MimeError::Config when the environment cannot be represented by Config.

pub fn set_default(config: Self)

Replaces the global default MIME configuration.

Parameters

• config: Configuration to use for future default instances.

pub fn reload_default(config: &Config) -> MimeResult<()>

Reloads the global default MIME configuration from a config object.

Parameters

• config: Configuration object used to build the new default.

Errors

Returns MimeError::Config when a present configuration value cannot be converted to the expected type.

pub fn reload_default_from_env() -> MimeResult<()>

Reloads the global default MIME configuration from process environment.

Errors

Returns MimeError::Config when the environment cannot be represented by Config.

pub fn mime_detector_default(&self) -> &str

Gets the configured default MIME detector selector.

Returns

Backend selector used by default detector wrappers.

pub fn mime_detector_fallbacks(&self) -> &[String]

Gets fallback MIME detector selectors.

Returns

Ordered fallback backend selectors.

pub fn media_stream_classifier_default(&self) -> &str

Gets the configured default media stream classifier selector.

Returns

Backend selector used by default classifier wrappers.

pub fn enable_precise_detection(&self) -> bool

Tells whether precise media-stream detection is enabled.

Returns

true when ambiguous media MIME types may be refined.

pub fn precise_detection_patterns(&self) -> &HashSet<String>

Gets extensions requiring precise detection.

Returns

Lowercase extension names without leading dots.

pub fn ambiguous_mime_mapping(&self) -> &HashMap<String, [String; 2]>

Gets ambiguous extension mappings.

Returns

Mapping from extension to [video_mime, audio_mime].

Trait Implementations

impl Clone for MimeConfig

fn clone(&self) -> MimeConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MimeConfig

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

Formats the value using the given formatter.

impl Default for MimeConfig

fn default() -> Self

Loads default configuration.