# substitute-letters A Perl module and CLI utility that replaces Latin letters with lookalike characters from other Unicode ranges — mathematical alphanumeric symbols (monospace, script, fraktur, doublestruck, sans-serif and their variants), enclosed forms (circled, parenthesized, squared and negated variants), fullwidth, and more. For example, `ABC` → `𝙰𝙱𝙲` (monospace) or `𝒜ℬ𝒞` (script). Spaces and already non-ASCII text are left unchanged — except that the `bold`, `circled`, `doublestruck`, `fullwidth`, `monospace`, `parenthesized`, `sans_serif` and `sans_serif_bold` styles also substitute digits `0-9` (`parenthesized` has no glyph for `0`), and the `fullwidth` style maps all printable ASCII punctuation (including `_`) to its fullwidth form. The `squared`, `negative_circled` and `negative_squared` styles only cover uppercase letters. Russian documentation: [russian.md](russian.md) Repository: — bug reports and other issues are welcome at ## Features - `Text::UnicodeStyle` — API: `stylize($string, $style)` and `styles()` - `bin/substitute-letters` — CLI wrapper built on `Getopt::Long` - 19 styles: `bold`, `bold_fraktur`, `bold_italic`, `bold_script`, `circled`, `doublestruck`, `fraktur`, `fullwidth`, `italic`, `monospace`, `negative_circled`, `negative_squared`, `parenthesized`, `sans_serif`, `sans_serif_bold`, `sans_serif_bold_italic`, `sans_serif_italic`, `script`, `squared` ## CLI usage ```sh # text as arguments (joined with spaces) bin/substitute-letters --style script 'Hello, World!' bin/substitute-letters -s fraktur route_id # or via stdin echo mkdir folder_name | bin/substitute-letters -s monospace # list available styles bin/substitute-letters --list # help bin/substitute-letters --help ``` Options: `-s/--style STYLE` (default `monospace`), `-l/--list`, `-h/-?/--help`. ## Installation From this repository (no dependencies beyond core modules): ```sh perl Makefile.PL && make && sudo make install # or simply: cpanm . ``` After installation both `Text::UnicodeStyle` and the `substitute-letters` script are available system-wide. ## Module usage ```perl use lib 'lib'; use Text::UnicodeStyle qw( stylize styles ); say stylize('something_id', 'monospace'); # 𝚜𝚘𝚖𝚎𝚝𝚑𝚒𝚗𝚐_𝚒𝚍 say join ', ', styles(); ``` `stylize` returns a new string; the input is not modified. ## Tests ```sh prove -Ilib t/ ``` `t/stylize.t` covers the API and the conversion tables, `t/cli.t` — CLI behavior (including exit codes and help output). ## Example `example.pl` — a demo script using the module. ## Layout ``` lib/Text/UnicodeStyle.pm # module API lib/Text/UnicodeStyle/*.pm # style tables (lazy load) bin/substitute-letters # CLI t/ # tests (Test::More + prove) example.pl # example ``` ## License [MIT](LICENSE) ## Author Alexander Sapozhnikov ## Support the project If you find this project useful, you can support its development via [PayPal](https://paypal.me/shoorick77).