wakaru 1.14.0

Public Rust API for the Wakaru JavaScript decompiler
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

use std::fmt;

pub type Result<T> = std::result::Result<T, Error>;

/// The category of a fatal operation failure.
///
/// [`Emit`](ErrorKind::Emit) and [`Internal`](ErrorKind::Internal) are
/// reserved for failures where Wakaru cannot return any coherent artifact or
/// uphold its result invariants; most post-parse failures instead surface as
/// a best-effort artifact with
/// [`ModuleStatus::DecompileFailed`](crate::ModuleStatus::DecompileFailed).
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
#[non_exhaustive]
pub enum ErrorKind {
    InvalidOptions,
    InvalidInput,
    Parse,
    SourceMap,
    Emit,
    Internal,
}

pub(crate) fn from_core_driver_error(kind: wakaru_core::driver::DriverErrorKind) -> ErrorKind {
    match kind {
        wakaru_core::driver::DriverErrorKind::Parse => ErrorKind::Parse,
        wakaru_core::driver::DriverErrorKind::SourceMap => ErrorKind::SourceMap,
        wakaru_core::driver::DriverErrorKind::InvalidInput => ErrorKind::InvalidInput,
        wakaru_core::driver::DriverErrorKind::InvalidOptions => ErrorKind::InvalidOptions,
        wakaru_core::driver::DriverErrorKind::Internal => ErrorKind::Internal,
    }
}

/// A fatal operation failure: invalid options, an unusable top-level input,
/// or a failure that prevents Wakaru from returning a coherent result.
///
/// Recoverable per-module problems belong in
/// [`Diagnostic`](crate::Diagnostic) and
/// [`ModuleStatus`](crate::ModuleStatus), not in `Error`. SWC error types and
/// `anyhow::Error` are never part of the public contract.
#[derive(Debug)]
pub struct Error {
    kind: ErrorKind,
    input_filename: Option<String>,
    source: anyhow::Error,
}

impl Error {
    pub(crate) fn new(
        kind: ErrorKind,
        input_filename: Option<String>,
        source: impl Into<anyhow::Error>,
    ) -> Self {
        Self {
            kind,
            input_filename,
            source: source.into(),
        }
    }

    pub fn kind(&self) -> ErrorKind {
        self.kind
    }

    pub fn input_filename(&self) -> Option<&str> {
        self.input_filename.as_deref()
    }
}

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        self.source.fmt(f)
    }
}

impl std::error::Error for Error {
    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
        self.source.source()
    }
}