Metadata-Version: 1.1
Name: nose-parallel
Version: 0.1.1
Summary: A nosetests plugin to split test suites to run in parallel
Home-page: https://github.com/dlanger/nose-parallel
Author: Daniel Langer
Author-email: UNKNOWN
License: LICENSE
Description: nose-parallel
        =============
        
        A plugin to help split up your tests runs across multiple machines.
        
        In an ideal world, test suites should be fast enough that they can 
        be run locally on a single machine without extra engineering. This 
        plugin is there to help when you can't make that to happen.
        
        This **won't** help you run tests in parallel on one machine in different 
        threads; that's what the built-in `multiprocess 
        <http://nose.readthedocs.org/en/latest/plugins/multiprocess.html>`_ plugin 
        is for.
        
        This **will** help you split up your test suites so that you can run the 
        suites on multiple machines and not have the same test run twice - think 
        Jenkins with the 
        `multijob <https://wiki.jenkins-ci.org/display/JENKINS/Multijob+Plugin>`_ 
        plugin, or CI services like `CircleCI <https://circleci.com/docs/parallel-manual-setup>`_.
        
        
        Install
        -------
        
        .. code::
        
           pip install nose-parallel
        
        
        Usage
        -----
        
        On each machine:
        
        #. Export environment variables ``NODE_TOTAL`` (the number of machines on which the suite will be run) and and ``NODE_INDEX`` (the 0-based index of the current machine)
        #. Run nosetests with the ``--with-parallel`` flag
        #. Do something to join the results from all the machines back together
        
        For example, this is how we'd run nosetests on the second machine in a 
        four-machine testing cluster:
        
        .. code:: bash
        
           NODE_TOTAL=4 NODE_INDEX=1 nosetests --with-parallel
           
           
        If you don't set those variables, ``nose-parallel`` will do the right thing and run all your tests. 
        The CircleCI versions of the environment variables (``CIRCLE_NODE_TOTAL`` and ``CIRCLE_NODE_INDEX``, 
        respectively) are also natively supported.
        
        
        License
        -------
        
        ``nose-parallel`` is released under the MIT license.
        
        
        Contribute
        ----------
        
        - Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
        - Fork the repository on GitHub to start making your changes to the master branch (or branch off of it).
        - Send a pull request and bug the maintainer until it gets merged and published.
        - Add yourself to the authors list in ``setup.py``
        
        
        Thanks To
        ---------
        
        - `@mahmoudimus <https://github.com/mahmoudimus>`_, whose `nose-timer <https://github.com/mahmoudimus/nose-timer>`_ plugin this is based off of
        
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Topic :: Software Development :: Testing
Classifier: Environment :: Console
