From 39a9d065f4b642f56b6899172f4001dcf5ca3ca7 Mon Sep 17 00:00:00 2001 From: Dandaedre Date: Sun, 3 Nov 2024 03:11:03 +0100 Subject: [PATCH 1/2] Changes the readme to be a little better looking --- .gitignore | 3 +++ README.md | 34 +++++++++++++++++++++++++++++++++- 2 files changed, 36 insertions(+), 1 deletion(-) diff --git a/.gitignore b/.gitignore index 66d6b5a..9dd9bc9 100644 --- a/.gitignore +++ b/.gitignore @@ -25,3 +25,6 @@ tarpaulin-report.html # The log files *.log + +# A module summary +summary.md diff --git a/README.md b/README.md index 35c9b15..5bbfa0a 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,30 @@ # idlefox ![code coverage](badge.svg) -A Rust Discord Bot, in charge of greatly simplifying the process of finding a meeting date, organising an event and choosing between several options. +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. @@ -10,3 +33,12 @@ This bot also spins a web interface to allow real time monitoring of all activit ## 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. -- 2.45.1 From 9647655f69a46b11161e617099c638b53144916d Mon Sep 17 00:00:00 2001 From: Vicky Date: Sun, 3 Nov 2024 22:52:40 +0100 Subject: [PATCH 2/2] Update README.md small tweaks and added new commands (vote_short and vote_long) --- README.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 5bbfa0a..0d457ef 100644 --- a/README.md +++ b/README.md @@ -5,12 +5,12 @@ IdleFox is a feature-rich Discord bot designed to streamline the process of find ### 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. +- **Find Meeting Dates**: Easily coordinate with your community through reaction-voting for 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. +- **Web Interface**: Provides monitoring of all activities and enables admins to close votes through a web interface. ## Bot Components @@ -25,14 +25,16 @@ IdleFox is a feature-rich Discord bot designed to streamline the process of find - `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. - + +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. +* `/vote_short` Creates an exceptional (non-weekly) vote. This is used for events outside of the normal voting window and can't go above 7 days-options. +* `/vote_long` Creates a vote for a long period of time (from 8 days to 12 months). This is used for important events that must be planned extremely long in advance. ### Contributing -- 2.45.1