Unicode-aware string utilities for Gleam
Production-ready Gleam library for Unicode-aware string operations. All operations work at grapheme cluster boundaries, correct behaviour for emoji, ZWJ sequences, combining marks, and flags.
| Category | Highlights |
|---|---|
| Grapheme-Aware | take, drop, length, reverse, chunk — all grapheme-correct |
| Case Conversions | snake_case, camelCase, kebab-case, PascalCase, Title Case |
| Slug Generation | slugify with token limits, custom separators, Unicode preservation |
| Search & Replace | index_of, last_index_of, replace_first/last, contains_any/all |
| Validation | is_uppercase/lowercase/title_case, is_ascii/hex/numeric/alpha |
| Escaping | escape_html, unescape_html, escape_regex |
| Similarity | Levenshtein distance, normalized similarity, hamming_distance |
| Splitting | splitn, partition, rpartition, chunk, lines, words |
| Padding | pad_left, pad_right, center, fill |
| Minimal deps | No OTP requirement — works on Erlang and JavaScript targets |
gleam add strimportstr// Grapheme-safe truncation preserves emoji sequencesstr.truncate("Hello 👩👩👧👦 World",10,"...")// → "Hello 👩👩👧👦..."// ASCII transliteration and URL-friendly slugsstr.slugify("Crème Brûlée — Recipe 2025!")// → "creme-brulee-recipe-2025"// Case conversionsstr.to_camel_case("hello world")// → "helloWorld"str.to_snake_case("Hello World")// → "hello_world"// Grapheme-aware search — counts clusters, not bytesstr.index_of("👨👩👧👦 family test","family")// → Ok(2)// Normalized Levenshtein similaritystr.similarity("hello","hallo")// → 0.8| Document | Description |
|---|---|
| API Reference | Complete function reference with examples |
| Examples | Integration snippets and patterns |
| OTP Integration | NFC/NFD normalization via Erlang | | Core internals | Grapheme-aware core operations | | Extra internals | ASCII folding and slug generation | | Tokenizer | Pure-Gleam grapheme tokenizer reference |
| Module | Use when | Import |
|---|---|---|
str | Everything — recommended entry point | import str |
str/advanced | Explicit KMP algorithm control, map caching | import str/advanced |
str/config | Tune search heuristic thresholds | import str/config |
str/
├── str.gleam # Main module — complete public API
├── advanced.gleam # Low-level search algorithms
├── config.gleam # Search heuristic configuration
└── internal/ # Implementation details (not part of public API)
gleam test# run test suite (Erlang target)
gleam test --target javascript # run on JavaScript target
python3 scripts/generate_character_tables.py # regenerate transliteration tablesContributions welcome. See CONTRIBUTING.md.
Run gleam test before submitting PRs.
MIT — see LICENSE.