growl.node.txt

                                  ┏━━━━━━━━━━━┓
                                  ┃   GROWL   ┃
                                  ┗━━━━━━━━━━━┛

INSTALL ==>                   #OS notifications.
                              #Node module (1.4.1)
                              #But need to install before notification library:
                              #  - Linux: libnotify-bin
                              #  - OSX: terminal-notifier|growlnotifier
                              #  - Windows: GrowlForWindows and growlnotify

GROWL(STR[,OBJ[,FUNC(ERROR)]])#OBJ:
                              #  - title STR (displayed first)
                              #  - name STR: application name (not displayed)
                              #  - image STR|FILE_STR (.png|jpeg|icns|pdf): STR is filesystem icon
                              #  - sticky BOOL: must click on it manually to close or not
                              #  - priority NUM (déf: 0, from -2 to 2)
                              #FUNC() is fired when notification starts.

GROWLY                        #Node module (1.1.1)
                              #Same but use GNTP as a client, which means it needs a GNTP server.
                              #On Linux, must install and launch Growl-on-Linux
GROWLY.notify(STR[,OBJ        #OBJ:
[,FUNC(ERROR, STR2)]])        #  - title, sticky, priority
                              #  - image STR|FILE_STR
                              #  - label STR
                              #FUNC() is fired when notification stops. STR2 is "closed|clicked"

NODE-NOTIFIER.notify          #Uses native notification system on Linux, Mac or Windows, or Growl as fallback.
(OBJ, FUNC(ERROR, RESPONSE))  #On Linux, must install notify-osd (is by def. on Ubuntu)
                              #Version 4.0.2
                              #OBJ (for Linux):
                              #  - title STR
                              #  - message STR
                              #  - icon IMAGE_FILE
                              #  - urgency "low|normal|critical" ("critical changes default icon)
NODE-NOTIFIER.on( "click",...)#
NODE-NOTIFIER.on
( "timeout", ...)             #

GULP-NOTIFY[.onError]         #Uses NODE-NOTIFIER (with Gulp icon). Version 2.0.1
(VAL[, OBJ])                  #VAL can be:
                              #  - STR, including LoDash templates (filled with OBJ and VINYL)
                              #  - FUNC(VINYL)->STR|false
                              #  - OBJ, passed to NODE-NOTIFIER notify(), with also:
                              #     - onLast BOOL: if true (def: false), only fires if last file in VINYL stream
                              #     - emitError BOOL (def: false)
                              #     - title|message can be STR or FUNC(VINYL)->STR|false
                              #     - templateOptions OBJ: fill LoDash templates
                              #If onError:
                              #  - only fired if ERROR thrown
                              #  - fill LoDash template with { error: ERROR } (so can use error.message)
                              #  - used as a normal function, not an IOSTREAM. E.g. using as GULP-PLUMBER errorHandler
                              #Disabled if ENVVAR DISABLE_NOTIFIER true
GULP-NOTIFY.logLevel(0|1|2)   #When to log to console: on error (1|2) and on notifications (2) (def)