qubit-mime 0.2.2

MIME type detection utilities for Rust based on filename glob rules and content magic
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

/*******************************************************************************
 *
 *    Copyright (c) 2026 Haixing Hu.
 *
 *    SPDX-License-Identifier: Apache-2.0
 *
 *    Licensed under the Apache License, Version 2.0.
 *
 ******************************************************************************/
//! Provider for the built-in system `file` command MIME detector.

use crate::{
    FileCommandMimeDetector,
    MimeConfig,
    MimeDetector,
    MimeResult,
};

use super::{
    MimeDetectorAvailability,
    MimeDetectorProvider,
};

/// Provider for the built-in system `file` command detector.
#[derive(Debug, Clone, Copy, Default)]
pub struct FileCommandMimeDetectorProvider;

impl MimeDetectorProvider for FileCommandMimeDetectorProvider {
    /// Gets the canonical provider identifier.
    fn id(&self) -> &'static str {
        "file"
    }

    /// Gets file command detector aliases.
    fn aliases(&self) -> &'static [&'static str] {
        &["file-command", "file-command-mime-detector"]
    }

    /// Gives the file command provider higher auto priority than repository.
    fn priority(&self) -> i32 {
        10
    }

    /// Checks whether the `file` command is available.
    fn availability(&self, _config: &MimeConfig) -> MimeDetectorAvailability {
        if FileCommandMimeDetector::is_available() {
            MimeDetectorAvailability::Available
        } else {
            MimeDetectorAvailability::Unavailable {
                reason: "`file` command is not available".to_owned(),
            }
        }
    }

    /// Creates a file-command-backed detector.
    fn create(&self, config: &MimeConfig) -> MimeResult<Box<dyn MimeDetector>> {
        Ok(Box::new(FileCommandMimeDetector::from_mime_config(
            config.clone(),
        )))
    }
}