ambient_api_core 0.3.1

The API to the Ambient Runtime (core)
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

use crate::{
    internal::{self, conversion::FromBindgen},
    prelude::EntityId,
};

#[doc(hidden)]
pub fn get_entity_for_package_id(package_id: &str) -> Option<EntityId> {
    internal::wit::ambient_package::get_entity_for_package_id(package_id).from_bindgen()
}

#[cfg(feature = "server")]
/// Load a package from a URL.
pub async fn load(url: &str) -> anyhow::Result<EntityId> {
    use crate::{
        internal::generated::ambient_core::package::messages::{
            PackageLoadFailure, PackageLoadSuccess,
        },
        prelude::wait_for_fallible_runtime_messages,
    };

    internal::wit::server_ambient_package::load(url);
    let res = wait_for_fallible_runtime_messages::<PackageLoadSuccess, PackageLoadFailure>(
        {
            let url = url.to_owned();
            move |s| s.url == url
        },
        {
            let url = url.to_owned();
            move |f| f.url == url
        },
    )
    .await;

    match res {
        Ok(s) => Ok(s.package),
        Err(e) => Err(anyhow::Error::msg(e.reason)),
    }
}