A collection of utilities for Gerbil Scheme.
This collection homesteads the toplevel name
clan in the global package namespace.
It is intended to host utilities that, if and when complete, well-designed and well-documented,
are headed for the
std/ hierarchy of standard libraries,
but are not there yet (and for some of them may never be).
Maintenance of the utilities is collegial, with fare as current lead maintainer.
All who are welcome to join the effort,
as long as they are ready to uphold high standards of quality as they collaborate
on the joint code base;
and even those who do not have the time and dedication to be maintainers
can contribute code, documentation, and suggestions.
You can install using the Gerbil package manager:
gxpkg install github.com/fare/gerbil-utils
Alternatively, you can clone the repo and build the utils using the build script:
$ git clone https://github.com/fare/gerbil-utils.git $ cd gerbil-utils $ gxpkg link github.com/fare/gerbil-utils $PWD $ ./build.ss
If you are using NixOS or nixpkgs, see also the file
for interactive development of Gerbil software.
Contribution by all Gerbil hackers is welcome, as the current curator though, I may insist that all code should follow a style and naming conventions that are consistent with the existing body of code, or at least with themselves (which weaker requirement only applies for code that doesn't interact strongly with the rest of the codebase).
The APIs of functions in this collection should not be considered stable unless otherwise noted;
still, efforts are being made to not gratuitously introduce backward incompatibility.
When the APIs are stable, the functions and macros will be moved to the standard library,
under the prefix
std/ instead of
clan/ --- though slightly different style standards may
apply there, as vyzo is the curator and may have different tastes.
That said, current version of
gerbil-utils requires Gerbil v0.16 or later to work.