Struct StringPool 

pub struct StringPool { /* private fields */ }

String pool for deduplicating commonly repeated strings in execution history.

Phase names and agent names are repeated frequently across execution history entries. Using Arc with a string pool reduces memory usage by sharing the same allocation for identical strings.

Example

use ralph_workflow::checkpoint::string_pool::StringPool;
use std::sync::Arc;

let (pool, phase1) = StringPool::new().intern("Development");
let (_, phase2) = pool.intern("Development");

// Both Arc<str> values point to the same allocation
assert!(Arc::ptr_eq(&phase1, &phase2));

Implementations

impl StringPool

pub fn new() -> Self

Create a new string pool with default capacity hint.

Pre-allocates capacity for 16 unique strings, which is typical for most pipeline runs (phase names, agent names, step types).

pub fn with_capacity(capacity: usize) -> Self

Create a string pool with specific capacity.

Use this when you know the expected number of unique strings to avoid hash table resizing during initial population.

pub fn intern_str(self, s: &str) -> (Self, Arc<str>)

Get or insert a string slice into the pool, returning an Arc.

Prefer this when the input is already a &str to avoid allocating a temporary String on repeated calls.

Example

use ralph_workflow::checkpoint::string_pool::StringPool;

let (pool, s1) = StringPool::new().intern_str("test");
let (pool, s2) = pool.intern_str("test");
assert!(std::sync::Arc::ptr_eq(&s1, &s2));

pub fn intern_string(self, s: String) -> (Self, Arc<str>)

Get or insert an owned string into the pool, returning an Arc.

This path can reuse the allocation of the provided String when inserting.

pub fn intern(self, s: impl Into<String>) -> (Self, Arc<str>)

Backward-compatible convenience: accepts any Into<String>.

Note: callers passing &str should prefer intern_str() to avoid allocating a temporary String on repeated lookups.

pub fn len(&self) -> usize

Get the number of unique strings in the pool.

pub fn is_empty(&self) -> bool

Check if the pool is empty.

pub fn clear(self) -> Self

Clear all entries from the pool.

Trait Implementations

impl Clone for StringPool

fn clone(&self) -> StringPool

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StringPool

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for StringPool

fn default() -> StringPool

Returns the “default value” for a type.