/rust/registry/src/index.crates.io-6f17d22bba15001f/wasm-encoder-0.32.0/src/component.rs

Source (jump to first uncovered line)
mod aliases;
mod builder;
mod canonicals;
mod components;
mod exports;
mod imports;
mod instances;
mod modules;
mod names;
mod start;
mod types;

pub use self::aliases::*;
pub use self::builder::*;
pub use self::canonicals::*;
pub use self::components::*;
pub use self::exports::*;
pub use self::imports::*;
pub use self::instances::*;
pub use self::modules::*;
pub use self::names::*;
pub use self::start::*;
pub use self::types::*;

use crate::{CustomSection, Encode, ProducersSection, RawCustomSection};

// Core sorts extended by the component model
const CORE_TYPE_SORT: u8 = 0x10;
const CORE_MODULE_SORT: u8 = 0x11;
const CORE_INSTANCE_SORT: u8 = 0x12;

const CORE_SORT: u8 = 0x00;
const FUNCTION_SORT: u8 = 0x01;
const VALUE_SORT: u8 = 0x02;
const TYPE_SORT: u8 = 0x03;
const COMPONENT_SORT: u8 = 0x04;
const INSTANCE_SORT: u8 = 0x05;

/// A WebAssembly component section.
///
/// Various builders defined in this crate already implement this trait, but you
/// can also implement it yourself for your own custom section builders, or use
/// `RawSection` to use a bunch of raw bytes as a section.
pub trait ComponentSection: Encode {
    /// Gets the section identifier for this section.
    fn id(&self) -> u8;

    /// Appends this section to the specified destination list of bytes.
    fn append_to_component(&self, dst: &mut Vec<u8>) {
        dst.push(self.id());
        self.encode(dst);
    }
}

/// Known section identifiers of WebAssembly components.
///
/// These sections are supported by the component model proposal.
#[derive(Clone, Copy, Debug, Eq, PartialEq, Ord, PartialOrd)]
#[repr(u8)]
pub enum ComponentSectionId {
    /// The section is a core custom section.
    CoreCustom = 0,
    /// The section is a core module section.
    CoreModule = 1,
    /// The section is a core instance section.
    CoreInstance = 2,
    /// The section is a core type section.
    CoreType = 3,
    /// The section is a component section.
    Component = 4,
    /// The section is an instance section.
    Instance = 5,
    /// The section is an alias section.
    Alias = 6,
    /// The section is a type section.
    Type = 7,
    /// The section is a canonical function section.
    CanonicalFunction = 8,
    /// The section is a start section.
    Start = 9,
    /// The section is an import section.
    Import = 10,
    /// The section is an export section.
    Export = 11,
}

impl From<ComponentSectionId> for u8 {
    #[inline]
    fn from(id: ComponentSectionId) -> u8 {
        id as u8
    }
}

impl Encode for ComponentSectionId {
    fn encode(&self, sink: &mut Vec<u8>) {
        sink.push(*self as u8);
    }
}

/// Represents a WebAssembly component that is being encoded.
///
/// Unlike core WebAssembly modules, the sections of a component
/// may appear in any order and may be repeated.
///
/// Components may also added as a section to other components.
#[derive(Clone, Debug)]
pub struct Component {
    bytes: Vec<u8>,
}

impl Component {
    /// The 8-byte header at the beginning of all components.
    #[rustfmt::skip]
    pub const HEADER: [u8; 8] = [
        // Magic
        0x00, 0x61, 0x73, 0x6D,
        // Version
        0x0d, 0x00, 0x01, 0x00,
    ];

    /// Begin writing a new `Component`.
    pub fn new() -> Self {
        Self {
            bytes: Self::HEADER.to_vec(),
        }
    }

    /// Finish writing this component and extract ownership of the encoded bytes.
    pub fn finish(self) -> Vec<u8> {
        self.bytes
    }

    /// Write a section to this component.
    pub fn section(&mut self, section: &impl ComponentSection) -> &mut Self {
        self.bytes.push(section.id());
        section.encode(&mut self.bytes);
        self
    }

    /// View the encoded bytes.
    pub fn as_slice(&self) -> &[u8] {
        &self.bytes
    }
}

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

impl ComponentSection for CustomSection<'_> {
    fn id(&self) -> u8 {
        ComponentSectionId::CoreCustom.into()
    }
}

impl ComponentSection for RawCustomSection<'_> {
    fn id(&self) -> u8 {
        ComponentSectionId::CoreCustom.into()
    }
}

