Struct StringNonEmpty 

pub struct StringNonEmpty<const MAX_LEN: usize = 4096> { /* private fields */ }

Contract type for non-empty String values with bounded length.

Built on top of Utf8Bytes<N> foundation, adding non-empty constraint.

Type Parameters

• MAX_LEN - Maximum byte length (default: 4096)

Invariants

1. Content is valid UTF-8 (inherited from Utf8Bytes)
2. Length is > 0 (non-empty)
3. Length <= MAX_LEN (bounded)

Validates on construction, then can unwrap to stdlib String via into_inner().

Implementations

impl<const MAX_LEN: usize> StringNonEmpty<MAX_LEN>

pub fn new(value: String) -> Result<Self, ValidationError>

Constructs a non-empty, bounded String from stdlib String.

Errors

Returns ValidationError if:

• String is empty
• String length exceeds MAX_LEN bytes
• String is not valid UTF-8 (should never happen for stdlib String)

pub fn get(&self) -> &str

Gets the wrapped value as a string slice.

pub fn len(&self) -> usize

Gets the byte length of the string.

pub fn is_empty(&self) -> bool

Checks if the string is empty (always false due to invariant).

pub fn into_inner(self) -> String

Unwraps to stdlib String (trenchcoat off).

Trait Implementations

impl<const MAX_LEN: usize> Clone for StringNonEmpty<MAX_LEN>

fn clone(&self) -> StringNonEmpty<MAX_LEN>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<const MAX_LEN: usize> Debug for StringNonEmpty<MAX_LEN>

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

Formats the value using the given formatter.

impl<'de, const MAX_LEN: usize> Deserialize<'de> for StringNonEmpty<MAX_LEN>

fn deserialize<D: Deserializer<'de>>(d: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl ElicitComplete for StringNonEmpty

fn validate_proofs_non_empty() -> bool

Runtime check: all three proof methods return non-empty TokenStreams.

fn kani_proof_contains<Inner: Elicitation>() -> bool

Runtime check: does this type’s Kani proof contain Inner’s Kani proof?

fn verus_proof_contains<Inner: Elicitation>() -> bool

Runtime check: does this type’s Verus proof contain Inner’s Verus proof?

fn creusot_proof_contains<Inner: Elicitation>() -> bool

Runtime check: does this type’s Creusot proof contain Inner’s Creusot proof?

impl<const MAX_LEN: usize> ElicitIntrospect for StringNonEmpty<MAX_LEN>

fn pattern() -> ElicitationPattern

What elicitation pattern does this type use?

fn metadata() -> TypeMetadata

Get the complete structural metadata for this type.

impl<const MAX_LEN: usize> ElicitPromptTree for StringNonEmpty<MAX_LEN>

fn prompt_tree() -> PromptTree

Return the static prompt tree for this type.

fn assembled_prompts() -> Vec<AssembledPrompt>

Return the complete assembled prompts in elicitation order.

impl ElicitSpec for StringNonEmpty

fn type_spec() -> TypeSpec

Returns the complete spec for this type.

impl<const MAX_LEN: usize> Elicitation for StringNonEmpty<MAX_LEN>

type Style = StringNonEmptyStyle

The style enum for this type.

async fn elicit<C: ElicitCommunicator>(communicator: &C) -> ElicitResult<Self>

Elicit a value of this type from the user via style-aware client.

fn kani_proof() -> TokenStream

Generate a Kani symbolic execution proof harness for this type.

fn verus_proof() -> TokenStream

Returns a proc_macro2::TokenStream containing a Verus-verified function with requires/ensures specifications for this type’s invariants.

fn creusot_proof() -> TokenStream

Returns a proc_macro2::TokenStream containing Creusot contract functions with #[requires]/#[ensures]/#[trusted] attributes for this type’s invariants.

fn elicit_checked( peer: Peer<RoleServer>, ) -> impl Future<Output = ElicitResult<Self>> + Send

Server-side elicitation via MCP peer.

fn with_style(style: Self::Style) -> ElicitBuilder<Self>

Create a builder for one-off style override.

fn elicit_proven<C: ElicitCommunicator>( communicator: &C, ) -> impl Future<Output = ElicitResult<(Self, Established<Is<Self>>)>> + Send

Elicit a value with proof it inhabits type Self.

fn prusti_proof() -> TokenStream

Returns a proc_macro2::TokenStream containing Prusti contract functions with #[requires]/#[ensures] attributes for this type’s invariants.

impl<const MAX_LEN: usize> Hash for StringNonEmpty<MAX_LEN>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<const MAX_LEN: usize> JsonSchema for StringNonEmpty<MAX_LEN>

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn json_schema(_gen: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

impl<const MAX_LEN: usize> PartialEq for StringNonEmpty<MAX_LEN>

fn eq(&self, other: &StringNonEmpty<MAX_LEN>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<const MAX_LEN: usize> Prompt for StringNonEmpty<MAX_LEN>

fn prompt() -> Option<&'static str>

Optional prompt to guide user interaction.

impl<const MAX_LEN: usize> Serialize for StringNonEmpty<MAX_LEN>

fn serialize<S: Serializer>(&self, s: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl<const MAX_LEN: usize> ToCodeLiteral for StringNonEmpty<MAX_LEN>

fn to_code_literal(&self) -> TokenStream

Return a TokenStream containing a single Rust expression whose evaluation produces a value equal to self.

fn type_tokens() -> TokenStream

where Self: Sized,

Token stream for the concrete type name (used to annotate None::<T>).

impl<const MAX_LEN: usize> Eq for StringNonEmpty<MAX_LEN>

impl<const MAX_LEN: usize> StructuralPartialEq for StringNonEmpty<MAX_LEN>