V2.8.0

Welcome to the last feature release of TwitchIO V2!

This will be the last release with new features for the current development cycle of TwitchIO. Beyond this release, we will continue to make releases for bugfixes and new twitch changes to existing features (or notable/important features). However, we will no longer be developing new library features for V2 as we go full tilt into development on V3.

Additions in version 2.8:

• Added new follower/followed endpoints on PartialUser. You will need to migrate to these as Twitch is removing the old follow endpoints.
• Added is_featured parameter for PartialUser.fetch_clips, and attribute for Clip model
• Added support for the following typing constructs in ext.commands command signatures:
  • Union[A, B] / A | B
  • Optiona[T] / T | None
  • Annotated[T, converter]
• Added a walkthrough of command creation in the docs.

P.S. We fixed the ReadTheDocs config file, so you'll actually get doc builds this time.

V2.7.0

Version 2.7

version 2.7 brings some long awaited features, such as websocket support for eventsub, and content classification labels.
We've also squashed some more bugs, and added other new twitch features.
Here's a short list of major changes:

• Added PartialUser.fetch_charity_campaigns and charity donate events to eventsub.
• Added new parameters to PartialUser.modify_stream for is_branded_content and content_classification_labels.
• Fixed CustomReward.edit to be able to enable the reward.
• Added two new events: event_notice and event_raw_notice for notice events from IRC.
• Added Message.hype_chat_data for messages that contain hype chat information.
• Fixed a reconnect loop when the IRC server sent a RECONNECT message.
• Bumped [speed] and [sound] deps to latest versions.
• Updated the HTTPException message to provide useful information instead of generic errors

And more! See the full changelog: https://twitchio.dev/en/latest/changelog.html

V2.6.0

This release has various additions and bug fixes for the core lib and the eventsub + pubsub exts.

These release notes are simply a brief. To view the full changelog, visit https://twitchio.dev/en/latest/changelog.html

General additions:

• Added shield mode support to PartialUser and eventsub
• Added followed streams support to PartialUser
• Added shoutout support to PartialUser and eventsub
• Added type arg to Client.fetch_streams
• Added support for ciso8601 when installed
• Added speed flag to install available c-based speedups: pip install twitchio[speed]
• Added support for follows V2 in eventsub. This is the main way to subscribe to follow events now.
• Added auth_fail_hook and reconnect_hook to PubSubPool

Bug fixes:

• PartialUser.fetch_bits_leaderboard not handling started_at arg properly.
• Fix auto-reconnect logic of IRC websocket
• implicitly remove newlines in chat messages
• fixed RECONNECT event in pubsub websocket

Deprecations:

• EventSubClient.subscribe_channel_follows. Use EventSubClient.subscribe_channel_follows_v2

V2.5.0

This release makes changes to the entirety of the library. For change notes, please see the 2.5.0 section of the changelog

2.4.0

TwitchIO 2.4 brings a huge set of changes! We've implemented new endpoints, squashed tons of bugs, and fixed up the eventsub ext.

Here's some bug fixes:

• Added self.registered_callbacks = {} to Client.from_client_credentials
• Allow empty or missing initial_channels to trigger Client.event_ready
• Corrected CustomRewardRedemption.fulfill endpoint typo and creation
• Corrected CustomRewardRedemption.refund endpoint typo and creation
• Changed Client.join_channels logic to handle bigger channel lists better
• Corrected Predictor slots and user keys, repr has also been added
• Updated IRC parser to not strip colons from beginning of messages
• Updated IRC parser to not remove multiple spaces when clumped together
• Fixed Client.start exiting immediately (YES, this means Client.start works properly now!)
• Chatters will now update correctly when someone leaves chat
• Fixed a crash when twitch sends a RECONNECT notice

We've added all the moderation endpoints, the new send_whisper endpoint (although this isn't very reliable, just like normal whispers).
Added Client.fetch_channels to allow fetching of more than one channel with a single API call.

Eventsub ext:

• Added "Gift Subscriptions" subscriptions for gifting other users Subs
• Added Re-subscription Message subscriptions for Resub messages
• Added EventSubClient.delete_all_active_subscriptions for convenience
• Created an Eventsub-specific CustomReward model

And more!

As always, check out the full changelist at https://twitchio.dev/en/latest/changelog.html

2.3.0

We've revamped our documentation, check out https://twitchio.dev/en/latest/changelog.html for the full changelog.

A few key highlights of this release:

• Added retain_cache kwarg to Client and Bot. Default is True.
• Added support for poll endpoints
• fixed some bugs related to initial_channels
• fixed the issues with ext.commands cooldown buckets always using the global bucket
• fixed an issue with ext.commands.Bot.reload_module failing to reinstate the old module if an error occurred while reloading

2.2.0

Version 2.2.0

2.2.0 brings some exciting new features to TwitchIO, along with our usual span of bugfixes. The full changelog can be found at https://twitchio.dev, but here's some highlights:

• more eventsub models! channel polls and predictions have both been implemented
• more pubsub models! channel subscriptions are now covered by pubsub
• Fixed pagination logic! This means that requests that ask for more than the default limit will now actually receive those extra responses
• aiohttp requirements have been relaxed to include 3.8.1
• And more! see the changelog for all the changes

2.1.5

Add user_id property to Client
Change id_cache to only cache if a value is not None.
Add Client.wait_for_ready

v2.1.4

2.1.4

• TwitchIO

  • Chatter.is_mod now uses name instead of display_name
  • Added ChannelInfo to slots
  • Remove loop= parameter for asyncio.Event in websocket for 3.10 compatibility

• ext.eventsub

  • ChannelCheerData now returns user if is_anonymous is False else None

v2.1.3

2.1.3

• Twitchio

  • Fix bug where chatter never checked for founder in is_subscriber
  • Fix rewards model so it can now handle pubsub and helix callbacks

• ext.commands

  • Fix TypeError in Bot.from_client_credentials

• GitHub Workflows

  • Added automatic version handling via release tag.
  • Added TwitchIO Manager bot