条件 0.2.0

示例

下面是一个来自该书的示例，但使用conditions库在Python中实现

def parse_log_entry(text):
    """This function does all real job on log line parsing.
    it setup two cases for restart parsing if a line
    with wrong format was found.

    Restarts:
    - use_value: just retuns an object it was passed. This can
      be any value.
    - reparse: calls `parse_log_entry` again with other text value.
      Beware, this call can lead to infinite recursion.
    """
    text = text.strip()

    if well_formed_log_entry_p(text):
        return LogEntry(text)
    else:
        def use_value(obj):
            return obj
        def reparse(text):
            return parse_log_entry(text)

        with restarts(use_value,
                      reparse) as call:
            return call(signal, MalformedLogEntryError(text))


def log_analyzer(path):
    """This procedure replaces every line which can't be parsed
    with special object MalformedLogEntry.
    """
    with handle(MalformedLogEntryError,
                  lambda (c):
                      invoke_restart('use_value',
                                     MalformedLogEntry(c.text))):
        for filename in find_all_logs(path):
            analyze_log(filename)


def log_analyzer2(path):
    """This procedure considers every line which can't be parsed
    as a line with ERROR level.
    """
    with handle(MalformedLogEntryError,
                  lambda (c):
                      invoke_restart('reparse',
                                     'ERROR: ' + c.text)):
        for filename in find_all_logs(path):
            analyze_log(filename)

这里有一个名为 parse_log_entry 的函数，它定义了两种处理异常情况的方法：use_value 和 reparse。但是，如何处理不良行由高级函数 log_analyser 决定。原始书籍的章节只有一个版本的 log_analyser，但我添加了一个替代的 log_analyser2 来说明为什么重启是一个有用的模式。这种模式的优点在于可以将决策代码从低级库函数移动到高级业务逻辑。

该示例的完整版本可以在 example/example.py 文件中找到。

0.2.0 (2016-04-05)

• 添加了上下文管理器 restarts，现在 restart 管理器只接收一个函数，并返回一个函数，类似于调用要重启的代码。

0.1.0 (2016-03-29)

• 首次发布在 PyPI 上。