CHANGELOG.md

Upcoming

... all released!

0.9.0

February 24, 2025

Breaking Changes 💥

• Removed deprecated methods CompactString::new_inline(...) and CompactString::from_static_str(...).
  • Implemented in fix: delete methods that are documented as deprecated in v0.9.0
• Changed the CompactStringExt::join_compact and CompactStringExt::concat_compact to take a reference (i.e. &C) to a type C: IntoIterator<Item = &str> instead of ownership of a type C where &C: IntoIterator<Item = &str>.
  • Fixed issue#412 which made the CompactStringExt more ergonomic.
  • Implemented in feat: tweak the CompactStringExt trait so join_compact and concat_compact work better

Changes

• Fixed the borsch feature in no_std environments.
  • Implemented in fix: The borsch feature with no-std.
• Implemented the zeroize::Zeroize trait for CompactString.
  • Implemented in feat: Add support for zeroize::Zeroize.
• Fixed the CompactString::retain method to not set length if the predicate panics.
  • Implemented in fix: retain not set len if predicate panics.
• Implement sqlx::postgres::PgHasArrayType for CompactString.
  • Implemented in impl sqlx::postgres::PgHasArrayType.
• Bump the markup dependency to v0.15.
  • Implemented in deps: upgrade to markup v0.8.
• Bump the rkyv dependency to v0.8.
  • Implemented in deps: upgrade to rkyv v0.8.
• Bump the sqlx dependency to v0.8.
  • Implemented in deps: upgrade to sqlx v0.8.

0.8.0

July 8, 2024

Breaking Changes 💥

• Consolidate CompactString::new_inline(...) and CompactString::from_static_str(...) into CompactString::const:new(...). Methods are currently marked as deprecated and will be removed in v0.9.0.
  • Implemented in Add const_new(); remove new_inline() and from_static_str()
• Minimum supported Rust version (MSRV) was bumped to v1.60
  • Implemented in fix: MSRV check and change MSRV to 1.60

Changes

• Add support for borsh under an optional feature.
  • Implemented in Add borsh support
• Add additial PartialEq impls for CompactString
  • Implemented in fix: More PartialEq impls
• Match alignment of internal InlineBuffer and Repr.
  • Implemeneted in Align InlineBuffer same as Repr
• Fix conflict between serde and no_std features.
  • Implemented in fix serde no-std issue
• Improve performance of CompactString::is_empty.
  • Implemented in Simplify is_empty()
• Implement additional From impls that std::string::String has.
  • Implemented in Add missing From impls that String has
• Implement Clone::clone_from for CompactString.
  • Implemented in Impl Clone::clone_from for CompactString
• Make re-allocations of a heap-based CompactString fallible.
  • Implemented in Make (re)allocations fallible
• Inline short &'static strs
  • Implemented in Inline short static strings
• Add support for serializing a CompactString from diesel and sqlx
  • Implemented in Implement diesel compatibility
  • Implemented in Implement for sqlx

... and everything from v0.8.0-beta

Fixed Issues

• Re-enabled specialization for String in trait ToCompactString by upgrading to castaway v0.2.3
  • Implemented in deps: Upgrade to castaway v0.2.3

0.8.0-beta

October 8, 2023

Outstanding Issues

• Re-enable specialization for String in trait ToCompactString, #304

Changes

• Support storing a &'static str in a CompactString in O(1)
  • Implemented in feat: Support O(1) CompactString::from_static_str
• Support no_std environments
  • Implemented in support no_std
• Add repeat() API to CompactString
  • Implemented in feat: Implement CompactString::repeat
• Add to_ascii_lowercase(), to_ascii_uppercase(), to_lowercase(), and to_uppercase() APIs to CompactString
  • Implemented in feat: Implement case conversion fn for CompactString
• Add from_str_to_lower(...) and from_str_to_upper(...) APIs to CompactString
  • Implemented in feat: Impl CompactString::from_str_to_{lower, upper}case
• Improve the performance of the CompactString::as_str() API
  • Implemented in Remove branches from Repr::as_slice()
• Improve the performance of the CompactString::len() API
  • Implemented in Simplify Repr::len()
• Improve the performance of the Clone implementation for CompactString
  • Implemented in Simplify clone()
• Improve the performance of some internal types.
  • Implemented in Fix and optimize Capacity
• Open more niches for enum layout optimizations
  • Implemented in Open up more niches
• Update MSRV to 1.59
  • Implemented in MSRV: Bump to 1.59

0.7.1

June 21, 2023

• Improve the performance of the ToCompactString trait
  • Implemented in fix: Don't count bytes in ToCompactString

0.7.0

February 21, 2023

• Use the -Zrandomize-layout rustc flag in CI
  • Implemented in ci: Randomize Layout in CI
• Change as_ptr() to require only &self and not &mut self
  • Implemented in refactor: Change CompactString::as_ptr to take &self
• Add into_bytes() method behind the smallvec feature which converts a CompactString into a byte vector using a SmallVec
  • Implemented in api: Add CompactString::into_bytes
