ASCII Art Converter — nWave Tutorial

Starter project for the Your First Delivery tutorial.

3 failing acceptance tests. Empty implementation. Your job: run /nw:deliver and watch nWave build it.

Quick Start

python3 -m venv .venv && source .venv/bin/activate
pip install pytest
pytest tests/ -v          # 3 failing tests — expected

Open Claude Code and deliver:

claude

/nw:deliver "Image-to-ASCII art converter using PPM format"

~8 minutes later: all tests green, code reviewed, mutation tested.

What's Inside

src/ascii_art/__init__.py    # Empty — nWave implements this
tests/test_ascii_art.py      # 3 acceptance tests defining the feature
tests/fixtures/diagonal.ppm  # 4x4 test image (white diagonal on black)

The Tests

1. Correct width — output lines match requested character width
2. Valid characters — only density ramp chars " .:-=+*#%@"
3. Brightness mapping — white pixels → dense chars, dark → sparse

Requirements

• Python 3.10+
• Claude Code with nWave installed

License

MIT