husk-scheme: R5RS Scheme interpreter, compiler, and library.

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

Husk is a dialect of Scheme written in Haskell that implements a superset of the R5RS standard. Advanced features are provided including:

First-class continuations of unlimited extent
Hygienic macros based on syntax-rules
Low-level explicit renaming macros
Library syntax from the R7RS standard
A foreign function interface (FFI) to Haskell
Full numeric tower providing support for real, rational, and complex numbers
Proper tail recursion and lexical scoping
Read-Eval-Print-Loop (REPL) interpreter, with input driven by Haskeline to provide a rich user experience
Standard library of Scheme functions, and support for many popular SRFI's

Husk may be used as either a stand-alone interpreter or as an extension language within a larger Haskell application. By closely following the R5RS standard, the intent is to develop a Scheme that is as compatible as possible with other R5RS Schemes. Husk is mature enough for use in production, however it is not optimized for performance-critical applications.

Scheme is one of two main dialects of Lisp. Scheme follows a minimalist design philosophy: the core language consists of a small number of fundamental forms which may be used to implement other built-in forms. Scheme is an excellent language for writing small, elegant programs, and may also be used to write scripts or embed scripting functionality within a larger application.

For documentation and examples, see http://justinethier.github.io/husk-scheme/documentation.html.

For detailed information on each release, see http://justinethier.github.io/husk-scheme/news.html.

[Skip to Readme]

Properties

Versions	1.0, 1.1, 1.2, 1.3, 2.0, 2.1, 2.2, 2.3, 2.4, 3.0, 3.1, 3.2, 3.2.1, 3.3, 3.4, 3.4.1, 3.4.2, 3.4.3, 3.4.4, 3.5.1, 3.5.2, 3.5.2.1, 3.5.2.2, 3.5.2.3, 3.5.3, 3.5.3.1, 3.5.3.2, 3.5.4, 3.5.5, 3.5.6, 3.5.7, 3.6, 3.6.1, 3.6.2, 3.6.3, 3.7, 3.8, 3.9, 3.10, 3.11, 3.12, 3.13, 3.14, 3.15, 3.15.1, 3.15.2, 3.16, 3.16.1, 3.17, 3.17.1, 3.18, 3.19, 3.19.1, 3.19.2, 3.19.3, 3.19.3, 3.20
Change log	ChangeLog.markdown
Dependencies	array, base (>=2.0 && <5), bytestring, containers, directory, filepath, ghc, ghc-paths, haskeline, husk-scheme, knob, mtl, parsec, process, time, transformers, utf8-string [details]
License	MIT
Author	Justin Ethier
Maintainer	Justin Ethier <github.com/justinethier>
Category	Compilers/Interpreters, Language
Home page	http://justinethier.github.com/husk-scheme
Bug tracker	http://github.com/justinethier/husk-scheme/issues
Source repo	head: git clone git://github.com/justinethier/husk-scheme.git
Uploaded	by JustinEthier at 2016-07-10T01:13:33Z

Modules

[Index]

Language
- Scheme

Flags

Automatic Flags

Name	Description	Default
usedebug	Include debug trace statements in compiled code.	Disabled
useffi	Haskell Foreign Function Interface (FFI). Allows husk to import and call into Haskell code directly from Scheme code. Turn off FFI to decrease build times and minimize executable sizes	Disabled
uselibraries	R7RS-style libraries.	Enabled
useptrs	Turn off pointers to increase performance at the expense of severely restricting the functionality of mutable variables. Setting this flag to false will revert back to the behavior from older versions of husk.	Enabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

husk-scheme-3.19.3.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

JustinEthier

For package maintainers and hackage trustees

edit package information

Readme for husk-scheme-3.19.3

[back to package description]

Husk is a dialect of Scheme written in Haskell that implements a superset of the R⁵RS standard and a large portion of the R⁷RS-small language. Advanced features are provided including continuations, hygienic macros, libraries, and a full numeric tower.

Husk may be used as either a stand-alone interpreter or as an extension language within a larger Haskell application. By closely following the R⁵RS standard, the intent is to develop a Scheme that is as compatible as possible with other R⁵RS Schemes. Husk is mature enough for use in production applications, however it is not optimized for performance-critical applications.

More information is available on the husk website.

Installation

Prerequisites: You will need the Haskell Platform if you don't already have a recent copy installed.

Install Husk using cabal:

 cabal update
 cabal install husk-scheme

Adjust your PATH: Before running Husk you may also need to add the cabal executable directory to your path. On Linux this is ~/.cabal/bin.

Now you are ready to start up the interpreter:

 justin@my-pc$ huski
   _               _        __                 _                          
  | |             | |       \\\               | |                         
  | |__  _   _ ___| | __     \\\      ___  ___| |__   ___ _ __ ___   ___  
  | '_ \| | | / __| |/ /    //\\\    / __|/ __| '_ \ / _ \ '_ ` _ \ / _ \ 
  | | | | |_| \__ \   <    /// \\\   \__ \ (__| | | |  __/ | | | | |  __/ 
  |_| |_|\__,_|___/_|\_\  ///   \\\  |___/\___|_| |_|\___|_| |_| |_|\___| 
                                                                      
  http://justinethier.github.com/husk-scheme                              
  (c) 2010-2014 Justin Ethier                                             
  Version 3.18 
                                                                      
 huski> (define (hello) 'world)
 (lambda () ...)
 huski> (hello)
 world

Husk has been tested on Windows, Linux, and FreeBSD.

Documentation

The online user manual provides an overview of the Scheme language as implemented by Husk, including:

A getting started guide.
Instructions for using the Haskell API
An alphabetical listing of the Scheme API.

Directory Structure

docs - Documentation has been moved from here to the gh-pages branch.
examples - Example programs, mostly written in Scheme.
extensions - Haskell-based extensions to Husk.
hs-src - Haskell source code for Husk.
lib - Library portions of Husk written in Scheme.
scripts - Build scripts for Husk and a basic Emacs integration script.
tests - Functional tests for Husk. These can be run automatically by using make test from the main Husk directory.

License

Husk scheme is available under the MIT license.

The interpreter is based on code from the book Write Yourself a Scheme in 48 Hours written by Jonathan Tang and hosted / maintained by Wikibooks.