fusion.py 2.2.7.6
An API wrapper for discord; maintained and improved from discord.py
License: MIT
Requires Python: >=3.8.0

Fusion.py
=========

`Documentation <https://fusion.senarc.org/en/latest/api.html>`_

What is Fusion.py you might ask; Fusion.py is a Discord.py fork that
has most of the good features from most of the big Discord.py forks, and
provides a library that has features that other forks has and combines
most of the big forks with some added features.

Badges
------

.. image:: https://discord.com/api/guilds/881095332434440224/embed.png
    :alt: Discord
    :target: https://discord.gg/zzdEGHbkTj
.. image:: https://img.shields.io/pypi/v/fusion.py.svg
    :alt: PyPi
    :target: https://pypi.python.org/pypi/fusion.py
.. image:: https://img.shields.io/pypi/pyversions/fusion.py.svg
    :alt: Python Version
    :target: https://pypi.python.org/pypi/fusion.py
.. image:: https://img.shields.io/github/issues/Senarc-Studios/fusion.py?style=plastic
    :alt: Issues
    :target: https://github.com/Senarc-Studios/fusion.py/issues
.. image:: https://img.shields.io/github/forks/Senarc-Studios/fusion.py?style=plastic
    :alt: Forks
    :target: https://github.com/Senarc-Studios/fusion.py/network
.. image:: https://img.shields.io/github/stars/Senarc-Studios/fusion.py?style=plastic
    :alt: Stars
    :target: https://github.com/Senarc-Studios/fusion.py/stargazers
.. image:: https://img.shields.io/github/license/Senarc-Studios/fusion.py?style=plastic
    :alt: License
    :target: https://github.com/Senarc-Studios/fusion.py/blob/master/LICENSE

Main Features
-------------

-  Modern Python API async wrapper.
-  Rate limit handling.
-  Optimised for Speed and Memory.
-  Big features combined into one from other forks.

Installation
------------

**Python 3.8 or higher is required**

 **Normal Installation:**

.. code:: sh

      # Windows
    $ py -3 -m pip install -U fusion.py
      # Linux/MacOS
    $ python3 -m pip install -U fusion.py
..

 **Installation with Full Voice Support:**

.. code:: sh

      # Windows
    $ py -3 -m pip install -U fusion.py[voice]
      # Linux/MacOS
    $ python3 -m pip install -U fusion.py[voice]
..

 **Installing Development Builds:**

.. code:: sh

    $ git clone https://github.com/Senarc-Studios/fusion.py
    $ cd fusion.py
    $ python3 -m pip install -U .[voice]
..

Additional Packages
-------------------

-  ```PyNaCl`` <https://pypi.org/project/PyNaCl>`__ - Used for voice
   support.

**Please note that on Linux installing voice you must install the
following packages via your package manager (e.g. ``apt``) before
running the commands above:**

-  libffi-dev (or ``libffi-devel`` on some systems)
-  python-dev (e.g. ``python3.6-dev`` for Python 3.6)

Examples
--------

Client:

.. code:: python

    import discord

    class MyClient(discord.Client):
        async def on_ready(self):
            print('Logged on as', self.user)

        async def on_message(self, message):
            # To make sure that the bot doesn't respond to it's own messages.
            if message.author == self.user:
                return

            if message.content == 'ping':
                await message.channel.send('pong')

    client = MyClient()
    client.run('your-token')

Bot:

.. code:: python

    import discord
    from discord.ext import commands

    bot = commands.Bot(command_prefix="!", slash_interactions=True)

    @bot.command(slash_interaction=True)
    async def ping(ctx):
        await ctx.send("pong", ephemeral=True)
        
    bot.run("your-token")

Links
-----

-  `Documentation <https://fusion.senarc.org/en/master/>`__
-  `Official Discord Server <https://discord.gg/zzdEGHbkTj>`__
-  `Discord API <https://discord.gg/discord-api>`__

Fusion Outsourced Credits
-------------------------
 Fusion.py wouldn't be made possible without these projects andcontributors.

1. `Enhanced Discord.py <https://github.com/iDevision/enhanced-discord.py>`__
2. `Pycord <https://github.com/Pycord-Development/pycord>`__