fxpipe

Parallel BLAKE3 under FsCap for fx projects.

fxpipe hashes many paths with a structured worker pool (host nursery). Output is ordered hex path. Not GNU parallel; not language spawn-closures. Dual-path: emit-C and IR.

Requires	fx 0.9.6+ (with --cli)
Platforms	Windows + Linux x86_64
License	GPL-3.0 (tool) · CC0-1.0 (BLAKE3)
Org	LedoCorp

Install (release binaries)

1. Install fx 0.9.6+.
2. Download the asset for your OS from Releases.
3. Put bin/windows/fxpipe.exe or bin/linux/fxpipe on your PATH.

# Windows (PowerShell)
Invoke-WebRequest -Uri https://github.com/ledocorp/fxpipe/releases/download/v0.1.0/fxpipe-0.1.0-windows-x86_64.zip -OutFile fxpipe.zip
Expand-Archive fxpipe.zip -DestinationPath .
.\bin\windows\fxpipe.exe --help

# Linux
curl -LO https://github.com/ledocorp/fxpipe/releases/download/v0.1.0/fxpipe-0.1.0-linux-x86_64.tar.gz
tar xzf fxpipe-0.1.0-linux-x86_64.tar.gz
./bin/linux/fxpipe --help

Optional: fxpipe-ir is the IR dual-path binary (same CLI).

Quick start

fxpipe --allow fixtures --workers 4 abc.txt empty.txt
fxpipe --allow fixtures --workers 2 --stdin < paths.txt

CLI

Flag / arg	Behavior
--allow <dir>	Required FsCap root
--workers N	Default 4; clamp 1..16
--stdin	Paths one per line (UTF-8); empty lines skipped
<path>…	Relative to allow or already under allow; no ..

Exit codes: 0 all hashed · 1 usage · 2 deny · 3 one or more hash failures (success lines still printed).

Rebuild from source

Needs fx 0.9.6+ with --cli, host/cap, host/concur nursery, BLAKE3 amalgamation, and this repo’s fx_pipe_ref.c:

fx build fxpipe_lib.fx -o out --emit-c --cli \
  --link fx_pipe_ref.c \
  --link <blake3>/blake3_amalg.c \
  --link <host>/cap/fx_cap_runtime.c \
  --link <host>/concur/fx_task_nursery.c \
  --link-include <blake3> \
  --link-include <host>/cap \
  --link-include <host>/concur

On Linux also link pthread (--link-lib pthread or -pthread as your toolchain expects). Same with --backend ir for IR.

Non-goals (v1)

Shell/{} templates · GNU parallel parity · Chan/spawn-closure language epic · tree mode (use fxblake3 --tree) · Tokio/Go identity · macOS prebuilt claim

Docs

• docs/FXPIPE.md — design summary
• docs/releases/ — release notes
• Language: ledocorp/fxlang

License

Copyright Shawn Londono · LedoCorp · GPL-3.0 — see LICENSE.