Getty
Getty is a framework for building robust, optimal, and reusable (de)serializers in Zig.
- Compile-time (de)serialization.
- Out-of-the-box support for a variety of
stdtypes. - Granular customization for existing and remote types.
- Data models that serve as simple and generic baselines for (de)serializers.
Quick Start
build.zig
const std = @import("std");
pub fn build(b: *std.Build) void {
const target = b.standardTargetOptions(.{});
const optimize = b.standardOptimizeOption(.{});
const opts = .{ .target = target, .optimize = optimize };
const json_mod = b.dependency("json", opts).module("json");
const exe = b.addExecutable(.{
.name = "quick-start",
.root_source_file = .{ .path = "src/main.zig" },
.target = target,
.optimize = optimize,
});
exe.addModule("json", json_mod);
const run_cmd = b.addRunArtifact(exe);
const run_step = b.step("run", "Run the app");
run_step.dependOn(&run_cmd.step);
}
build.zig.zon
.{
.name = "quick-start",
.version = "0.0.0",
.dependencies = .{
.json = .{
.url = "https://github.com/getty-zig/json/archive/5a64449.tar.gz",
.hash = "122087fe6d2b141548103e98e4324ac0ab889e7d50d82e186f396d90f55a942aef61",
},
},
}
src/main.zig
const std = @import("std");
const json = @import("json");
const allocator = std.heap.page_allocator;
const Point = struct {
x: i32,
y: i32,
};
pub fn main() !void {
const value = Point{ .x = 1, .y = 2 };
// Serialize a Point value into JSON.
const serialized = try json.toSlice(allocator, value);
defer allocator.free(serialized);
// Deserialize JSON data into a Point value.
const deserialized = try json.fromSlice(allocator, Point, serialized);
// Print results.
std.debug.print("{s}\n", .{serialized});
std.debug.print("{}\n", .{deserialized});
}