grafos store

Object storage CLI on top of grafos-store.

grafos store

Object storage: buckets, put, get, head, rm, ls

Usage: grafos store [OPTIONS] <COMMAND>

Commands:
  mb       Create a bucket
  rb       Remove a bucket
  buckets  List all buckets
  put      Upload an object to the store
  get      Download an object from the store
  head     Show object metadata without downloading
  rm       Delete an object
  ls       List objects in a bucket
  help     Print this message or the help of the given subcommand(s)

Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --json             Output in JSON format for scripting
      --wide             Show additional columns in table output
      --no-color         Disable color output
      --pool <POOL>      Pool name (default: "default") [default: default]
  -h, --help             Print help
  -V, --version          Print version

grafos store mb

Create a bucket

Usage: grafos store mb [OPTIONS] <BUCKET>

Arguments:
  <BUCKET>  Bucket name to create

Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --json             Output in JSON format for scripting
      --wide             Show additional columns in table output
      --no-color         Disable color output
      --pool <POOL>      Pool name (default: "default") [default: default]
  -h, --help             Print help
  -V, --version          Print version

grafos store rb

Remove a bucket

Usage: grafos store rb [OPTIONS] <BUCKET>

Arguments:
  <BUCKET>  Bucket name to remove

Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --force            Force removal even if bucket has objects
      --json             Output in JSON format for scripting
      --wide             Show additional columns in table output
      --no-color         Disable color output
      --pool <POOL>      Pool name (default: "default") [default: default]
  -h, --help             Print help
  -V, --version          Print version

grafos store buckets

List all buckets

Usage: grafos store buckets [OPTIONS]

Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --json             Output in JSON format for scripting
      --wide             Show additional columns in table output
      --no-color         Disable color output
      --pool <POOL>      Pool name (default: "default") [default: default]
  -h, --help             Print help
  -V, --version          Print version

grafos store put

Upload an object to the store.

Reads from a local file, or stdin if path is "-".

Usage: grafos store put [OPTIONS] <URI> [FILE]

Arguments:
  <URI>
          Fabric URI (fabric://pool/bucket/key)

  [FILE]
          Local file path, or "-" for stdin

          [default: -]

Options:
      --content-type <CONTENT_TYPE>
          Content type override

      --fabric <FABRIC>
          Fabric address (host:port). Overrides GRAFOS_FABRIC env var

          [env: GRAFOS_FABRIC=]

      --json
          Output in JSON format for scripting

      --wide
          Show additional columns in table output

      --no-color
          Disable color output

      --pool <POOL>
          Pool name (default: "default")

          [default: default]

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

grafos store get

Download an object from the store.

Writes to a local file, or stdout if path is "-".

Usage: grafos store get [OPTIONS] <URI> [FILE]

Arguments:
  <URI>
          Fabric URI (fabric://pool/bucket/key)

  [FILE]
          Local file path, or "-" for stdout

          [default: -]

Options:
      --fabric <FABRIC>
          Fabric address (host:port). Overrides GRAFOS_FABRIC env var

          [env: GRAFOS_FABRIC=]

      --json
          Output in JSON format for scripting

      --wide
          Show additional columns in table output

      --no-color
          Disable color output

      --pool <POOL>
          Pool name (default: "default")

          [default: default]

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

grafos store head

Show object metadata without downloading

Usage: grafos store head [OPTIONS] <URI>

Arguments:
  <URI>  Fabric URI (fabric://pool/bucket/key)

Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --json             Output in JSON format for scripting
      --wide             Show additional columns in table output
      --no-color         Disable color output
      --pool <POOL>      Pool name (default: "default") [default: default]
  -h, --help             Print help
  -V, --version          Print version

grafos store rm

Delete an object

Usage: grafos store rm [OPTIONS] <URI>

Arguments:
  <URI>  Fabric URI (fabric://pool/bucket/key)

Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --json             Output in JSON format for scripting
      --wide             Show additional columns in table output
      --no-color         Disable color output
      --pool <POOL>      Pool name (default: "default") [default: default]
  -h, --help             Print help
  -V, --version          Print version

grafos store ls

List objects in a bucket

Usage: grafos store ls [OPTIONS] <BUCKET> [PREFIX]

Arguments:
  <BUCKET>  Bucket name
  [PREFIX]  Key prefix filter [default: ]

Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --recursive        List all keys under prefix recursively
      --json             Output in JSON format for scripting
      --wide             Show additional columns in table output
      --no-color         Disable color output
      --pool <POOL>      Pool name (default: "default") [default: default]
  -h, --help             Print help
  -V, --version          Print version