lively.lang 

What? This project packages abstractions for JavaScript that proved to be useful in
the Lively Web project. On first glance it might seem
to be just another underscore.js library but apart from extensions to existing
JavaScript objects and classes it also provides abstractions for asynchronous
code, new object representations, and functions for inspecting JavaScript
objects.

Why? Make it easy to reuse abstractions we found helpful in all kinds of
contexts. All features can be used in browser environments and in node.js.
Actually, one motivation for this library was to have unified interfaces across
JavaScript environments.

How? By default the library is non-invasive, i.e. no global objects are
modified. To use provided functions you can either

1. call them directly,
2. use underscore.js-like chain/value wrapping,
3. or install extension methods explicitly in global objects.

Summary

Utility functions for default JavaScript objects:

- Array
- String
- Number
- Object
- Function
- Date

Abstractions usually not included by default in JavaScript runtimes:

- node.js-like event emitter interface (uses event module on node.js)
- Path (deep property access)
- Interval
- Grid
- Tree
- array projection
- Closure
- Messengers (generic interface for remote-messaging)
- Workers based on messengers

Please see the individual doc files for detailed information.

$3

String utility methods for printing, parsing, and converting strings.

$3

* Utility functions for JS Numbers.

$3

* Utility functions that help to inspect, enumerate, and create JS objects

$3

-=-=-=-=-=-=-=-=-=-=-=-=-=-
js object path accessor
-=-=-=-=-=-=-=-=-=-=-=-=-=-

$3

* Methods to make working with arrays more convenient and collection-like
* abstractions for groups, intervals, grids.

$3

Accessor to sub-ranges of arrays. This is used, for example, for rendering
large lists or tables in which only a part of the items should be used for
processing or rendering. An array projection provides convenient access and
can apply operations to sub-ranges.

$3

A Grouping is created by arr.groupBy and maps keys to Arrays.

$3

Computation over graphs. Unless otherwise specified a graph is a simple JS
object whose properties are interpreted as nodes that refer to arrays whose
elements describe edges. Example:

``js
var testGraph = {
"a": ["b", "c"],
"b": ["c", "d", "e", "f"],
"d": ["c", "f"],
"e": ["a", "f"],
"f": []
}
`

$3

A grid is a two-dimaensional array, representing a table-like data

$3

Intervals are arrays whose first two elements are numbers and the
first element should be less or equal the second element, see
[interval.isInterval](). This abstraction is useful when working with text
ranges in rich text, for example.

$3


* Methods for traversing and transforming tree structures.

$3


* Abstractions around first class functions like augmenting and inspecting
* functions as well as to control function calls like dealing with asynchronous
* control flows.

$3

A Closure is a representation of a JavaScript function that controls what
values are bound to out-of-scope variables. By default JavaScript has no
reflection capabilities over closed values in functions. When needing to
serialize execution or when behavior should become part of the state of a
system it is often necessary to have first-class control over this language
aspect.

Typically closures aren't created directly but with the help of asScriptOf

Example:
function func(a) { return a + b; }
var closureFunc = Closure.fromFunction(func, {b: 3}).recreateFunc();
closureFunc(4) // => 7
var closure = closureFunc.livelyClosure // => {
// varMapping: { b: 3 },
// originalFunc: function func(a) {/.../}
// }
closure.lookup("b") // => 3
closure.getFuncSource() // => "function func(a) { return a + b; }"

$3


* Methods helping with promises (Promise/A+ model). Not a promise shim.

$3


* Util functions to print and work with JS date objects.

$3


* A pluggable interface to provide asynchronous, actor-like message
* communication between JavaScript systems. Provides a unified message protocol
* and send / receive methods.

$3


* A simple node.js-like cross-platform event emitter implementation that can
* be used as a mixin. Emitters support the methods: on(eventName, handlerFunc),
* once(eventName, handlerFunc), emit(eventName, eventData),
* removeListener(eventName, handlerFunc), removeAllListeners(eventName)`
* Example:
* var emitter = events.makeEmitter({});
* var log = [];
* emitter.on("test", function() { log.push("listener1"); });
* emitter.once("test", function() { log.push("listener2"); });
* emitter.emit("test");
* emitter.emit("test");
* log // => ["listener1","listener2","listener1"]
* emitter.removeAllListeners("test");
* emitter.emit("test");
* log // => is still ["listener1","listener2","listener1"]

$3

* A platform-independent worker interface that will spawn new processes per
* worker (if the platform you use it on supports it).

License

MIT License

$3

adapted from Underscore.js 1.3.3
© 2009-2012 Jeremy Ashkenas, DocumentCloud Inc.
Underscore is distributed under the MIT license.

$3

Date Format 1.2.3
© 2007-2009 Steven Levithan
MIT license
Includes enhancements by Scott Trenda
and Kris Kowal