feat(stack-cstr): add thiserror dependency for error handling, replacing &'static str

Author: fxdmhtt

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "stack-cstr"
-version = "0.1.2"
+version = "0.1.3"
 edition = "2024"
 authors = ["Junkang Yuan <[email protected]>"]
 description = "High-performance stack-to-heap C string creation for Rust with FFI support"
@@ -12,3 +12,4 @@ categories = ["development-tools::ffi", "memory-management"]
 
 [dependencies]
 arrayvec = "0.7.6"
+thiserror = "2.0.16"

Cargo.toml

@@ -2,7 +2,7 @@ use std::ffi::{CStr, c_char};
 
 use arrayvec::ArrayString;
 
-use crate::CStrLike;
+use crate::{CStrError, CStrLike};
 
 /// A stack-allocated, null-terminated C string with fixed capacity.
 ///
@@ -41,14 +41,11 @@ impl<const N: usize> CStrStack<N> {
     ///
     /// The string is written into an internal buffer of size `N`.
     /// If the string does not fit, returns an error.
-    pub fn new(fmt: std::fmt::Arguments) -> Result<CStrStack<N>, &'static str> {
+    pub fn new(fmt: std::fmt::Arguments) -> Result<CStrStack<N>, CStrError> {
         let mut buf: ArrayString<N> = ArrayString::new();
-        std::fmt::write(&mut buf, fmt).map_err(|_| "format failed")?;
+        std::fmt::write(&mut buf, fmt)?;
 
-        if buf.len() + 1 > N {
-            return Err("buffer overflow");
-        }
-        buf.push('\0');
+        buf.try_push('\0')?;
 
         Ok(Self { buf })
     }

src/cstr_stack.rs

@@ -0,0 +1,9 @@
+use thiserror::Error;
+
+#[derive(Error, Debug)]
+pub enum CStrError {
+    #[error("format failed")]
+    FormatError(#[from] core::fmt::Error),
+    #[error("buffer overflow")]
+    OverflowError(#[from] arrayvec::CapacityError<char>),
+}

src/error.rs

@@ -102,8 +102,10 @@
 pub mod cstr_heap;
 pub mod cstr_like;
 pub mod cstr_stack;
+pub mod error;
 pub mod macros;
 
 pub use cstr_heap::CStrHeap;
 pub use cstr_like::CStrLike;
 pub use cstr_stack::CStrStack;
+pub use error::CStrError;