A Rust Discord Bot, in charge of greatly simplifying the process of finding a meeting date, organizing an event and choosing between several options.
Go to file
Dandaedre 1f0d00fa2c Adds a new entry function to parse
Adds more badges and a benchmark
2024-11-04 01:08:00 +01:00
.cargo Adds all skeleton files 2024-10-29 11:02:53 +01:00
badges Adds a new entry function to parse 2024-11-04 01:08:00 +01:00
benches Adds a new entry function to parse 2024-11-04 01:08:00 +01:00
src Adds a new entry function to parse 2024-11-04 01:08:00 +01:00
tests Adds a lib and fixes all doctests 2024-11-02 19:09:54 +01:00
.gitignore Changes the readme to be a little better looking 2024-11-03 03:11:03 +01:00
Cargo.toml Adds a new entry function to parse 2024-11-04 01:08:00 +01:00
FEATURES.md Renames the modal command to vote_modal and creates vote_command 2024-10-30 14:09:41 +01:00
LICENSE Initial commit 2024-10-28 21:29:36 +01:00
README.md Adds a new entry function to parse 2024-11-04 01:08:00 +01:00
TODO.md Adds a new entry function to parse 2024-11-04 01:08:00 +01:00

README.md

idlefox

code coverage version code coverage

IdleFox is a feature-rich Discord bot designed to streamline the process of finding meeting dates, organizing events, and making decisions among multiple options. With its user-friendly commands and robust command system, IdleFox helps facilitate effective communication within server communities.

Key Features

  • Advanced Date Handling: IdleFox offers robust date parsing and manipulation, supporting complex date formats and context-aware conversions.
  • Find Meeting Dates: Easily coordinate with your community by voting on different dates.
  • Event Organization: Start events to organize group activities, meetups, or campaigns.
  • Decision Making: Use the bot's voting functionalities to make informed decisions among multiple options.
  • Vote Management: Keep track of ongoing votes and manage their lifecycle from initiation to closure.
  • Vote Organization: Delays vote posting and allows continuous editing of answers as time progresses.
  • Web Interface: Provides real-time monitoring of all activities and enables admins to close votes through a web interface.

Bot Components

  • main.rs: Initializes logging and starts the main loop for handling Discord interactions.
  • config.rs: Manages configuration settings for the bot, ensuring data persistence and recovery.
  • date/: Provides functionalities for date parsing, conversion, and manipulation.
    • dateparse.rs: Parses input strings into date objects using nom parsers.
    • date_tools.rs: Transforms dates into more precise formats based on context.
  • io.rs: Interacts with Discord through Serenity and Poise libraries to handle commands and events.
  • votes.rs: Manages event and vote data structures, enabling voting functionality within Discord servers.
  • persistence.rs: Ensures data persistence and integrity between bot runs.
  • server.rs: Provides server-related functionalities, such as displaying votes and closing ongoing votes.
  • modules.rs: Aggregates various voting logic functions into a single module for easier management and use within the application. This includes decision-making features beyond simple vote counting.
  • error_handling.rs: Handles error reporting and logging, ensuring that any issues encountered by the bot are appropriately recorded and reported.

A great emphasis is put on organizing the votes themselves, delaying posting them and editing the answers as time goes.

This bot also spins a web interface to allow real time monitoring of all activities and (for admins) close the votes via said interface

List of commands

  • /vote_modal Pops up a modal (discord form) helping the user through creating a vote.
  • /vote_command Comprehensive text command for creating a vote.

Contributing

IdleFox welcomes contributions from the community. To contribute, fork the repository, make your changes, and submit a pull request for review.

License

This project is licensed under the MIT License. For more information, see the LICENSE file.