cadmpeg 0.5.5

Convert and inspect native CAD files.
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145

// SPDX-License-Identifier: Apache-2.0
//! Encoder construction at the CLI boundary.
//!
//! Format-specific write options are chosen before calling these helpers, so a
//! Cadir encoder cannot carry STEP options.

use cadmpeg_core::CodecError;
use cadmpeg_ir::codec::{CadirEncoder, Encoder};

use crate::Format;

/// Format-specific options required to construct an encoder.
#[derive(Debug, Clone)]
pub enum EncoderRequest {
    /// Neutral encoder with no format-specific options.
    Neutral,
    /// STEP header and schema options.
    #[cfg(feature = "step")]
    Step(cadmpeg_codec_step::StepWriteOptions),
    /// Rhino archive version.
    #[cfg(feature = "rhino")]
    Rhino(cadmpeg_codec_rhino::RhinoArchiveVersion),
    /// IGES specification version.
    #[cfg(feature = "iges")]
    Iges(cadmpeg_codec_iges::IgesWriteOptions),
}

/// Builds the encoder for an export format from an already-selected request.
///
/// Cadir and STEP options are distinct request variants, so they are not
/// representable together.
#[cfg_attr(
    not(any(feature = "step", feature = "rhino", feature = "iges")),
    allow(clippy::needless_pass_by_value)
)]
pub fn build_encoder(
    format: Format,
    request: EncoderRequest,
) -> Result<Box<dyn Encoder>, CodecError> {
    match format {
        Format::Cadir => {
            require_neutral(&request, "cadir")?;
            Ok(Box::new(CadirEncoder))
        }
        #[cfg(feature = "step")]
        Format::Step => match request {
            EncoderRequest::Step(options) => {
                Ok(Box::new(cadmpeg_codec_step::StepCodec { options }))
            }
            _ => Err(CodecError::Malformed(
                "STEP encoder requires STEP target options".into(),
            )),
        },
        #[cfg(feature = "fcstd")]
        Format::Fcstd => {
            require_neutral(&request, "fcstd")?;
            Ok(Box::new(cadmpeg_codec_freecad::FcstdCodec))
        }
        #[cfg(feature = "f3d")]
        Format::F3d => {
            require_neutral(&request, "f3d")?;
            Ok(Box::new(cadmpeg_codec_f3d::F3dCodec))
        }
        #[cfg(feature = "sldprt")]
        Format::Sldprt => {
            require_neutral(&request, "sldprt")?;
            Ok(Box::new(cadmpeg_codec_sldprt::SldprtCodec))
        }
        #[cfg(feature = "rhino")]
        Format::Rhino => match request {
            EncoderRequest::Rhino(version) => {
                Ok(Box::new(cadmpeg_codec_rhino::RhinoEncoder::new(version)))
            }
            _ => Err(CodecError::Malformed(
                "Rhino encoder requires Rhino target options".into(),
            )),
        },
        #[cfg(feature = "iges")]
        Format::Iges => match request {
            EncoderRequest::Iges(options) => {
                Ok(Box::new(cadmpeg_codec_iges::IgesEncoder::new(options)))
            }
            _ => Err(CodecError::Malformed(
                "IGES encoder requires IGES target options".into(),
            )),
        },
    }
}

// When no option-bearing codec feature is on, Neutral is the only
// EncoderRequest variant: the Err path is absent and Result is always Ok.
#[cfg_attr(
    not(any(feature = "step", feature = "rhino", feature = "iges")),
    allow(clippy::unnecessary_wraps)
)]
fn require_neutral(request: &EncoderRequest, id: &str) -> Result<(), CodecError> {
    match request {
        EncoderRequest::Neutral => {
            let _ = id;
            Ok(())
        }
        // Non-Neutral variants exist only when their codec features are on.
        // With `--features sldprt` alone, Neutral is the sole variant and this
        // arm must not compile, or `-D unreachable-patterns` fails the gate.
        #[cfg(any(feature = "step", feature = "rhino", feature = "iges"))]
        _ => Err(CodecError::malformed(format_args!(
            "target options do not belong to the {id} encoder"
        ))),
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn every_exportable_format_builds_an_encoder() {
        for (format, request) in [
            (Format::Cadir, EncoderRequest::Neutral),
            #[cfg(feature = "step")]
            (
                Format::Step,
                EncoderRequest::Step(cadmpeg_codec_step::StepWriteOptions::default()),
            ),
            #[cfg(feature = "fcstd")]
            (Format::Fcstd, EncoderRequest::Neutral),
            #[cfg(feature = "f3d")]
            (Format::F3d, EncoderRequest::Neutral),
            #[cfg(feature = "sldprt")]
            (Format::Sldprt, EncoderRequest::Neutral),
            #[cfg(feature = "rhino")]
            (
                Format::Rhino,
                EncoderRequest::Rhino(cadmpeg_codec_rhino::RhinoArchiveVersion::V8),
            ),
            #[cfg(feature = "iges")]
            (
                Format::Iges,
                EncoderRequest::Iges(cadmpeg_codec_iges::IgesWriteOptions::default()),
            ),
        ] {
            build_encoder(format, request).expect("encoder builds");
        }
    }
}