mirror of
https://github.com/idris-lang/Idris2.git
synced 2024-09-11 13:36:08 +03:00
The previous command does not work in any shell I am aware of. The new one directly opens the library documentation in $BROWSER if it is set and otherwise just echos the path to index.html.
215 lines
7.3 KiB
Markdown
215 lines
7.3 KiB
Markdown
# Installation
|
|
|
|
- [Installing with a package manager](#installing-with-a-package-manager)
|
|
- [Installing from source](#installing-from-source)
|
|
- [Installing Chez Scheme on Apple Silicon](#installing-chez-scheme-on-apple-silicon)
|
|
|
|
## Installing with a package manager
|
|
|
|
You can install Idris 2 with any one of a number of package managers.
|
|
|
|
### Installing with [Pack](https://github.com/stefan-hoeck/idris2-pack)
|
|
Pack comes with an installation of Idris 2, so you just need to install Pack.
|
|
See [the installation instructions](https://github.com/stefan-hoeck/idris2-pack/blob/main/INSTALL.md)
|
|
on GitHub.
|
|
### Installing with [Homebrew](https://brew.sh/)
|
|
```sh
|
|
brew install idris2
|
|
```
|
|
### Installing with [Nix](https://nixos.org/features.html)
|
|
```sh
|
|
nix-env -i idris2
|
|
```
|
|
### Installing with [Nix Flakes](https://nixos.wiki/wiki/Flakes)
|
|
```sh
|
|
nix profile install github:idris-lang/Idris2
|
|
```
|
|
|
|
## Installing from source
|
|
|
|
The easiest way to install from source is via the existing generated Scheme
|
|
code. The requirements are:
|
|
|
|
- A Scheme compiler; either Chez Scheme (default), or Racket.
|
|
- `bash`, `GNU make`, `gcc` or `clang`, `sha256sum` and `GMP`. On Linux, you probably already
|
|
have these. On macOS and major BSD flavours, you can install them using a
|
|
package manager: for instance, on macOS, you can install with the
|
|
`brew install coreutils gmp` and on OpenBSD, with the `pkg_add coreutils
|
|
bash gmake gmp` command. You specifically need the dev GMP library, which
|
|
means on some systems the package you need to install will be named
|
|
something more like `libgmp3-dev`. macOS ships with `clang` whereas `gcc` is
|
|
more common for other \*nix distributions.
|
|
|
|
On Windows, it has been reported that installing via `MSYS2` works
|
|
[MSYS2](https://www.msys2.org/). On Windows older than Windows 8, you may need
|
|
to set an environment variable `OLD_WIN=1` or modify it in `config.mk`.
|
|
|
|
On Raspberry Pi, you can bootstrap via Racket.
|
|
|
|
By default, code generation is via Chez Scheme. You can use Racket instead,
|
|
by setting the environment variable `IDRIS2_CG=racket` before running `make`.
|
|
If you install Chez Scheme from source files, building it locally,
|
|
make sure you run `./configure --threads` to build multithreading support in.
|
|
|
|
**NOTE**: On FreeBSD, OpenBSD and NetBSD you need to use `gmake` command instead
|
|
of `make` in the following steps.
|
|
|
|
**NOTE**: If you're running macOS on Apple Silicon (arm64) you will need to use
|
|
Chez scheme version `10.0.0` or greater. Homebrew has been updated to ship Chez
|
|
Scheme 10+ as of this writing. If you cannot install Chez Scheme 10+, install
|
|
the Racket fork of chez scheme as described
|
|
[below](#installing-chez-scheme-on-apple-silicon). If you install gmp via
|
|
homebrew, you will also need to `export CPATH=/opt/homebrew/include`.
|
|
|
|
### 1: Set installation target directory
|
|
|
|
- Change the `PREFIX` in `config.mk` to the absolute path of your chosen
|
|
installation destination. The default is to install in `$HOME/.idris2`
|
|
|
|
If you have an existing Idris 2, go to Step 3. Otherwise, read on...
|
|
|
|
Make sure that:
|
|
|
|
- `$PREFIX/bin` is in your `PATH`
|
|
|
|
Further, on Apple silicon Macs (M1/M2), you need to set the following environment
|
|
variables:
|
|
|
|
``` sh
|
|
export IDRIS2_LIBS=/opt/homebrew/lib
|
|
export CPATH=/opt/homebrew/include:/opt/homebrew/lib
|
|
```
|
|
|
|
### 2: Installing without an existing Idris 2
|
|
|
|
You can build from pre-built Chez Scheme source, as long as you have Chez Scheme
|
|
installed (or, alternatively, Racket). To do this, enter one of the following:
|
|
|
|
- `make bootstrap SCHEME=chez`
|
|
- `make bootstrap-racket`
|
|
|
|
`chez` is the executable name of the Chez Scheme compiler. You may need to
|
|
replace this with the executable for Chez Scheme on your system. This could be
|
|
`scheme`, `chezscheme` or `chezscheme9.5` or something else, depending on your
|
|
system and the Chez Scheme version.
|
|
|
|
This builds an Idris 2 compiler from scheme code output from a working Idris 2
|
|
compiler (which isn't necessarily up to date, but is up to date enough to
|
|
build the current repository). It then rebuilds using the result, and runs
|
|
the tests.
|
|
|
|
If all is well, to install, type:
|
|
|
|
- `make install`
|
|
|
|
If you are building with Racket, you'll need to run `IDRIS2_CG=racket make install`.
|
|
|
|
### 3: Installing with an existing Idris 2
|
|
|
|
If you have the latest *released* version of Idris 2
|
|
(0.6.0 at the time of writing) installed:
|
|
|
|
- `make all`
|
|
- `make install`
|
|
|
|
### 4: (Optional) Installing Idris 2 library documentation
|
|
|
|
After `make install`, type `make install-libdocs` to install Idris 2 library documentation. After
|
|
that, the index file can be found here: ``"${BROWSER:-echo}" "$(idris2 --libdir)"/docs/index.html``
|
|
|
|
### 5: (Optional) Self-hosting step
|
|
|
|
As a final step, you can rebuild from the newly installed Idris 2 to verify
|
|
that everything has worked correctly. Assuming that `idris2` is in your
|
|
`PATH`.
|
|
|
|
- `make clean` -- to make sure you're building everything with the new version
|
|
- `make all && make install` -- OR
|
|
`make all IDRIS2_BOOT='idris2 --codegen racket' && make install`
|
|
if using Racket.
|
|
|
|
### 6: Running tests
|
|
|
|
After `make all`, type `make test` to check everything works. This uses the
|
|
executable in `./build/exec`.
|
|
|
|
### 7: (Optional) Enabling incremental compilation
|
|
|
|
If you are working on Idris, incremental compilation means that rebuilds are
|
|
much faster, at the cost of runtime performance being slower. To enable
|
|
incremental compilation for the Chez backend, set the environment variable
|
|
`IDRIS2_INC_CGS=chez`, or set the `--inc chez` flag in `idris2.ipkg`.
|
|
|
|
### 8: (Optional) Installing the Idris 2 API
|
|
|
|
You'll only need this if you're developing support tools, such as an external
|
|
code generator. To do so, once everything is successfully installed, type:
|
|
|
|
- `make install-api`
|
|
|
|
The API will only work if you've completed the self-hosting step (step 5), since
|
|
the intermediate code versions need to be consistent throughout. Otherwise, you
|
|
will get an `Error in TTC: TTC data is in an older format` error.
|
|
|
|
### 9: (Optional) Shell Auto-completion
|
|
|
|
Idris2 supports tab auto-completion for Bash-like shells.
|
|
|
|
#### For Bash Users
|
|
|
|
From within bash, run the following command:
|
|
|
|
```sh
|
|
eval "$(idris2 --bash-completion-script idris2)"
|
|
```
|
|
|
|
You can also add it to your `.bashrc` file.
|
|
|
|
#### For ZSH Users
|
|
|
|
From within ZSH, run the following commands:
|
|
|
|
```sh
|
|
eval "$(idris2 --zsh-completion-script idris2)"
|
|
```
|
|
|
|
ZSH auto-completion is implemented via `bashcompinit`.
|
|
|
|
You can also add them to your `.zshrc` file.
|
|
|
|
### Troubleshooting
|
|
|
|
If you get the message `variable make-thread-parameter is not bound` while
|
|
bootstrapping via Chez Scheme, or while running the tests when bootstrapping via
|
|
Racket, then your copy of Chez Scheme was built without thread support. Pass
|
|
`--threads` to `./configure` while building Chez Scheme to correct the issue.
|
|
|
|
## Running in text editor
|
|
|
|
### Run on emacs using nix flakes
|
|
|
|
If you are a [nix flakes](https://nixos.wiki/wiki/Flakes) user you can run
|
|
Idris 2 in emacs by running the following command:
|
|
|
|
```sh
|
|
nix run github:idris-lang/Idris2#emacs-with-idris idrisCode.idr
|
|
```
|
|
|
|
## Installing Chez Scheme on Apple Silicon
|
|
|
|
Chez scheme only supports Apple Silicon for versions `10.0.0` or newer.
|
|
|
|
Homebrew bundles Chez Scheme 10+ so if that's your manager of choice, you don't
|
|
need to read on.
|
|
|
|
If you cannot install that new of a version of Chez Scheme, you will need to
|
|
build and install the Racket fork of chez scheme.
|
|
|
|
```sh
|
|
git clone git@github.com:racket/ChezScheme.git
|
|
cd ChezScheme
|
|
./configure --threads
|
|
make
|
|
sudo make install
|
|
```
|