Expects is an expressive and extensible TDD/BDD expectations library for Python.

Just import the expect callable and start writing test expectations.

from expects import expect

expect([]).to.be.empty

expect(False).not_to.be.true

expect({'name': 'Jack', 'email': 'jack@example.com'}).to.have.key('name') \
                                                     .with_value.match('\w+')

expect(str).to.have.property('split')

expect(lambda: foo).to.raise_error(NameError)

You can see all the builtin expectations with lots of examples here.

You can install the last stable release of Expects from PyPI using pip or easy_install.

$ pip install expects

Also you can install the latest sources from Github.

$ pip install -e git+git://github.com/jaimegildesagredo/expects.git#egg=expects

To run the Expects specs you should install the development requirements and then run mamba.

$ pip install -r requirements-devel.txt
$ mamba

Expects is released under the Apache2 license.

See Changes.

Expects docs are hosted on Read The Docs.