Dress up
Convert your strings to various Unicode characters. Turn "words" into "𝔴𝔬𝔯𝔡𝔰", "🆆🅾🆁🅳🆂", and "𝔀𝓸𝓻𝓭𝓼".
Documentation: https://dressup.readthedocs.io/
Contents
Installation
To install Dress up, run this command in your terminal
❯ python -m pip install dressupIf you're using it primarily as a command-line tool, it's recommended you install it via pipx
❯ pipx install dressupUsage
There are two primary ways to use Dress up—as a command-line tool, or as Python library.
Command-line usage
Display all possible transformations by running:
❯ dressup Hello
Circle
Ⓗⓔⓛⓛⓞ
Negative circle
🅗🅔🅛🅛🅞
Monospace
Ｈｅｌｌｏ
Math bold
𝐇𝐞𝐥𝐥𝐨
...Return only a specific transformation by using the --type flag.
❯ dressup Vibes --type inverted
𐌡ıqǝsAutocompletion
Dress up supports argument completions along with live previews. To enable autocompletion run.
❯ dressup --install-completion zsh
zsh completion installed in /Users/username/.zshrc.Completion will take effect once you restart the terminal.
zsh may be replaced with bash, fish, powershell, or pwsh. Along with typical
autocompletion, when typing in a value for --type if [TAB] is pressed the matching
parameter values will be displayed below along with a preview of the conversion.
❯ dressup Words --type math [TAB]
math-bold -- 𝐖𝐨𝐫𝐝𝐬
math-bold-fraktur -- 𝖂𝖔𝖗𝖉𝖘
math-bold-italic -- 𝑾𝒐𝒓𝒅𝒔
math-bold-script -- 𝓦𝓸𝓻𝓭𝓼
math-double-struck -- 𝕎𝕠𝕣𝕕𝕤
math-fraktur -- 𝔚𝔬𝔯𝔡𝔰
math-monospace -- 𝚆𝚘𝚛𝚍𝚜
math-sans -- 𝖶𝗈𝗋𝖽𝗌
math-sans-bold -- 𝗪𝗼𝗿𝗱𝘀
math-sans-bold-italic -- 𝙒𝙤𝙧𝙙𝙨
math-sans-italic -- 𝘞𝘰𝘳𝘥𝘴Library usage
To convert characters, use convert.
import dressup
dressup.convert("Hello", unicode_type="negative circle")'🅗🅔🅛🅛🅞'To return all possible conversions, use show_all.
import dressup
dressup.show_all("Hello"){'Circle': 'Ⓗⓔⓛⓛⓞ', 'Negative circle': '🅗🅔🅛🅛🅞',
'Monospace': 'Ｈｅｌｌｏ', 'Math bold': '𝐇𝐞𝐥𝐥𝐨',
'Math bold fraktur': '𝕳𝖊𝖑𝖑𝖔', 'Math bold italic': '𝑯𝒆𝒍𝒍𝒐',
'Math bold script': '𝓗𝓮𝓵𝓵𝓸', 'Math double struck': 'ℍ𝕖𝕝𝕝𝕠',
'Math monospace': '𝙷𝚎𝚕𝚕𝚘', 'Math sans': '𝖧𝖾𝗅𝗅𝗈', 'Math sans bold':
'𝗛𝗲𝗹𝗹𝗼', 'Math sans bold italic': '𝙃𝙚𝙡𝙡𝙤', 'Math sans italic':
'𝘏𝘦𝘭𝘭𝘰', 'Parenthesized': '⒣⒠⒧⒧⒪', 'Square': '🄷🄴🄻🄻🄾',
'Negative square': '🅷🅴🅻🅻🅾', 'Cute': 'Héĺĺő', 'Math fraktur':
'ℌ𝔢𝔩𝔩𝔬', 'Rock dots': 'Ḧëḷḷö', 'Small caps': 'ʜᴇʟʟᴏ', 'Stroked':
'Ħɇłłø', 'Subscript': 'ₕₑₗₗₒ', 'Superscript': 'ᴴᵉˡˡᵒ',
'Inverted': 'ɥǝןןo', 'Reversed': 'Hɘ⅃⅃o'}Contributing
All character mappings are stored in translator.toml. Want to add a new mapping or tweak an existing one? Simply edit translator.toml and create a pull request.
Check out CONTRIBUTING.md for general contribution guidelines.