Version: 3.1.0

First feature release of version 3.x
Please see below for important links and information.

Changelog

Version 3.1.0

Links

Documentation:
https://twitchio.dev

Examples:
https://github.com/PythonistaGuild/TwitchIO/tree/main/examples

Discord:
For help and support, consider joining us on 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 from 2.x to 3.x:
https://twitchio.dev/en/latest/getting-started/migrating.html

What's Changed

• Add Generic to Context by @EvieePy in #506
• Feature/command converters by @EvieePy in #507
• Feature/payload respond by @EvieePy in #508
• Remove unnecessary token_for from ChannelPointsReward.fetch_reward by @bartmoorman in #510
• docs: fix typos in AutoBot by @returnDanilo in #512
• docs: minor Quickstart page rewording by @returnDanilo in #511
• Feature/translations by @EvieePy in #513

Full Changelog: v3.0.1...v3.1.0

Contributors

• @bartmoorman
• @EvieePy
• @returnDanilo

Version: 3.0.1

Patch to fix a missing subscription revoke reason from Twitch API.

• Fixed chat_user_banned revocation reason in EventSub.
• Changed subscriptions parameter type in AutoClient.multi_subscribe to accept a typing.Collection.

Full Changelog: v3.0.0...v3.0.1

Documentation:
https://twitchio.dev

Discord:
For help and support, consider joining us on Discord: https://discord.gg/RAKc3HF

Version: 3.0.0

First release of TwitchIO Version 3.
Please see below for important links and information.

Documentation:
https://twitchio.dev

Examples:
https://github.com/PythonistaGuild/TwitchIO/tree/main/examples

Discord:
For help and support, consider joining us on 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:

This document is still a work in progress:
https://twitchio.dev/en/latest/getting-started/migrating.html

What's Changed since BETA

• Add channel.ad_break.begin for EventSub by @Aluerie in #464
• Fix Stream.fetch_game erroring for streams without a set game by @LostLuma in #478
• Merge 3.0 into main by @EvieePy in #480
• fix 404 in readme link by @returnDanilo in #481
• Add paused to CustomReward.update() by @bartmoorman in #482
• 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
• docs: make username propriety more findable by @returnDanilo in #493
• Create issue templates for bugs and feature requests by @AbstractUmbra in #497

New Contributors

• @Aluerie made their first contribution in #464
• @returnDanilo made their first contribution in #481
• @bartmoorman made their first contribution in #482
• @cwtravis made their first contribution in #483

Full Changelog: v2.10.0...v3.0.0

Thanks to all the testers throughout both Alpha and Beta stages, without you we wouldn't have been able to make it this far <3

Developers/Maintainers:

• @EvieePy
• @chillymosh

Special thanks to:

• @IAmTomahawkx - Previous contributions and initial work and bikeshedding for version 3
• @LostLuma (https://lostluma.net) - Bikeshedding, Bug finding, feature requests, contributions
• @AbstractUmbra (https://github.com/AbstractUmbra) - Bikeshedding, contributions
• @Aluerie - Bikeshedding, Bug finding, testing, feature requests, contributions
• @bartmoorman - Bikeshedding, Bug finding, testing, feature requests, contributions
• philhoff (https://twitch.tv/philhoff) - Bikeshedding, bug finding, testing, contributions
• @returnDanilo - Bug finding, testing, feature requests, contributions
• @cwtravis - Bug finding, testing, feature requests, contributions
• @Fanyatsu (https://github.com/Fanyatsu) - Bug finding, testing, feature requests, help with Conduits
• @ezstarr (https://github.com/ezstarr | https://twitch.tv/timeenjoyed) - Bug finding, testing, feature requests
• @sockheadrps - Bikeshedding, bug finding, feature requests
• ljrex (https://twitch.tv/LJRexCodes) - Bikeshedding, Bug finding, testing, feature requests
• @Shepsalmighty (https://twitch.tv/shepsalmighty | https://github.com/shepsalmighty) - Bikeshedding, Bug finding, testing, feature requests
• @teabunniecodes (https://github.com/teabunniecodes | https://twitch.tv/ambivalentbunnie) - Bug finding, testing, documentation requests/feedback
• nyghl_ (https://twitch.tv/nyghl_) - Bug finding, testing, feature requests
• mrr3dl1ne (https://twitch.tv/mrr3dl1ne) - Bug finding, testing, feature requests
• wospins (https://twitch.tv/wospins) - Testing, feature requests
• szczot3k (Discord) - Bug finding, testing, feature requests
• @MrChuw (https://twitch.tv/mr_chuw) - Bug finding, testing, feature requests
• All the testers on discord and twitch and anyone else I forgot! <3

Contributors

• @bartmoorman
• @cwtravis
• @MrChuw
• @AbstractUmbra
• @ezstarr
• @EvieePy
• @Aluerie
• @LostLuma
• @Fanyatsu
• @sockheadrps
• @IAmTomahawkx
• @returnDanilo
• @Shepsalmighty
• @chillymosh
• @bunniebytes

Version: 3.0.0b4

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

Contributors

• @bartmoorman
• @cwtravis

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!

Contributors

• @bartmoorman

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

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

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.

Small bug fix to actually fix the eventsub bad frame reconnect

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

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