METADATA

Metadata-Version: 2.1
Name: twitchio
Version: 2.2.0
Summary: An asynchronous Python IRC and API wrapper for Twitch.
Home-page: https://github.com/TwitchIO/TwitchIO
Author: TwitchIO
License: MIT
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
License-File: LICENSE
Requires-Dist: aiohttp (<4,>=3.6.0)
Requires-Dist: iso8601
Requires-Dist: typing-extensions
Provides-Extra: sounds
Requires-Dist: yt-dlp (>=2022.2.4) ; extra == 'sounds'
Requires-Dist: pyaudio (==0.2.11) ; (platform_system != "Windows") and extra == 'sounds'

.. image:: https://raw.githubusercontent.com/TwitchIO/TwitchIO/master/logo.png
    :align: center
    
    
.. image:: https://img.shields.io/badge/Python-3.7%20%7C%203.8%20%7C%203.9-blue.svg
    :target: https://www.python.org


.. image:: https://img.shields.io/github/license/TwitchIO/TwitchIO.svg
    :target: ./LICENSE


.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/psf/black

.. image:: https://img.shields.io/pypi/dm/twitchio?color=black
    :target: https://pypi.org/project/twitchio
    :alt: PyPI - Downloads
    

TwitchIO is an asynchronous Python wrapper around the Twitch API and IRC, with a powerful command extension for creating Twitch Chat Bots. TwitchIO covers almost all of the new Twitch API and features support for commands, PubSub, Webhooks, and EventSub.

Documentation
---------------------------
For the Official Documentation: `Click Here! <https://twitchio.dev/>`_

Support
---------------------------
For support using TwitchIO, please join the official `support server
<https://discord.gg/RAKc3HF>`_ on `Discord <https://discord.com/>`_.

|Discord|

.. |Discord| image:: https://img.shields.io/discord/490948346773635102?color=%237289DA&label=Pythonista&logo=discord&logoColor=white
   :target: https://discord.gg/RAKc3HF
   
Installation
---------------------------
TwitchIO requires **Python 3.7+**. You can download the latest version of Python  `here <https://www.python.org/downloads/>`_.

**Windows**

.. code:: sh

    py -m pip install -U twitchio

**Linux**

.. code:: sh

    python -m pip install -U twitchio

Access Tokens
---------------------------
Visit `Token Generator <https://twitchtokengenerator.com/>`_ for a simple way to generate tokens for use with TwitchIO.

Getting Started
---------------------------
A simple Chat Bot.

.. code:: python

    from twitchio.ext import commands


    class Bot(commands.Bot):

        def __init__(self):
            # Initialise our Bot with our access token, prefix and a list of channels to join on boot...
            super().__init__(token='ACCESS_TOKEN', prefix='?', initial_channels=['...'])

        async def event_ready(self):
            # We are logged in and ready to chat and use commands...
            print(f'Logged in as | {self.nick}')
            print(f'User id is | {self.user_id}')

        @commands.command()
        async def hello(self, ctx: commands.Context):
            # Send a hello back!
            await ctx.send(f'Hello {ctx.author.name}!')


    bot = Bot()
    bot.run()


Contributing
---------------------------
TwitchIO currently uses the `Black <https://black.readthedocs.io/en/stable/index.html/>`_ formatter to enforce sensible style formatting.


Before creating a Pull Request it is encouraged you install and run black on your code.

The Line Length limit for TwitchIO is **120**.


For installation and usage of Black visit: `Black Formatter <https://black.readthedocs.io/en/stable/usage_and_configuration/index.html/>`_

For integrating Black into your IDE visit: `Black IDE Usage <https://black.readthedocs.io/en/stable/integrations/editors.html>`_

Special Thanks
---------------------------
Thank you to all those who contribute and help TwitchIO grow.

Special thanks to:

`SnowyLuma <https://github.com/SnowyLuma>`_

`Harmon <https://github.com/Harmon758>`_

`Tom <https://github.com/IAmTomahawkx>`_

`Tesence <https://github.com/tesence>`_

`Adure <https://github.com/Adure>`_

`Scragly <https://github.com/scragly>`_

`Chillymosh <https://github.com/chillymosh>`_

If I have forgotten anyone please let me know <3: `EvieePy <https://github.com/EvieePy>`_