mitsuhiko/logbook — pull request #50 by mbr (2012-03-14 13:11:42+00:00)
Title: Broken documentation/feature

The specific example in the handler.BaseHandler docs does not work, see for a test case. One issue is that the docs have confused True and False in the example. Fixing that, it stil does not work, however.

The "shortcut" in logbook/base.py:899 seems to be the issue:

```python

# if this is a blackhole handler, don't even try to
# do further processing, stop right away. Technically
# speaking this is not 100% correct because if the handler
# is bubbling we shouldn't apply this logic, but then we
# won't enter this branch anyways. The result is that a
# bubbling blackhole handler will never have this shortcut
# applied and do the heavy init at one point. This is fine
# however because a bubbling blackhole handler is not very
# useful in general.
if handler.blackhole:
break
```

This is the only application of the blackhole-feature that I could find and it breaks it (disabling the check causes everything to work as expected).

Please have a look at the very simple test case I've provided.