• Add from_string_buffer() method which always re-uses the underlying buffer from String
  • Implemented in api: Update From<String> and From<Box<str>> to eagerly inline
• Eagerly inline strings when Clone-ing a CompactString
  • Implemented in perf: Inline strings when Clone-ing
• Updated From<String> and From<Box<str>> to eagerly inline strings
  • Implemented in api: Update From<String> and From<Box<str>> to eagerly inline
• Fix a typo in the documentation on CompactString
  • Implemented in Fix a typo in documentation
• Implement AsRef<[u8]> for CompactString
  • Implemented in impl AsRef<[u8]> for CompactString
• Improve the performance of string and length access by using branchless instructions
  • Implemented in perf: Refactor underlying buffers for branchless access
• Implement From<CompactString> for Cow<'_, str>
  • Implemented in Implement From<CompactString> for Cow<'_, str>
• Improve the performance of CompactString::new_inline
  • Implemented in Copy inline string reversed
• Implement more FromIterator and Extend traits for CompactString
  • Implemented in Implement more FromIterator & Extend traits
• Add into_string() method
  • Implemented in Implement more FromIterator & Extend traits

0.6.1

August 22, 2022

• Enable the std feature in proptest to fix documentation on docs.rs
  • Implemented in Enable "proptest/std" feature

0.6.0

August 21, 2022

• Add from_utf16_lossy(), from_utf16be_lossy(), and from_utf16le_lossy()
  • Implemented in feat: implement from_utf16_lossy API
  • Implemented in Implement from_utf16ne_lossy and from_utf16be_lossy
• Add from_utf16be() and from_utf16le() methods
  • Implemented in Implement from_utf16le, from_utf16be, from_utf16ne
• Implement rkyv::Archive, rkyv::Deserialize, and rkyv::Serialize for CompactString
  • Implemented in Add rkyv serialization
• Improve performance when counting number of bytes to write into a CompactString
  • Implemented in Don't format char to determine it's UTF-8 length
• Improve macro hygiene for format_compact! macro
  • Implemented in Macro hygiene: use re-exported format_args!()
• Improve performance when a CompactString is allocated on the heap
  • Implemented in #160 perf: Implement realloc for BoxString
• Implement markup::Render trait
  • Implemented in #157 Implement markup::Render trait and document features
• Implement the Arbitrary trait from arbitrary, proptest, and quickcheck
  • Implemented in 146 feat: Implemented the Arbitrary trait from various crate
• impl From<CompactString> for String
  • Implemented in #118 feat: add impl From<CompactString> for String
• impl AddAssign (+=) for CompactString
  • Implemented in add AddAssign operator

std::String API Parity Milestone

• Add from_utf8_lossy() method
  • Implemented in Implement from_utf8_lossy()
• Add from_utf8_unchecked() method
  • Implemented in feat: from_utf8_unchecked()
• Add retain() method
  • Implemented in Implement retain()
• Add remove() method
  • Implemented in feat: Implement CompactString::remove()
• Add from_utf16() method
  • Implemented in #170 feat: Implement CompactString::from_utf16
• Add split_off() method
  • Implemented in #154 Implement split_off()
• Add drain() method
  • Implemented in #153 Implement drain()
• Add clear() method
  • Implemented in #149 Implement clear()
• Add insert() and insert_str() methods
  • Implemented in #148 Implement insert() and insert_str()
• Add truncate() method
  • Implemented in #132 Implement truncate()
• Add replace_range() method
  • Implemented in #125 Implement replace_range()
• Add as_mut_str() method
  • Implemented in #124 Add as_mut_str() method

0.5.2

July 24, 2022

• Fix error when creating CompactString with capacity 16711422 on 32-bit archiectures
  • Implemented in #161 fix: Test case discovered by AFL
  • Backported in #167 backport(v0.5): Test case discovered by AFL

0.5.1

June 27, 2022

• Fix error when importing compact_str by change the existing Add<...> impls
  • Implemented in #103 fix/feat: Change the existing Add<...> impls
  • Backported

0.5.0

June 18, 2022

• Add examples for CompactStringExt and ToCompactString traits, and format_compact!(...) macro
  • Implemented in #114 cleanup and examples: Removes bounds check, adds more examples, removes const_panic hack
• Remove potential bounds check when converting to &str
  • Implemented in #114 cleanup and examples: Removes bounds check, adds more examples, removes const_panic hack
  • Implemented in #9 Remove potential bounds check from a hot path
• Remove CompactStr type alias to prep for v0.5, as the deprecation message noted
  • Implemented in #110 chore: Remove CompactStr type alias
• Add CompactStringExt which provides methods to join and concatenate collections into a CompactString
  • Implemented in #109 feat: CompactStringExt trait
• Encode CompactString in such a way that size_of::<CompactString>() == size_of::<Option<CompactString>>()
  • Implemented in #105 perf: Option<CompactString> same size as CompactString
  • Implemented in #75: smol option
  • Implemented in #22 draft: Optimize Option<CompactStr> to be the same size as CompactStr
