node package manager

horten

The ultimate global variable.

This module has been a work in progress for years, but there's still no docs. Sorry about that.

Conventions

Horten does things a little differently than comparable modules.

Horten pathes are lists of keys which allow deep access to objects.

var value = {
  foo: {
    bar: {
      baz: 42
    }
  }
}
 
var result = H.get( value, 'foo/bar/baz/' )
 
assert.equal( result, 42 )

For various historical reasons, the canonical String representation of paths is delimited by '/' with a trailing slash. Deal with it.

Mutants are Horten's method for encapsulating mutable object operations, while maintaining immutability of inputs and outputs. For example:

  var value = { foo: 'bar', baz: 'bop' }
      , mutant = H.Mutant( value )
 
  mutant.set( 42, 'foo' )
 
  assert.deepEqual( mutant.get(), { foo: 42, baz: 'bop' } )
 

Echo objects are used to control echoing of change between Horten systems.