HowToUse

How to use

How to install

You need to run the installation script. The installation script can be executed as follows:

$ curl https://raw.githubusercontent.com/ktakashi/scheme-env/master/bin/install.sh | bash

If you don't have sudo right and running on Ubuntu, you can also disable the auto package resolution for host Scheme system by specifying SCHEME_ENV_INSTALL_PACKAGE environment variable no.

$ SCHEME_ENV_INSTALL_PACKAGE=no curl https://raw.githubusercontent.com/ktakashi/scheme-env/master/bin/install.sh | bash

After the installation, you need to add ~/.scheme-env/bin to your $PATH environment variable.

How to add implementations

You can add implementations using install command. The following example shows the installation command of Chibi Scheme (master).

$ scheme-env install chibi-scheme

You can also specify the version with implementation name followed by @version like this:

$ scheme-env install [email protected]

To show the list of supported implementation, you need run the install command without specifying implementation like this:

$ scheme-env install

The above command shows the list of supported implementation.

How to run the installed Scheme system

You can use run command followed by implementation@version like this:

$ scheme-env run [email protected]

For convenience, the tool has default implementation. To run the default implementation, you can simply execute the run command without specifying implementation like this:

$ scheme-env run

By default, the default implementation is the same as host Scheme system (the latest Sagittarius). To switch the default implementation, you can use switch command like this:

$ scheme-env switch [email protected]

Removing installed Scheme system

Sometimes you want to remove installed Scheme systems. (free up your HDD or so?). In such a case, you can use remove command like this:

$ scheme-env remove [email protected]

Then the specified Scheme system will be removed from your Scheme Environment Tool.

NOTE: this command cannot be done to host Scheme system (the latest Sagittarius)

Adding external library

You can install external libraries by using sitelib command

Below is an example: $ scheme-env sitelib climate lib/

The sitelib command supports catalog install as well. The format of a catalog is as follows:

(
  (name "$library")        ;; library name
  (implementation "$impl") ;; [Optional] specific implementation
  (archive "$uri")         ;; location of the archive file
  (source "$uri")          ;; Directory to be copied
)