chibi-scheme - a tiny Scheme interpreter
script argument ...
is a sample interactive Scheme interpreter for the
library. It serves as an example of how to embed
in applications, and can be useful on its own for writing
scripts and interactive development.
is given, the script will be loaded with SRFI-22 semantics,
calling the procedure
(if defined) with a single parameter as a list of the
command-line arguments beginning with the script name. This
works as expected with shell #! semantics.
Otherwise, if no script is given and no -e or -p options
are given an interactive repl is entered, reading, evaluating,
then printing expressions until EOF is reached. The repl
provided is very minimal - if you want readline
completion you may want to wrap it with the
program. Signals aren't caught either - to enable handling keyboard
interrupts you can use the (chibi process) module. For a more
sophisticated REPL with readline support, signal handling, module
management and smarter read/write you may want to use the (chibi repl)
module. This can be launched automatically with:
For convenience the default language is the
(scheme small) module, which includes every library in the R7RS
small standard, and transitively some other dependencies. All of this
together is actually quite large, so for a more minimal startup
language you'll want to use the
option described below.
To get a mostly R5RS-compatible language, use
or to get just the core language used for bootstrapping, use
or its shortcut
Space is optional between options and their arguments. Options
without arguments may not be chained together.
To reduce the need for shell escapes, options with module arguments
) are written in a dot notation, so that the module
is written as
Prints the version information and exits.
"Quick" load, shortcut for
This is a slightly different language from (scheme base),
which may load faster, and is guaranteed not to load any
additional shared libraries.
Extra "quick" load, shortcut for
The resulting environment will only contain the core syntactic
forms and primitives coded in C. This is very fast and guaranteed
not to load any external files, but is also very limited.
Run the "main" procedure when the script finishes loading as in SRFI-22.
Loads the given module and runs the "main" procedure it defines (which
need not be exported) with a single argument of the list of command-line
arguments as in SRFI-22. The name "main" can be overridden with the -r
may be omitted, in which case it defaults to chibi.repl. Thus
is the recommended means to obtain the advanced REPL.
Strict mode, escalating warnings to fatal errors.
Change the reader to case-fold symbols as in R5RS.
Disables tail-call optimization. This can be useful for
debugging in some cases, but also makes it very likely to
overflow the stack.
Specifies the initial size of the heap, in bytes,
optionally followed by the maximum size the heap can
can be any integer value, optionally suffixed by
"K", for kilobytes, "M" for megabytes, or "G" for gigabytes.
must be specified before any options which load or
evaluate Scheme code.
on front of the load path list.
to the load path list.
to the feature list, useful for cond-expanding different
as though "(import
)" were evaluated.
version is used, then
replaces the current environment instead of being added to it.
Loads the Scheme source from the file
searched for in the default load path.
Evaluates the Scheme expression
Evaluates the Scheme expression
then prints the result to stdout.
Enables tracing for the given identifier
in the module
Dumps the current Scheme heap to
and exits. This feature is still experimental.
Loads the Scheme heap from
instead of compiling the init file on the fly.
This feature is still experimental.
A colon separated list of directories to search for module
files, inserted before the system default load paths. chibi-scheme
searchs for modules in directories in the following order:
- directories included with the -I path option
- directories included from CHIBI_MODULE_PATH
- system directories
- directories included with -A path option
If CHIBI_MODULE_PATH is unset, the directories "./lib", and "." are
search in order.
Alex Shinn (alexshinn @ gmail . com)
More detailed information can be found in the manual included in
doc/chibi.scrbl included in the distribution.
The chibi-scheme home-page:
Markup created by unroff 1.0sc, March 04, 2023.