Postmany

Postmany reads filenames from stdin and transfers file content to/from an HTTP(S) endpoint.

It is designed for event-driven pipelines where a list of files is produced by one tool and streamed to another system.

Features

• Stream filenames from stdin
• Upload with POST or PUT
• Download with GET
• Multiple worker fibers (-w) for concurrent transfers
• Static request headers (-H) for APIs like Azure Blob

Installation

Build from source

shards install
shards --production build --release --static

The compiled binary is written to bin/postmany.

Docker development image

Use compose.yml with crystallang/crystal:1.19.1-alpine:

docker compose run --rm dev shards install
docker compose run --rm dev crystal spec

Usage

POST upload

URL="https://example.test/webhook"
find files -name '*.json' | postmany "$URL"

PUT upload (Azure Blob style)

SAS="?sv=2020-10-02&..."
STORAGE_ACCOUNT="mystorageaccount"
CONTAINER="mycontainer"
find images -name '*.png' | \
  postmany -X PUT -H x-ms-blob-type:BlockBlob \
  "https://${STORAGE_ACCOUNT}.blob.core.windows.net/${CONTAINER}${SAS}"

GET download

printf "docs/a.json\ndocs/b.json\n" | postmany -X GET "https://example.test/files"

CLI Reference

Option	Description
-w, --workers=WORKERS	Number of workers (default: 1, minimum: 1)
-s, --silent	Disable per-file stdout output
--no-progress	Disable progress messages
-X, --request=METHOD	HTTP method: POST, PUT, GET (default: POST)
-H, --header=HEADER	Static HTTP header (key:value)
-h, --help	Show help
--version	Show version

Positional argument:

• ENDPOINT (required): target URL.

Engineering Docs

Contributor workflows, architecture, and CI/CD details live in CONTRIBUTING.md.

License

UNLICENSE.