⁉️ Why?

In the new context of the pandemic, many educational institutions have shifted their courses online, with the use of communication platforms like Discord. However, managing multiple roles and channels across a Discord server is challenging : there are no way to centrally visualize the information nor to apply synchronized permissions updates. This tool allows you to define a single configuration file to be applied to a server, and it will automatically find the changes that needs to be made, ensuring that your Discord will always be in synch with your config.

⭐ Features

• 📜 Diff current Discord server config with your desired one
• 🏗️ Apply large scale changes to your Discord server
• ⚡ Fast, secure and reliable

Modules

• disma : Core Rust library for defining configuration as code and controlling your own orchestrations and implementations.
• disma-cli : A stable and easy to use command line interface for defining configuration as simple YAML files. Still allows for templating to simplify the configuration.

V1 Roadmap

Features

• [x] Roles: add, update or remove roles
• [x] Categories: add, update or remove categories
• [x] Channels: add, update or remove channels
• [x] Allow additional roles, categories or members
• [ ] Members: invite or kick members (#25)
• [ ] Other small but important features (see the Stable features milestone)

Technical

• [ ] Bulletproof test all important concepts :
  • [ ] Diffs (comparisons)
  • [ ] Diff commands
  • [ ] Commands to requests convertion
  • [ ] Responses to existing guild convertion
  • [x] Config to awaiting guild convertion
  • [x] Existing guild to config convertion
• [ ] Exception handling strategies for :
  • [ ] Discord API
  • [ ] Server errors (Discord's end)
  • [ ] Permission errors (user's bot configuration) - see bug #26
  • [ ] Config validation
  • [ ] Runtime errors (ex: changes in existing state)
  • [ ] Fatal
  • [ ] Non-fatal

Documentation

• [ ] Library
  • [ ] Rust doc (with doc-tests if needed)
• [ ] Cli
  • [ ] Examples
  • [ ] Guide
  • [ ] JSON and YAML schemas for config