tourmaline v0.20.0 Release Notes

Release Date: 2020-06-08 // 9 months ago
  • ๐Ÿš€ Ok so this release removes the filters added several releases back. I didn't like how filters forced people to think and they weren't very Crystally in function. The main issue with them was trying to allow a developer to receive information about the update being filtered. I tried to solve this using Update#context, but it was majorly limited and pretty messy.

    ๐Ÿ– So handlers are back and better than ever! I had initially gotten rid of handlers because I couldn't figure out a way to handle them that wasn't messy. In the initial revision each handler was its own class, but the annotation logic for the handler was contained in the base EventHandler class. This made it hard to figure out an easy way for people to add their own handlers without also being able to modify the method within EventHandlers::Annotator that handled the annotation logic.

    โšก๏ธ Well no more! EventHandler is now a very simple abstract class that requires one method, call(update : Update). If a subclass includes a self.annotate method that method will be called when the client is initialized. There are also several new handlers that didn't exist before, based on the filters they replaced, including CommandHandler, HearsHandler, CallbackQueryHandler, ChosenInlineResultHandler, InlineQueryHandler, and the standard UpdateHandler. I highly recommend checking out the API docs on each of them.

    โšก๏ธ This update also brings RoutedMenu for easy creation of menus using inline keyboards.

Previous changes from v0.19.1

    • Replace broken Int in unions with Int::Primitive
    • ๐Ÿ‘‰ Make Helpers.random_string actually return a random string, not just a number
    • ๐Ÿ”„ Change the first run logic in Stage