Coming soon...
configurable writers
currently jsonlog writes to stderr, as the default std log fn does. we'd like to make the writer user configurable.
const std = @import("std");
const jsonLog = @import("jsonlog");
const log = std.log.scoped(.demo);
pub const std_options: std.Options = .{
// configure the std lib log api fn to use jsonlog formatting
.logFn = jsonLog.logFn,
};
pub fn main() void {
// std log interface
log.debug("DEBUG", .{});
log.info("INFO", .{});
log.warn("WARN", .{});
log.err("ERR", .{});
// jsonLog interface for provoding arbitrary structured metadata
jsonLog.info("things are happening", .{}, .{
.endpoint = "/home",
.method = "GET",
});
// create a custom scope for doing the same
jsonLog.scoped(.demo).warn("things could be better", .{}, .{
.endpoint = "/home",
.method = "GET",
});
}
{"ts":"2024-03-20T15:07:15.363Z","level":"debug","msg":"DEBUG","scope":"demo"}
{"ts":"2024-03-20T15:07:15.364Z","level":"info","msg":"INFO","scope":"demo"}
{"ts":"2024-03-20T15:07:15.364Z","level":"warning","msg":"WARN","scope":"demo"}
{"ts":"2024-03-20T15:07:15.364Z","level":"error","msg":"ERR","scope":"demo"}
{"ts":"2024-03-20T15:07:15.364Z","level":"info","msg":"things are happening","scope":"default","meta":{"endpoint":"/home","method":"GET"}}
{"ts":"2024-03-20T15:07:15.364Z","level":"warning","msg":"things could be better","scope":"demo","meta":{"endpoint":"/home","method":"GET"}}
Create a new exec project with zig init-exe
. Copy the echo handler example above into src/main.zig
Create a build.zig.zon
file to declare a dependency
.zon short for "zig object notation" files are essentially zig structs.
build.zig.zon
is zigs native package manager convention for where to declare dependencies
Starting in zig 0.12.0, you can use and should prefer
zig fetch --save https://github.com/softprops/zig-jsonlog/archive/refs/tags/v0.2.1.tar.gz
otherwise, to manually add it, do so as follows
.{
.name = "my-app",
.version = "0.1.0",
.dependencies = .{
+ // π declare dep properties
+ .jsonlog = .{
+ // π uri to download
+ .url = "https://github.com/softprops/zig-jsonlog/archive/refs/tags/v0.2.1.tar.gz",
+ // π hash verification
+ .hash = "...",
+ },
},
}
the hash below may vary. you can also depend any tag with
https://github.com/softprops/zig-jsonlog/archive/refs/tags/v{version}.tar.gz
or current main withhttps://github.com/softprops/zig-jsonlog/archive/refs/heads/main/main.tar.gz
. to resolve a hash omit it and let zig tell you the expected value.
Add the following in your build.zig
file
const std = @import("std");
pub fn build(b: *std.Build) void {
const target = b.standardTargetOptions(.{});
const optimize = b.standardOptimizeOption(.{});
// π de-reference jsonlog dep from build.zig.zon
+ const jsonlog = b.dependency("jsonlog", .{
+ .target = target,
+ .optimize = optimize,
+ }).module("jsonlog");
var exe = b.addExecutable(.{
.name = "your-exe",
.root_source_file = .{ .path = "src/main.zig" },
.target = target,
.optimize = optimize,
});
// π add the jsonlog module to executable
+ exe.root_mode.addImport("jsonlog", jsonlog);
b.installArtifact(exe);
}
Does this look interesting but you're new to zig and feel left out? No problem, zig is young so most us of our new are as well. Here are some resources to help get you up to speed on zig
- softprops 2024