json-collection-decorator

efficiently run a collection of records by conditions and decorate them when conditions match, return results - filtered items

Inputs

1. config object
2. collection of jsonobjects

var objConfig={
     filters:[
        { path:"path.to.key",op:"eq",val:"value to match" }
     ]
    ,decorate:[
        {
            find:[{ path:"path.to.key",op:"eq",val:"value to match" }]
            ,do:[{ path:"path.to.key",act:"set",val:"value to set" }]
        },{
            ,find:{ path:"path.to.key",op:"eq",val:"value to match" }
            ,do:{path:"path.to.key",act:"stack",val:"value to add to array" }
        }
    ]
}

arrResults = decorate(objConfig,arrCollection);

multiple matching conditions

multiple conditions in an array are treated as an AND, they ALL must match. OR conditions can be listed as a separate line. Multiple actions are ALL executed

Action Parameters

1. filter : conditions to meet for filtering out the object from the collection to return
2. decorate: pairs of conditions and decorator actions to perform on each object in the collection
3. decorate.find: the condiion for a decoration
4. decorate.act: the action to perform on hat is matched

Comparison Parameters

1. path : dot notation path to the field
2. op : operand
3. val : stauc value to compare against
4. path2 : used for comparisons between values instead of setting a static one

Operands

1. eq : ==
2. ne : !=
3. gt : >
4. lt : <
5. in : found in a string or simple array
6. ni : opposite of in
7. has : more than a count of occurences of in
8. any: doesnt matter
9. empty: no data, null, or undefined
10. data: populated field
11. find: run a nested comparison, comparison will be in val:

Actions

1. log: console.log what was found
2. set: static value to set
3. stack: static value to add to an array
4. unstack: remove an exact value from an array
5. add: numeric value to add, this will also convert existing values to a number
6. append: string to append
7. prepend: string to append
8. remove: remove the field from the object
9. rename: rename a field of an object
10. prioritize: adds 1 to existings _priority, unless a different number is specified
11. focus: array of paths to keep, remove all others ['path1', 'path2.child']
12. implode: convert an array into a comma separated string
13. explode: convert a value separated string into an array
14. copy: get the value from path deinfed in val: copy it to path:
15. findCopy same as copy but has 2 paths in val to find items in an array {path:'_image',act:'findCopy',val:{path:'preview.images',path2:'source.url'}}
16. parseUrl: add properties to a destination val: from a parsed path requires url-parse repo library included 19: rand: set a random integrer given a min and max {path:,val:[min,max]}