Docker

These libraries are experimental. APIs may change without notice. Generated from source on 6/15/2026.

@korulang/docker - Docker DSL for Koru

@koru/docker

@korulang/docker - Docker DSL for Koru Declarative image definitions and typed container lifecycle. Phantom obligations ensure containers are properly stopped. DECLARATIVE IMAGES: ~koru/docker:image(tag: "myapp:latest") { FROM alpine:3.18 COPY zig-out/bin/main /usr/local/bin/myapp CMD ["myapp"] } CONDITIONAL IMAGES (build flags): ~[build("prod")]koru/docker:image(tag: "myapp:latest") { FROM alpine:3.18 COPY zig-out/bin/main /usr/local/bin/myapp CMD ["myapp"] } ~[build("dev")]koru/docker:image(tag: "myapp:latest") { FROM alpine:3.18 RUN apk add --no-cache gdb strace COPY zig-out/bin/main /usr/local/bin/myapp CMD ["myapp", "--debug"] } Then run: koruc main.kz --build=prod docker build This generates Dockerfiles and builds all declared images matching the flag.

~[comptime|command]pub event docker {
    program: *const Program,
    allocator: __koru_std.mem.Allocator,
    argv: []const []const u8,
}

// ============================================================================
// Declarative Image Definition (compile-time)
// ============================================================================
// 
// Declare a Docker image - collected at compile time, generates Dockerfile
// Usage:
//   ~koru/docker:image(tag: "myapp:latest") {
//       FROM node:18-alpine
//       WORKDIR /app
//       COPY . .
//       CMD ["node", "index.js"]
//   }
~[comptime|norun]pub event image {
    tag: []const u8, source: Source
}

// ============================================================================
// Build Operations
// ============================================================================
~pub event build {
    tag: []const u8, context: []const u8
}
| built Image
| failed { code: i32, msg: []const u8 }

// ============================================================================
// Container Lifecycle (with phantom obligations)
// ============================================================================
// 
// Run a container - creates <running!> obligation that must be discharged
~pub event run {
    image: []const u8, name: ?[]const u8
}
| started Container<running!>
| failed { code: i32, msg: []const u8 }

// Stop a container - discharges <running!> obligation
~pub event stop {
    container: Container<!running>
}
| stopped
| failed { code: i32, msg: []const u8 }

// Kill a container (forceful) - also discharges <running!> obligation
~pub event kill {
    container: Container<!running>
}
| killed
| failed { code: i32, msg: []const u8 }

// ============================================================================
// Registry Operations
// ============================================================================
~pub event push {
    image: []const u8
}
| pushed
| failed { code: i32, msg: []const u8 }

~pub event pull {
    image: []const u8
}
| pulled
| failed { code: i32, msg: []const u8 }