fusible 0.20.3

Electronic linter: a fuse that blows to block firmware code generation
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

//! Errors of the assembly pipeline.

use std::path::PathBuf;

use miette::Diagnostic;
use thiserror::Error;

use crate::commands::body::BodyError;
use crate::commands::check::CheckError;
use crate::commands::target::TargetError;

/// Unified error enum for `fusible assembly`.
#[derive(Debug, Error, Diagnostic)]
pub enum AssemblyError {
    #[error(transparent)]
    #[diagnostic(transparent)]
    Check(#[from] CheckError),

    #[error(transparent)]
    #[diagnostic(transparent)]
    Target(#[from] TargetError),

    #[error(transparent)]
    #[diagnostic(transparent)]
    Body(#[from] BodyError),

    #[error("failed to write assembly files: {0}")]
    #[diagnostic(code(fusible::assembly::io_error))]
    Io(#[from] std::io::Error),

    #[error("fusible.yml has no `assembly:` section")]
    #[diagnostic(
        code(fusible::assembly::missing),
        help("add `assembly:` with the `parts` to place, e.g. `parts: {{main: {{}}}}`")
    )]
    Missing,

    #[error("unknown assembly format \"{format}\"")]
    #[diagnostic(
        code(fusible::assembly::unknown_format),
        help("valid formats are: `glb`, `step`, or `all`")
    )]
    UnknownFormat { format: String },

    #[error("board `{name}` has no tscircuit source, so it has no 3D model")]
    #[diagnostic(
        code(fusible::assembly::no_board_model),
        help(
            "point the board's `entry:` at its .tsx file; a Circuit JSON alone cannot be modeled"
        )
    )]
    NoBoardModel { name: String },

    #[error("board `{name}` needs a tscircuit runner to export its 3D model: {reason}")]
    #[diagnostic(
        code(fusible::assembly::board_model_failed),
        help("run `fusible doctor` to check the tscircuit runner, then rerun `fusible assembly`")
    )]
    BoardModelFailed { name: String, reason: String },

    #[error("body `{name}`: \"{}\" is not a STEP or STL file", path.display())]
    #[diagnostic(
        code(fusible::assembly::unsupported_source),
        help("export the body as .step, .stp, or .stl to place it in the assembly")
    )]
    UnsupportedSource { name: String, path: PathBuf },

    #[error("the measurement cannot be trusted: {reason}")]
    #[diagnostic(
        code(fusible::assembly::bad_measurement),
        help("rerun `fusible assembly`; if it persists, report the bug with this message")
    )]
    BadMeasurement { reason: String },

    #[error("body `{name}` loaded but is not a solid, so its overlaps cannot be measured")]
    #[diagnostic(
        code(fusible::assembly::body_not_solid),
        help(
            "export a closed, watertight solid; an open or empty STL or STEP shell has no volume"
        )
    )]
    BodyNotSolid { name: String },
}