k.eaven
6f9202efd4
- Fixed content_contains validation logic in scenario_runner - Fixed component_type validation for action rows - Fixed ScenarioBot model with command, env, cwd fields - Fixed _start_bot method to use attribute access on Pydantic models - Added command field to ScenarioBot model with proper defaults - All 19 tests passing - End-to-end scenario test passing (4/4 steps)
APIcord
Discord API Emulator for bot testing.
A standalone Python CLI program that emulates the Discord API (REST + WebSocket Gateway), enabling self-contained testing of Discord bots without requiring a real Discord connection.
Features
- REST API Server - Implements Discord REST API endpoints needed for bot operations
- WebSocket Gateway - Emulates Discord's Gateway for real-time events (READY, INTERACTION_CREATE, etc.)
- State Management - In-memory state with guilds, channels, users, messages, and interactions
- Test Scenarios - YAML-based test scenarios for automated bot testing
- CLI Interface - Easy-to-use commands for starting, testing, and managing the emulator
Installation
pip install -e .
# Or for development
pip install -e ".[dev]"
Quick Start
# Start emulator with a test scenario
apicord start --scenario scenarios/basic_test.yaml
# Run automated test against a bot
apicord test --scenario scenarios/full_test.yaml --bot-path /path/to/bot
# Start with custom configuration
apicord start --port 8080 --guilds 2 --channels 5
Project Structure
apicord/
├── src/apicord/
│ ├── main.py # CLI entry point
│ ├── config.py # Configuration management
│ ├── rest/ # REST API server (aiohttp)
│ ├── gateways/ # WebSocket gateway (websockets)
│ ├── state/ # State management
│ ├── models/ # Pydantic models for Discord objects
│ └── cli/ # CLI commands
├── tests/ # Unit tests
├── scenarios/ # YAML test scenarios
└── pyproject.toml
License
GPL-3.0 - See LICENSE file for details.