• Update MSRV to 1.57
• impl AsRef<OsStr> for CompactStr
  • Implemented in #102 Impl AsRef<OsStr> for CompactString
• Add format_compact! macro
  • Implemented in #101 Add macro_rules format_compact!

0.4.1

June 27, 2022

• Fix error when importing compact_str by change the existing Add<...> impls
  • Implemented in #103 fix/feat: Change the existing Add<...> impls
  • Backported

0.4.0

May 27, 2022

• Rename CompactStr -> CompactString and ToCompactStr -> ToComapctString
  • Implemented in #97 refactor: Rename CompactStr to CompactString
• Improve performance of ToCompactStr by reducing copies for some specialized types
  • Implemented in #95 perf: Reduce copies in ToCompactStr for integer types
• Introduce the ToCompactStr trait, with specialized impls for common types
  • Implemented in #16 Add && Impl new trait ToCompactStr
• Improve the performance of From<Cow<'_, str>>
  • Implemented in #90 Optimize From<Cow<'a, str>> impl for CompactStr
• impl various Add<T> for CompactStr, enabling concatination with + Implemented in #81 impl a bunch of Add<T>s for CompactStr, and Add<CompactStr> for String
• Improved the performance of Drop for inlined strings
  • Implemented in #78 perf: Improve the performance of Repr::Drop for Inlined Variants
• impl fmt::Write for CompactStr
  • Implemented in #73 Implement fmt::Write for CompactStr
• Inline short heap strings when resizing. After enabling O(1) conversion from String and Box<str> it became possible for short strings to be heap allocated. Now if we need to resize a short heap string, we'll inline it, instead of re-heap allocating.
  • Implemented in #70 perf: Inline short heap strings when resizing

0.3.2

March 27, 2022

• Enable O(1) conversion from String or Box<str> to CompactStr
  • Implemented in #65 perf: Move Capacity onto the Stack
• Update the README to remove references to "immutable". CompactStr became mutable with v0.3.0

0.3.1

March 6, 2022

• impl Extend<Cow<str>> for CompactStr
  • Implemented in #64 feature: impl Extend<Cow<'_, str>> for CompactStr
• impl From<Cow<str>> for CompactStr
  • Implemented in #62 impl From<Cow<'_, str>> for CompactStr

0.3.0

February 27, 2022

• Add CompactStr::from_utf8(...) API
  • Implemented in #57 feature: Add from_utf8 API
• Changed the heap variant from an atomically reference counted string, to a normal heap allocated string
  • Implenented in #56 feature: BoxString
  • Note: This change was made after much deliberation and research into C++ strings and the performance of "copy on write" once mutation is introduced
• Combined the Inline and Packed variants into one variant, store the discriminant in the last byte instead of first
  • Implemented in #49 refactor: Combine Inline and Packed Variants
  • Note: This simplified the code, and improved the performance of inline string creation and modification
• Removed all required dependencies from ComapctStr
  • Implemented in #48 vendor: static-assertions
• Add more public docs and doc tests for CompactStr
  • Implemented in #46 chore: Add public documentation to CompactStr
• Add CompactStr::pop(...), CompactStr::push(...), and CompactStr::push_str(...) APIs
  • Implemented in #45 feature: impl the Extend trait for CompactStr
• Implement the Extend trait for CompactStr
  • Implemented in #45 feature: impl the Extend trait for CompactStr
• Add bytes feature to CompactStr, includes from_utf8_buf*(...) APIs
  • Implemented in #40 feature: bytes
• Add a CompactStr::as_mut_slice(...) API
  • Implemented in #37 feature: as_mut_slice API
• Add a CompactStr::reserve(...) API
  • Implemented in #36 feature: reserve API
• Improve CI, add workflows for MSRV, Miri, All Features, Fuzzing, Docs, and self-hosted ARMv7
  • Implemented in #26, #32, 34, #35, #42, #56

0.2.0

November 14, 2021

• Change Minimum Supported Rust Version to 1.49
  • Implemented in #24 Make Minimum Supported Rust Version 1.49
• Implement FromIterator for CompactStr
  • Implemented in #23 impl FromIterator<...> for CompactStr

0.1.2

October 29, 2021

• impl FromStr for CompactStr
  • Fixes #18 Consider impl trait FromStr for CompactStr
  • Implemented by #20 impl FromStr for CompactStr
• Setting minimum supported Rust version (MSRV) to 1.56
  • Fixes #3 Document minimal supported Rust Version
  • Implemented by #17 Upgrade to Edition 2021 and mac MSRV 1.56
• Upgrade to Edition 2021
  • #17 Upgrade to Edition 2021 and make MSRV 1.56

0.1.1

September 30, 2021

• impl PartialEq from more types
  • #15 Add impl PartialEq for &str
• Add missing #[inline] and #[repr(C)] annotations
  • #6 add missing repr(C)
  • #5 add missing inline
• Fix typos
  • #10 missing rename
  • #8 fix typo
• Avoid future incompatibilities with warnings
  • #4 avoid incompatibility with future warnings hazard

0.1

September 19, 2021

• Initial release!