saltstack/salt
1
0
Fork 0
mirror of https://github.com/saltstack/salt.git synced 2025-04-17 10:10:20 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Merge pull request #38194 from vutny/integration-test-requirements-doc

Browse source 
Document the requirements for running ZeroMQ-based integration tests
This commit is contained in:
Mike Place 2016-12-12 02:42:11 -07:00 • committed by GitHub
commit 28171cbfc5
2 changed files with 45 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
doc/topics/development/tests/index.rst
View file

@ -45,7 +45,7 @@ sent through the started daemons.
Integration tests are particularly good at testing modules, states, and
shell commands, among other segments of Salt's ecosystem. By utilizing
the integration test daemons, integration tests are easy to write. They
are also SaltStack's gerneally preferred method of adding new tests.
are also SaltStack's generally preferred method of adding new tests.
The discussion in the :ref:`Integration vs. Unit <integration-vs-unit>`
section of the :ref:`testing tutorial <tutorial-salt-testing>` is
@ -88,6 +88,28 @@ the lines below, depending on the relevant Python version:
pip install -r requirements/dev_python26.txt
pip install -r requirements/dev_python27.txt
To be able to run integration tests which utilizes ZeroMQ transport, you also
need to install additional requirements for it. Make sure you have installed
the C compiler and development libraries and header files needed for your
Python version.
This is an example for RedHat-based operating systems:
.. code-block:: bash
yum install gcc python-devel
pip install -r requirements/zeromq.txt
On Debian, Ubuntu or their derivatives run the following commands:
.. code-block:: bash
apt-get install build-essential python-dev
pip install -r requirements/zeromq.txt
This will install the latest ``pycrypto`` and ``pyzmq`` (with bundled
``libzmq``) Python modules required for running integration tests suite.
.. note::
In Salt 0.17, testing libraries were migrated into their own repo. To install them:

22
doc/topics/tutorials/writing_tests.rst
View file

@ -42,6 +42,28 @@ depending on your relevant version of Python:
pip install -r requirements/dev_python26.txt
pip install -r requirements/dev_python27.txt
To be able to run integration tests which utilizes ZeroMQ transport, you also
need to install additional requirements for it. Make sure you have installed
the C compiler and development libraries and header files needed for your
Python version.
This is an example for RedHat-based operating systems:
.. code-block:: bash
yum install gcc python-devel
pip install -r requirements/zeromq.txt
On Debian, Ubuntu or their derivatives run the following commands:
.. code-block:: bash
apt-get install build-essential python-dev
pip install -r requirements/zeromq.txt
This will install the latest ``pycrypto`` and ``pyzmq`` (with bundled
``libzmq``) Python modules required for running integration tests suite.
Test Directory Structure
========================