Skip to content

Commit 5e1723f

Browse files
committed
docs: update CLAUDE.md with test prerequisites and workflow
1 parent 65c4605 commit 5e1723f

File tree

1 file changed

+5
-15
lines changed

1 file changed

+5
-15
lines changed

CLAUDE.md

Lines changed: 5 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -59,15 +59,17 @@ pytest -v
5959
#### Test Prerequisites and Workflow
6060

6161
1. **Always start Balatro first**:
62+
6263
```bash
6364
# Check if game is running
6465
ps aux | grep run_lovely_macos
6566

66-
# Start if not running
67+
# Start if not running
6768
./balatro.sh > balatro_game.log 2>&1 & sleep 10 && echo "Balatro started and ready"
6869
```
6970

7071
2. **Monitor game startup**:
72+
7173
```bash
7274
# Check logs for successful mod loading
7375
tail -f balatro_game.log
@@ -79,14 +81,13 @@ pytest -v
7981
```
8082

8183
3. **Common startup issues and fixes**:
82-
- **Syntax errors in balatrobot.lua**: Check for corrupted text like `asldkfjalksdjlocal` that should be `local`
8384
- **Game crashes on mod load**: Review full log for Lua stack traces
8485
- **Steam connection warnings**: Can be ignored - game works without Steam in development
8586
- **JSON metadata errors**: Normal for development files (.vscode, .luarc.json) - can be ignored
8687

8788
4. **Test execution**:
88-
- **Test suite**: 31 tests covering API functions and UDP communication
89-
- **Execution time**: ~56 seconds (includes game state transitions)
89+
- **Test suite**: 32 tests covering API functions and UDP communication
90+
- **Execution time**: ~60 seconds (includes game state transitions)
9091
- **Coverage**: API function calls, socket communication, error handling, edge cases
9192

9293
5. **Troubleshooting test failures**:
@@ -104,17 +105,6 @@ mkdocs serve
104105
mkdocs build
105106
```
106107

107-
### Bot Development
108-
109-
```bash
110-
# Run the example bot
111-
python bots/example.py
112-
113-
# Run bot with different log levels
114-
python bots/example.py --log DEBUG
115-
python bots/example.py --log INFO
116-
```
117-
118108
## Architecture Overview
119109

120110
BalatroBot is a Python framework for developing automated bots to play the card game Balatro. The architecture consists of three main layers:

0 commit comments

Comments
 (0)