rune_alloc/
lib.rs

Help
1//! <img alt="rune logo" src="https://raw.githubusercontent.com/rune-rs/rune/main/assets/icon.png" />
2//! <br>
3//! <a href="https://github.com/rune-rs/rune"><img alt="github" src="https://img.shields.io/badge/github-rune--rs/rune-8da0cb?style=for-the-badge&logo=github" height="20"></a>
4//! <a href="https://crates.io/crates/rune-alloc"><img alt="crates.io" src="https://img.shields.io/crates/v/rune-alloc.svg?style=for-the-badge&color=fc8d62&logo=rust" height="20"></a>
5//! <a href="https://docs.rs/rune-alloc"><img alt="docs.rs" src="https://img.shields.io/badge/docs.rs-rune--alloc-66c2a5?style=for-the-badge&logoColor=white&logo=data:image/svg+xml;base64,PHN2ZyByb2xlPSJpbWciIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgdmlld0JveD0iMCAwIDUxMiA1MTIiPjxwYXRoIGZpbGw9IiNmNWY1ZjUiIGQ9Ik00ODguNiAyNTAuMkwzOTIgMjE0VjEwNS41YzAtMTUtOS4zLTI4LjQtMjMuNC0zMy43bC0xMDAtMzcuNWMtOC4xLTMuMS0xNy4xLTMuMS0yNS4zIDBsLTEwMCAzNy41Yy0xNC4xIDUuMy0yMy40IDE4LjctMjMuNCAzMy43VjIxNGwtOTYuNiAzNi4yQzkuMyAyNTUuNSAwIDI2OC45IDAgMjgzLjlWMzk0YzAgMTMuNiA3LjcgMjYuMSAxOS45IDMyLjJsMTAwIDUwYzEwLjEgNS4xIDIyLjEgNS4xIDMyLjIgMGwxMDMuOS01MiAxMDMuOSA1MmMxMC4xIDUuMSAyMi4xIDUuMSAzMi4yIDBsMTAwLTUwYzEyLjItNi4xIDE5LjktMTguNiAxOS45LTMyLjJWMjgzLjljMC0xNS05LjMtMjguNC0yMy40LTMzLjd6TTM1OCAyMTQuOGwtODUgMzEuOXYtNjguMmw4NS0zN3Y3My4zek0xNTQgMTA0LjFsMTAyLTM4LjIgMTAyIDM4LjJ2LjZsLTEwMiA0MS40LTEwMi00MS40di0uNnptODQgMjkxLjFsLTg1IDQyLjV2LTc5LjFsODUtMzguOHY3NS40em0wLTExMmwtMTAyIDQxLjQtMTAyLTQxLjR2LS42bDEwMi0zOC4yIDEwMiAzOC4ydi42em0yNDAgMTEybC04NSA0Mi41di03OS4xbDg1LTM4Ljh2NzUuNHptMC0xMTJsLTEwMiA0MS40LTEwMi00MS40di0uNmwxMDItMzguMiAxMDIgMzguMnYuNnoiPjwvcGF0aD48L3N2Zz4K" height="20"></a>
6//! <a href="https://discord.gg/v5AeNkT"><img alt="chat on discord" src="https://img.shields.io/discord/558644981137670144.svg?logo=discord&style=flat-square" height="20"></a>
7//! <br>
8//! Minimum support: Rust <b>1.81+</b>.
9//! <br>
10//! <br>
11//! <a href="https://rune-rs.github.io"><b>Visit the site 🌐</b></a>
12//! &mdash;
13//! <a href="https://rune-rs.github.io/book/"><b>Read the book 📖</b></a>
14//! <br>
15//! <br>
16//!
17//! The Rune Language, an embeddable dynamic programming language for Rust.
18// Quite a few parts copied from the Rust Project under the MIT license.
19//
20// Copyright 2014-2024 The Rust Project Developers
21//
22// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
23// https://www.apache.org/licenses/LICENSE-2.0> or the MIT license <LICENSE-MIT
24// or https://opensource.org/licenses/MIT>, at your option. Files in the project
25// may not be copied, modified, or distributed except according to those terms.
26
27// hashbrown
28//
29// Copyright (c) 2016 Amanieu d'Antras
30//
31// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
32// https://www.apache.org/licenses/LICENSE-2.0> or the MIT license <LICENSE-MIT
33// or https://opensource.org/licenses/MIT>, at your option. Files in the project
34// may not be copied, modified, or distributed except according to those terms.
35
36#![no_std]
37#![deny(rustdoc::broken_intra_doc_links)]
38#![deny(rustdoc::private_doc_tests)]
39#![cfg_attr(rune_nightly, deny(rustdoc::missing_doc_code_examples))]
40#![cfg_attr(rune_nightly, allow(internal_features))]
41#![cfg_attr(rune_nightly, feature(fmt_internals))]
42#![cfg_attr(rune_nightly, feature(rustdoc_missing_doc_code_examples))]
43#![cfg_attr(rune_nightly, feature(core_intrinsics))]
44#![cfg_attr(rune_nightly, feature(dropck_eyepatch))]
45#![cfg_attr(rune_nightly, feature(min_specialization))]
46#![cfg_attr(rune_nightly, feature(slice_range))]
47#![cfg_attr(rune_nightly, feature(rustc_attrs))]
48#![allow(clippy::comparison_chain)]
49#![allow(clippy::manual_map)]
50#![allow(clippy::type_complexity)]
51#![allow(clippy::drop_non_drop)]
52
53#[cfg(feature = "std")]
54extern crate std;
55
56#[cfg(feature = "alloc")]
57extern crate alloc as rust_alloc;
58
59// This is here for forward compatibility when we can support allocation-free
60// execution.
61#[cfg(not(feature = "alloc"))]
62compile_error!("The `alloc` feature is currently required to build rune-alloc, but will change for parts of rune in the future.");
63
64/// A `Result` aliased specialized towards an allocation [`Error`].
65pub type Result<T, E = crate::error::Error> = core::result::Result<T, E>;
66
67#[cfg(feature = "std")]
68pub use std::path;
69#[cfg(not(feature = "std"))]
70pub mod path;
71
72#[cfg(not(feature = "std"))]
73mod no_std;
74#[cfg(not(feature = "std"))]
75pub use self::no_std::abort;
76
77#[cfg(feature = "std")]
78pub use std::process::abort;
79
80#[cfg(feature = "serde")]
81mod serde;
82
83#[macro_use]
84mod public_macros;
85
86#[macro_use]
87mod macros;
88
89pub use self::error::Error;
90pub mod error;
91
92pub mod str;
93
94pub(crate) mod raw_vec;
95
96pub use self::boxed::Box;
97pub mod boxed;
98
99pub use self::btree::{map as btree_map, map::BTreeMap};
100pub use self::btree::{set as btree_set, set::BTreeSet};
101pub(crate) mod btree;
102
103pub use self::hashbrown::{map as hash_map, map::HashMap};
104pub use self::hashbrown::{set as hash_set, set::HashSet};
105pub mod hashbrown;
106
107pub use self::vec::Vec;
108pub mod vec;
109
110pub use self::vec_deque::VecDeque;
111pub mod vec_deque;
112
113pub use self::string::String;
114pub mod string;
115
116pub mod alloc;
117
118pub mod clone;
119
120pub mod borrow;
121
122pub mod iter;
123
124pub mod fmt;
125
126mod option;
127
128pub(crate) mod hint;
129pub(crate) mod ptr;
130#[doc(hidden)]
131pub mod slice;
132
133pub mod callable;
134
135pub mod prelude {
136    //! Prelude for common traits used in combination with this crate which
137    //! matches the behavior of the std prelude.
138
139    pub use crate::borrow::TryToOwned;
140    pub use crate::boxed::Box;
141    pub use crate::clone::{TryClone, TryCopy};
142    pub use crate::iter::{IteratorExt, TryExtend, TryFromIterator, TryFromIteratorIn};
143    pub use crate::option::OptionExt;
144    pub use crate::string::{String, TryToString};
145    pub use crate::vec::Vec;
146    pub use crate::{try_format, try_vec};
147}
148
149pub mod limit;
150
151#[cfg(test)]
152mod testing;
153
154#[cfg(test)]
155mod tests;
rune_alloc/lib.rs

rune_alloc/
lib.rs
