Nextcore

_{A low level Discord API wrapper.}

✨ Features

• Speed

  We try to make the library as fast as possible, without compromising on readability of the code or features.

  speed-showcase.mp4

• Modularity

  All the components can easily be swapped out with your own.

• Control

  Nextcore offers fine-grained control over things most libraries don't support.

  This currently includes:

  • Setting priority for individual requests
  • Swapping out components

Examples

🏓 Ping pong

A simple "ping pong" example in nextcore. This will respond with "pong" each time someone sends "ping" in the chat.

importasynciofromosimportenvironfromtypingimportcastfromdiscord_typingsimportMessageDatafromnextcore.gatewayimportShardManagerfromnextcore.httpimportBotAuthentication, HTTPClient, Route# ConstantsAUTHENTICATION=BotAuthentication(environ["TOKEN"])
# Intents are a way to select what intents Discord should send to you.# For a list of intents see https://discord.dev/topics/gateway#gateway-intentsGUILD_MESSAGES_INTENT=1<<9MESSAGE_CONTENT_INTENT=1<<15INTENTS=GUILD_MESSAGES_INTENT|MESSAGE_CONTENT_INTENT# Guild messages and message content intents.# Create a HTTPClient and a ShardManager.# A ShardManager is just a neat wrapper around Shard objects.http_client=HTTPClient()
shard_manager=ShardManager(AUTHENTICATION, INTENTS, http_client)
@shard_manager.event_dispatcher.listen("MESSAGE_CREATE")asyncdefon_message(message: MessageData):
# This function will be called every time a message is sent.ifmessage["content"] =="ping":
# Send a pong message to respond.route=Route("POST", "/channels/{channel_id}/messages", channel_id=message["channel_id"])
awaithttp_client.request(
route,
rate_limit_key=AUTHENTICATION.rate_limit_key,
json={"content": "pong"},
headers=AUTHENTICATION.headers,
)
asyncdefmain():
awaithttp_client.setup()
# This should return once all shards have started to connect.# This does not mean they are connected.awaitshard_manager.connect()
# Raise a error and exit whenever a critical error occurs
(error,) =awaitshard_manager.dispatcher.wait_for(lambda: True, "critical")
raisecast(Exception, error)
asyncio.run(main())

More examples can be seen in the examples directory.

Contributing

Want to help us out? Please read our contributing docs.