tatuagem 0.1.0

A tool to generate ASCII art signatures (tattoos) and apply them to your code files recursively.

Tatuagem, the boastful code signature suite

Tatuagem is a tool to generate ASCII art signatures (tattoos) and apply them to your code files recursively.

Usage

python3 tatuagem.py [text_input] [options]

Arguments

Argument	Description	Default
text_input	The string you want to convert into a tattoo. Required if --file is not provided.	None
--text	The character used to draw the text pixels.	1
--backsplash	The character used to fill the background.	0$*~
--font	The TrueType font file (.ttf) to use for generating the text shape.	unicode-arial.ttf
--pattern	A repeating string pattern to use for the background. Overrides --backsplash.	None
--margin	Number of empty lines (margin) to add above and below the text.	3
--recurse-path	Path to a directory. Tatuagem will walk through this directory and prepend the tattoo to every file found.	None
--file, -f	Path to a file containing text. • Standard Mode: The content of the file is converted into the tattoo art. • Recurse Mode (with --recurse-path): The content of the file is used as-is for the tattoo (useful for pre-generated art).	None

Examples

Basic Example

Generate a simple tattoo.

python3 tatuagem.py "tatuagem"

Defaults: '1' for text, '0' for background, unicode-arial.ttf for font

Elaborate Syntax Example

Customizing the text and background characters.

python3 tatuagem.py "L'appel du vide" --font 'unicode-arial.ttf' --backsplash '!' --text '@'

Wallpaper: Pattern-Argument Syntax Example

Using a pattern string for the background.

python3 tatuagem.py "Tatuagem" --pattern '`':,:''

Recurse your project

Apply the generated tattoo to all files in test_tattoo/.

python tatuagem.py "Tatuagem" --pattern '`':,:''  --recurse-path test_tattoo/

Recurse your project with a text file

Apply the contents of tests/aeaea.inc as a header to all files in test_tattoo/.

python3 tatuagem.py --file tests/aeaea.inc --recurse-path test_tattoo/

Features

✓ Shebang detection and preservation - files with #!/... shebangs keep them at the top ✓ Safe for npm projects - tattooed npm projects continue to work after tattooing ✓ Idempotent - Tattoos won't repeat on themselves if run multiple times