parity-wasm 0.45.0

WebAssembly low-level format library
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
110
111
112
113
114
115
116
117
118
119
120

use super::invoke::{Identity, Invoke};
use crate::elements;
use alloc::{borrow::ToOwned, string::String};

/// Export entry builder
pub struct ExportBuilder<F = Identity> {
	callback: F,
	field: String,
	binding: elements::Internal,
}

impl ExportBuilder {
	/// New export builder
	pub fn new() -> Self {
		ExportBuilder::with_callback(Identity)
	}
}

impl Default for ExportBuilder {
	fn default() -> Self {
		Self::new()
	}
}

impl<F> ExportBuilder<F> {
	/// New export entry builder in the specified chained context
	pub fn with_callback(callback: F) -> Self {
		ExportBuilder { callback, field: String::new(), binding: elements::Internal::Function(0) }
	}

	/// Set the field name of the export entry
	pub fn field(mut self, field: &str) -> Self {
		self.field = field.to_owned();
		self
	}

	/// Specify the internal module mapping for this entry
	pub fn with_internal(mut self, external: elements::Internal) -> Self {
		self.binding = external;
		self
	}

	/// Start the internal builder for this export entry
	pub fn internal(self) -> ExportInternalBuilder<Self> {
		ExportInternalBuilder::with_callback(self)
	}
}

impl<F> ExportBuilder<F>
where
	F: Invoke<elements::ExportEntry>,
{
	/// Finalize export entry builder spawning the resulting struct
	pub fn build(self) -> F::Result {
		self.callback.invoke(elements::ExportEntry::new(self.field, self.binding))
	}
}

impl<F> Invoke<elements::Internal> for ExportBuilder<F> {
	type Result = Self;
	fn invoke(self, val: elements::Internal) -> Self {
		self.with_internal(val)
	}
}

/// Internal mapping builder for export entry
pub struct ExportInternalBuilder<F = Identity> {
	callback: F,
	binding: elements::Internal,
}

impl<F> ExportInternalBuilder<F>
where
	F: Invoke<elements::Internal>,
{
	/// New export entry internal mapping for the chained context
	pub fn with_callback(callback: F) -> Self {
		ExportInternalBuilder { callback, binding: elements::Internal::Function(0) }
	}

	/// Map to function by index
	pub fn func(mut self, index: u32) -> F::Result {
		self.binding = elements::Internal::Function(index);
		self.callback.invoke(self.binding)
	}

	/// Map to memory
	pub fn memory(mut self, index: u32) -> F::Result {
		self.binding = elements::Internal::Memory(index);
		self.callback.invoke(self.binding)
	}

	/// Map to table
	pub fn table(mut self, index: u32) -> F::Result {
		self.binding = elements::Internal::Table(index);
		self.callback.invoke(self.binding)
	}

	/// Map to global
	pub fn global(mut self, index: u32) -> F::Result {
		self.binding = elements::Internal::Global(index);
		self.callback.invoke(self.binding)
	}
}

/// New builder for export entry
pub fn export() -> ExportBuilder {
	ExportBuilder::new()
}

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

	#[test]
	fn example() {
		let entry = export().field("memory").internal().memory(0).build();
		assert_eq!(entry.field(), "memory");
	}
}