An auto tiler for macOS
parcel Scripts Tooling.md
2.7 kB · 53 lines
Markdown
at main

Developer tools #

Run Scripts/parcel-dev.sh COMMAND [ARGUMENTS]. Both commit hooks use this wrapper. It builds parcel-dev in release once, then runs the cached executable. The cache keys source contents, the package manifest/resolution, wrapper, and compiler/SDK selection—not modification dates. Implicit, explicit, and symlinked selections of the same SDK share the cache. Identical rewrites and unrelated app edits do not rebuild it. Concurrent callers share one build; failed builds stop the command without certifying the old executable. PARCEL_DEV_BINARY selects an already-built executable for isolated fixtures. PARCEL_DEV_ROOT is the caller's checkout, not the binary's.

The executable lives in the main package without app dependencies or resources. That keeps one test plan and reuses product settings and version validation. The release tool uses .build/parcel-dev as its own SwiftPM cache. Script fixtures can therefore bootstrap it while their parent test process holds the app cache's lock. The catalog plugin has an explicit tool dependency; native bundle planning uses the bundle script's prebuilt executable. The warm staged name check executes the binary, not SwiftPM. Casks use the pinned Ruby syntax checker; workflows use a small strict parser rather than another dependency.

Former helper Command or test replacement
name-guard name-guard check / name-guard generate
launch-feed launch-feed
launch-policy policy-*
release-order release-order
update-metadata update-metadata
generate-update-key generate-update-key
check-workflows check-workflows
check-binaries check-binaries
check-ruby-syntax check-ruby-syntax
install-tools install-tools
install-bundle install-bundle
strip-binary-paths strip-binary-paths
bench-ab-summary bench-ab-summary
bench-identity bench-identity
idle-summary idle-summary
quiet-readings quiet-readings
trace-summary trace-summary
tests/workflows WorkflowTests / WorkflowContractTests
tests/launch-interactive InteractiveLaunchTests
tests/measurement-tests Measurement*Tests

Native implementations are in Sources/ParcelDev. Pure and fixture-driven tests are in Tests/ParcelDevTests; naming-policy oracles remain in Scripts/tests/NameGuardTests. mise run test:scripts runs them and every shell fixture. Unit and live-window lanes stay separate.

Update keys use CryptoKit. Explicit keychain access uses the system security frontend with secret input on stdin, never process arguments. It verifies the stored seed and never changes the keychain search list or default keychain.