Metadata-Version: 2.0
Name: pytest-cpp
Version: 0.3.0
Summary: Use pytest's runner to discover and execute C++ tests
Home-page: http://github.com/nicoddemus/pytest-cpp
Author: Bruno Oliveira
Author-email: nicoddemus@gmail.com
License: MIT
Keywords: pytest test unittest
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: C++
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Requires-Dist: pytest
Requires-Dist: colorama

==========
pytest-cpp
==========

Use `pytest <https://pypi.python.org/pypi/pytest>`_ runner to discover and execute C++ tests.

Supports both `Google Test <https://code.google.com/p/googletest>`_ and
`Boost::Test <http://www.boost.org/doc/libs/release/libs/test>`_:

.. image:: https://raw.githubusercontent.com/nicoddemus/pytest-cpp/master/images/screenshot.png

|version| |downloads| |ci| |coverage|

.. |version| image:: http://img.shields.io/pypi/v/pytest-cpp.png
  :target: https://crate.io/packages/pytest-cpp

.. |downloads| image:: http://img.shields.io/pypi/dm/pytest-cpp.png
  :target: https://crate.io/packages/pytest-cpp

.. |ci| image:: http://img.shields.io/travis/nicoddemus/pytest-cpp.png
  :target: https://travis-ci.org/nicoddemus/pytest-cpp

.. |coverage| image:: http://img.shields.io/coveralls/nicoddemus/pytest-cpp.png
  :target: https://coveralls.io/r/nicoddemus/pytest-cpp

This brings several benefits:

* Allows you to run all your tests in multi-language projects with a single
  command;
* Execute C++ tests in **parallel** using
  `pytest-xdist <https://pypi.python.org/pypi/pytest-xdist>`_ plugin;
* Use ``--junitxml`` option to produce a single and uniform xml file with all
  your test suite results;
* Filter which tests to run using standard test filtering capabilities, such as
  by file names, directories, keywords by using the ``-k`` option, etc.;

Usage
=====

Once installed, when py.test runs it will search and run tests
founds in executable files, detecting if the suites are
Google or Boost tests automatically.

You can configure which files are tested for suites by using the ``cpp_files``
ini configuration::

    [pytest]
    cpp_files=test_suite*

Default is to match ``test_*`` and ``*_test`` file names.

Requirements
============

* Python 2.7+, Python 3.2+
* pytest

Install
=======

Install using `pip <http://pip-installer.org/>`_:

.. code-block:: console

    $ pip install pytest-cpp

Changelog
=========

Please consult `releases <https://github.com/nicoddemus/pytest-cpp/releases>`_.

Support
=======

All feature requests and bugs are welcome, so please make sure to add
feature requests and bugs to the
`issues <https://github.com/nicoddemus/pytest-cpp/issues>`_ page!


