k.eaven
6fbd7fea79
- Implemented ScenarioRunner with headless scenario execution - Added YAML-based test scenario framework with validation expectations - Added CLI command 'run-scenario' with --headless, --output, --junit-xml options - Created 3 Pterodisbot test scenarios: * Basic Server Status Flow (slash_command, select_menu, button_click) * Admin Commands (refresh_embeds, purge_embeds with permissions) * Multi-Guild Isolation (independent server tracking per guild) - Fixed content_contains validation logic - Fixed component_type validation for action rows - Added command field to ScenarioBot model - Fixed content_contains validation handling - All 19 tests passing
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.