retro v0.0.0

#RETRO

   ,,,,,,,,,     ,,,,,,,,,,    ,,,,,,,,,,    ,,,,,,,,,     ,,,,,,,,,  
  /       /|    /        /|   /        /|   /       /|    /       /|
 /       / |   /        / |  /        / |  /       / |   /       / |
|```````|  |  |````````|  | |````````| /  |```````|  |  |````````| |
|   [ ] | /,,,|  [:::] | /|,|,     ,,|/,,,|   [ ] | /,,,|   ,,   | |,,,
|      _|/\,, |  ______|/ |, |     |  |,, |      _|/\,, |  [  ]  | |,,
|      \  /,  |  |;... | /,  |     | /,,  |      \  /,  |   ``   | /, 
|_______\/,   |________|/,   |.....|/,    |_______\/,   |________|/,

A lib that harkens back to the old days when everything was an acronym and you had to shout at the computer to get it to do anything.

RETRO provides a bold new set of async control flow statesments in CAPS.

retro.IF(test).THEN(function).ELSE(function)

retro.NOT(function)
retro.TRUE //function that calls back true
retro.FALSE //function that calls back false

retro
  .TRY(function)
  .CATCH(function)    // called if try errors
  .PASS(function)     // called if try does not error
  .FINALLY(function)  // called after CATCH/PASS wether or not TRY errored. 
                      // (unless CATCH or PASS errored)

retro
  .TRY(function)
  .FINALLY(function) // CATCH/PASS are optional

retro
  .WHILE(test)       // async test
  .DO(function)      // perform this function

retro
  .DO(function)      // the same, but DO first, then check. 
  .WHILE(test)

retro
  .FOR_EACH(array)
  .DO(function)      // DO this FOR_EACH item in the array

retro.UNTIL(test)    // same as while, but do until test fails
  .DO(function)

retro
  .DO(function)
  .UNTIL(test)

retro
  .OPEN_PANDORA_BOX() // install monkeypatches onto global context

thinking outloud TRY...CATCH...FINALLY will probably be the most useful. because often one does use an async error value to test something.

sync if returns.