.. image:: https://raw.githubusercontent.com/nextcord/nextcord/master/assets/repo-banner.svg
:alt: Nextcord
.. image:: https://img.shields.io/discord/881118111967883295?color=blue&label=discord
:target: https://discord.gg/nextcord
:alt: Discord server invite
.. image:: https://img.shields.io/pypi/v/nextcord.svg
:target: https://pypi.org/project/nextcord/
:alt: PyPI version info
.. image:: https://img.shields.io/pypi/dm/nextcord?color=informational&label=pypi%20downloads
:target: https://pypi.org/project/nextcord/
:alt: PyPI version info
.. image:: https://img.shields.io/pypi/pyversions/nextcord.svg
:target: https://pypi.org/project/nextcord/
:alt: PyPI supported Python versions
.. image:: https://img.shields.io/readthedocs/nextcord
:target: https://docs.nextcord.dev/
:alt: Nextcord documentation
Nextcord
--------
A modern, easy-to-use, feature-rich, and async-ready API wrapper for Discord written in Python.
Key Features
-------------
- Modern Pythonic API using ``async`` and ``await``
- Proper rate limit handling
- Optimised in both speed and memory
Installing
----------
**Python 3.8 or higher is required**
To install the library without full voice support, you can just run the following command:
.. code:: sh
# Linux/macOS
python3 -m pip install -U nextcord
# Windows
py -3 -m pip install -U nextcord
Otherwise to get voice support you should run the following command:
.. code:: sh
# Linux/macOS
python3 -m pip install -U "nextcord[voice]"
# Windows
py -3 -m pip install -U nextcord[voice]
To install additional packages for speedup, run the following command:
.. code:: sh
# Linux/macOS
python3 -m pip install -U "nextcord[speed]"
# Windows
py -3 -m pip install -U nextcord[speed]
To install the development version, do the following:
.. code:: sh
$ git clone https://github.com/nextcord/nextcord/
$ cd nextcord
$ python3 -m pip install -U .[voice]
Optional Packages
~~~~~~~~~~~~~~~~~~
* `PyNaCl <https://pypi.org/project/PyNaCl/>`__ (for voice support)
* `aiodns <https://pypi.org/project/aiodns/>`__, `Brotli <https://pypi.org/project/Brotli/>`__, `cchardet <https://pypi.org/project/cchardet/>`__ (for aiohttp speedup)
* `orjson <https://pypi.org/project/orjson/>`__ (for json speedup)
Please note that on Linux installing voice you must install the following packages via your favourite package manager (e.g. ``apt``, ``dnf``, etc) before running the above commands:
* libffi-dev (or ``libffi-devel`` on some systems)
* python-dev (e.g. ``python3.8-dev`` for Python 3.8)
Quick Example
~~~~~~~~~~~~~
.. code:: py
import nextcord
from nextcord.ext import commands
bot = commands.Bot()
@bot.slash_command(description="Replies with pong!")
async def ping(interaction: nextcord.Interaction):
await interaction.send("Pong!", ephemeral=True)
bot.run("token")
You can find more examples in the `examples directory <https://github.com/nextcord/nextcord/blob/master/examples/>`_.
**NOTE:** It is not advised to leave your token directly in your code, as it allows anyone with it to access your bot. If you intend to make your code public you should `store it securely <https://github.com/nextcord/nextcord/blob/master/examples/secure_token_storage.py/>`_.
Links
------
- `Documentation <https://docs.nextcord.dev/>`_
- `Official Discord Server <https://discord.gg/nextcord>`_
- `Discord Developers Server <https://discord.gg/discord-developers>`_
Raw data
{
"_id": null,
"home_page": "https://github.com/nextcord/nextcord",
"name": "nextcord",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8.0",
"maintainer_email": "",
"keywords": "",
"author": "Nextcord Developers & Rapptz",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/f2/0e/347795cec6bc841ed426bc5e112380335869e9ba0922c5ed7ec7bb8ab1a5/nextcord-2.6.0.tar.gz",
"platform": null,
"description": ".. image:: https://raw.githubusercontent.com/nextcord/nextcord/master/assets/repo-banner.svg\n :alt: Nextcord\n\n.. image:: https://img.shields.io/discord/881118111967883295?color=blue&label=discord\n :target: https://discord.gg/nextcord\n :alt: Discord server invite\n.. image:: https://img.shields.io/pypi/v/nextcord.svg\n :target: https://pypi.org/project/nextcord/\n :alt: PyPI version info\n.. image:: https://img.shields.io/pypi/dm/nextcord?color=informational&label=pypi%20downloads\n :target: https://pypi.org/project/nextcord/\n :alt: PyPI version info\n.. image:: https://img.shields.io/pypi/pyversions/nextcord.svg\n :target: https://pypi.org/project/nextcord/\n :alt: PyPI supported Python versions\n.. image:: https://img.shields.io/readthedocs/nextcord\n :target: https://docs.nextcord.dev/\n :alt: Nextcord documentation\n\nNextcord\n--------\n\nA modern, easy-to-use, feature-rich, and async-ready API wrapper for Discord written in Python.\n\n\nKey Features\n-------------\n\n- Modern Pythonic API using ``async`` and ``await``\n- Proper rate limit handling\n- Optimised in both speed and memory\n\nInstalling\n----------\n\n**Python 3.8 or higher is required**\n\nTo install the library without full voice support, you can just run the following command:\n\n.. code:: sh\n\n # Linux/macOS\n python3 -m pip install -U nextcord\n\n # Windows\n py -3 -m pip install -U nextcord\n\nOtherwise to get voice support you should run the following command:\n\n.. code:: sh\n\n # Linux/macOS\n python3 -m pip install -U \"nextcord[voice]\"\n\n # Windows\n py -3 -m pip install -U nextcord[voice]\n\nTo install additional packages for speedup, run the following command:\n\n.. code:: sh\n\n # Linux/macOS\n python3 -m pip install -U \"nextcord[speed]\"\n\n # Windows\n py -3 -m pip install -U nextcord[speed]\n\n\nTo install the development version, do the following:\n\n.. code:: sh\n\n $ git clone https://github.com/nextcord/nextcord/\n $ cd nextcord\n $ python3 -m pip install -U .[voice]\n\n\nOptional Packages\n~~~~~~~~~~~~~~~~~~\n\n* `PyNaCl <https://pypi.org/project/PyNaCl/>`__ (for voice support)\n* `aiodns <https://pypi.org/project/aiodns/>`__, `Brotli <https://pypi.org/project/Brotli/>`__, `cchardet <https://pypi.org/project/cchardet/>`__ (for aiohttp speedup)\n* `orjson <https://pypi.org/project/orjson/>`__ (for json speedup)\n\nPlease note that on Linux installing voice you must install the following packages via your favourite package manager (e.g. ``apt``, ``dnf``, etc) before running the above commands:\n\n* libffi-dev (or ``libffi-devel`` on some systems)\n* python-dev (e.g. ``python3.8-dev`` for Python 3.8)\n\n\nQuick Example\n~~~~~~~~~~~~~\n\n.. code:: py\n\n import nextcord\n from nextcord.ext import commands\n\n\n bot = commands.Bot()\n\n @bot.slash_command(description=\"Replies with pong!\")\n async def ping(interaction: nextcord.Interaction):\n await interaction.send(\"Pong!\", ephemeral=True)\n\n bot.run(\"token\")\n\nYou can find more examples in the `examples directory <https://github.com/nextcord/nextcord/blob/master/examples/>`_.\n\n**NOTE:** It is not advised to leave your token directly in your code, as it allows anyone with it to access your bot. If you intend to make your code public you should `store it securely <https://github.com/nextcord/nextcord/blob/master/examples/secure_token_storage.py/>`_.\n\nLinks\n------\n\n- `Documentation <https://docs.nextcord.dev/>`_\n- `Official Discord Server <https://discord.gg/nextcord>`_\n- `Discord Developers Server <https://discord.gg/discord-developers>`_\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python wrapper for the Discord API forked from discord.py",
"version": "2.6.0",
"project_urls": {
"Documentation": "https://docs.nextcord.dev/",
"Homepage": "https://github.com/nextcord/nextcord",
"Issue tracker": "https://github.com/nextcord/nextcord/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f20e347795cec6bc841ed426bc5e112380335869e9ba0922c5ed7ec7bb8ab1a5",
"md5": "7135bb4e4e87214a7228b4b1ff510cc8",
"sha256": "ccf461157be682cbceaa474e8df4afa302351b8d6ced632f9ccb7aa647b092e7"
},
"downloads": -1,
"filename": "nextcord-2.6.0.tar.gz",
"has_sig": false,
"md5_digest": "7135bb4e4e87214a7228b4b1ff510cc8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.0",
"size": 932913,
"upload_time": "2023-09-23T16:29:52",
"upload_time_iso_8601": "2023-09-23T16:29:52.347544Z",
"url": "https://files.pythonhosted.org/packages/f2/0e/347795cec6bc841ed426bc5e112380335869e9ba0922c5ed7ec7bb8ab1a5/nextcord-2.6.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-23 16:29:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "nextcord",
"github_project": "nextcord",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "nextcord"
}
JSON
