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

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/

Replace existing tattoos with --overwrite

Update existing tattoos in files that were already tattooed. Without this flag, already-tattooed files will be skipped.

python3 tatuagem.py "New Tattoo" --recurse-path test_tattoo/ --overwrite

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

✓ .tatignore support - Exclude specific files and directories from tattooing

.tatignore

Similar to .gitignore, you can create a .tatignore file in the root of the directory you want to tattoo to specify patterns of files and directories to exclude from tattooing.

.tatignore Syntax

The .tatignore file supports the following patterns:

• Simple filenames: file.txt - ignores any file named file.txt
• Wildcards: *.log - ignores all files ending with .log
• Directory patterns: node_modules/ - ignores all files in node_modules directory
• Recursive patterns: build/** - ignores all files in build and its subdirectories
• Comments: Lines starting with # are treated as comments
• Empty lines: Empty lines are ignored

.tatignore Example

# Ignore log files
*.log

# Ignore build artifacts
build/
dist/

# Ignore dependencies
node_modules/

# Ignore specific files
secrets.py
config.local.json

# Ignore test directories
tests/**

Usage with .tatignore

1. Create a .tatignore file in the directory you want to tattoo (or copy .tatignore.example from this repository)
2. Add patterns for files/directories to exclude
3. Run tatuagem with --recurse-path as usual

# This will respect patterns in .tatignore
python3 tatuagem.py "MyProject" --recurse-path ./my-project/