Files
serai/common/std-shims
Luke Parker b24adcbd14 Add panic-on-poison to no-std std_shims::sync::Mutex
We already had this behavior on `std`. It was omitted when no-`std` due to
deferring to `spin::Mutex`, which does not track poisoning at all. This
increases the parity of the two.

Part of https://github.com/serai-dex/serai/issues/698.
2025-12-06 08:06:38 -05:00
..
2025-09-18 17:06:05 -04:00
2025-08-25 10:06:35 -04:00
2025-09-15 21:24:10 -04:00

std shims

std-shims is a Rust crate with two purposes:

  • Expand the functionality of core and alloc
  • Polyfill functionality only available on newer version of Rust

The goal is to make supporting no-std environments, and older versions of Rust, as simple as possible. For most use cases, replacing std:: with std_shims:: and adding use std_shims::prelude::* is sufficient to take full advantage of std-shims.

API Surface

std-shims only aims to have items mutually available between alloc (with extra dependencies) and std publicly exposed. Items exclusive to std, with no shims available, will not be exported by std-shims.

Dependencies

HashSet and HashMap are provided via hashbrown. Synchronization primitives are provided via spin (avoiding a requirement on critical-section). Sections of std::io are independently matched as possible. rustversion is used to detect when to provide polyfills.

Disclaimer

No guarantee of one-to-one parity is provided. The shims provided aim to be sufficient for the average case. Pull requests are welcome.