deancord (WIP)

Warning

This project is still a work in progress, and is not functional at the moment. I'm pretty close to completing though so check back in a few weeks (or feel free to contribute!)

A Discord API for the Zig programming language.

Currently built off of Zig Version 0.13.0. If you notice that it is broken on a more recent patch of Zig, please create an issue!

To include this in your zig project, use the Zig Package Manager:

zig fetch --save 'git+https://github.com/deanveloper/deancord.zig#main'

Then, make sure something similar to the following is in your build.zig:

	const deancord_dependency = b.dependency("deancord");
	const deancord_module = deancord_dependency.module("deancord");
    const my_bot = b.addExecutable(.{
        .name = "my-bot",
        .optimize = optimize,
        .target = target,
        .root_source_file = b.path("./src/main.zig"),
    });
    gateway_bot.root_module.addImport("deancord", deancord_module);
	b.installArtifact(gateway_bot);

Basic Usage

The best way to look at examples is to look at the examples directory.

The examples are also runnable with zig build examples:gateway and zig build examples:interaction (or simply zig build examples to build all examples)

TODO

• HTTP Interaction Server: Zig does not currently have a std HTTPS library (or even TLS server, which could be used to get "close enough"). I plan to wait for that before implementing the HTTP interaction server. However, the example in examples/interaction-bot.zig is what it will eventually look like!
• Should probably add a wrapper for rest.Client to make calling endpoints a bit more obvious.
  • rest.Client -> rest.Client
  • rest.*.endpointName(client, ...) -> rest.ApiClient.init(rest.Client); api_client.endpointName(...)