Description:
greeneggs 0.3.0
Green Eggs
About
This is a library/framework that you can use to easily create a channel chatbot with Python code.
It is intended to be very quick and simple to set up and use, and either be stopped and started whenever, or stay
running indefinitely.
Usage
See example.py for an example bot setup. That's all
there is for now, more in-depth documentation is coming soon.
bot.register_basic_commands is a function that takes a mapping of first word invoke to response strings.
bot.register_command is a decorator that takes a first word invoke and decorates a function that's called when the
command is run.
Notice in the example that this can be a sync or async function.
The parameters must be accessible by keyword, and the value depends on the name of the keyword.
Features
A robust IRC client that ensures that expected responses to actions have happened, such as joining and leaving a
channel, and reconnects or fails as necessary.
Cool-downs on commands, per user and global.
A Helix API accessor with functions for each documented endpoint, fully typed for URL parameter and payload body
values.
An expandable way of specifying how messages trigger command, beyond just the first word being !command.
A complete suite of dataclasses to represent all possible data that comes through the IRC chat. This allows for robust
typings.
Link detection and purging, complete with configurable allow conditions of link target and user status
Link target allowing works on domain and/or path string or regex matching
Currently, user conditions are only subscriber or VIP or either
Features soon coming
A suite of SQLAlchemy models to save incoming data from IRC, with columns to match the dataclasses.
Eventual future features
A way to write the bot with a config file and/or a python file.
API result caching to prevent rate limiting.
A suite of CLI options to quickly make API calls and database queries.
Webhooks for handling events that don't come through in chat, and better handling of events that do.
License
For personal and professional use. You cannot resell or redistribute these repositories in their original state.
Customer Reviews
There are no reviews.
