mirror of
https://github.com/fluencelabs/wasm-bindgen
synced 2025-04-22 04:32:13 +00:00
269c491380
* Gate `web-sys` APIs on activated features Currently the compile times of `web-sys` are unfortunately prohibitive, increasing the barrier to using it. This commit updates the crate to instead have all APIs gated by a set of Cargo features which affect what bindings are generated at compile time (and which are then compiled by rustc). It's significantly faster to activate only a handful of features vs all thousand of them! A magical env var is added to print the list of all features that should be generated, and then necessary logic is added to ferry features from the build script to the webidl crate which then uses that as a filter to remove items after parsing. Currently parsing is pretty speedy so we'll unconditionally parse all WebIDL files, but this may change in the future! For now this will make the `web-sys` crate a bit less ergonomic to use as lots of features will need to be specified, but it should make it much more approachable in terms of first-user experience with compile times. * Fix AppVeyor testing web-sys * FIx a typo * Udpate feature listings from rebase conflicts * Add some crate docs and such
20 lines
814 B
Rust
Executable File
20 lines
814 B
Rust
Executable File
//! Raw API bindings for Web APIs
|
|
//!
|
|
//! This is a procedurally generated crate from browser WebIDL which provides a
|
|
//! binding to all APIs that browser provide on the web.
|
|
//!
|
|
//! This crate by default contains very little when compiled as almost all of
|
|
//! its exposed APIs are gated by Cargo features. The exhaustive list of
|
|
//! features can be found in `crates/web-sys/Cargo.toml`, but the rule of thumb
|
|
//! for `web-sys` is that each type has its own cargo feature (named after the
|
|
//! type). Using an API requires enabling the features for all types used in the
|
|
//! API, and APIs should mention in the documentation what features they
|
|
//! require.
|
|
|
|
#![doc(html_root_url = "https://docs.rs/web-sys/0.2")]
|
|
|
|
extern crate wasm_bindgen;
|
|
extern crate js_sys;
|
|
|
|
include!(concat!(env!("OUT_DIR"), "/bindings.rs"));
|