glutils

glutils
=====

Synopsis

Utilities to help someone code the way Greg Little (dglittle) does.
Based on https://github.com/dglittle/gl519

Description

This utility library is compiled over the years by Greg Little to support his - minimum dependencies - maximum code lifetime - rely on the language vs the libraries - unique coding style.
It consists of five distinct sections

- glutils-js - These are functions that should/could have been part of the javascript language itself. Most of them enable a functional programming style - others are just fixes for well known deficiencies of javascript:
has, identity, each, map, filter, reduce, some, every, rename, min, max, find, range,
size, deepEquals, keys, values, merge, clone, deepClone, pairs, object, pick, omit, setAdd,
makeSet, inSet, setSub, bagAdd, listAdd, lerp, lerpCap, time, trim, lines, sum, sample, shuffle,
randomInt, randomString, sort, sortDesc, toArray, ensure

- glutils-browser : Common helper functions for the browser.
escapeUnicodeChar, escapeString, escapeRegExp, escapeUrl, unescapeUrl, escapeXml, unescapeXml,
getUrlParams, splitHorz, splitVert, dialog

- glutils-json : This set of utilities make it straightforward to persist whole javascript structures (including pointers, cycles) to a file.
decycle, recycle, json, unJson

- glutils-node : Common helper functions for node
serveOnExpress, read, write, print, exit, md5

- glutils_promises : Simple but powerful fibers-based "real" promises
run, yield, p, parallel, consume, wget

Here is an example of using the promises:

``
var _ = require('glutils')
_.run(function () {
...
var user = _.p(db.users.findone({ username : username}, _.p()))
console.log(user)
...
}
`


Installation


`
npm install glutils
``

Changes

Here are my changes from the original gl519 repo

02/22/2014

- Added rename function in glutils-js section. (allows renaming of the keys of a hash based on map parameter)

02/17/2014 - Initial Commits

- pushed the tests in a test subfolder
- change test output into TAP (prepended OK, NOT OK, or # before each line of output)
- disable print() test and exit() tests - they were relying on human observation
- added npm test script - that tests using tap
- express serve the file statically at route /glutil instead of /gl519
- added MIT License file as specified in original package.json by dglittle
- added travis integration