cad_import 0.3.1

A simple library for importing CAD data from different formats into a uniform in-memory structure.
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

use std::{path::Path, collections::{BTreeMap, BTreeSet}};

use crate::{error::Error, structure::CADData};

use super::{FileResource, Resource};

pub type ExtensionMap = BTreeMap<String, BTreeSet<String>>;

/// The trait for a registered loader.
pub trait Loader {
    /// Returns a reference onto the name of the loader.
    fn get_name(&self) -> &str;

    /// Returns the priority of the loader. The higher the priority the more likely that the
    /// loader is chosen if multiple loaders match for a given resource.
    fn get_priority(&self) -> u32;

    /// Returns a map of known file extensions with their respective mime types for the loader.
    fn get_extensions_mime_type_map(&self) -> ExtensionMap;

    /// Returns list of supported mime types for the formats the loader is supporting.
    fn get_mime_types(&self) -> Vec<String>;

    /// Reads the CAD data from the given reader. If something happens, the loader will return
    /// a error message.
    ///
    /// # Arguments
    /// * `reader` - The reader from which the loader will read the cad data.
    fn read(&self, resource: &dyn Resource) -> Result<CADData, Error>;

    /// Reads the CAD data from the given path. If something happens, the loader will return
    /// a error message.
    ///
    /// # Arguments
    /// * `p` - The path from which the loader will read the cad data.
    fn read_file(&self, p: &Path, mime_type: &str) -> Result<CADData, Error> {
        let f = FileResource::new(p.to_owned(), mime_type);
        self.read(&f)
    }
}