Skip to content

CLI

Optional binary (--features cli). Files and stdin become opaque batches— useful for black-box tests, not a Kafka client.

cargo install object-log --features cli
object-log --help

Commands

CommandPurpose
produceAppend batches from files / stdin
consumeRead batches to stdout or --out-dir
roundtripOne-shot produce+consume (--memory for in-process)
listList object keys under a prefix
inspectPrint ManifestSequencer index (optional --json)
orphansDry-run or --delete unreferenced data objects
fetchLow-level fetch with hex/text preview

Framing modes

ModeProduceConsume
fileeach path = one batch—
linesnewline-splitpayload + \n
nulNUL-splitpayload + NUL
framedu64 BE length + bytessame
raw—concatenate payloads

Store backends

  • Local: --root DIR
  • S3-compatible: build with cli,s3 and --s3-endpoint / --s3-bucket / OBJECT_LOG_S3_KEY_ID / OBJECT_LOG_S3_SECRET

Examples

printf 'a\nb\nc\n' | object-log produce --root /tmp/olog --partition demo --lines
object-log consume --root /tmp/olog --partition demo --lines

object-log inspect --root /tmp/olog --summary
object-log list --root /tmp/olog --prefix log/