linebender_resource_handle 0.1.1

Raw resource handle for immutable blobs with dynamic lifetimes.
Documentation 
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

// Copyright 2024 the Raw Resource Handle Authors
// SPDX-License-Identifier: Apache-2.0 OR MIT

//! Linebender Resource Handle provides functionality for storing blobs of data and an associated ID.
//! This primitive is adapted in Peniko to store images, but the [`FontData`] type lives in this crate.
//! This crate is designed to allow making semver incompatible releases of Parley and Vello, whilst allowing them to be cross-compatible.
//!
//! This crate is not intended for long-term use, and we expect our resource handling story to change.
//! That's the reason that this crate has the organisation name ("Linebender") in its crate name; we avoid squatting a more general name after we abandon it.

// LINEBENDER LINT SET - lib.rs - v3
// See https://linebender.org/wiki/canonical-lints/
// These lints shouldn't apply to examples or tests.
#![cfg_attr(not(test), warn(unused_crate_dependencies))]
// These lints shouldn't apply to examples.
#![warn(clippy::print_stdout, clippy::print_stderr)]
// Targeting e.g. 32-bit means structs containing usize can give false positives for 64-bit.
#![cfg_attr(target_pointer_width = "64", warn(clippy::trivially_copy_pass_by_ref))]
// END LINEBENDER LINT SET
#![cfg_attr(docsrs, feature(doc_auto_cfg))]
#![no_std]

#[cfg(feature = "std")]
// Ensure that we don't compile if you're using the std feature on a platform without `std`
extern crate std as _;

mod blob;
mod font;

pub use blob::{Blob, WeakBlob};
pub use font::FontData;

#[cfg(test)]
mod tests {
    // CI will fail unless cargo nextest can execute at least one test per workspace.
    // Delete this dummy test once we have an actual real test.
    #[test]
    fn dummy_test_until_we_have_a_real_test() {}
}