mirror of
https://github.com/kuhyx/testsAndMisc-archive.git
synced 2026-07-04 14:23:04 +02:00
Krzysztof kuhy Rudnicki
1892fd171c
- Add test_engine.py with 100% coverage for engine.py - Tests for Engine class initialization - Tests for choose_move with various scenarios - Tests for best move parsing and validation - Tests for checkmate and stalemate detection - Add test_lichess_api.py with 98% coverage for lichess_api.py - Tests for API initialization and request handling - Tests for stream_events with proper infinite loop handling - Tests for challenge accept/decline - Tests for game streaming and move submission - Tests for rate limit handling and retry logic - Remove unreachable return statement in lichess_api.make_move Coverage: engine.py 17% -> 100%, lichess_api.py 0% -> 98% |
||
|---|---|---|
| .. | ||
| tests | ||
| tools | ||
| __init__.py | ||
| .bot_version | ||
| engine.py | ||
| lichess_api.py | ||
| main.py | ||
| README.md | ||
| requirements.txt | ||
| run_tests.sh | ||
| run.sh | ||
| utils.py | ||
Lichess Bot (minimal)
A small Lichess BOT that accepts standard challenges and plays quick random legal moves using python-chess. It demonstrates the Lichess Board API basics with a simple, readable implementation.
Features
- Connects to Lichess Board API via streaming NDJSON
- Accepts only standard chess challenges (bullet/blitz/rapid/classical)
- Spawns a thread per active game
- Plays random legal moves (swap in a stronger engine later)
- Simple logging and basic retries on transient network errors
Requirements
- Python 3.9+
- A Lichess account that is activated as a BOT
- A Lichess API access token with at least the scopes:
- bot:play
- challenge:read
- challenge:write
Install dependencies:
pip install -r PYTHON/lichess_bot/requirements.txt
Activate BOT and get a token
- Create or use an existing Lichess account for your bot.
- Activate it as a BOT (one-time): https://lichess.org/api#tag/Bot
- If not already BOT, you need to convert the account; follow Lichess docs.
- Create a personal API token: https://lichess.org/account/oauth/token/create
- Grant scopes: bot:play, challenge:read, challenge:write
Export the token in your shell (recommended):
export LICHESS_TOKEN="your_bot_token_here"
Run
From the repo root:
python -m PYTHON.lichess_bot.main
Optional flags:
--log-level INFO|DEBUG|WARNING|ERROR(default: INFO)--decline-correspondence(declines correspondence challenges)
You can also use the helper script:
bash PYTHON/lichess_bot/run.sh
Notes
- The engine is intentionally weak (random moves). Swap it with a UCI engine or implement a better search in
engine.py. - Network calls hit real Lichess endpoints. Keep the bot polite; respect rate limits.
Development
- Small unit tests are in
tests/and only cover local helpers (no network). Run:
python -m pytest PYTHON/lichess_bot/tests -q
If you add tests requiring third-party packages, install them in your environment first.