slog/README.md

slog

Single-header structured logger in C99

Simple usage

  ...
	struct SlogLogger logger = SLOG_DEFAULT_TEXT_LOGGER;

	SLOG_DEBUG(&logger, "will not appear");
	// Dropped, the default text logger has .Opts.MinLevel = SlogLevelInfo

	SLOG_INFO(&logger, "hello from minimal.c");
	// The default text logger's output file is stdout:
	// time=2025-09-29T17:46:49.409721457-06:00 level=INFO msg=hello from minimal.c

	struct SlogAttr attrs[] = {
		SlogAttrB("ok", true),
	};

	SLOG_INFO_ATTRS(&logger, "hello", attrs);
	// time=2025-09-29T17:46:49.409721457-06:00 level=INFO msg=hello ok=true
  ...

Advanced usage

#include <slog/slog.h>
#include <stdbool.h>

int main(void)
{
	struct SlogHandlerOpts opts1 = {
		.File = stdout,
		.MinLevel = SlogLevelDebug,
		.Prefix = NULL,
		.AddSource = true,
		.Json = false,
	};

	struct SlogLogger l1 = {
		SlogTextHandler,
		opts1,
	};

	struct SlogHandlerOpts opts2 = {
		.File = stderr,
		.MinLevel = SlogLevelError,
		.Prefix = "scope",
		.AddSource = false,
		.Json = true,
	};

	struct SlogLogger l2 = {
		SlogTextHandler,
		opts2,
	};

	struct SlogAttr attrs[] = {
		SlogAttrB("ok", true),
	};

	SLOG_INFO_ATTRS(&l1, "hello", attrs);
	// stdout:
	// time=2025-09-30T09:38:32.607139416-06:00 level=INFO msg=hello source=tests/slog.c:36 func=main ok=true

	SLOG_ERROR(&l2, "hello");
	// stderr:
	// time=2025-09-30T09:38:32.607139416-06:00 level=INFO msg=hello

	return 0;
}