should_dsl 1.2.1 / 2.0 Alp

should_dsl is a library which goal is to write should assertions in Python as clear and readable as possible.<br /><br />It would be good to be as close as:<br /><br />SOME_VALUE should be equal to ANOTHER VALUE<br />or<br />SOME_EXCEPTION should be thrown by SOME_CALLABLE<br />or<br />SOME_VALUE should not be into SOME_CONTAINER<br /><br />For using this DSL, you need to import all the module's namespace, as:<br /><br />from should_dsl import *<br /><br />For example:<br /><br />1 |should_be.equal_to| 1 # will be true<br />'should' |should_have| 'oul' # will also be true<br />3 |should_be.into| (0, 1, 2) # will raise a ShouldNotSatisfied exception<br /><br />The equal_to matcher verifies object equality. If you want to ensure identity, you must use should_be with no matcher:<br /><br />2 |should_be| 2<br /><br />A nice example of exceptions would be:<br /><br />def raise_zerodivisionerror():<br /> return 1/0<br />ZeroDivisionerror |should_be.thrown_by| raise_zerodivisionerror<br /><br />Both should_have and should_be have versions for negation:<br /><br />2 |should_not_be.into| [1, 3, 5] # will be true<br />'should' |should_not_have| 'oul' # will raise a ShouldNotSatisfied exception<br /><br />Extending the DSL with custom matchers is easy:<br /><br />@matcher<br />def the_square_root_of():<br /> import math<br /> return (lambda x, y: x == math.sqrt(y), "%s is %sthe square root of %s")<br /><br />3 |should_be.the_square_root_of| 9 # will be true<br />4 |should_be.the_square_root_of| 9 # will raise a ShouldNotSatisfiedException<br /><br />should-dsl is unittest-compatible, so, on a unittest test case, failures on should expectations will result on unittest failures, not errors.<br /><br /><br />#md5=74e6eb2a3fd9517a5d910a200b17c4aa<br /><br />#md5=5af49409f051c08e71ad970eee00eb00<br /><br />#md5=cd5807354e3f46556c2913ed42ed98ae

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Alp,  Bethe Square Root,  Dsl,  Errors,  Exceptions,  Failures,  Import,  Oul,  Raise,  Raise Zerodivisi Nerror,  Raise Zerodivisi Nerrorboth,  Return,  Should Be,  Should Have,  Shouldnotsatisfied,  True,  Unittest,  Versions
Users rating:	0/10