Venusian is a library which allows framework authors to defer
decorator actions. Instead of taking actions when a function (or
class) decorator is executed at import time, you can defer the action
usually taken by the decorator until a separate “scan” phase.
See the “docs” directory of the package or the online documentation at
- Fix an issue under PyPy > 2.0 where attached decorators may not be found.
- Drop support of Python 2.4 / 2.5 / Jython.
- Add lift and onlyliftedfrom class decorators to allow for inheritance
of venusian decorators attached to superclass methods. See the API
documentation for more information.
- Fix bug where otherwise undecorated subclass of a superclass that had
venusian decorators on it would inherit its superclass’ decorations.
Venusian decorators should have never been inherited implicitly. See
- Pass ignore argument along recursively to walk_packages so custom
ignore functions will ignore things recursively. See
- Don’t run tox tests under Python 2.4 anymore (tox no longer supports 2.4).
- Venusian now works on Python 3.3b2+ (importlib-based).
- Use nose-exclude instead of relying on fragile module-scope code to ensure
we don’t get errors resulting from import of fixture code during
- Bug fix: no longer suppress ImportError while scanning by default. If
you want to suppress ImportError while scanning, you’ll now need use an
onerror callback as described in the documentation.
- Don’t ignore decorated objects within their original locations if they
happen to be imported into another module (remove seen set from invoke
in venusian scanning). See https://github.com/Pylons/venusian/pull/13 .
- Slightly less sucky way to ignore objects during scanning that are only
imported into a module but not actually defined there. See 1.0a4 change
notes for rationale. Now instead of checking whether the module of the
scanned object matches the module being scanned, we check whether the
module of the Venusian attachment matches the module being scanned. This
allows some genuine uses of imported objects as Venusian scan targets while
preventing inappropriate double-scanning of objects that have a venusian
attachment which just happen to be imported into other scanned modules.
- Add dev and docs setup.py commands (ala Pyramid).
Attempt to ignore objects during scanning that are only imported into a
module but not actually defined there. This is a semantics change, but
it’s the right thing to do, because I found myself facing a situation like
# in a module named "one"
from two import anotheradecoratedthing
def adecoratedthing(): pass
# and scanning both modules
In this case you’d wind up with two repeated registrations for
“anotherdecoratedthing”, which isn’t what anyone expects.
- Add an ignore argument to the scan method of a Scanner. This
argument allows a user to ignore packages, modules, and global objects by
name during a scan. See the “ignore Scan Argument” in the narrative
documentation for more details.
- Close ImpLoader file handle to avoid resource warnings on Python 3.
- Python 3 compatibility.
- Allow an onerror callback to be passed to Scanner.scan().
- Normal “setup.py test” can’t support running the venusian tests under py
2.4 or 2.5; when it scans the ‘classdecorators’ fixture, it barfs. To get
around this, we used to depend on nose in setup_requires and tell
“setup.py test” to use nose by setting test_suite to “nose.collector” but
we can’t anymore because folks use Venusian in systems which install from
pip bundles; pip bundles do not support setup_requires. So, sorry, we’re
painted into a corner; at this point you just have to know to install nose
and run “setup.py nosetests” rather than “setup.py test”. Or just run
“tox” which tests it under all Pythons.
- Use Pylons theme in documentation.
- Fix orphaned pyc test on pypy.
- Fix GitHub Issue #1: subclasses of decorated classes that do not
have any decorations should not inherit the decorations of their
- Fix GitHub Issue #2: scans should only “find” each object once per
scan, regardless of how many modules that object is imported into.
- Some metaclasses (Elixir’s) don’t raise an AttributeError when asked for a
nonexistent attribute during a scan. We now catch all exceptions when
interrogating an object for __venusian_callbacks__ rather than just
- Make codeinfo attribute available as an attribute of the AttachInfo
object. It will be a tuple in the form (filename, lineno, function,
sourceline) representing the context of the venusian decorator. Eg.
'testCallInfo', 'add_handler(foo, bar)')
- Bug fix: when a venusian decorator used as a class decorator was
used against both a class and a subclass of that class, the
superclass and subclass would effectively share the same set of
callbacks. This was not the intent: each class declaration should
have its own local set of callbacks; callbacks added via decorations
should not be inherited, and a superclass should not receive its
- Arrange test fixtures into a single directory.
- Ignore orphaned modules (.pyc or .pyo files without a
corresponding .py file) during a scan.
- Add the concept of scan categories (see the “Scan Categories”
section of the documentation) to allow an application to make use of
more than one Venusian-using framework simultaneously.
TODO: Brief introduction on what you do with files - including link to relevant help section.