smallstr

smallstr provides a SmallString type: a String-like container backed by SmallVec that keeps short strings inline on the stack and only spills to the heap once they exceed a configurable capacity. This small-string optimization avoids heap allocation for the common case of short text, which can meaningfully reduce allocation pressure in hot paths.

The type behaves like the standard String, implementing the usual traits (Deref to str, formatting, iteration, comparison) so it can be used as a near drop-in replacement. It offers optional serde serialization, a no_std mode, and FFI-friendly and union storage features.

What You Get

• A SmallString type with configurable inline capacity
• Small-string optimization that avoids heap allocation for short text
• A String-like API via Deref to str and standard trait implementations
• Optional serde Serialize/Deserialize support
• no_std, union storage, and FFI feature flags

Common Use Cases

• Storing many short strings (keys, tokens, identifiers) without per-item heap allocation
• Reducing allocation pressure in performance-sensitive parsing or formatting code
• Embedding short strings in structs on no_std targets

Under The Hood

Architecture - The crate is two files: lib.rs re-exports the public surface and string.rs defines SmallString<A>, a newtype over SmallVec<A> where A is a byte array type setting the inline capacity. String operations maintain UTF-8 validity over the underlying byte buffer, and the type derefs to str so the standard slice methods apply without reimplementation.

Tech Stack - Written in Rust (edition 2018) declaring the crates.io data-structures category. Its only required dependency is smallvec; serde (alloc features) is optional, and bincode is used as a dev-dependency for serialization tests. Feature flags (std, union, ffi) toggle no_std behavior, tighter union storage, and FFI support.

Code Quality - The implementation is compact and leans on the well-tested smallvec for its storage invariants, focusing its own code on preserving UTF-8 and mirroring String’s trait surface. It carries serialization round-trip tests and has accrued fixes from several contributors, and remains maintained with a 2025 release.

API Design - Because SmallString mirrors String (Deref to str, From/FromIterator, formatting, comparison), it is close to a drop-in replacement, so the main thing a user learns is picking an inline-capacity array type. That single decision plus familiar methods keeps the learning curve low, and docs.rs documents the type and its feature flags clearly.