mezzaluna_loaded_features/
lib.rs

1#![warn(clippy::all, clippy::pedantic, clippy::undocumented_unsafe_blocks)]
2#![allow(
3    clippy::let_underscore_untyped,
4    reason = "https://github.com/rust-lang/rust-clippy/pull/10442#issuecomment-1516570154"
5)]
6#![allow(
7    clippy::question_mark,
8    reason = "https://github.com/rust-lang/rust-clippy/issues/8281"
9)]
10#![allow(clippy::manual_let_else, reason = "manual_let_else was very buggy on release")]
11#![allow(clippy::missing_errors_doc, reason = "A lot of existing code fails this lint")]
12#![allow(
13    clippy::unnecessary_lazy_evaluations,
14    reason = "https://github.com/rust-lang/rust-clippy/issues/8109"
15)]
16#![cfg_attr(
17    test,
18    allow(clippy::non_ascii_literal, reason = "tests sometimes require UTF-8 string content")
19)]
20#![allow(unknown_lints)]
21#![warn(
22    missing_copy_implementations,
23    missing_debug_implementations,
24    missing_docs,
25    rust_2024_compatibility,
26    trivial_casts,
27    trivial_numeric_casts,
28    unused_qualifications,
29    variant_size_differences
30)]
31#![forbid(unsafe_code)]
32// Enable feature callouts in generated documentation:
33// https://doc.rust-lang.org/beta/unstable-book/language-features/doc-cfg.html
34//
35// This approach is borrowed from tokio.
36#![cfg_attr(docsrs, feature(doc_cfg))]
37#![cfg_attr(docsrs, feature(doc_alias))]
38
39//! A container for storing loaded features in a Ruby VM.
40//!
41//! The Artichoke Ruby VM may load code (called "features") with several
42//! strategies. Features can be loaded from an in-memory virtual file system
43//! (which can also store native extensions) or natively from local disk.
44//!
45//! The data structures in this crate track which features have been loaded
46//! with support for deduplicating features which may reside at multiple paths.
47//!
48//! # Examples
49//!
50//! ```
51//! use mezzaluna_loaded_features::{Feature, LoadedFeatures};
52//!
53//! let mut features = LoadedFeatures::new();
54//! features.insert(Feature::with_in_memory_path("/src/_lib/test.rb".into()));
55//! features.insert(Feature::with_in_memory_path("set.rb".into()));
56//! features.insert(Feature::with_in_memory_path("artichoke.rb".into()));
57//!
58//! for f in features.features() {
59//!     println!("Loaded feature at: {}", f.path().display());
60//! }
61//! ```
62
63// Ensure code blocks in `README.md` compile
64#[cfg(doctest)]
65#[doc = include_str!("../README.md")]
66mod readme {}
67
68mod feature;
69pub mod loaded_features;
70
71pub use feature::Feature;
72#[doc(inline)]
73pub use loaded_features::LoadedFeatures;
74#[doc(inline)]
75#[cfg(feature = "disk")]
76#[cfg_attr(docsrs, doc(cfg(feature = "disk")))]
77pub use same_file::Handle;
mezzaluna_loaded_features/lib.rs

mezzaluna_loaded_features/
lib.rs
