summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRobby Zambito <contact@robbyzambito.me>2025-04-19 23:56:47 -0400
committerRobby Zambito <contact@robbyzambito.me>2025-04-19 23:59:06 -0400
commitfe26cb002db4b7bd9a53265690aba19a54ebe50f (patch)
treee139cfef34ffef1b5f0d936100a4e412aa5bc342
parentc34748dab3def4dbb1deea7240ab3d4ef17ef161 (diff)
Initial C api
-rw-r--r--build.zig22
-rw-r--r--include/zaprus.h24
-rw-r--r--src/c_api.zig56
-rw-r--r--src/root.zig2
4 files changed, 102 insertions, 2 deletions
diff --git a/build.zig b/build.zig
index a45ac7c..6f7f1e4 100644
--- a/build.zig
+++ b/build.zig
@@ -1,4 +1,5 @@
const std = @import("std");
+const Step = std.Build.Step;
// Although this function looks imperative, note that its job is to
// declaratively construct a build graph that will be executed by an external
@@ -37,13 +38,30 @@ pub fn build(b: *std.Build) void {
exe_mod.addImport("zaprus", lib_mod);
exe_mod.addImport("clap", b.dependency("clap", .{}).module("clap"));
- const lib = b.addLibrary(.{
+ const static_lib = b.addLibrary(.{
.linkage = .static,
.name = "zaprus",
.root_module = lib_mod,
});
- b.installArtifact(lib);
+ b.installArtifact(static_lib);
+
+ const dynamic_lib = b.addLibrary(.{
+ .linkage = .dynamic,
+ .name = "zaprus",
+ .root_module = lib_mod,
+ });
+
+ b.installArtifact(dynamic_lib);
+
+ // C Headers
+ const c_header = b.addInstallFileWithDir(
+ b.path("include/zaprus.h"),
+ .header,
+ "zaprus.h",
+ );
+
+ b.getInstallStep().dependOn(&c_header.step);
// This creates another `std.Build.Step.Compile`, but this one builds an executable
// rather than a static library.
diff --git a/include/zaprus.h b/include/zaprus.h
new file mode 100644
index 0000000..31fe97c
--- /dev/null
+++ b/include/zaprus.h
@@ -0,0 +1,24 @@
+// client
+
+int zaprus_init(void);
+
+int zaprus_deinit(void);
+
+int zaprus_send_relay(const char* payload, usize len, char[4] dest);
+
+int zaprus_send_initial_connection(const char* payload, usize len, uint16_t initial_port);
+
+struct SaprusMessage* zaprus_connect(const char* payload, usize len);
+
+// message
+struct SaprusMessage {
+
+};
+
+// ptr should be freed by the caller.
+int zaprus_message_to_bytes(struct SaprusMessage msg, char** ptr, usize* len);
+
+// Return value should be destroyed with zaprus_message_deinit.
+struct SaprusMessage* zaprus_message_from_bytes(const char* bytes, usize len);
+
+void zaprus_message_deinit(struct SaprusMessage* msg);
diff --git a/src/c_api.zig b/src/c_api.zig
new file mode 100644
index 0000000..bb233e0
--- /dev/null
+++ b/src/c_api.zig
@@ -0,0 +1,56 @@
+// client
+
+export fn zaprus_init() c_int {
+ SaprusClient.init() catch return 1;
+ return 0;
+}
+
+export fn zaprus_deinit() c_int {
+ SaprusClient.deinit();
+ return 0;
+}
+
+export fn zaprus_send_relay(payload: [*]const u8, len: usize, dest: [4]u8) c_int {
+ SaprusClient.sendRelay(payload[0..len], dest, allocator) catch return 1;
+ return 0;
+}
+
+export fn zaprus_send_initial_connection(payload: [*]const u8, len: usize, initial_port: u16) c_int {
+ SaprusClient.sendInitialConnection(payload[0..len], initial_port, allocator) catch return 1;
+ return 0;
+}
+
+export fn zaprus_connect(payload: [*]const u8, len: usize) ?*SaprusMessage {
+ return SaprusClient.connect(payload[0..len], allocator) catch null;
+}
+
+// message
+
+/// ptr should be freed by the caller.
+export fn zaprus_message_to_bytes(msg: SaprusMessage, ptr: *[*]u8, len: *usize) c_int {
+ const bytes = msg.toBytes(allocator) catch return 1;
+ ptr.* = bytes[0..].*;
+ len.* = bytes.len;
+ return 0;
+}
+
+/// Return value should be destroyed with zaprus_message_deinit.
+export fn zaprus_message_from_bytes(bytes: [*]const u8, len: usize) ?*SaprusMessage {
+ return SaprusMessage.fromBytes(bytes[0..len], allocator) catch null;
+}
+
+export fn zaprus_message_deinit(msg: *SaprusMessage) void {
+ msg.deinit(allocator);
+}
+
+const std = @import("std");
+
+const zaprus = @import("./root.zig");
+const SaprusClient = zaprus.Client;
+const SaprusMessage = zaprus.Message;
+
+const allocator = std.heap.c_allocator;
+
+test {
+ std.testing.refAllDeclsRecursively(@This());
+}
diff --git a/src/root.zig b/src/root.zig
index 5d93578..dfa4984 100644
--- a/src/root.zig
+++ b/src/root.zig
@@ -1,2 +1,4 @@
pub const Client = @import("Client.zig");
pub usingnamespace @import("message.zig");
+
+pub usingnamespace @import("c_api.zig");