How hllstr/sora-rs works
Sora-on-rust is a WhatsApp bot: it loads configuration and runtime state, connects through the WhatsApp client, processes inbound events, and dispatches commands or message behavior. Its command families cover general information, media downloads, group administration, owner controls, and utility tools; macros support sending text and media. The README confirms the bot’s identity and setup but gives few behavioral details. Some command-family links are shown as unverified because the sampled excerpts do not show how distributed command registration connects those modules to dispatch.
Main entry points: cmd.rs Command dispatch · handler.rs Event handler · state.rs Runtime state · logger.rs Logging
Components 19
Runtime
- Startup
src/main.rs - Configuration
src/config.rs - Runtime state
src/state.rs - WhatsApp client
src/client.rs - Event handler
src/handler.rs - Logging
src/logger.rs
Commands
- Command dispatch
src/commands/cmd.rs - General commands
src/commands/general - Media playback
src/commands/downloader/play.rs - Reel downloads
src/commands/downloader/reels.rs - Group administration
src/commands/group - Owner controls
src/commands/root - Bot tools
src/commands/tools
Messaging
- Message utilities
src/utils.rs - Text sending
src/macros/send_msg.rs - Audio sending
src/macros/send_audio.rs - Video sending
src/macros/send_video.rs
Other components
- Bot operator
- WhatsApp service
Connections 31
- Bot operator → Startup: starts bot
README.md - Startup → Configuration: loads settings
src/main.rs - Startup → Runtime state: loads state
src/main.rs - Startup → WhatsApp client: creates client
src/main.rs - WhatsApp client → Configuration: uses settings
src/client.rs - WhatsApp client → Runtime state: captures state
src/client.rs - WhatsApp client → Event handler: registers events
src/client.rs - WhatsApp service → Event handler: sends events
- Event handler → Command dispatch: dispatches commands
src/handler.rs - Event handler → Runtime state: reads and updates
src/handler.rs - Event handler → Configuration: checks settings
src/handler.rs - Event handler → Message utilities: uses message helpers
src/handler.rs - Event handler → Logging: logs errors
src/handler.rs - Command dispatch → Runtime state: shares state
src/commands/cmd.rs - Command dispatch → General commands: routes registered commands
src/commands/general/info.rs - Command dispatch → Media playback: routes registered commands
src/commands/downloader/play.rs - Command dispatch → Reel downloads: routes registered commands
- Command dispatch → Group administration: routes registered commands
- Command dispatch → Owner controls: routes registered commands
src/commands/root/spamedit.rs - Command dispatch → Bot tools: routes registered commands
src/commands/tools/translate.rs - Media playback → Logging: logs activity
src/commands/downloader/play.rs - Reel downloads → Logging: logs activity
src/commands/downloader/reels.rs - Owner controls → Runtime state: updates settings
src/commands/root/set.rs - Owner controls → Configuration: uses configuration
src/commands/root/set.rs - Owner controls → Logging: logs changes
src/commands/root/set.rs - Bot tools → Message utilities: uses helpers
src/commands/tools/translate.rs - Bot tools → Logging: logs activity
src/commands/tools/translate.rs - Audio sending → Message utilities: loads media bytes
src/macros/send_audio.rs - Audio sending → Runtime state: reads expiry
src/macros/send_audio.rs - Video sending → Message utilities: loads media and thumbnail
src/macros/send_video.rs - Video sending → Runtime state: reads expiry
src/macros/send_video.rs