This README is the one indexed from the repository at its latest ref, not from the tag for this version.

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.