@blockstack/clarity-native-bin
v0.3.15
Published
Library for providing the native Clarity CLI binary
Maintainers
Readme
@blockstack/clarity-native-bin
This package installs the system-specific native clarity-cli binary.
The JS module also provides programmatic access to the binary file path and the installation functions.
Installation
An installation script runs automatically when this package is installed via npm install (or an equivalent package install tool/command). Pre-built dist files are downloaded if the platform & arch is supported, otherwise, it attempts to compile the binary from source.
Controlling Installation Options
Force install via source compilation by specifying either the BLOCKSTACK_CORE_SOURCE_TAG or BLOCKSTACK_CORE_SOURCE_BRANCH
environment variables. The variable must be available during the npm install script. If found then the script will not attempt to download
a pre-compiled distributable. The value must be set to a git tag or branch on the https://github.com/blockstack/blockstack-core
repo.
To move a local copy of the clarity-cli binary from a different folder on your machine, include the environment variable BLOCKSTACK_CORE_SOURCE_PATH.
For example, the following commands test a blockstack-core repo feature branch using the clarity-tutorials package:
git clone [email protected]:blockstack/clarity-js-sdk.git
cd clarity-js-sdk
BLOCKSTACK_CORE_SOURCE_BRANCH="feature/new-thing" npm install
cd packages/clarity-tutorials
npm testOr, for an already setup local SDK dev environment, trigger an npm install of this package. Examples:
cd clarity-js-sdk
BLOCKSTACK_CORE_SOURCE_BRANCH="feature/new-thing" npm run rebuildOr
cd clarity-js-sdk/packages/clarity-native-bin
BLOCKSTACK_CORE_SOURCE_BRANCH="feature/new-thing" npm installSource Compilation Requirements
If compiling from source then the Rust toolchain and a C compiler must be available.
