1 /// Auto-generated bindings for a pre-instantiated version of a
2 /// component which implements the world `the-world`.
3 ///
4 /// This structure is created through [`TheWorldPre::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 [`TheWorld`] as well.
9 pub struct TheWorldPre<T: 'static> {
10     instance_pre: wasmtime::component::InstancePre<T>,
11     indices: TheWorldIndices,
12 }
13 impl<T: 'static> Clone for TheWorldPre<T> {
clone(&self) -> Self14     fn clone(&self) -> Self {
15         Self {
16             instance_pre: self.instance_pre.clone(),
17             indices: self.indices.clone(),
18         }
19     }
20 }
21 impl<_T: 'static> TheWorldPre<_T> {
22     /// Creates a new copy of `TheWorldPre` 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.
new( instance_pre: wasmtime::component::InstancePre<_T>, ) -> wasmtime::Result<Self>27     pub fn new(
28         instance_pre: wasmtime::component::InstancePre<_T>,
29     ) -> wasmtime::Result<Self> {
30         let indices = TheWorldIndices::new(&instance_pre)?;
31         Ok(Self { instance_pre, indices })
32     }
engine(&self) -> &wasmtime::Engine33     pub fn engine(&self) -> &wasmtime::Engine {
34         self.instance_pre.engine()
35     }
instance_pre(&self) -> &wasmtime::component::InstancePre<_T>36     pub fn instance_pre(&self) -> &wasmtime::component::InstancePre<_T> {
37         &self.instance_pre
38     }
39     /// Instantiates a new instance of [`TheWorld`] 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.
instantiate( &self, mut store: impl wasmtime::AsContextMut<Data = _T>, ) -> wasmtime::Result<TheWorld>46     pub fn instantiate(
47         &self,
48         mut store: impl wasmtime::AsContextMut<Data = _T>,
49     ) -> wasmtime::Result<TheWorld> {
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 impl<_T: Send + 'static> TheWorldPre<_T> {
56     /// Same as [`Self::instantiate`], except with `async`.
instantiate_async( &self, mut store: impl wasmtime::AsContextMut<Data = _T>, ) -> wasmtime::Result<TheWorld>57     pub async fn instantiate_async(
58         &self,
59         mut store: impl wasmtime::AsContextMut<Data = _T>,
60     ) -> wasmtime::Result<TheWorld> {
61         let mut store = store.as_context_mut();
62         let instance = self.instance_pre.instantiate_async(&mut store).await?;
63         self.indices.load(&mut store, &instance)
64     }
65 }
66 /// Auto-generated bindings for index of the exports of
67 /// `the-world`.
68 ///
69 /// This is an implementation detail of [`TheWorldPre`] and can
70 /// be constructed if needed as well.
71 ///
72 /// For more information see [`TheWorld`] as well.
73 #[derive(Clone)]
74 pub struct TheWorldIndices {
75     interface0: exports::foo::foo::floats::GuestIndices,
76 }
77 /// Auto-generated bindings for an instance a component which
78 /// implements the world `the-world`.
79 ///
80 /// This structure can be created through a number of means
81 /// depending on your requirements and what you have on hand:
82 ///
83 /// * The most convenient way is to use
84 ///   [`TheWorld::instantiate`] which only needs a
85 ///   [`Store`], [`Component`], and [`Linker`].
86 ///
87 /// * Alternatively you can create a [`TheWorldPre`] ahead of
88 ///   time with a [`Component`] to front-load string lookups
89 ///   of exports once instead of per-instantiation. This
90 ///   method then uses [`TheWorldPre::instantiate`] to
91 ///   create a [`TheWorld`].
92 ///
93 /// * If you've instantiated the instance yourself already
94 ///   then you can use [`TheWorld::new`].
95 ///
96 /// These methods are all equivalent to one another and move
97 /// around the tradeoff of what work is performed when.
98 ///
99 /// [`Store`]: wasmtime::Store
100 /// [`Component`]: wasmtime::component::Component
101 /// [`Linker`]: wasmtime::component::Linker
102 pub struct TheWorld {
103     interface0: exports::foo::foo::floats::Guest,
104 }
105 const _: () = {
106     impl TheWorldIndices {
107         /// Creates a new copy of `TheWorldIndices` bindings which can then
108         /// be used to instantiate into a particular store.
109         ///
110         /// This method may fail if the component does not have the
111         /// required exports.
new<_T>( _instance_pre: &wasmtime::component::InstancePre<_T>, ) -> wasmtime::Result<Self>112         pub fn new<_T>(
113             _instance_pre: &wasmtime::component::InstancePre<_T>,
114         ) -> wasmtime::Result<Self> {
115             let _component = _instance_pre.component();
116             let _instance_type = _instance_pre.instance_type();
117             let interface0 = exports::foo::foo::floats::GuestIndices::new(
118                 _instance_pre,
119             )?;
120             Ok(TheWorldIndices { interface0 })
121         }
122         /// Uses the indices stored in `self` to load an instance
123         /// of [`TheWorld`] from the instance provided.
124         ///
125         /// Note that at this time this method will additionally
126         /// perform type-checks of all exports.
load( &self, mut store: impl wasmtime::AsContextMut, instance: &wasmtime::component::Instance, ) -> wasmtime::Result<TheWorld>127         pub fn load(
128             &self,
129             mut store: impl wasmtime::AsContextMut,
130             instance: &wasmtime::component::Instance,
131         ) -> wasmtime::Result<TheWorld> {
132             let _ = &mut store;
133             let _instance = instance;
134             let interface0 = self.interface0.load(&mut store, &_instance)?;
135             Ok(TheWorld { interface0 })
136         }
137     }
138     impl TheWorld {
139         /// Convenience wrapper around [`TheWorldPre::new`] and
140         /// [`TheWorldPre::instantiate`].
instantiate<_T>( store: impl wasmtime::AsContextMut<Data = _T>, component: &wasmtime::component::Component, linker: &wasmtime::component::Linker<_T>, ) -> wasmtime::Result<TheWorld>141         pub fn instantiate<_T>(
142             store: impl wasmtime::AsContextMut<Data = _T>,
143             component: &wasmtime::component::Component,
144             linker: &wasmtime::component::Linker<_T>,
145         ) -> wasmtime::Result<TheWorld> {
146             let pre = linker.instantiate_pre(component)?;
147             TheWorldPre::new(pre)?.instantiate(store)
148         }
149         /// Convenience wrapper around [`TheWorldIndices::new`] and
150         /// [`TheWorldIndices::load`].
new( mut store: impl wasmtime::AsContextMut, instance: &wasmtime::component::Instance, ) -> wasmtime::Result<TheWorld>151         pub fn new(
152             mut store: impl wasmtime::AsContextMut,
153             instance: &wasmtime::component::Instance,
154         ) -> wasmtime::Result<TheWorld> {
155             let indices = TheWorldIndices::new(&instance.instance_pre(&store))?;
156             indices.load(&mut store, instance)
157         }
158         /// Convenience wrapper around [`TheWorldPre::new`] and
159         /// [`TheWorldPre::instantiate_async`].
instantiate_async<_T>( store: impl wasmtime::AsContextMut<Data = _T>, component: &wasmtime::component::Component, linker: &wasmtime::component::Linker<_T>, ) -> wasmtime::Result<TheWorld> where _T: Send,160         pub async fn instantiate_async<_T>(
161             store: impl wasmtime::AsContextMut<Data = _T>,
162             component: &wasmtime::component::Component,
163             linker: &wasmtime::component::Linker<_T>,
164         ) -> wasmtime::Result<TheWorld>
165         where
166             _T: Send,
167         {
168             let pre = linker.instantiate_pre(component)?;
169             TheWorldPre::new(pre)?.instantiate_async(store).await
170         }
add_to_linker<T, D>( linker: &mut wasmtime::component::Linker<T>, host_getter: fn(&mut T) -> D::Data<'_>, ) -> wasmtime::Result<()> where D: foo::foo::floats::HostWithStore, for<'a> D::Data<'a>: foo::foo::floats::Host, T: 'static,171         pub fn add_to_linker<T, D>(
172             linker: &mut wasmtime::component::Linker<T>,
173             host_getter: fn(&mut T) -> D::Data<'_>,
174         ) -> wasmtime::Result<()>
175         where
176             D: foo::foo::floats::HostWithStore,
177             for<'a> D::Data<'a>: foo::foo::floats::Host,
178             T: 'static,
179         {
180             foo::foo::floats::add_to_linker::<T, D>(linker, host_getter)?;
181             Ok(())
182         }
foo_foo_floats(&self) -> &exports::foo::foo::floats::Guest183         pub fn foo_foo_floats(&self) -> &exports::foo::foo::floats::Guest {
184             &self.interface0
185         }
186     }
187 };
188 pub mod foo {
189     pub mod foo {
190         #[allow(clippy::all)]
191         pub mod floats {
192             #[allow(unused_imports)]
193             use wasmtime::component::__internal::Box;
194             pub trait HostWithStore: wasmtime::component::HasData {}
195             impl<_T: ?Sized> HostWithStore for _T
196             where
197                 _T: wasmtime::component::HasData,
198             {}
199             pub trait Host {
f32_param(&mut self, x: f32) -> ()200                 fn f32_param(&mut self, x: f32) -> ();
f64_param(&mut self, x: f64) -> ()201                 fn f64_param(&mut self, x: f64) -> ();
f32_result(&mut self) -> f32202                 fn f32_result(&mut self) -> f32;
f64_result(&mut self) -> f64203                 fn f64_result(&mut self) -> f64;
204             }
205             impl<_T: Host + ?Sized> Host for &mut _T {
f32_param(&mut self, x: f32) -> ()206                 fn f32_param(&mut self, x: f32) -> () {
207                     Host::f32_param(*self, x)
208                 }
f64_param(&mut self, x: f64) -> ()209                 fn f64_param(&mut self, x: f64) -> () {
210                     Host::f64_param(*self, x)
211                 }
f32_result(&mut self) -> f32212                 fn f32_result(&mut self) -> f32 {
213                     Host::f32_result(*self)
214                 }
f64_result(&mut self) -> f64215                 fn f64_result(&mut self) -> f64 {
216                     Host::f64_result(*self)
217                 }
218             }
add_to_linker<T, D>( linker: &mut wasmtime::component::Linker<T>, host_getter: fn(&mut T) -> D::Data<'_>, ) -> wasmtime::Result<()> where D: HostWithStore, for<'a> D::Data<'a>: Host, T: 'static,219             pub fn add_to_linker<T, D>(
220                 linker: &mut wasmtime::component::Linker<T>,
221                 host_getter: fn(&mut T) -> D::Data<'_>,
222             ) -> wasmtime::Result<()>
223             where
224                 D: HostWithStore,
225                 for<'a> D::Data<'a>: Host,
226                 T: 'static,
227             {
228                 let mut inst = linker.instance("foo:foo/floats")?;
229                 inst.func_wrap(
230                     "f32-param",
231                     move |mut caller: wasmtime::StoreContextMut<'_, T>, (arg0,): (f32,)| {
232                         let host = &mut host_getter(caller.data_mut());
233                         let r = Host::f32_param(host, arg0);
234                         Ok(r)
235                     },
236                 )?;
237                 inst.func_wrap(
238                     "f64-param",
239                     move |mut caller: wasmtime::StoreContextMut<'_, T>, (arg0,): (f64,)| {
240                         let host = &mut host_getter(caller.data_mut());
241                         let r = Host::f64_param(host, arg0);
242                         Ok(r)
243                     },
244                 )?;
245                 inst.func_wrap(
246                     "f32-result",
247                     move |mut caller: wasmtime::StoreContextMut<'_, T>, (): ()| {
248                         let host = &mut host_getter(caller.data_mut());
249                         let r = Host::f32_result(host);
250                         Ok((r,))
251                     },
252                 )?;
253                 inst.func_wrap(
254                     "f64-result",
255                     move |mut caller: wasmtime::StoreContextMut<'_, T>, (): ()| {
256                         let host = &mut host_getter(caller.data_mut());
257                         let r = Host::f64_result(host);
258                         Ok((r,))
259                     },
260                 )?;
261                 Ok(())
262             }
263         }
264     }
265 }
266 pub mod exports {
267     pub mod foo {
268         pub mod foo {
269             #[allow(clippy::all)]
270             pub mod floats {
271                 #[allow(unused_imports)]
272                 use wasmtime::component::__internal::Box;
273                 #[derive(Clone)]
274                 pub struct Guest {
275                     f32_param: wasmtime::component::Func,
276                     f64_param: wasmtime::component::Func,
277                     f32_result: wasmtime::component::Func,
278                     f64_result: wasmtime::component::Func,
279                 }
280                 #[derive(Clone)]
281                 pub struct GuestIndices {
282                     f32_param: wasmtime::component::ComponentExportIndex,
283                     f64_param: wasmtime::component::ComponentExportIndex,
284                     f32_result: wasmtime::component::ComponentExportIndex,
285                     f64_result: wasmtime::component::ComponentExportIndex,
286                 }
287                 impl GuestIndices {
288                     /// Constructor for [`GuestIndices`] which takes a
289                     /// [`Component`](wasmtime::component::Component) as input and can be executed
290                     /// before instantiation.
291                     ///
292                     /// This constructor can be used to front-load string lookups to find exports
293                     /// within a component.
new<_T>( _instance_pre: &wasmtime::component::InstancePre<_T>, ) -> wasmtime::Result<GuestIndices>294                     pub fn new<_T>(
295                         _instance_pre: &wasmtime::component::InstancePre<_T>,
296                     ) -> wasmtime::Result<GuestIndices> {
297                         let instance = _instance_pre
298                             .component()
299                             .get_export_index(None, "foo:foo/floats")
300                             .ok_or_else(|| {
301                                 wasmtime::format_err!(
302                                     "no exported instance named `foo:foo/floats`"
303                                 )
304                             })?;
305                         let mut lookup = move |name| {
306                             _instance_pre
307                                 .component()
308                                 .get_export_index(Some(&instance), name)
309                                 .ok_or_else(|| {
310                                     wasmtime::format_err!(
311                                         "instance export `foo:foo/floats` does \
312                         not have export `{name}`"
313                                     )
314                                 })
315                         };
316                         let _ = &mut lookup;
317                         let f32_param = lookup("f32-param")?;
318                         let f64_param = lookup("f64-param")?;
319                         let f32_result = lookup("f32-result")?;
320                         let f64_result = lookup("f64-result")?;
321                         Ok(GuestIndices {
322                             f32_param,
323                             f64_param,
324                             f32_result,
325                             f64_result,
326                         })
327                     }
load( &self, mut store: impl wasmtime::AsContextMut, instance: &wasmtime::component::Instance, ) -> wasmtime::Result<Guest>328                     pub fn load(
329                         &self,
330                         mut store: impl wasmtime::AsContextMut,
331                         instance: &wasmtime::component::Instance,
332                     ) -> wasmtime::Result<Guest> {
333                         let _instance = instance;
334                         let _instance_pre = _instance.instance_pre(&store);
335                         let _instance_type = _instance_pre.instance_type();
336                         let mut store = store.as_context_mut();
337                         let _ = &mut store;
338                         let f32_param = *_instance
339                             .get_typed_func::<(f32,), ()>(&mut store, &self.f32_param)?
340                             .func();
341                         let f64_param = *_instance
342                             .get_typed_func::<(f64,), ()>(&mut store, &self.f64_param)?
343                             .func();
344                         let f32_result = *_instance
345                             .get_typed_func::<(), (f32,)>(&mut store, &self.f32_result)?
346                             .func();
347                         let f64_result = *_instance
348                             .get_typed_func::<(), (f64,)>(&mut store, &self.f64_result)?
349                             .func();
350                         Ok(Guest {
351                             f32_param,
352                             f64_param,
353                             f32_result,
354                             f64_result,
355                         })
356                     }
357                 }
358                 impl Guest {
call_f32_param<S: wasmtime::AsContextMut>( &self, mut store: S, arg0: f32, ) -> wasmtime::Result<()>359                     pub fn call_f32_param<S: wasmtime::AsContextMut>(
360                         &self,
361                         mut store: S,
362                         arg0: f32,
363                     ) -> wasmtime::Result<()> {
364                         let callee = unsafe {
365                             wasmtime::component::TypedFunc::<
366                                 (f32,),
367                                 (),
368                             >::new_unchecked(self.f32_param)
369                         };
370                         let () = callee.call(store.as_context_mut(), (arg0,))?;
371                         Ok(())
372                     }
call_f64_param<S: wasmtime::AsContextMut>( &self, mut store: S, arg0: f64, ) -> wasmtime::Result<()>373                     pub fn call_f64_param<S: wasmtime::AsContextMut>(
374                         &self,
375                         mut store: S,
376                         arg0: f64,
377                     ) -> wasmtime::Result<()> {
378                         let callee = unsafe {
379                             wasmtime::component::TypedFunc::<
380                                 (f64,),
381                                 (),
382                             >::new_unchecked(self.f64_param)
383                         };
384                         let () = callee.call(store.as_context_mut(), (arg0,))?;
385                         Ok(())
386                     }
call_f32_result<S: wasmtime::AsContextMut>( &self, mut store: S, ) -> wasmtime::Result<f32>387                     pub fn call_f32_result<S: wasmtime::AsContextMut>(
388                         &self,
389                         mut store: S,
390                     ) -> wasmtime::Result<f32> {
391                         let callee = unsafe {
392                             wasmtime::component::TypedFunc::<
393                                 (),
394                                 (f32,),
395                             >::new_unchecked(self.f32_result)
396                         };
397                         let (ret0,) = callee.call(store.as_context_mut(), ())?;
398                         Ok(ret0)
399                     }
call_f64_result<S: wasmtime::AsContextMut>( &self, mut store: S, ) -> wasmtime::Result<f64>400                     pub fn call_f64_result<S: wasmtime::AsContextMut>(
401                         &self,
402                         mut store: S,
403                     ) -> wasmtime::Result<f64> {
404                         let callee = unsafe {
405                             wasmtime::component::TypedFunc::<
406                                 (),
407                                 (f64,),
408                             >::new_unchecked(self.f64_result)
409                         };
410                         let (ret0,) = callee.call(store.as_context_mut(), ())?;
411                         Ok(ret0)
412                     }
413                 }
414             }
415         }
416     }
417 }
418