It's a short introduction to a project we have made recently here at Doist Inc to improve our test codebase. The project is named resources and it's not available on PyPI, but you can install it right from the github anyway.
pip install -e email@example.com:Doist/resources.git#egg=resources-dev
What's the point of the project?
The idea is to provide a yet another way to manage your test fixtures (that is, objects and other resources you create usually before you start verifying an assertion.)
There are two popular ways to initialize fixtures in Python I'm aware of:
Now, there is another way to make the same. The approach we propose is to create fixtures roughly the way we did it for py.test -- a function per fixture, and to use it the way how the Michael Foord's mock manages the lifespan of patches it applies -- with context managers, function decorators or start/stop methods.
So, without further ado, a short usage example which explains better than thousands of words. The library should work with py.test, nose or unittest.
# import global instance from resources import resources # register resource named "user" by defining a function with the same # name. The function must have exactly one "yield" construction and is # used both to set up and tear down the fixtures @resources.register_func def user(firstname.lastname@example.org', password='password', username='Joe'): user = User.objects.create(email=email, password=password, username=username) try: yield user finally: user.delete() # use resource with an automatically created "user_ctx" context manager def test_user_properties(): with resources.user_ctx() as user: # the resource will be available as an assignment target # of the "with"-construction assert user.username == 'Joe' # it's also stored in the "resources" global object assert resources.user.username == 'Joe' # instances doesn't exist and isn't accessible anymore assert not hasattr(resources, 'user')
It's a very basic example, though. If you feel like it may be useful for you, feel free to visit the github page and to read the README we created especially for this purpose.