1 /// Auto-generated bindings for a pre-instantiated version of a
2 /// component which implements the world `imports`.
3 ///
4 /// This structure is created through [`ImportsPre::new`] which
5 /// takes a [`InstancePre`](wasmtime::component::InstancePre) that
6 /// has been created through a [`Linker`](wasmtime::component::Linker).
7 ///
8 /// For more information see [`Imports`] as well.
9 pub struct ImportsPre<T> {
10     instance_pre: wasmtime::component::InstancePre<T>,
11     indices: ImportsIndices,
12 }
13 impl<T> Clone for ImportsPre<T> {
14     fn clone(&self) -> Self {
15         Self {
16             instance_pre: self.instance_pre.clone(),
17             indices: self.indices.clone(),
18         }
19     }
20 }
21 impl<_T> ImportsPre<_T> {
22     /// Creates a new copy of `ImportsPre` bindings which can then
23     /// be used to instantiate into a particular store.
24     ///
25     /// This method may fail if the component behind `instance_pre`
26     /// does not have the required exports.
27     pub fn new(
28         instance_pre: wasmtime::component::InstancePre<_T>,
29     ) -> wasmtime::Result<Self> {
30         let indices = ImportsIndices::new(instance_pre.component())?;
31         Ok(Self { instance_pre, indices })
32     }
33     pub fn engine(&self) -> &wasmtime::Engine {
34         self.instance_pre.engine()
35     }
36     pub fn instance_pre(&self) -> &wasmtime::component::InstancePre<_T> {
37         &self.instance_pre
38     }
39     /// Instantiates a new instance of [`Imports`] within the
40     /// `store` provided.
41     ///
42     /// This function will use `self` as the pre-instantiated
43     /// instance to perform instantiation. Afterwards the preloaded
44     /// indices in `self` are used to lookup all exports on the
45     /// resulting instance.
46     pub fn instantiate(
47         &self,
48         mut store: impl wasmtime::AsContextMut<Data = _T>,
49     ) -> wasmtime::Result<Imports> {
50         let mut store = store.as_context_mut();
51         let instance = self.instance_pre.instantiate(&mut store)?;
52         self.indices.load(&mut store, &instance)
53     }
54 }
55 /// Auto-generated bindings for index of the exports of
56 /// `imports`.
57 ///
58 /// This is an implementation detail of [`ImportsPre`] and can
59 /// be constructed if needed as well.
60 ///
61 /// For more information see [`Imports`] as well.
62 #[derive(Clone)]
63 pub struct ImportsIndices {}
64 /// Auto-generated bindings for an instance a component which
65 /// implements the world `imports`.
66 ///
67 /// This structure can be created through a number of means
68 /// depending on your requirements and what you have on hand:
69 ///
70 /// * The most convenient way is to use
71 ///   [`Imports::instantiate`] which only needs a
72 ///   [`Store`], [`Component`], and [`Linker`].
73 ///
74 /// * Alternatively you can create a [`ImportsPre`] ahead of
75 ///   time with a [`Component`] to front-load string lookups
76 ///   of exports once instead of per-instantiation. This
77 ///   method then uses [`ImportsPre::instantiate`] to
78 ///   create a [`Imports`].
79 ///
80 /// * If you've instantiated the instance yourself already
81 ///   then you can use [`Imports::new`].
82 ///
83 /// * You can also access the guts of instantiation through
84 ///   [`ImportsIndices::new_instance`] followed
85 ///   by [`ImportsIndices::load`] to crate an instance of this
86 ///   type.
87 ///
88 /// These methods are all equivalent to one another and move
89 /// around the tradeoff of what work is performed when.
90 ///
91 /// [`Store`]: wasmtime::Store
92 /// [`Component`]: wasmtime::component::Component
93 /// [`Linker`]: wasmtime::component::Linker
94 pub struct Imports {}
95 const _: () = {
96     #[allow(unused_imports)]
97     use wasmtime::component::__internal::anyhow;
98     impl ImportsIndices {
99         /// Creates a new copy of `ImportsIndices` bindings which can then
100         /// be used to instantiate into a particular store.
101         ///
102         /// This method may fail if the component does not have the
103         /// required exports.
104         pub fn new(
105             component: &wasmtime::component::Component,
106         ) -> wasmtime::Result<Self> {
107             let _component = component;
108             Ok(ImportsIndices {})
109         }
110         /// Creates a new instance of [`ImportsIndices`] from an
111         /// instantiated component.
112         ///
113         /// This method of creating a [`Imports`] will perform string
114         /// lookups for all exports when this method is called. This
115         /// will only succeed if the provided instance matches the
116         /// requirements of [`Imports`].
117         pub fn new_instance(
118             mut store: impl wasmtime::AsContextMut,
119             instance: &wasmtime::component::Instance,
120         ) -> wasmtime::Result<Self> {
121             let _instance = instance;
122             Ok(ImportsIndices {})
123         }
124         /// Uses the indices stored in `self` to load an instance
125         /// of [`Imports`] from the instance provided.
126         ///
127         /// Note that at this time this method will additionally
128         /// perform type-checks of all exports.
129         pub fn load(
130             &self,
131             mut store: impl wasmtime::AsContextMut,
132             instance: &wasmtime::component::Instance,
133         ) -> wasmtime::Result<Imports> {
134             let _instance = instance;
135             Ok(Imports {})
136         }
137     }
138     impl Imports {
139         /// Convenience wrapper around [`ImportsPre::new`] and
140         /// [`ImportsPre::instantiate`].
141         pub fn instantiate<_T>(
142             mut store: impl wasmtime::AsContextMut<Data = _T>,
143             component: &wasmtime::component::Component,
144             linker: &wasmtime::component::Linker<_T>,
145         ) -> wasmtime::Result<Imports> {
146             let pre = linker.instantiate_pre(component)?;
147             ImportsPre::new(pre)?.instantiate(store)
148         }
149         /// Convenience wrapper around [`ImportsIndices::new_instance`] and
150         /// [`ImportsIndices::load`].
151         pub fn new(
152             mut store: impl wasmtime::AsContextMut,
153             instance: &wasmtime::component::Instance,
154         ) -> wasmtime::Result<Imports> {
155             let indices = ImportsIndices::new_instance(&mut store, instance)?;
156             indices.load(store, instance)
157         }
158         pub fn add_to_linker<T, U>(
159             linker: &mut wasmtime::component::Linker<T>,
160             get: impl Fn(&mut T) -> &mut U + Send + Sync + Copy + 'static,
161         ) -> wasmtime::Result<()>
162         where
163             U: a::b::interface_with_live_type::Host
164                 + a::b::interface_with_dead_type::Host,
165         {
166             a::b::interface_with_live_type::add_to_linker(linker, get)?;
167             a::b::interface_with_dead_type::add_to_linker(linker, get)?;
168             Ok(())
169         }
170     }
171 };
172 pub mod a {
173     pub mod b {
174         #[allow(clippy::all)]
175         pub mod interface_with_live_type {
176             #[allow(unused_imports)]
177             use wasmtime::component::__internal::{anyhow, Box};
178             #[derive(wasmtime::component::ComponentType)]
179             #[derive(wasmtime::component::Lift)]
180             #[derive(wasmtime::component::Lower)]
181             #[component(record)]
182             #[derive(Clone, Copy)]
183             pub struct LiveType {
184                 #[component(name = "a")]
185                 pub a: u32,
186             }
187             impl core::fmt::Debug for LiveType {
188                 fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
189                     f.debug_struct("LiveType").field("a", &self.a).finish()
190                 }
191             }
192             const _: () = {
193                 assert!(4 == < LiveType as wasmtime::component::ComponentType >::SIZE32);
194                 assert!(
195                     4 == < LiveType as wasmtime::component::ComponentType >::ALIGN32
196                 );
197             };
198             pub trait Host {
199                 fn f(&mut self) -> LiveType;
200             }
201             pub trait GetHost<
202                 T,
203                 D,
204             >: Fn(T) -> <Self as GetHost<T, D>>::Host + Send + Sync + Copy + 'static {
205                 type Host: Host;
206             }
207             impl<F, T, D, O> GetHost<T, D> for F
208             where
209                 F: Fn(T) -> O + Send + Sync + Copy + 'static,
210                 O: Host,
211             {
212                 type Host = O;
213             }
214             pub fn add_to_linker_get_host<
215                 T,
216                 G: for<'a> GetHost<&'a mut T, T, Host: Host>,
217             >(
218                 linker: &mut wasmtime::component::Linker<T>,
219                 host_getter: G,
220             ) -> wasmtime::Result<()> {
221                 let mut inst = linker.instance("a:b/interface-with-live-type")?;
222                 inst.func_wrap(
223                     "f",
224                     move |mut caller: wasmtime::StoreContextMut<'_, T>, (): ()| {
225                         let host = &mut host_getter(caller.data_mut());
226                         let r = Host::f(host);
227                         Ok((r,))
228                     },
229                 )?;
230                 Ok(())
231             }
232             pub fn add_to_linker<T, U>(
233                 linker: &mut wasmtime::component::Linker<T>,
234                 get: impl Fn(&mut T) -> &mut U + Send + Sync + Copy + 'static,
235             ) -> wasmtime::Result<()>
236             where
237                 U: Host,
238             {
239                 add_to_linker_get_host(linker, get)
240             }
241             impl<_T: Host + ?Sized> Host for &mut _T {
242                 fn f(&mut self) -> LiveType {
243                     Host::f(*self)
244                 }
245             }
246         }
247         #[allow(clippy::all)]
248         pub mod interface_with_dead_type {
249             #[allow(unused_imports)]
250             use wasmtime::component::__internal::{anyhow, Box};
251             pub trait Host {}
252             pub trait GetHost<
253                 T,
254                 D,
255             >: Fn(T) -> <Self as GetHost<T, D>>::Host + Send + Sync + Copy + 'static {
256                 type Host: Host;
257             }
258             impl<F, T, D, O> GetHost<T, D> for F
259             where
260                 F: Fn(T) -> O + Send + Sync + Copy + 'static,
261                 O: Host,
262             {
263                 type Host = O;
264             }
265             pub fn add_to_linker_get_host<
266                 T,
267                 G: for<'a> GetHost<&'a mut T, T, Host: Host>,
268             >(
269                 linker: &mut wasmtime::component::Linker<T>,
270                 host_getter: G,
271             ) -> wasmtime::Result<()> {
272                 let mut inst = linker.instance("a:b/interface-with-dead-type")?;
273                 Ok(())
274             }
275             pub fn add_to_linker<T, U>(
276                 linker: &mut wasmtime::component::Linker<T>,
277                 get: impl Fn(&mut T) -> &mut U + Send + Sync + Copy + 'static,
278             ) -> wasmtime::Result<()>
279             where
280                 U: Host,
281             {
282                 add_to_linker_get_host(linker, get)
283             }
284             impl<_T: Host + ?Sized> Host for &mut _T {}
285         }
286     }
287 }
288