Skip to main content

A sane Discord API for Python 3 built on asyncio and good intentions

Project description

hikari

An opinionated Discord API for Python 3 and asyncio.

THIS API IS CURRENTLY IN A PRE-ALPHA STAGE, SO NEW VERSIONS WILL CONTAIN BREAKING CHANGES WITHOUT A MINOR VERSION INCREMENTATION. ALL FEATURES ARE PROVISIONAL AND CAN CHANGE AT ANY TIME UNTIL THIS API IS IN A USABLE STATE FOR A FULL FIRST RELEASE.

Please VISIT MY DISCORD if you wish to receive progress updates or help out, any help and contribution is more than welcome :-)

If you wish to explore the code in an online interactive viewer, you can use Sourcegraph on master and staging too!

What is this API?

A base Python Discord API framework for CPython 3.8 Designed for ease of use, customization, and sane defaults.

This API is designed to provide the pure-python interface to the RESTful Discord API and the Gateway. This will provide a set of basic models and abstractions that can be used to build a basic Discord bot in Python with asyncio in a logical, idiomatic, Pythonic, concise way.

Other APIs may exist that are faster, use less memory, or are smaller. I wont dispute that. The aim of this library is to provide a solid and consistent interface that can be relied upon by the end user, and to provide regular updates that are able to be opted into.

I also aim to provide as much automated test coverage as possible. I want to be able to immediately prove that a function does what is expected of it to provide hard evidence that a build is not fundamentally broken before deploying it.

The final aim is for maintainability. This API attempts to be as documented and expandable as possible internally. If something isn't right and you have some understanding of Python, hopefully you should be able to pick it up and tweak it to solve your use case, rather than fighting inflexible internal abstractions that hide the information you need.

What is this API not?

This API is not for people using anything older than CPython 3.8.

It currently is not able to provide voice functionality. Again, this may be added in the future.

FAQ

Contributing to Hikari

View the contributing guide!

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hikari-1.0.1.dev17.tar.gz (133.5 kB view details)

Uploaded Source

Built Distribution

hikari-1.0.1.dev17-py3-none-any.whl (173.8 kB view details)

Uploaded Python 3

File details

Details for the file hikari-1.0.1.dev17.tar.gz.

File metadata

  • Download URL: hikari-1.0.1.dev17.tar.gz
  • Upload date:
  • Size: 133.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/45.1.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.8.1

File hashes

Hashes for hikari-1.0.1.dev17.tar.gz
Algorithm Hash digest
SHA256 756a859b1743a6b7cfd7bc6d897df5f4993235ecdbe0aefa88691dfc815907f7
MD5 57b60ec22517a9b2a51c17ca4f5d131d
BLAKE2b-256 53d40157fc596f84905dc04b7ca4942dc1cf1a721ef20f0cc837c752cf764f3f

See more details on using hashes here.

File details

Details for the file hikari-1.0.1.dev17-py3-none-any.whl.

File metadata

  • Download URL: hikari-1.0.1.dev17-py3-none-any.whl
  • Upload date:
  • Size: 173.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/45.1.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.8.1

File hashes

Hashes for hikari-1.0.1.dev17-py3-none-any.whl
Algorithm Hash digest
SHA256 b9f4afee00506c9f0393986a1e54e7a80090abd86cee71eb05e7980a672d5c4a
MD5 849e9cb97038a4cdf7c5c3657310ba16
BLAKE2b-256 ddaebea55b88d933e6fe26af6d8047cba414d93c9c009ac4b081de2fcc900666

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page