STklos Reference Manual
ScmPkg is a package distribution system for Scheme. It is currently supported by Bigloo and Stklos. This package system provides new APIs to Scheme (e.g., network programming, cryptography, encoding, ...) and it manages automatic package installation, deinstallation and testing.
11.1 ScmPkg "tutorial"
stklos-pkg is the command which gives access to ScmPkg in STklos. This is the only command necessary to manage ScmPkg packages. For instance, this command manages a local cache of the ScmPkg server, permits (de)installation of ScmPkg packages, the test of packages, ...
To start, we can synchronize our local repository with the ScmPkg servers. This can be done by the following command:
This will download a description of the ScmPkg packages which are available. The list of these packages can be displayed with:
Packages whose name start by an underscore are packages needed for alien language support (e.g. the package "_bigloo" is necessary to run a package written in the Bigloo Scheme dialect, or the package "_chicken-net" is necessary for the packages using the network primitives of the Chicken Scheme dialect). Some packages my offer a tuning. A tuned package is a package which has been specially tuned for STklos (e.g. the generic "srfi1" package which implement SRFI-1 has been tuned to be more efficient in STklos)
To download a new package (and all its dependencies), one can simply issue the following command:
This command downloads the package PKG, it dependencies and (eventually) its tuning. It also creates a Makefile for compiling the package. The --directory option specifies where the files must be extracted in the /tmp/Test directory (instaed of the current directory). The generated Makefile offers the following main targets
To test a package, one can also use the following command:
This downloads the necessary files in a temporary directory, and launches the tests of the package PKG
To install a package, one can also use the following command:
This downloads the necessary files in a temporary directory, and installs the package PKG
This completes the basis ScmPkg tutorial. See below for the list of all stklos-pkg options
11.2 stklos-pkg options
Here are the options supported by the stklos-pkg command