Struct FileCommandMimeDetector 

pub struct FileCommandMimeDetector<'a> { /* private fields */ }

MIME detector backed by file --mime-type --brief.

Implementations

impl FileCommandMimeDetector<'static>

pub fn new() -> Self

Creates a detector using the embedded repository for filename guesses.

Returns

File command detector.

pub fn from_mime_config(config: MimeConfig) -> Self

Creates a detector using the embedded repository and explicit config.

Parameters

• config: MIME detector configuration.

Returns

File command detector.

impl<'a> FileCommandMimeDetector<'a>

pub const COMMAND: &'static str = "file"

System command executable name.

pub const MIME_TYPE_ARG: &'static str = "--mime-type"

Argument enabling MIME type output.

pub const BRIEF_ARG: &'static str = "--brief"

Argument enabling concise output.

pub fn with_repository(repository: &'a MimeRepository) -> Self

Creates a detector using an explicit repository for filename guesses.

Parameters

• repository: Repository used for filename detection.

Returns

File command detector borrowing repository.

pub fn with_repository_and_runner( repository: &'a MimeRepository, command_runner: CommandRunner, ) -> Self

Creates a detector using an explicit repository and command runner.

Parameters

• repository: Repository used for filename detection.
• command_runner: Runner used for all file command executions.

Returns

File command detector borrowing repository and owning the supplied runner.

pub fn with_repository_runner_and_config( repository: &'a MimeRepository, command_runner: CommandRunner, config: MimeConfig, ) -> Self

Creates a detector using an explicit repository, runner, and config.

Parameters

• repository: Repository used for filename detection.
• command_runner: Runner used for all file command executions.
• config: MIME detector configuration.

Returns

File command detector borrowing repository and owning the supplied runner.

pub fn core(&self) -> &MimeDetectorCore

Gets the shared detector core.

Returns

Shared detector core.

pub fn core_mut(&mut self) -> &mut MimeDetectorCore

Gets mutable shared detector core.

Returns

Mutable shared detector core.

pub fn repository(&self) -> &'a MimeRepository

Gets the repository used for filename detection.

Returns

Repository reference.

pub fn command_runner(&self) -> &CommandRunner

Gets the command runner used by this detector.

Returns

Runner used for file command executions.

pub fn set_command_runner(&mut self, command_runner: CommandRunner)

Replaces the command runner used by this detector.

Parameters

• command_runner: New runner configuration.

pub fn with_command_runner(self, command_runner: CommandRunner) -> Self

Replaces the command runner and returns the updated detector.

Parameters

• command_runner: New runner configuration.

Returns

The updated detector.

pub fn detect_file_by_content(&self, file: &Path) -> MimeResult<Option<String>>

Detects content from a local file using the file command only.

Parameters

• file: Local file path to inspect.

Returns

MIME type name, or None.

Errors

Returns MimeError::Command when the command cannot be executed.

pub fn detect_file( &self, file: &Path, policy: MimeDetectionPolicy, ) -> MimeResult<Option<String>>

Detects a local file from filename and content.

Parameters

• file: Local file path.
• policy: Strategy for resolving filename and content results.

Returns

Selected MIME type name, or None.

Errors

Returns MimeError::Command when command execution fails.

pub fn detect_reader( &self, reader: &mut dyn ReadSeek, filename: Option<&str>, policy: MimeDetectionPolicy, ) -> MimeResult<Option<String>>

Detects a seekable reader by staging its prefix to a temporary file.

Parameters

• reader: Reader to inspect. The original position is restored.
• filename: Optional filename.
• policy: Strategy for resolving filename and content results.

Returns

Selected MIME type name, or None.

Errors

Returns MimeError::Io when stream operations fail.

pub fn is_available() -> bool

Checks whether the file command is available.

Availability is checked by executing file --mime-type --brief . with a quiet command runner. This only validates that the command can be started successfully in the current process environment; it does not guarantee that every future file path can be inspected.

Returns

true when the command can be executed.

Trait Implementations

impl<'a> Clone for FileCommandMimeDetector<'a>

fn clone(&self) -> FileCommandMimeDetector<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for FileCommandMimeDetector<'a>

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

Formats the value using the given formatter.

impl Default for FileCommandMimeDetector<'static>

fn default() -> Self

Creates a detector using the embedded repository.

impl<'a> FileBasedMimeDetector for FileCommandMimeDetector<'a>

fn core(&self) -> &MimeDetectorCore

Gets the shared detector core.

fn max_test_bytes(&self) -> usize

Gets the maximum content prefix length from the repository.

fn guess_from_filename(&self, filename: &str) -> Vec<String>

Guesses MIME type names from filename rules.

fn guess_from_local_file(&self, file: &Path) -> MimeResult<Vec<String>>

Guesses MIME type names from a local file using the file command.