Logging

from nullspace import Template, default_build_logger

build = Template.build(
    builder,
    name="my-template",
    tags=["stable"],
    on_log_entry=default_build_logger(),
)

const template = await client.templates.builder()
  .fromPythonImage("3.12")
  .build({
    name: "my-template",
    tags: ["stable"],
    onLogEntry: (entry) => console.log(entry.level, entry.message),
  });

# The default text log format streams progress to stderr during the build.
nullspace template build --from-python-image 3.12 --name my-template --tag stable

# POST /v1/templates/build returns a text/event-stream of structured log
# entries. Use -N to disable buffering. See the API reference for the
# TemplateBuildLogEntry schema.
curl -N -X POST "${NULLSPACE_API_URL}/v1/templates/build" \
  -H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{"name": "my-template", "tags": ["stable"], "base_image": "python:3.12"}'

from nullspace import TemplateBuild

build = TemplateBuild.connect("tb_...")
status = build.get_status(offset=0)
for entry in status.entries:
    print(entry.kind, entry.message)
print(status.next_offset)

nullspace template build-status tb_... --offset 0
nullspace template logs tb_...

# GET /v1/templates/builds/{build_id}/logs replays durable entries from offset
# and follows live entries with follow=true. See the API reference for the
# TemplateBuildLogEntry schema.
curl -N "${NULLSPACE_API_URL}/v1/templates/builds/tb_.../logs?offset=0&follow=true" \
  -H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
  -H "Accept: text/event-stream"