qord-legacy

KO | EN

gitlite — search

#react #ai #go #android #machine-learning #linux #windows #awesome #cli #vue #pytorch #security #ios #open-source

(★ 14)

Python library for Discord API based around asyncio.

qord-legacy Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Qord

Python library for Discord API based around asyncio.

**Features:**

- Object oriented, user friendly interface with no dirty payloads.
- Easy to customise and manage.
- Robust handling of HTTP ratelimits.
- Supports automatic gateway sharding.

## Development stage
Qord is currently under it's initial development (alpha) stage. During this phase, there may be breaking changes and public user-facing API should not be considered stable. There would be no efforts in keeping backward compatibility. While the library currently supports the basic functionalities required to build a bot, many essential features are yet to be implemented and for this reason, Qord isn't yet a library to choose for making full fledged bots.

The complete lifetime of 0.x version is considered the development phase. More info about this semantic versioning specification can be found [here](https://semver.org/#spec-item-4).

## Installation
Qord is installed using Python's traditional package manager, pip.
```bash
python -m pip install -U qord
```

Qord requires **Python 3.8 or higher**. The dependencies are handled by pip automatically, see complete list of dependencies [here](https://github.com/izxxr/qord/blob/main/requirements.txt).

## Usage
To whet your appetite, let's get a quickstart with an example of a simple "Ping-Pong" bot.
```py
import qord

intents = qord.Intents.unprivileged()
intents.message_content = True
client = qord.Client(intents=intents)

@client.event(qord.GatewayEvent.READY)
async def on_ready(event):
  print("Bot is ready.")
  print(f"Shards: {client.shards_count}")
  print(f"User: {client.user.proper_name}")
  print(f"Guilds: {len(client.cache.guilds())}")

@client.event(qord.GatewayEvent.MESSAGE_CREATE)
async def on_message_create(event):
  message = event.message

if message.author.bot:
    # Don't respond to bot messages.
    return

if message.content == "!ping":
    await message.channel.send("Pong!")

client.start("BOT_TOKEN")
```

For a brief explanation of this example, go to [this page](https://github.com/izxxr/qord/blob/master/examples/basic.py). More examples can be found in the [`examples`](https://github.com/izxxr/qord/blob/master/examples) directory.

## Contributing
Qord is under heavy development. You can help us in reaching 100% coverage of Discord API by reporting bugs, suggesting features or even directly contributing to the code base. Please read the [Contribution Guidelines](https://github.com/izxxr/qord/blob/main/CONTRIBUTING.MD).

----

<br>
<div align="center">
  <a href="https://qord.rtfd.io">Documentation</a> • <a href="https://discord.gg/nE9cGtzayA">Discord Server</a> • <a href="https://pypi.org/project/qord">PyPi</a>
  • <a href="https://github.com/izxxr/qord">GitHub</a> • <a href="https://github.com/izxxr/qord/issues">Issues Tracker</a>
  <br><br>
  <sup>Copyright (C) izxxr and contributors 2022, Under the MIT license.</sup>
</p>

qord-legacy

qord-legacy Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

qord-legacy

qord-legacy Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README