litext

A lightweight procedural macro library for extracting string literal contents from tokens. Built for proc-macro authors.

What is this?

Litext provides a macro to extract the inner text from a string literal token. You pass raw tokens to litext! and it gives you back the unwrapped string content without the quotes.

This is a proc-macro helper library. It is designed for proc-macro authors who need to extract string content from TokenStream input during macro expansion without the bloat.

Zero dependencies, tiny, built for proc-macro authors.

Installation

Add litext to project:

cargo add litext

Quick Start

use litext::{litext, TokenStream};

pub fn my_macro(input: TokenStream) -> TokenStream {
    let string_content: String = litext!(input);
    // ... use string_content
}

Features

Extract string content from TokenStream tokens
Support for regular strings: "hello world"
Support for raw strings: r#"hello world"#
Support for raw strings with multiple hashes: r##"hello #" world"##
Clear error messages for invalid inputs
Zero runtime dependencies

Requirements

Rust 2024 edition
A proc-macro crate (this library is for macro authors, not end users)

License

Licensed under either of:

Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.