flynx/actions.js
1
0
Fork 0
mirror of https://github.com/flynx/actions.js.git synced 2025-10-29 02:10:09 +00:00
Code Issues Packages Projects Releases Wiki Activity

working on docs..

Browse Source 
Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>
This commit is contained in:
Alex A. Naanou 2016-08-23 17:31:06 +03:00
parent afd6eaf7a9
commit a397fe6a42
1 changed files with 21 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
README.md
View File

@ -17,9 +17,9 @@ a set of specific tasks.
**Action set** **Action set**
- an object containing a number of actions, - an object containing a number of actions,
- optionally, directly or indirectly inherited from MetaActions - optionally, directly or indirectly inherited from `MetaActions`
and/or other action sets, and/or other action sets,
- the action handlers are bound relative to it (._action_handlers) - the action handlers are bound relative to it (`._action_handlers`)
**Action** **Action**
@ -34,7 +34,7 @@ Root Action o---|---x
``` ```
- a method, created by Action(..), - a method, created by `Action(..)`,
- calls all the shadowed/overloaded actions in the inheritance - calls all the shadowed/overloaded actions in the inheritance
chain in sequence implicitly, chain in sequence implicitly,
NOTE: there is no way to prevent an action in the chain from NOTE: there is no way to prevent an action in the chain from
@ -72,7 +72,7 @@ Root Action o---|---x
### The action system main protocols: ### The action system main protocols:
1. Documentation generation and introspection (MetaActions) 1. Documentation generation and introspection (`MetaActions`)
``` ```
<action>.toString() <action>.toString()
@ -93,7 +93,7 @@ Root Action o---|---x
``` ```
2. Event-like callbacks for actions (MetaActions, Action) 2. Event-like callbacks for actions (`MetaActions`, `Action`)
``` ```
<action-set>.on('action', function(){ ... }) <action-set>.on('action', function(){ ... })
@ -105,7 +105,7 @@ Root Action o---|---x
3. A mechanism to define and extend already defined actions 3. A mechanism to define and extend already defined actions
This replaces / complements the standard JavaScript overloading This replaces / complements the standard JavaScript overloading
mechanisms (Action, Actions) mechanisms (`Action`, `Actions`)
``` ```
// Actions... // Actions...
@ -122,9 +122,10 @@ Root Action o---|---x
}) })
``` ```
NOTE: what is done here is similar to calling `O.__proto__.m.call(..)` **Notes:**
- what is done here is similar to calling `O.__proto__.m.call(..)`
but is implicit, and not dependant on the original containing but is implicit, and not dependant on the original containing
object name/reference ('O'), thus enabling an action to be object name/reference (`O`), thus enabling an action to be
referenced and called from any object and still chain correctly. referenced and called from any object and still chain correctly.
@ -151,7 +152,8 @@ Root Action o---|---x
All action protocol details apply. All action protocol details apply.
NOTE: there is not reliable way to call the post phase without first **Notes:**
- there is not reliable way to call the post phase without first
calling the pre phase due to how the pre phase is defined (i.e. calling the pre phase due to how the pre phase is defined (i.e.
pre phase functions can return post phase functions). pre phase functions can return post phase functions).
@ -206,13 +208,14 @@ Root Action o---|---x
2. implementation action (inner) 2. implementation action (inner)
3. post phase of protocol action (outer) 3. post phase of protocol action (outer)
NOTE: this will not affect to protocol/signature of the outer action **Notes:**
- this will not affect to protocol/signature of the outer action
in any way. in any way.
NOTE: both the inner and outer actions will get passed the same - both the inner and outer actions will get passed the same
arguments. arguments.
NOTE: another use-case is testing/debugging actions. - another use-case is testing/debugging actions.
NOTE: this is effectively the inside-out of normal action overloading. - this is effectively the inside-out of normal action overloading.
NOTE: there is intentionally no shorthand for this feature, to avoid - there is intentionally no shorthand for this feature, to avoid
confusion and to discourage the use of this feature unless confusion and to discourage the use of this feature unless
really necessary. really necessary.
@ -224,12 +227,13 @@ Root Action o---|---x
the action name as first argument and a list of action arguments as the action name as first argument and a list of action arguments as
the second arguments, and as normal a result on the post phase. the second arguments, and as normal a result on the post phase.
NOTE: it is not necessary to define the actual action, binding to a **Notes:**
- it is not necessary to define the actual action, binding to a
handler will also work. handler will also work.
NOTE: one should not call actions directly from within a __call__ - one should not call actions directly from within a __call__
handler as that will result in infinite recursion. handler as that will result in infinite recursion.
XXX need a way to prevent this... XXX need a way to prevent this...
NOTE: one should use this with extreme care as this will introduce - one should use this with extreme care as this will introduce
an overhead on all the actions if not done carefully. an overhead on all the actions if not done carefully.