ad-astra 1.0.0

Embeddable scripting language platform Ad Astra. Main Crate.
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
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

////////////////////////////////////////////////////////////////////////////////
// This file is part of "Ad Astra", an embeddable scripting programming       //
// language platform.                                                         //
//                                                                            //
// This work is proprietary software with source-available code.              //
//                                                                            //
// To copy, use, distribute, or contribute to this work, you must agree to    //
// the terms of the General License Agreement:                                //
//                                                                            //
// https://github.com/Eliah-Lakhin/ad-astra/blob/master/EULA.md               //
//                                                                            //
// The agreement grants a Basic Commercial License, allowing you to use       //
// this work in non-commercial and limited commercial products with a total   //
// gross revenue cap. To remove this commercial limit for one of your         //
// products, you must acquire a Full Commercial License.                      //
//                                                                            //
// If you contribute to the source code, documentation, or related materials, //
// you must grant me an exclusive license to these contributions.             //
// Contributions are governed by the "Contributions" section of the General   //
// License Agreement.                                                         //
//                                                                            //
// Copying the work in parts is strictly forbidden, except as permitted       //
// under the General License Agreement.                                       //
//                                                                            //
// If you do not or cannot agree to the terms of this Agreement,              //
// do not use this work.                                                      //
//                                                                            //
// This work is provided "as is", without any warranties, express or implied, //
// except where such disclaimers are legally invalid.                         //
//                                                                            //
// Copyright (c) 2024 Ilya Lakhin (Илья Александрович Лахин).                 //
// All rights reserved.                                                       //
////////////////////////////////////////////////////////////////////////////////

macro_rules! debug_unreachable (
    ($message:expr) => {
        {
            #[cfg(debug_assertions)]
            {
                $crate::report::system_panic!($message);
            }

            #[allow(unreachable_code)]
            ::std::hint::unreachable_unchecked()
        }
    };

    ($message:expr, $($args:tt)*) => {
        $crate::report::debug_unreachable!(::std::format!($message, $($args)*))
    };
);

macro_rules! system_panic (
    ($message:expr) => {{
        #[cfg(not(target_family = "wasm"))]
        {
            let std_error = ::std::io::stderr();
            let mut handle = std_error.lock();

            let message = $crate::report::error_message!($message);
            let _ = ::std::io::Write::write(
                &mut handle,
                ::std::ops::Deref::deref(&message).as_bytes(),
            );
            let _ = ::std::io::Write::flush(&mut handle);

            ::std::process::abort();
        }

        #[cfg(target_family = "wasm")]
        {
            let message = $crate::report::error_message!($message);
            ::std::panic!("{}", message);
        }
    }};

    ($message:expr, $($args:tt)*) => {
        $crate::report::system_panic!(::std::format!($message, $($args)*))
    };
);

macro_rules! error_message (
    ($message:expr) => {
        ::std::format!(
r#" !! AD ASTRA INTERNAL ERROR
 !!
 !! This is a bug.
 !! If you see this message, please open an Issue: https://github.com/Eliah-Lakhin/ad-astra/issues
 !!
 !! Message: {}
 !! File: {}
 !! Line: {}
 !! Column: {}
"#,
            $message,
            ::std::panic::Location::caller().file(),
            ::std::panic::Location::caller().line(),
            ::std::panic::Location::caller().column(),
        )
    };

    ($message:expr, $($args:tt)*) => {
        $crate::report::error_message!(::std::format!($message, $($args)*))
    };
);

pub(crate) use debug_unreachable;
pub(crate) use error_message;
pub(crate) use system_panic;