amiwo

amiwo is a simple box of utility functions I'm using across various node applications

Install

npm install amiwo

Release notes

• v5.1.x: util > setProperty() support arrays or properties

• v5.0.x: refactored using bluebird Promise library instead of when; created stream library

• v4.18.x: removed $DEBUG proxy logger

• v4.17.x: util > added rmap(), toBoolean() method, hasOwnProperties() returns a number (vs. boolean)

• v4.16.x: rest > added executeIf() middleware and associated Jasmine tests; util > added deleteProperties(), addToSet(), unwind() methods ; db > added dropCollection(), findOne() methods to DBObject (andd their equivalent implementation for GenericDBObject); jasmine > added toBeAnArray() matcher

• v4.15.x: util > added round() and trunc()

• v4.14.x: Removed requirement to global

• v4.13.x: Added generic flatten() method to DBObject ; support for Mongo v3.4

• v4.12.x: Added jasmine customer matchers based on util's smartEqual()

• v4.11.x: Added doc (jsdoc)

• v4.10.x: util: added method map(), filter()

• v4.9.x: util: added method overwrite()

• v4.8.x: util: added method keys() and values(), toLowerCase() and toUpperCase() (functional programming helpers)

• v4.7.x: util: added method flattenArray()

• v4.6.x: util: added method setCharAt(); error: added InvalidIDError

• v4.5.x: util: method expressParam() now supports dotted names

• v4.4.x: session: added method Route::keepMethod()

• v4.3.x: test: added generic tests for DBObjects

• v4.2.x: db: Added Optimist Concurrency Check to DBObject save(), push() and addToSet() methods (and associated method in GenericMongoDBObject

• v4.1.x: util: Added setProperty() method

• v4.0.x: Added db & error suite

• v3.1.x: Added util::isValidEmail()

• v3.0.x: Added 'test' suite

• v2.8.x: RequestHandler & Route: added debug middleware supporting hot processing of debug & verbose parameters; minor edits in Session::init() middleware

• v2.7.x: util::request() now unwraps StatusCodeError from node-request module and returns its encapsulated Error directly

• v2.6.x: Added typeOf() and isObject() methods

• v2.5.x: Added native PerformanceTimer support to Route objects

• v2.4.x: Added Route::parallel() method

• v2.3.x: Added argv() method

• v2.2.x: Added Route object

• v2.1.x: Added PerformanceMonitor object

• v2.0.x: Added Session and RequestHandler objects

• v1.18.x: Fixed method clone() and smart(Deep)Equal() for Dates

• v1.17.x: Added method getProperty()

• v1.16.x: Enhanced min & max functions

• v1.15.x: Added addDays(), addMonths() and addYears() methods

• v1.14.x: Added average(), min(), max() methods

• v1.13.x: Improved merge() to work on more complex object structures

• v1.12.x: Added function getWeek(date) to get Date week number

• v1.11.x: Added function yesterday() and today() to get Date

• v1.10.x: Added functions get(obj, expr) getting properties from obj's keys matching 'expr'

• v1.9.x: Added functions flatten() and isObject()

• v1.7.x / v1.8.x: Added function request(), wrapping request-promise to add a 'amiwo' parameter with a unique ID (generated by node-uuid)

• v1.6.x: Added function hasOwnProperties(), isEmpty() now properly handles Date objects

• v1.5.x: Added function indexOf()

• v1.4.x: Added function expressParam() to replace the deprecated Express::Request::param() method

• v1.3.x: Added function add() to add a property/value to an Object safely and corrected a few typos, and smartEqual / smartDeepEqual to implement a simple = test on Arrays and Objects

• v1.2.0: Functions isEmpty() / isNotEmpty() now support Array and Object instead of just Strings

• v1.1.0: Added equal/deepEqual/notEqual/notDeepEqual functions

Related Modules

Main modules used by amiwo are

• merge — Merge multiple objects into one, optionally creating a new cloned object. Similar to the jQuery.extend but more flexible.
• request-promise — The world-famous HTTP client "Request" now Promises/A+ compliant. Powered by Bluebird.
• uuid - Simple, fast generation of RFC4122 UUIDS.

Tests

Basic test files are in /tests. I add them each time I add a new feature (or try to :) )

Credits

• Boris Gbahoue
• Yvan Stern for his invaluable help and support

License

The MIT License

Copyright (c) 2011-2015 Boris Gbahoue <http://www.athieme_consulting.com/>