A fast, standalone Rust reimplementation of MacPorts port CLI, with parallel downloads, platform-aware indexes
README.md

port-rs #

Rust

A standalone Rust implementation of the MacPorts port CLI, built with clap, Tokio, and reqwest. No Tcl runtime or existing MacPorts executable required; SQLite is bundled.

Every port action is implemented, from queries to source and binary installs, upgrades, snapshots, sync, lint and installer packages, with the documented differences. Test it against a separate prefix (see PORTSRC in the guide) before using it on an existing MacPorts installation.

sudo port install neovim

Install #

On macOS (Apple Silicon or Intel), install the latest release with:

curl -fsSL https://raw.githubusercontent.com/tsirysndr/macports-rs/main/install.sh | sh

This installs port into /usr/local/bin (using sudo when needed) after checking the download against its published SHA-256. Set PORT_RS_VERSION to install a specific tag, or PORT_RS_INSTALL_DIR to choose another directory. If MacPorts is also installed, whichever port comes first in PATH runs. port selfupdate later replaces the binary with newer releases. The installer also links portindex, which the same binary provides.

Quick start #

Use macOS (Apple Silicon or Intel) with the stable Rust toolchain and Xcode Command Line Tools.

cargo build --release --locked
./target/release/port --help
./target/release/port search --name curl
./target/release/port info --index curl
./target/release/port -y install curl

The first index query downloads and caches the index for your Mac's CPU and Darwin version. Use --index-file PATH or PORT_RS_INDEX for a local index. For local Portfile evaluation, select a ports tree containing a PortIndex and its Portfiles; the downloaded index alone only supports indexed queries. A tree without an index can be indexed with portindex (or by listing it as a file:// source in sources.conf and running port sync).

Binary archives #

port install prefers signed binary archives from the MacPorts package servers. A port whose archive is available needs only its runtime dependencies, so build-only dependencies are skipped. All archives an install needs are downloaded concurrently before installation starts, up to four transfers at a time. Set fetch_threads in macports.conf to change the limit (1 to 128):

fetch_threads 8

The downloaded archives are then unpacked and inspected in parallel, one per CPU core. Storing, registering and activating still run one port at a time, in dependency order, so activation hooks see the same state as with MacPorts.

Ports without an archive, or whose download fails, are built from source. -s always builds from source and -b requires binaries.

Benchmarks #

Read-only queries against the same ports tree (42,470 ports) and registry as MacPorts 2.12.7, on an Apple M4 (10 cores, macOS 15.6). Best of 20 runs per command, both binaries interleaved:

Command MacPorts port-rs Speedup
port version 69 ms 6 ms 11.6×
port info curl 245 ms 63 ms 3.9×
port search --name curl 189 ms 143 ms 1.3×
port list curl 198 ms 26 ms 7.6×
port deps curl 273 ms 58 ms 4.7×
port variants curl 222 ms 66 ms 3.4×
port rdeps curl 833 ms 595 ms 1.4×
port echo all 2018 ms 137 ms 14.8×
port installed 83 ms 8 ms 10.6×
port outdated 94 ms 27 ms 3.5×

The index is read lazily: only record boundaries are scanned up front, and a port's fields are parsed when it is first looked up, so single-port queries (info, deps, list, outdated) skip most of the 26 MB PortIndex. Portfile evaluation reads the Xcode version from the selected Xcode's version.plist instead of running xcodebuild. Queries that visit every port (search, rdeps) still parse the whole index. Reproduce with:

cargo build --release --locked
python3 scripts/compare.py target/release/port

Development #

cargo fmt --all --check
cargo clippy --locked --all-targets -- -D warnings
cargo test --locked --workspace
cargo build --locked --release
cargo bench --locked --bench index

Tests run offline after dependencies are installed; HTTP tests use local servers. CI targets macOS aarch64-apple-darwin and x86_64-apple-darwin only.

The project is a Cargo workspace:

Crate Purpose
crates/port-core/ Catalog parsing, selectors, port specifications, dependency graphs, progress and terminal output
crates/port-registry/ SQLite registry queries, transactions and snapshots, through sqlx with sea-query statements
crates/port-engine/ Portfile evaluation (portfile/), builds (build/), signed archives and installation (install/), configuration (config/)
crates/port-rs/ The port binary: CLI parsing, command handlers (src/commands/), integration tests and benchmarks
crates/molt/ Vendored Tcl interpreter and local patches

Contributing #

Pick a gap from the compatibility notes and include a regression test for the behavior you add or fix. Keep MacPorts command semantics and existing data formats compatible; unsupported behavior should fail explicitly. Use focused modules and conventional commits, and run the checks above before opening a pull request.

The main remaining work is complete Portfile/PortGroup support, source-phase scheduling, and end-to-end install, activation, upgrade, and uninstall. Performance comparisons with the original port are still needed.

Documentation #

License #

MIT — Copyright (c) 2026 Tsiry Sandratraina tsiry.sndr@rocksky.app.