SpecLoud 0.3.1

SpecLoud is a Python module to use nosetests and plugins to take BDD specifications easier.<br /><br />Installation<br /><br />The easiest way to install specloud is using pip and requirements file:<br /><br />pip install --no-deps specloud -r http://github.com/hugobr/specloud/raw/master/requirements.txt<br /><br />Or you can try finding dependencies by yourself and installing specloud without requirements file.<br /><br />Usage<br /><br />Get a python file with BDD-style test names (starting with it, ensure, should, must, spec, example) and add them to the test suite<br /><br />For example:<br /><br />cat example.py<br /><br />import unittest<br /><br /><br />class CalculatorSpec(unittest.TestCase):<br /><br /> def it_should_sum_integers(self):<br /> # ...<br /> pass<br /><br /> def should_not_divide_by_zero(self):<br /> # ...<br /> pass<br /><br /> def must_accept_floats(self):<br /> # ...<br /> pass<br /><br /> def ensure_it_work_with_fractions(self):<br /> # ...<br /> pass<br /><br /> def test_subtract_positive_from_negative_numbers(self):<br /> # ...<br /> pass<br /><br />The command line tool specloud colorizes green for tests with no failures and no errors and red for tests with failures and/or errors:<br /><br />specloud example.py<br /><br />Calculator spec<br />- ensure it work with fractions<br />- it should sum integers<br />- must accept floats<br />- should not divide by zero<br />- subtract positive from negative numbers<br /><br />----------------------------------------------------------------------<br />Ran 5 tests in 0.003s<br /><br />OK<br /><br />How It Works<br /><br />SpecLoud is a python package that install nose, pinocchio and figleaf packages, so it can call nosetests with pinocchio and figleaf plugins. nosetests is called with some default options to find test methods and pinocchio to show pretty and colored messages. figleaf is just pinocchio dependency.<br /><br />A call to:<br /><br />specloud FILE<br /><br />is the same doing:<br /><br />nosetests -i '^(it|ensure|must|should|specs?|examples?)' -i '(specs?(.py)?|examples?(.py)?)$' '--with-spec' '--spec-color'<br /><br />Old Name<br /><br />The project was born as a proof of concept and I named it firstly pyunitbdd. But that's a terrible name. So I renamed the project to specloud.<br /><br /><br />#md5=65fc6ac2b58ea7e34d343254abb222c3

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Called,  Colored,  Default,  Ensure,  Failures,  Figleaf,  Install,  Module,  Nosetests,  Options,  Packages,  Pinocchio,  Plugins,  Pretty,  Project,  Python,  Requirements,  Specloud,  Tests
Users rating:	0/10