V3.0.0b4

Version: 3.0.0b4

Warning

This is a BETA release.

Added:

• commands.reward_command
• commands.RewardCommand
• commands.RewardStatus
• ContextType
• Context.type
• Context.payload
• Context.redemption
• Mixin.unique_commands
• Command.qualified_name
• Command.full_parent_name
• Command.relative_name
• SSL to AiohttpAdapter
• PartialUser.update_custom_reward()
• PartialUser.delete_custom_reward()
• Default colour classmethods to Colour/Color
• Client.websocket_subscriptions()
• Client.delete_websocket_subscription()
• Command callbacks can return a value which can be caught along the invocation chain.
• ChannelBitsUseSubscription
• event_bits_use()
• ChannelBitsUse model.
• event_token_refreshed and TokenRefreshedPayload
• AutoRedeemReward
• UnlockedEmote
• Client.fetch_channel
• Added version 2 data to AutoRedeemReward.

Fixed:

• event_raid documentation.
• Incorrect warning in after_routine check.
• Removed redundant arguments in subscribe_webhook
• Optimizations to websocket revocations/reconnections.
• Fixed a check for invalid tokens in HTTP.
• Proactively refresh tokens before they expire
• Remove invalid token check in websocket.
• Fixed exporting types (Improves intellisense)
• Various fixes to Ad models; due to Twitch documentation error.
• Cleanup some logging messages.

Changed:

• PartialUser/Chatter.send_message the send parameter can be positional.

Notes:
This is technically a breaking change but I suspect the reach will be minimal, it will affect users who override Bot.get_context or Bot.process_commands and for those who subclass Context and use them along with keyword-arguments:

Bot.get_context > Positional message parameter was renamed to payload
Bot.process_commands > Positional message parameter was renamed to payload
Context > Positional message parameter was renamed to payload

The other potential breaking change is Context.message can now return None. However; it won't return None in non-message based Contexts anyways so it shouldn't affect anyone.

Documentation:
https://twitchio.dev/en/latest/

Discord:
https://discord.gg/RAKc3HF

Installing:
https://twitchio.dev/en/latest/getting-started/installing.html

Quickstart:
https://twitchio.dev/en/latest/getting-started/quickstart.html

Migrating:
https://twitchio.dev/en/latest/getting-started/migrating.html

Thanks for all the continued testing!

Contributions

• Fix incorrect after_routine warning by @bartmoorman in #484
• Add SSLContext arg to aiohttp adapter by @cwtravis in #483
• Refresh tokens before they expire by @bartmoorman in #486
• Refresh token if it will likely expire before the next validation by @bartmoorman in #487
• Add missing default_auth by @bartmoorman in #489

New Contributors

• @cwtravis made their first contribution in #483

Full Changelog: v3.0.0b3...v3.0.0b4

V3.0.0b3

Warning

This is a BETA release.

The second BETA release of TwitchIO version 3.

Added:

• Bot.get_command
• Bot.commands
• Group.get_command
• Group.commands
• Bot.get_context
• FetchTokenPayload
• UserTokenPayload
• web.AiohttpAdapter.oauth_callback()
• web.StarletteAdapter.oauth_callback()
• web.AiohttpAdapter.fetch_token()
• web.StarletteAdapter.fetch_token()
• web.BaseAdapter

Fixed:

• Added a missing py.typed to ext.commands
• Removed unneeded token_for parameter from multiple models and methods.
• Add the missing paused parameter to CustomReward.update() #482 @bartmoorman
• Multiple documentation fixes

Documentation:
https://twitchio.dev/en/latest/

Discord:
https://discord.gg/RAKc3HF

Installing:
https://twitchio.dev/en/latest/getting-started/installing.html

Quickstart:
https://twitchio.dev/en/latest/getting-started/quickstart.html

Migrating:
https://twitchio.dev/en/latest/getting-started/migrating.html

Thanks for all the continued testing!

V3.0.0b2

Warning

This is a BETA release.

The first BETA release of TwitchIO version 3.

The changelog is too large to include here, please see the migrating guide:
https://twitchio.dev/en/latest/getting-started/migrating.html

Note

The migrating guide is a current work in progress.

Documentation:
https://twitchio.dev/en/latest/

Discord:
https://discord.gg/RAKc3HF

Installing:
https://twitchio.dev/en/latest/getting-started/installing.html

Quickstart:
https://twitchio.dev/en/latest/getting-started/quickstart.html

Special thanks to everyone throughout the Alpha testing stages <3

V2.10.0

This release contains some bug fixes and Eventsub additions. TinyTag has been added as a sound ext dependancy to properly determine channel/sample rate data from sound files.

View the changelog here.

V2.9.1

Small bug fix to actually fix the eventsub bad frame reconnect

V2.9.0

V2.9:

• Fixed a crash in ext.eventsub with a bad assertion
• Fixed a crash in ext.eventsub when a known bad frame is received
• Fixed event_token_expired refreshed tokens not applying to request that called the hook
• Added PartialUser.fetch_moderated_channels
• Added PartialUser.fetch_ad_schedule
• Added PartialUser.snooze_ad
• Added PartialUser.fetch_user_emotes

V2.8.2

This is a bugfix release for ext.commands raising an internal error when using internal converters.

V2.8.1

This is a bugfix for a proccessing issue in get_context when no command exists.

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