Class GeneratorList

source code

Iterates through a specified list of generators. When the end of the list is reached a generator.GeneratorCompleted exceoption is raised.

NOTE: Generators are incremented by this object so DON'T SET A GROUP ON THEM!

NOTE: We only increment to next generator in list when the GeneratorCompleted exception has been thrown from current generator. This allows one todo kewl things like have 2 static generators, then a dictionary, then a repeater.

Example:

>>> gen = GeneratorList(None, [
...     Static('1'),
...     Static('2'),
...     Static('3')
...     ])
>>> print gen.getValue()
1
>>> gen.next()
>>> print gen.getValue()
2
>>> gen.next()
>>> print gen.getValue()
3
>>> try:
...     gen.next()      # Will raise GeneraterCompleted exception
... except:
...     pass
>>> print gen.getValue() # notice we get last value again.
3

Example:

>>> gen = GeneratorList(None, [
...     Repeater(None, Static('Peach'), 1, 2),
...     Static('Hello World')
...     ])
>>> print gen.getValue()
Peach
>>> gen.next()
>>> print gen.getValue()
PeachPeach
>>> gen.next()
>>> print gen.getValue()
Hello World
>>> try:
...     gen.next()      # Will raise GeneraterCompleted exception
... except:
...     pass
>>> print gen.getValue() # notice we get last value again.
Hello World

Bad Example, group set on Generator in list:

>>> group = Group()
>>> gen = GeneratorList(group, [
...     Repeater(group, Static('Peach'), 1, 2),
...     Static('Hello World')
...     ])
>>> print gen.getValue()
Peach
>>> group.next()
>>> print gen.getValue()
Hello World
>>> try:
...     gen.next()      # Will raise GeneraterCompleted exception
... except:
...     pass
>>> print gen.getValue() # notice we get last value again.
Hello World