1 /// Auto-generated bindings for a pre-instantiated version of a 2 /// component which implements the world `d`. 3 /// 4 /// This structure is created through [`DPre::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 [`D`] as well. 9 pub struct DPre<T: 'static> { 10 instance_pre: wasmtime::component::InstancePre<T>, 11 indices: DIndices, 12 } 13 impl<T: 'static> Clone for DPre<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: 'static> DPre<_T> { 22 /// Creates a new copy of `DPre` 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 = DIndices::new(&instance_pre)?; 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 [`D`] 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<D> { 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> DPre<_T> { 56 /// Same as [`Self::instantiate`], except with `async`. 57 pub async fn instantiate_async( 58 &self, 59 mut store: impl wasmtime::AsContextMut<Data = _T>, 60 ) -> wasmtime::Result<D> { 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 /// `d`. 68 /// 69 /// This is an implementation detail of [`DPre`] and can 70 /// be constructed if needed as well. 71 /// 72 /// For more information see [`D`] as well. 73 #[derive(Clone)] 74 pub struct DIndices {} 75 /// Auto-generated bindings for an instance a component which 76 /// implements the world `d`. 77 /// 78 /// This structure can be created through a number of means 79 /// depending on your requirements and what you have on hand: 80 /// 81 /// * The most convenient way is to use 82 /// [`D::instantiate`] which only needs a 83 /// [`Store`], [`Component`], and [`Linker`]. 84 /// 85 /// * Alternatively you can create a [`DPre`] ahead of 86 /// time with a [`Component`] to front-load string lookups 87 /// of exports once instead of per-instantiation. This 88 /// method then uses [`DPre::instantiate`] to 89 /// create a [`D`]. 90 /// 91 /// * If you've instantiated the instance yourself already 92 /// then you can use [`D::new`]. 93 /// 94 /// These methods are all equivalent to one another and move 95 /// around the tradeoff of what work is performed when. 96 /// 97 /// [`Store`]: wasmtime::Store 98 /// [`Component`]: wasmtime::component::Component 99 /// [`Linker`]: wasmtime::component::Linker 100 pub struct D {} 101 const _: () = { 102 #[allow(unused_imports)] 103 use wasmtime::component::__internal::anyhow; 104 impl DIndices { 105 /// Creates a new copy of `DIndices` bindings which can then 106 /// be used to instantiate into a particular store. 107 /// 108 /// This method may fail if the component does not have the 109 /// required exports. 110 pub fn new<_T>( 111 _instance_pre: &wasmtime::component::InstancePre<_T>, 112 ) -> wasmtime::Result<Self> { 113 let _component = _instance_pre.component(); 114 let _instance_type = _instance_pre.instance_type(); 115 Ok(DIndices {}) 116 } 117 /// Uses the indices stored in `self` to load an instance 118 /// of [`D`] from the instance provided. 119 /// 120 /// Note that at this time this method will additionally 121 /// perform type-checks of all exports. 122 pub fn load( 123 &self, 124 mut store: impl wasmtime::AsContextMut, 125 instance: &wasmtime::component::Instance, 126 ) -> wasmtime::Result<D> { 127 let _ = &mut store; 128 let _instance = instance; 129 Ok(D {}) 130 } 131 } 132 impl D { 133 /// Convenience wrapper around [`DPre::new`] and 134 /// [`DPre::instantiate`]. 135 pub fn instantiate<_T>( 136 store: impl wasmtime::AsContextMut<Data = _T>, 137 component: &wasmtime::component::Component, 138 linker: &wasmtime::component::Linker<_T>, 139 ) -> wasmtime::Result<D> { 140 let pre = linker.instantiate_pre(component)?; 141 DPre::new(pre)?.instantiate(store) 142 } 143 /// Convenience wrapper around [`DIndices::new`] and 144 /// [`DIndices::load`]. 145 pub fn new( 146 mut store: impl wasmtime::AsContextMut, 147 instance: &wasmtime::component::Instance, 148 ) -> wasmtime::Result<D> { 149 let indices = DIndices::new(&instance.instance_pre(&store))?; 150 indices.load(&mut store, instance) 151 } 152 /// Convenience wrapper around [`DPre::new`] and 153 /// [`DPre::instantiate_async`]. 154 pub async fn instantiate_async<_T>( 155 store: impl wasmtime::AsContextMut<Data = _T>, 156 component: &wasmtime::component::Component, 157 linker: &wasmtime::component::Linker<_T>, 158 ) -> wasmtime::Result<D> 159 where 160 _T: Send, 161 { 162 let pre = linker.instantiate_pre(component)?; 163 DPre::new(pre)?.instantiate_async(store).await 164 } 165 pub fn add_to_linker<T, D>( 166 linker: &mut wasmtime::component::Linker<T>, 167 host_getter: fn(&mut T) -> D::Data<'_>, 168 ) -> wasmtime::Result<()> 169 where 170 D: foo::foo::a::HostWithStore + foo::foo::b::HostWithStore 171 + foo::foo::c::HostWithStore + d::HostWithStore, 172 for<'a> D::Data< 173 'a, 174 >: foo::foo::a::Host + foo::foo::b::Host + foo::foo::c::Host + d::Host, 175 T: 'static, 176 { 177 foo::foo::a::add_to_linker::<T, D>(linker, host_getter)?; 178 foo::foo::b::add_to_linker::<T, D>(linker, host_getter)?; 179 foo::foo::c::add_to_linker::<T, D>(linker, host_getter)?; 180 d::add_to_linker::<T, D>(linker, host_getter)?; 181 Ok(()) 182 } 183 } 184 }; 185 pub mod foo { 186 pub mod foo { 187 #[allow(clippy::all)] 188 pub mod a { 189 #[allow(unused_imports)] 190 use wasmtime::component::__internal::{anyhow, Box}; 191 #[derive(wasmtime::component::ComponentType)] 192 #[derive(wasmtime::component::Lift)] 193 #[derive(wasmtime::component::Lower)] 194 #[component(record)] 195 #[derive(Clone, Copy)] 196 pub struct Foo {} 197 impl core::fmt::Debug for Foo { 198 fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result { 199 f.debug_struct("Foo").finish() 200 } 201 } 202 const _: () = { 203 assert!(0 == < Foo as wasmtime::component::ComponentType >::SIZE32); 204 assert!(1 == < Foo as wasmtime::component::ComponentType >::ALIGN32); 205 }; 206 pub trait HostWithStore: wasmtime::component::HasData {} 207 impl<_T: ?Sized> HostWithStore for _T 208 where 209 _T: wasmtime::component::HasData, 210 {} 211 pub trait Host { 212 fn a(&mut self) -> Foo; 213 } 214 impl<_T: Host + ?Sized> Host for &mut _T { 215 fn a(&mut self) -> Foo { 216 Host::a(*self) 217 } 218 } 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/a")?; 229 inst.func_wrap( 230 "a", 231 move |mut caller: wasmtime::StoreContextMut<'_, T>, (): ()| { 232 let host = &mut host_getter(caller.data_mut()); 233 let r = Host::a(host); 234 Ok((r,)) 235 }, 236 )?; 237 Ok(()) 238 } 239 } 240 #[allow(clippy::all)] 241 pub mod b { 242 #[allow(unused_imports)] 243 use wasmtime::component::__internal::{anyhow, Box}; 244 pub type Foo = super::super::super::foo::foo::a::Foo; 245 const _: () = { 246 assert!(0 == < Foo as wasmtime::component::ComponentType >::SIZE32); 247 assert!(1 == < Foo as wasmtime::component::ComponentType >::ALIGN32); 248 }; 249 pub trait HostWithStore: wasmtime::component::HasData {} 250 impl<_T: ?Sized> HostWithStore for _T 251 where 252 _T: wasmtime::component::HasData, 253 {} 254 pub trait Host { 255 fn a(&mut self) -> Foo; 256 } 257 impl<_T: Host + ?Sized> Host for &mut _T { 258 fn a(&mut self) -> Foo { 259 Host::a(*self) 260 } 261 } 262 pub fn add_to_linker<T, D>( 263 linker: &mut wasmtime::component::Linker<T>, 264 host_getter: fn(&mut T) -> D::Data<'_>, 265 ) -> wasmtime::Result<()> 266 where 267 D: HostWithStore, 268 for<'a> D::Data<'a>: Host, 269 T: 'static, 270 { 271 let mut inst = linker.instance("foo:foo/b")?; 272 inst.func_wrap( 273 "a", 274 move |mut caller: wasmtime::StoreContextMut<'_, T>, (): ()| { 275 let host = &mut host_getter(caller.data_mut()); 276 let r = Host::a(host); 277 Ok((r,)) 278 }, 279 )?; 280 Ok(()) 281 } 282 } 283 #[allow(clippy::all)] 284 pub mod c { 285 #[allow(unused_imports)] 286 use wasmtime::component::__internal::{anyhow, Box}; 287 pub type Foo = super::super::super::foo::foo::b::Foo; 288 const _: () = { 289 assert!(0 == < Foo as wasmtime::component::ComponentType >::SIZE32); 290 assert!(1 == < Foo as wasmtime::component::ComponentType >::ALIGN32); 291 }; 292 pub trait HostWithStore: wasmtime::component::HasData {} 293 impl<_T: ?Sized> HostWithStore for _T 294 where 295 _T: wasmtime::component::HasData, 296 {} 297 pub trait Host { 298 fn a(&mut self) -> Foo; 299 } 300 impl<_T: Host + ?Sized> Host for &mut _T { 301 fn a(&mut self) -> Foo { 302 Host::a(*self) 303 } 304 } 305 pub fn add_to_linker<T, D>( 306 linker: &mut wasmtime::component::Linker<T>, 307 host_getter: fn(&mut T) -> D::Data<'_>, 308 ) -> wasmtime::Result<()> 309 where 310 D: HostWithStore, 311 for<'a> D::Data<'a>: Host, 312 T: 'static, 313 { 314 let mut inst = linker.instance("foo:foo/c")?; 315 inst.func_wrap( 316 "a", 317 move |mut caller: wasmtime::StoreContextMut<'_, T>, (): ()| { 318 let host = &mut host_getter(caller.data_mut()); 319 let r = Host::a(host); 320 Ok((r,)) 321 }, 322 )?; 323 Ok(()) 324 } 325 } 326 } 327 } 328 #[allow(clippy::all)] 329 pub mod d { 330 #[allow(unused_imports)] 331 use wasmtime::component::__internal::{anyhow, Box}; 332 pub type Foo = super::foo::foo::c::Foo; 333 const _: () = { 334 assert!(0 == < Foo as wasmtime::component::ComponentType >::SIZE32); 335 assert!(1 == < Foo as wasmtime::component::ComponentType >::ALIGN32); 336 }; 337 pub trait HostWithStore: wasmtime::component::HasData {} 338 impl<_T: ?Sized> HostWithStore for _T 339 where 340 _T: wasmtime::component::HasData, 341 {} 342 pub trait Host { 343 fn b(&mut self) -> Foo; 344 } 345 impl<_T: Host + ?Sized> Host for &mut _T { 346 fn b(&mut self) -> Foo { 347 Host::b(*self) 348 } 349 } 350 pub fn add_to_linker<T, D>( 351 linker: &mut wasmtime::component::Linker<T>, 352 host_getter: fn(&mut T) -> D::Data<'_>, 353 ) -> wasmtime::Result<()> 354 where 355 D: HostWithStore, 356 for<'a> D::Data<'a>: Host, 357 T: 'static, 358 { 359 let mut inst = linker.instance("d")?; 360 inst.func_wrap( 361 "b", 362 move |mut caller: wasmtime::StoreContextMut<'_, T>, (): ()| { 363 let host = &mut host_getter(caller.data_mut()); 364 let r = Host::b(host); 365 Ok((r,)) 366 }, 367 )?; 368 Ok(()) 369 } 370 } 371