From f109fb62b7e45d54b0c9f524a0707f3c2688b6cb Mon Sep 17 00:00:00 2001
From: Nathan Reiner <nathan@nathanreiner.xyz>
Date: Sat, 23 May 2026 07:11:00 +0200
Subject: add api sketch

---
 src/http/Server.zig | 20 ++++++++++++++++++++
 src/http/Url.zig    | 39 +++++++++++++++++++++++++++++++++++++++
 src/http/root.zig   |  3 +++
 3 files changed, 62 insertions(+)
 create mode 100644 src/http/Server.zig
 create mode 100644 src/http/Url.zig

(limited to 'src/http')

diff --git a/src/http/Server.zig b/src/http/Server.zig
new file mode 100644
index 0000000..b6e2d90
--- /dev/null
+++ b/src/http/Server.zig
@@ -0,0 +1,20 @@
+const std = @import("std");
+
+const Self = @This();
+
+server: std.Io.net.Server,
+io: std.Io.Threaded,
+
+pub fn init(
+    gpa: std.mem.Allocator,
+    address: std.Io.net.IpAddress,
+) !Self {
+    var io: std.Io.Threaded = .init(gpa, .{});
+
+    return .{
+        .io = io,
+        .server = try address.listen(io.io(), .{ .reuse_address = true }),
+    };
+}
+
+pub fn serve(_: *Self) !void {}
diff --git a/src/http/Url.zig b/src/http/Url.zig
new file mode 100644
index 0000000..4a0a2b0
--- /dev/null
+++ b/src/http/Url.zig
@@ -0,0 +1,39 @@
+const std = @import("std");
+
+const Segment = union(enum) {
+    literal: []const u8,
+    parameter: []const u8,
+
+    pub fn format(self: @This(), writer: *std.Io.Writer) !void {
+        try writer.print("{s}{{ {s} }}", .{ @tagName(self), switch (self) {
+            inline else => |s| s,
+        } });
+    }
+};
+
+pub fn Template(comptime template: []const u8) []const Segment {
+    var segments: []const Segment = &.{};
+    var t = template;
+
+    if (template.len == 0 or template[0] != '/') {
+        @compileError("template needs to be absolute");
+    }
+
+    while (t.len > 0) {
+        const index = std.mem.indexOfScalar(u8, t, '/');
+        const segment = t[0 .. index orelse t.len];
+        t = t[(index orelse t.len - 1) + 1 ..];
+
+        if (segment.len > 0) {
+            const s: []const Segment = &.{seg: {
+                if (segment[0] == '{' and segment[segment.len - 1] == '}') {
+                    break :seg .{ .parameter = segment[1 .. segment.len - 1] };
+                } else {
+                    break :seg .{ .literal = segment };
+                }
+            }};
+            segments = segments ++ s;
+        }
+    }
+    return segments;
+}
diff --git a/src/http/root.zig b/src/http/root.zig
index 743e1c4..317dacd 100644
--- a/src/http/root.zig
+++ b/src/http/root.zig
@@ -2,6 +2,9 @@
 
 const std = @import("std");
 
+pub const Server = @import("Server.zig");
+pub const Url = @import("Url.zig");
+
 test {
     _ = std.testing.refAllDecls(@This());
 }
-- 
cgit v1.2.3-70-g09d2