mashin_core 0.1.4

The core of mashin, consumed by the runtime engine
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

/* -------------------------------------------------------- *\
 *                                                          *
 *      ███╗░░░███╗░█████╗░░██████╗██╗░░██╗██╗███╗░░██╗     *
 *      ████╗░████║██╔══██╗██╔════╝██║░░██║██║████╗░██║     *
 *      ██╔████╔██║███████║╚█████╗░███████║██║██╔██╗██║     *
 *      ██║╚██╔╝██║██╔══██║░╚═══██╗██╔══██║██║██║╚████║     *
 *      ██║░╚═╝░██║██║░░██║██████╔╝██║░░██║██║██║░╚███║     *
 *      ╚═╝░░░░░╚═╝╚═╝░░╚═╝╚═════╝░╚═╝░░╚═╝╚═╝╚═╝░░╚══╝     *
 *                                         by Nutshimit     *
 * -------------------------------------------------------- *
 *                                                          *
 *   This file is dual-licensed as Apache-2.0 or GPL-3.0.   *
 *   see LICENSE for license details.                       *
 *                                                          *
\* ---------------------------------------------------------*/

use deno_core::error::{type_error, AnyError};

/// Defines the accepted types that can be used as
/// parameters and return values in FFI.
#[derive(Clone, Debug, serde::Deserialize, Eq, PartialEq)]
#[serde(rename_all = "lowercase")]
pub enum NativeType {
	Void,
	Bool,
	U8,
	I8,
	U16,
	I16,
	U32,
	I32,
	U64,
	I64,
	USize,
	ISize,
	F32,
	F64,
	Pointer,
	Buffer,
	Function,
	Struct(Box<[NativeType]>),
}

impl TryFrom<NativeType> for libffi::middle::Type {
	type Error = AnyError;

	fn try_from(native_type: NativeType) -> Result<Self, Self::Error> {
		Ok(match native_type {
			NativeType::Void => libffi::middle::Type::void(),
			NativeType::U8 | NativeType::Bool => libffi::middle::Type::u8(),
			NativeType::I8 => libffi::middle::Type::i8(),
			NativeType::U16 => libffi::middle::Type::u16(),
			NativeType::I16 => libffi::middle::Type::i16(),
			NativeType::U32 => libffi::middle::Type::u32(),
			NativeType::I32 => libffi::middle::Type::i32(),
			NativeType::U64 => libffi::middle::Type::u64(),
			NativeType::I64 => libffi::middle::Type::i64(),
			NativeType::USize => libffi::middle::Type::usize(),
			NativeType::ISize => libffi::middle::Type::isize(),
			NativeType::F32 => libffi::middle::Type::f32(),
			NativeType::F64 => libffi::middle::Type::f64(),
			NativeType::Pointer | NativeType::Buffer | NativeType::Function =>
				libffi::middle::Type::pointer(),
			NativeType::Struct(fields) => libffi::middle::Type::structure(match fields.len() > 0 {
				true => fields
					.iter()
					.map(|field| field.clone().try_into())
					.collect::<Result<Vec<_>, _>>()?,
				false => return Err(type_error("Struct must have at least one field")),
			}),
		})
	}
}

#[derive(Clone)]
pub struct Symbol {
	pub cif: libffi::middle::Cif,
	pub ptr: libffi::middle::CodePtr,
	pub parameter_types: Vec<NativeType>,
	pub result_type: NativeType,
}

#[allow(clippy::non_send_fields_in_send_ty)]
// SAFETY: unsafe trait must have unsafe implementation
unsafe impl Send for Symbol {}
// SAFETY: unsafe trait must have unsafe implementation
unsafe impl Sync for Symbol {}