Skip to main content

A framework to build a Twitch chatbot.

Project description

Green Eggs

License Coverage Tests Version Downloads Supported Python Badges are fun

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

green-eggs-0.3.0.tar.gz (92.0 kB view hashes)

Uploaded Source

Built Distribution

green_eggs-0.3.0-py3-none-any.whl (97.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page