Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


node homespring.js <filename> [logging] [limit]

  • <filename> is required, and is the relative path to the file which contains the homespring program text
  • [logging] is optional and should be '0', 'f', or 'false' in order to keep logging disabled (default). Any other values will enable logging output
  • [limit] is optional. If it is included, [logging] must be specified. This is used to limit the number of steps the interpreter will run before quitting regardless of program state.
  • If [logging] is specified, debugging will also be enabled. Debugging mode requires you to hit enter between each step. If both [logging] and [limit] are defined, debugging stays off (the default).

node homespring.js examples/hello-3.hs
node homespring.js examples/hello-1.hs true 10


download and install Node.js



Homespring, alternatively HOtMEfSPRIbNG, is a high-level esoteric programming language created by Jeff Binder in 2003 with the express intention of being far higher level than anyone would ever reasonably need or want. Programs define a map of data control segments through which data flows sequentially and deterministically, and all commands are based on a metaphor of salmon travelling upriver. Each datum is an object consisting of a character string called the "name" and a boolean called the "age" of the datum. Three classes of command can change the value of data (name or age), the behavior of each datum (this behavior can be fixed or vary based on each datum), and the whole of the map on which the data flow. The name stands for Hatchery Oblivion through Marshy Energy from Snowmelt Powers Rapids Insulated but Not Great.

This is very much a work in progress. Starting with making the examples in the pdf work, then let's see what happens.


  • v0.1.0 documentation says snow and water ticks are post order, I am doing them pre-order so snow and water only move downstream 1 level per tick. This seems to parallel how the interpreter is implemented in v0.1.0.
  • v0.1.0 documentation says of springs: "it creates water." I have implemented them the same as snowmelt so this is changed to: "Creates water at the end of each water tick." This means that water starts flowing downstream in the second tick. This was done to get hello-3.hs to work correctly.
  • for reverse/force down/up: The documentation does not specify, but some examples (add.hs and others) seem to suggest that the fish is not only pushed up to the first/second child, but is also changed to an upstream fish.


No releases published


No packages published
You can’t perform that action at this time.