source: framspy/frams-test-props.py @ 1158

"""An example of iterating through the properties of an ExtValue object and printing their characteristics."""

import frams
import sys

frams.init(*(sys.argv[1:]))


def printSingleProperty(v, p):
        print(' * %s "%s" type="%s" flags=%d group=%d help="%s"' % (v._propId(p), v._propName(p), v._propType(p), v._propFlags(p), v._propGroup(p), v._propHelp(p)))


def printFramsProperties(v):
        N = v._propCount()
        G = v._groupCount()
        print("======================= '%s' has %d properties in %d group(s). =======================" % (v._class(), N, G))
        if G < 2:
                # No groups, simply iterate all properties
                for p in range(v._propCount()):
                        printSingleProperty(v, p)
        else:
                # Iterate through groups and iterate all props in a group.
                # Why the distinction?
                # First, just to show there are two ways. There is always at least one
                # group so you can always get all properties by iterating the group.
                # Second, groups actually do not exist as collections. Iterating in
                # groups works by checking all properties on each iteration and
                # testing which one is the m-th property of the group!
                # So these inefficient _memberCount() and _groupMember() are provided
                # for the sake of completeness, but don't use them without a good reason ;-)
                for g in range(G):
                        print('\n------------------- Group #%d: %s -------------------' % (g, v._groupName(g)))
                        for m in range(v._memberCount(g)):
                                p = v._groupMember(g, m)
                                printSingleProperty(v, p)
        print('\n\n')


printFramsProperties(frams.World)

printFramsProperties(frams.GenePools[0].add('X'))  # add('X') returns a Genotype object