impl ComponentSection for ProducersSection {
    fn id(&self) -> u8 {
        ComponentSectionId::CoreCustom.into()
    }
}

Line	Count	Source (jump to first uncovered line)
1		mod aliases;
2		mod builder;
3		mod canonicals;
4		mod components;
5		mod exports;
6		mod imports;
7		mod instances;
8		mod modules;
9		mod names;
10		mod start;
11		mod types;
12
13		pub use self::aliases::*;
14		pub use self::builder::*;
15		pub use self::canonicals::*;
16		pub use self::components::*;
17		pub use self::exports::*;
18		pub use self::imports::*;
19		pub use self::instances::*;
20		pub use self::modules::*;
21		pub use self::names::*;
22		pub use self::start::*;
23		pub use self::types::*;
24
25		use crate::{CustomSection, Encode, ProducersSection, RawCustomSection};
26
27		// Core sorts extended by the component model
28		const CORE_TYPE_SORT: u8 = 0x10;
29		const CORE_MODULE_SORT: u8 = 0x11;
30		const CORE_INSTANCE_SORT: u8 = 0x12;
31
32		const CORE_SORT: u8 = 0x00;
33		const FUNCTION_SORT: u8 = 0x01;
34		const VALUE_SORT: u8 = 0x02;
35		const TYPE_SORT: u8 = 0x03;
36		const COMPONENT_SORT: u8 = 0x04;
37		const INSTANCE_SORT: u8 = 0x05;
38
39		/// A WebAssembly component section.
40		///
41		/// Various builders defined in this crate already implement this trait, but you
42		/// can also implement it yourself for your own custom section builders, or use
43		/// `RawSection` to use a bunch of raw bytes as a section.
44		pub trait ComponentSection: Encode {
45		/// Gets the section identifier for this section.
46		fn id(&self) -> u8;
47
48		/// Appends this section to the specified destination list of bytes.
49	0	fn append_to_component(&self, dst: &mut Vec<u8>) {
50	0	dst.push(self.id());
51	0	self.encode(dst);
52	0	} Unexecuted instantiation: <wast::component::custom::Custom as wasm_encoder::component::ComponentSection>::append_to_component Unexecuted instantiation: <wasm_encoder::raw::RawSection as wasm_encoder::component::ComponentSection>::append_to_component Unexecuted instantiation: <wasm_encoder::core::custom::CustomSection as wasm_encoder::component::ComponentSection>::append_to_component Unexecuted instantiation: <wasm_encoder::core::custom::RawCustomSection as wasm_encoder::component::ComponentSection>::append_to_component Unexecuted instantiation: <wasm_encoder::core::producers::ProducersSection as wasm_encoder::component::ComponentSection>::append_to_component Unexecuted instantiation: <wasm_encoder::component::canonicals::CanonicalFunctionSection as wasm_encoder::component::ComponentSection>::append_to_component Unexecuted instantiation: <wasm_encoder::component::components::NestedComponentSection as wasm_encoder::component::ComponentSection>::append_to_component Unexecuted instantiation: <wasm_encoder::component::names::ComponentNameSection as wasm_encoder::component::ComponentSection>::append_to_component Unexecuted instantiation: <wasm_encoder::component::types::CoreTypeSection as wasm_encoder::component::ComponentSection>::append_to_component Unexecuted instantiation: <wasm_encoder::component::types::ComponentTypeSection as wasm_encoder::component::ComponentSection>::append_to_component Unexecuted instantiation: <wasm_encoder::component::aliases::ComponentAliasSection as wasm_encoder::component::ComponentSection>::append_to_component Unexecuted instantiation: <wasm_encoder::component::exports::ComponentExportSection as wasm_encoder::component::ComponentSection>::append_to_component Unexecuted instantiation: <wasm_encoder::component::imports::ComponentImportSection as wasm_encoder::component::ComponentSection>::append_to_component Unexecuted instantiation: <wasm_encoder::component::modules::ModuleSection as wasm_encoder::component::ComponentSection>::append_to_component Unexecuted instantiation: <wasm_encoder::component::instances::InstanceSection as wasm_encoder::component::ComponentSection>::append_to_component Unexecuted instantiation: <wasm_encoder::component::instances::ComponentInstanceSection as wasm_encoder::component::ComponentSection>::append_to_component
53		}
54
55		/// Known section identifiers of WebAssembly components.
56		///
57		/// These sections are supported by the component model proposal.
58		#[derive(Clone, Copy, Debug, Eq, PartialEq, Ord, PartialOrd)]
59		#[repr(u8)]
60		pub enum ComponentSectionId {
61		/// The section is a core custom section.
62		CoreCustom = 0,
63		/// The section is a core module section.
64		CoreModule = 1,
65		/// The section is a core instance section.
66		CoreInstance = 2,
67		/// The section is a core type section.
68		CoreType = 3,
69		/// The section is a component section.
70		Component = 4,
71		/// The section is an instance section.
72		Instance = 5,
73		/// The section is an alias section.
74		Alias = 6,
75		/// The section is a type section.
76		Type = 7,
77		/// The section is a canonical function section.
78		CanonicalFunction = 8,
79		/// The section is a start section.
80		Start = 9,
81		/// The section is an import section.
82		Import = 10,
83		/// The section is an export section.
84		Export = 11,
85		}
86
87		impl From<ComponentSectionId> for u8 {
88		#[inline]
89	0	fn from(id: ComponentSectionId) -> u8 {
90	0	id as u8
91	0	} Unexecuted instantiation: <u8 as core::convert::From<wasm_encoder::component::ComponentSectionId>>::from Unexecuted instantiation: <u8 as core::convert::From<wasm_encoder::component::ComponentSectionId>>::from
92		}
93
94		impl Encode for ComponentSectionId {
95	0	fn encode(&self, sink: &mut Vec<u8>) {
96	0	sink.push(*self as u8);
97	0	}
98		}
99
100		/// Represents a WebAssembly component that is being encoded.
101		///
102		/// Unlike core WebAssembly modules, the sections of a component
103		/// may appear in any order and may be repeated.
104		///
105		/// Components may also added as a section to other components.
106		#[derive(Clone, Debug)]
107		pub struct Component {
108		bytes: Vec<u8>,
109		}
110
111		impl Component {
112		/// The 8-byte header at the beginning of all components.
113		#[rustfmt::skip]
114		pub const HEADER: [u8; 8] = [
115		// Magic
116		0x00, 0x61, 0x73, 0x6D,
117		// Version
118		0x0d, 0x00, 0x01, 0x00,
119		];
120
121		/// Begin writing a new `Component`.
122	0	pub fn new() -> Self {
123	0	Self {
124	0	bytes: Self::HEADER.to_vec(),
125	0	}
126	0	}
127
128		/// Finish writing this component and extract ownership of the encoded bytes.
129	0	pub fn finish(self) -> Vec<u8> {
130	0	self.bytes
131	0	} Unexecuted instantiation: <wasm_encoder::component::Component>::finish Unexecuted instantiation: <wasm_encoder::component::Component>::finish
132
133		/// Write a section to this component.
134	0	pub fn section(&mut self, section: &impl ComponentSection) -> &mut Self {
135	0	self.bytes.push(section.id());
136	0	section.encode(&mut self.bytes);
137	0	self
138	0	} Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::start::ComponentStartSection<alloc::vec::Vec<u32>>> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::canonicals::CanonicalFunctionSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::components::NestedComponentSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::names::ComponentNameSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::types::CoreTypeSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::types::ComponentTypeSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::aliases::ComponentAliasSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::exports::ComponentExportSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::imports::ComponentImportSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::instances::InstanceSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::instances::ComponentInstanceSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::raw::RawSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wast::component::custom::Custom> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::canonicals::CanonicalFunctionSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::components::NestedComponentSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::types::CoreTypeSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::types::ComponentTypeSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::aliases::ComponentAliasSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::exports::ComponentExportSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::imports::ComponentImportSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::modules::ModuleSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::instances::InstanceSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::component::instances::ComponentInstanceSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::raw::RawSection> Unexecuted instantiation: <wasm_encoder::component::Component>::section::<wasm_encoder::core::custom::RawCustomSection>
139
140		/// View the encoded bytes.
141	0	pub fn as_slice(&self) -> &[u8] {
142	0	&self.bytes
143	0	}
144		}
145
146		impl Default for Component {
147	0	fn default() -> Self {
148	0	Self::new()
149	0	}
150		}
151
152		impl ComponentSection for CustomSection<'_> {
153	0	fn id(&self) -> u8 {
154	0	ComponentSectionId::CoreCustom.into()
155	0	}
156		}
157
158		impl ComponentSection for RawCustomSection<'_> {
159	0	fn id(&self) -> u8 {
160	0	ComponentSectionId::CoreCustom.into()
161	0	}
162		}
163
164		impl ComponentSection for ProducersSection {
165	0	fn id(&self) -> u8 {
166	0	ComponentSectionId::CoreCustom.into()
167	0	}
168		}

Coverage Report

Created: 2024-10-16 07:58