stowix blob push

Push files and directories to a Stowix raw blob repository.

Synopsis

stowix blob push [flags] <source> [<source>...] <remote-dest>

Description

stowix blob push uploads one or more files or directories to a Stowix raw blob repository. The last positional argument is always the remote destination. When uploading directories, the CLI walks the tree recursively and supports parallel uploads via configurable workers.

Destination Routing Rules

Invocation	Behavior
`stowix blob push file.bin releases/v1/file.bin`	Single file uploaded to the exact key `releases/v1/file.bin`
`stowix blob push file.bin releases/v1/`	Destination ends with `/` — file basename is appended: `releases/v1/file.bin`
`stowix blob push a.bin b.bin releases/v1/`	Multiple sources — last arg is always a prefix; both files uploaded under `releases/v1/`
`stowix blob push ./dist/ releases/v1.0/`	Directory — all files uploaded recursively, relative paths preserved under `releases/v1.0/`

Flags

Flag	Env Var	Required	Default	Description
`--target <url>`	`STOWIX_TARGET`	No	—	Full URL of the target repository, e.g. `https://acme.stowix.io/my-assets`
`--token <token>`	`STOWIX_TOKEN`	No	—	API token for authentication
`--workers <n>`	—	No	`4`	Number of parallel upload workers (used for directory push)
`--mime <type>`	—	No	auto-detected	Override MIME type for all uploaded files
`--dry-run`	—	No	`false`	Print what would be uploaded without making any API calls
`--verbose` / `-v`	—	No	`false`	Print per-file progress bars instead of an aggregate bar

Examples

# Upload a single file with an exact remote path
stowix blob push \
  --target https://acme.stowix.io/my-assets \
  logo.png images/logo.png

# Upload a directory with 8 parallel workers
stowix blob push \
  --target https://acme.stowix.io/my-releases \
  --workers 8 \
  ./dist/ v1.0.0/

# Dry-run to preview uploads
stowix blob push \
  --target https://acme.stowix.io/my-assets \
  --dry-run \
  ./build/ artifacts/latest/

# Override MIME type for a custom file format
stowix blob push \
  --target https://acme.stowix.io/my-assets \
  --mime application/x-custom \
  data.bin custom/data.bin