pria 0.1.3

Rusty asset pre-processor.
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
62

use std::{
    fmt::Display,
    path::{Path, PathBuf},
};

/// Defines what scenarios the processor runs in, output of [`Processor::criteria`].
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum ProcessorCriteria {
    EverythingElse,
    Extensions(&'static [&'static str]),
}

#[derive(Debug, Clone)]
pub struct ProcessorCriteriaConflict {
    pub new: ProcessorCriteria,
    pub existing: ProcessorCriteria,
}

impl Display for ProcessorCriteriaConflict {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "cannot insert handler: its criteria ({:?}) conflicts with an already existing criteria ({:?})", self.new, self.existing)
    }
}

/// The output of [`Processor::process`].
pub struct ProcessOutput {
    pub bytes: Vec<u8>,
    /// The preferred file extension of the output, if ``None``, the extension will not change.
    pub preferred_extension: Option<&'static str>,
}

/// Handles input files, transforms it somehow and spits out the result.
pub trait Processor {
    fn criteria(&self) -> ProcessorCriteria;
    fn process(
        &self,
        bytes: Vec<u8>,
        parameters_bytes: Option<Vec<u8>>,
        source_path: &Path,
    ) -> Result<ProcessOutput, anyhow::Error>;
}

/// Simply copies the source data.
pub struct CopyProcessor;

impl Processor for CopyProcessor {
    fn criteria(&self) -> ProcessorCriteria {
        ProcessorCriteria::EverythingElse
    }

    fn process(
        &self,
        bytes: Vec<u8>,
        _parameters_bytes: Option<Vec<u8>>,
        _source_path: &Path,
    ) -> Result<ProcessOutput, anyhow::Error> {
        Ok(ProcessOutput {
            bytes,
            preferred_extension: None,
        })
    }
}