alloc-shim 0.3.1

A shim crate for to import items of alloc crate ergonomically.
Documentation

alloc-shim

Build Status version documentation license Rustc Version

A shim crate for to import items of alloc crate ergonomically.

Examples

Usage

Add this to your Cargo.toml:

[dependencies]
alloc-shim = "0.3.1"

Set the features so that std depends on alloc-shim/std, and alloc depends on alloc-shim/alloc:

[features]
std = ["alloc-shim/std"]
alloc = ["alloc-shim/alloc"]

Add this to your crate root (lib.rs or main.rs):

#![cfg_attr(feature = "alloc", feature(alloc))]

Now, you can use alloc-shim:

#[cfg(any(feature = "alloc", feature = "std"))]
use alloc::prelude::*; // And more...

The current version of alloc-shim requires Rust 1.31 or later.

Crate Features

If not either std or alloc is specified, this crate does nothing.

  • std

    • Disabled by default.
    • Enable to use std crate.

  • alloc

    • Disabled by default.
    • Enable to use alloc crate.
    • Note that std crate is used if both std and alloc are specified at the same time (and it can compile in the minimum required version of alloc-shim).
    • This requires Rust Nightly.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.