# XML "function" nodes that transform their contents

funcs = {}

def process(node, on_error=exc.raise_):

    for child in xml_dom.NodeElemIter(node): process(child, on_error)

    name = node.tagName

    if name.startswith('_') and name in funcs:

            value = funcs[name](xml_dom.NodeTextEntryIter(node))

            xml_dom.replace_with_text(node, value)

        except Exception, e: # also catch XML func internal errors

            exc.add_traceback(e)

            exc.add_msg(e, 'function:\n'+str_)

            xml_dom.replace(node, node.ownerDocument.createComment(

                # comments can't contain '--'

    return [(name, func(value)) for name, value in items]

    '''Throws SyntaxException if can't cast'''

    try: return type_(val)

    except ValueError, e: raise SyntaxException(e)

        xml_dom.TextEntryOnlyIter(items))

# Function names must start with _ to avoid collisions with real tags

# Functions take arguments (items)

    return None

    items = dict(items)

    try:

        left = items['left']

        right = items['right']

    except KeyError: return '' # a value was None

    return util.bool2str(left == right)

funcs['_eq'] = _eq

def _if(items):

    items = dict(items)

    try:

        cond = items['cond']

        then = items['then']

    except KeyError, e: raise SyntaxException(e)

    else_ = items.get('else', None)

    cond = bool(cast(str, cond))

    if cond: return then

    else: return else_

funcs['_if'] = _if

    items.sort()

        # get *once* from iter and check types

    return maps.merge_values(*[v for k, v in items])

        # get *once* from iter and check types

        label = items['label']

        value = items['value']

    except KeyError, e: raise SyntaxException(e)

    return label+': '+value

    items = dict(conv_items(str, items))

    try: type_ = types_by_name[type_str]

    except KeyError, e: raise SyntaxException(e)

    null = type_(null)

    try: return util.none_if(value, null)

    except ValueError: return value # value not convertible, so can't equal null

    @param items

        <last_entry> Value

        <other_entries> name=value Mappings

            name "*" means all other input values

            value "*" means keep input value the same

            value "" means ignore input value

    '''

    map_ = dict(items)

    try: new_value = map_[value]

        se = SyntaxException(e)

        try: new_value = map_['*']

        except KeyError: raise se

    if new_value == '*': new_value = value # '*' means keep input value the same

    return util.none_if(new_value, u'') # empty map entry means None

def _replace(items):

    items = conv_items(str, items) # get *once* from iter and check types

    try:

        for repl, with_ in items:

            if re.match(r'^\w+$', repl):

                repl = r'(?<![^\W_])'+repl+r'(?![^\W_])' # match whole word

            value = re.sub(repl, with_, value)

    except sre_constants.error, e: raise SyntaxException(e)

    try: last = items.pop() # last entry contains value

    except IndexError: return None # input is empty and no actions

    if last[0] != 'value': return None # input is empty

    str_ = last[1]

    quantity = units.str2quantity(str_)

    try:

        for action, units_ in items:

            units_ = util.none_if(units_, u'')

            if action == 'default': units.set_default_units(quantity, units_)

            elif action == 'to': quantity = units.convert(quantity, units_)

            else: raise SyntaxException(ValueError('Invalid action: '+action))

    default = (str_, None)

    start, sep, end = str_.partition(range_sep)

    if sep == '': return default # not a range

def _rangeStart(items):

    items = dict(conv_items(str, items))

    try: value = items['value']

funcs['_rangeStart'] = _rangeStart

def _rangeEnd(items):

    items = dict(conv_items(str, items))

    try: value = items['value']

funcs['_rangeEnd'] = _rangeEnd

    items = dict(conv_items(float, items))

    from_ = items.get('from', None)

    to = items.get('to', None)

    if from_ == None or to == None: return None

    return str(to - from_)

funcs['_range'] = _range

    sum_ = 0.

        sum_ += value

    else: return str(sum_/count)

    def __init__(self):

        Exception.__init__(self, 'CV (coefficient of variation) values are only'

            ' allowed for ratio scale data '

            '(see <http://en.wikipedia.org/wiki/Coefficient_of_variation>)')

    except StopIteration: return None

    if re.match('^(?i)CV *\d+$', value): raise SyntaxException(CvException())

    return value

    try: str_ = items['date']

        try: items['year']

            if items == {}: return None # entire date is empty

            else: raise SyntaxException(e)

        # Convert month name to number

        try: month = items['month']

        except KeyError: pass

        else:

            if not month.isdigit(): # month is name

                items['month'] = str(dates.strtotime(month).month)

        items = dict(conv_items(int, items.iteritems()))

        items.setdefault('day', 1)

        for try_num in xrange(2):

            try:

                date = datetime.date(**items)

                break

            except ValueError, e:

                    # exception still raised after retry

                if msg == 'month must be in 1..12': # try swapping month and day

                    items['month'], items['day'] = items['day'], items['month']

                else: raise SyntaxException(e)

        except ValueError:

            except ValueError, e: raise SyntaxException(e)

        else: date = (datetime.date(int(year), 1, 1) +

            datetime.timedelta(round((year % 1.)*365)))

    items = dict(conv_items(str, items))

    try: value = items['value']

funcs['_dateRangeStart'] = _dateRangeStart

funcs['_dateRangeEnd'] = _dateRangeEnd

    ('first', slice(None, 1)),

    ('middle', slice(1, -1)),

    ('last', slice(-1, None)),

]

name_parts_slices = dict(_name_parts_slices_items)

name_parts = [name for name, slice_ in _name_parts_slices_items]

        if part in items: parts.append(items[part])

    for part, value in items:

        try: slice_ = name_parts_slices[part]

        except KeyError, e: raise SyntaxException(e)

funcs['_namePart'] = _namePart

    items = dict(items)

    try:

        next = cast(str, items['next'])

        require = cast(str, items['require'])

        root = items['path']

    except KeyError, e: raise SyntaxException(e)

    node = root

    while node != None:

        new_node = xpath.get_1(node, next, allow_rooted=False)

        if xpath.get_1(node, require, allow_rooted=False) == None: # empty elem

            xml_dom.replace(node, new_node) # remove current elem

            if node is root: root = new_node # also update root

        node = new_node

    return root

funcs['_simplifyPath'] = _simplifyPath