trog

trog is a generator that consumes an object and recursively iterates through its properties, yielding [key, value] pairs.

Iteration is breadth-first by default, meaning all the object's immediate properties will be yielded before recursion. This can be configured using a set of exported symbols:

key	description
BREAK	Stop the current iteration
DESCEND	Iterate through the last yielded value immediately, resuming current iteration later
DEFER	Iterate through the last yielded value after current iteration has finished
SKIP	Do not iterate through the last yielded value

Any of these can be passed in as the second argument to a trog generator to define default behaviour (eg passing SKIP would avoid recursion; passing DESCEND would force depth-first recursion), and any of these can be passed back into the generator (by manual iteration via next(FLAG)) to respond to specific conditions. For example, you may wish to SKIP circular references, or BREAK when you recognise a property to be part of a sub-tree you know you don't need to crawl.

TODO

• Tests
• Examples
• API refinement