A command-line tool to install PureScript to the current working directory
- First, it checks if a PureScript binary has been already cached in a disk, and restores that if available
- The second plan: if no cache is available, it downloads a prebuilt binary from the PureScript release page.
- The last resort: if no prebuilt binary is provided for the current platform or the downloaded binary doesn't work correctly, it downloads the PureScript source code and compile it with Stack.
In most cases users don't need to install this CLI directly, but would rather use the purescript npm package.
npm install purescript-installer
Once this package is installed to the project directory, users can execute install-purescript command inside npm scripts.
Usage:
install-purescript [options]
Options:
--purs-ver <string> Specify PureScript version
--name <string> Change a binary name
Default: 'purs.exe' on Windows, 'purs' on others
Or, if the current working directory contains package.json
with `bin` field specifying a path of `purs` command,
this option defaults to its value
--help, Print usage information
--version Print version
Also, these flags are passed to `stack install` command if provided:
--dry-run
--pedantic
--fast
--only-snapshot
--only-dependencies
--only-configure
--trace
--profile
--no-strip
--coverage
--no-run-tests
--no-run-benchmarks
If you'd like to contribute to this project, here are instructions for testing your changes locally:
Checkout code and create global link to PS installer package:
git clone https://github.com/purescript/npm-installer.git
cd npm-installer
npm link
Create another project for testing, and add linked PS installer:
cd ..
mkdir test-installer
cd test-installer
npm init -y
npm link purescript-installer
Test PS installer. You may re-run this command without repeating any of the above steps to pick-up new PS installer changes.
npx install-purescript
ISC License © 2017 - 2019 Watanabe Shinnosuke