Metadata-Version: 1.0
Name: should-dingus
Version: 0.1
Summary: Dingus call matcher for should-dsl
Home-page: https://github.com/CharString/should-dingus
Author: Chris Wesseling
Author-email: chris.wesseling@cwi.nl
License: BSD
Description: A custom Should-DSL matcher to use with Dingus
        ===============================================
        
        This modules contains a custom matcher so you can use should_dsl_ with Dingus_ calls
        
        A small warning: The | operator hack of should_dsl's doesn't really go well with the __or__() of a Dingus.
        I think the | hack is nasty, and I'm not sure I like should_dsl_ for it. This is where Ruby seems really pretty to me.
        
        .. _should_dsl: http://www.should-dsl.info/
        .. _Dingus: http://pypi.python.org/pypi/dingus
        
        
        
        You only need to import it ::
        
            >>> from should_dsl import should, should_not
            >>> from dingus import Dingus
            >>> import should_dingus
        
        
        ------------
        
        
        **call**
        
        Checks calls on a Dingus ::
        
            >>> stub = Dingus('stub')
            >>> def some_function():
            ...     stub()
            ...
            >>> some_function |should| call(stub)
        
        *call* can also check that it should be called *once*::
        
            >>> def some_function():
            ...     stub()
            ...     stub()
            ...
            >>> some_function |should| call(stub)
            >>> some_function |should| call(stub).once
            Traceback (most recent call last):
            ...
            ShouldNotSatisfied: <Dingus stub> was called 2 times, expected 1
        
        *call* can even check the parameters with *with_params*::
        
            >>> def some_function():
            ...     stub(True, kwak='tuut', braat='aap')
            ...
            >>> some_function |should| call(stub).with_params(True, kwak='tuut', braat='aap')
            >>> some_function |should| call(stub).with_params(True, kwak='tuut')
            Traceback (most recent call last):
            ...
            ShouldNotSatisfied: <Dingus stub> has not been called with params (True,) {'kwak': 'tuut'}
        
        *call* *with_params* can be combined with *once*::
        
            >>> def some_function():
            ...     stub(True, kwak='tuut', braat='aap')
            ...
            >>> some_function |should| call(stub).once.with_params(True, kwak='tuut', braat='aap')
            >>> stub.reset()
            >>> some_function |should| call(stub).with_params(True, kwak='tuut', braat='aap').once
        
Keywords: dingus should dsl testing test mocking mock double stub fake record assert bdd python expectation
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Testing
