Note: We have moved aspen to the Passerine monorepo, which can be found here. As a result, this repository is out of date and has been archived.

aspen

Passerine's package manager.

Getting Started

To install the aspen command, run this in the shell of your choice:

bash <(curl -sSf https://www.passerine.io/install.sh)

Note: The above shell script no longer works. We recommend you use this instead:

cargo install passerine-aspen

This requires git and a recent version of Cargo to work. You can inspect the contents of install.sh first if you want, we're not trying to play any tricks on you.

2. Start a new Passerine project using Aspen:

aspen new example

3. This will create a project named example in the current directory. Open this project and look through it in your editor of choice.
4. To run the project:

cd example
aspen run

aspen run and most other commands optionally take a path to the project root.

Commands

NOTE: Not all commands are implemented ATM. Commands in bold are partially or wholly implemented.

Command	Result
update	Updates the Passerine toolchain.
new	Creates a new Passerine package.
publish	Publishes package to the registries in Aspen.toml.
pull	Pulls fresh packages from the registries in Aspen.toml.
add	Adds a dependency to Aspen.toml.
run	Builds and runs the corresponding Passerine package.
repl	Opens a fresh repl session.
test	Builds and runs the package's tests.
bench	Builds and runs the package's benchmarks.
doc	Builds the package's documentation.
debug	Builds and runs the package in interactive debug mode.

An optional path to the project root may be provided.