Metadata-Version: 2.1
Name: nose-extra-tools
Version: 1.0.2
Summary: Extra testing goodies for nose.tools
Home-page: https://github.com/petarmaric/nose_extra_tools
Author: Petar Maric
Author-email: petarmaric@uns.ac.rs
License: BSD
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Utilities
Requires-Dist: nose (>=1.0)

About
=====

Extra testing goodies for ``nose.tools``.

Adds an ``issues_warnings`` decorator, where tests must issue one of the
expected warnings to pass (similar to ``nose.tools.raises`` for exceptions).

If installed on Python < 2.7 backports the new ``unittest.TestCase.assert*``
methods, and converts them to ``nose`` style assertions (spelled in PEP 8
fashion, so ``assert_equal`` rather than ``assertEqual``):

    * ``assert_greater`` / ``assert_less`` / ``assert_greater_equal`` /
      ``assert_less_equal``

    * ``assert_regexp_matches`` / ``assert_not_regexp_matches``

    * ``assert_in`` / ``assert_not_in``

    * ``assert_is`` / ``assert_is_not``

    * ``assert_is_none`` / ``assert_is_not_none``

    * ``assert_dict_contains_subset``

    * and `more...`_.

.. _`more...`: http://docs.python.org/2.7/whatsnew/2.7.html#updated-module-unittest


Installation
============

To install ``nose_extra_tools`` run::

    $ pip install nose_extra_tools


Usage examples
==============

::

    from nose_extra_tools import assert_in, issues_warnings

    @issues_warnings(UserWarning, DeprecationWarning)
    def test_issues_deprecation_warning():
        import warnings
        warnings.warn('This test passes')

    @issues_warnings(Warning)
    def test_forgot_to_issue_warning():
        pass

    def test_backported_assert_in():
        assert_in(10, range(5))


Contribute
==========

If you find any bugs, or wish to propose new features `please let me know`_.

If you'd like to contribute, simply fork `the repository`_, commit your changes
and send a pull request. Make sure you add yourself to `AUTHORS`_.

.. _`please let me know`: https://github.com/petarmaric/nose_extra_tools/issues/new
.. _`the repository`: https://github.com/petarmaric/nose_extra_tools
.. _`AUTHORS`: https://github.com/petarmaric/nose_extra_tools/blob/master/AUTHORS


