Metadata-Version: 2.1
Name: nose-blacklist
Version: 0.0.2
Summary: test exclusion for nose with blacklists
Home-page: https://github.com/pglass/nose-blacklist
Author: Paul Glass
Author-email: pnglass@gmail.com
License: MIT
Keywords: nose blacklist skip exclude
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Plugins
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Software Development :: Testing
Requires-Dist: nose
Requires-Dist: six

================
 nose-blacklist
================

.. image:: https://travis-ci.org/pglass/nose-blacklist.svg?branch=master
    :target: https://travis-ci.org/pglass/nose-blacklist

nose-blacklist is a plugin for nose_ that provides a powerful way of skipping
tests without requiring code changes.

- Test cases are excluded by regex matching
- Tests cases are matched by their fully-qualified names, including the module,
  class, and function/method names.
- Tests to skip can be sourced from one or more files, or from cli arguments


Quickstart
==========

.. code-block:: shell

    $ pip install nose-blacklist

    $ nosetests --with-blacklist \
        --blacklist=<pattern1> \
        --blacklist=<pattern2> \
        mytests/

Blacklist strings can be specified from one or more files. Blacklist files can
be used in conjunction with the ``--blacklist`` arguments.

.. code-block:: shell

    $ cat blacklist.txt
    test_thing
    # test_other_thing
    test_third_thing

    $ nosetests --with-blacklist \
        --blacklist-file=blacklist.txt \
        mytests/

The blacklist file should have a single pattern per line, as above. Any line
starting with a ``#`` is commented and will be ignored.


.. _nose: https://nose.readthedocs.org/en/latest/


