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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

//! # High-level bindings to quickjs
//!
//! The `rquickjs` crate provides safe high-level bindings to the [quickjs](https://bellard.org/quickjs/) javascript engine.
//! This crate is heavily inspired by the [rlua](https://crates.io/crates/rlua) crate.

#![allow(clippy::needless_lifetimes)]
#![cfg_attr(feature = "doc-cfg", feature(doc_cfg))]

//#[doc(hidden)]
pub mod qjs {
    //! Native low-level bindings
    pub use rquickjs_sys::*;
}

#[cfg(feature = "phf")]
#[doc(hidden)]
pub mod phf {
    pub use phf::*;
}

/// Short macro to define a cstring literal.
///
/// Make sure the string does not contain internal null characters or it will end early.
#[macro_export]
macro_rules! cstr {
    ($str:tt) => {
        std::ffi::CStr::from_bytes_until_nul(concat!($str, "\0").as_bytes()).unwrap()
    };
}

pub mod markers;
mod result;
pub use result::{CatchResultExt, CaughtError, CaughtResult, Error, Result, ThrowResultExt};
mod safe_ref;
pub(crate) use safe_ref::*;
pub mod runtime;
#[cfg(feature = "futures")]
#[cfg_attr(feature = "doc-cfg", doc(cfg(feature = "futures")))]
pub use runtime::AsyncRuntime;
pub use runtime::Runtime;
pub mod context;
#[cfg(feature = "futures")]
#[cfg_attr(feature = "doc-cfg", doc(cfg(feature = "futures")))]
pub use context::AsyncContext;
pub use context::{Context, Ctx};
mod persistent;
mod value;
pub use persistent::{Outlive, Persistent};
pub use value::{
    convert, function, module, object, Array, Atom, BigInt, Exception, FromAtom, FromJs, Function,
    IntoAtom, IntoJs, Module, Null, Object, String, Symbol, Type, Undefined, Value,
};

#[cfg(feature = "array-buffer")]
#[cfg_attr(feature = "doc-cfg", doc(cfg(feature = "array-buffer")))]
pub use value::{ArrayBuffer, TypedArray};
mod class_id;
#[cfg(not(feature = "classes"))]
pub(crate) use class_id::ClassId;
#[cfg(feature = "classes")]
#[cfg_attr(feature = "doc-cfg", doc(cfg(feature = "classes")))]
pub use class_id::ClassId;

#[cfg(feature = "classes")]
#[cfg_attr(feature = "doc-cfg", doc(cfg(feature = "classes")))]
pub mod class;
#[cfg(feature = "classes")]
#[cfg_attr(feature = "doc-cfg", doc(cfg(feature = "classes")))]
pub use class::Class;

pub(crate) use std::{result::Result as StdResult, string::String as StdString};

#[cfg(feature = "futures")]
#[cfg_attr(feature = "doc-cfg", doc(cfg(feature = "futures")))]
pub mod promise;

#[cfg(feature = "allocator")]
#[cfg_attr(feature = "doc-cfg", doc(cfg(feature = "allocator")))]
pub mod allocator;

#[cfg(feature = "loader")]
#[cfg_attr(feature = "doc-cfg", doc(cfg(feature = "loader")))]
pub mod loader;

pub mod prelude {
    //! A group of often used types.
    pub use crate::{
        context::MultiWith,
        convert::{Coerced, FromAtom, FromJs, IntoAtom, IntoJs, IteratorJs},
        function::{AsArguments, Func, MutFn, OnceFn, Rest, This},
        result::{CatchResultExt, ThrowResultExt},
    };
    #[cfg(feature = "futures")]
    #[cfg_attr(feature = "doc-cfg", doc(cfg(feature = "futures")))]
    pub use crate::{
        function::Async,
        promise::{Promise, Promised},
    };
}

/*#[cfg(feature = "loader")]
pub use loader::{
    BuiltinLoader, BuiltinResolver, Bundle, Compile, FileResolver, HasByteCode, Loader,
    ModuleLoader, Resolver, ScriptLoader,
};
*/

#[cfg(test)]
pub(crate) fn test_with<F, R>(func: F) -> R
where
    F: FnOnce(Ctx) -> R,
{
    let rt = Runtime::new().unwrap();
    let ctx = Context::full(&rt).unwrap();
    ctx.with(func)
}