mitogen/tests
David Wilson e2eac65347 tests: import mitogen_ansible_playbook.sh helper 2018-04-16 14:29:14 +01:00
..
ansible tests: import mitogen_ansible_playbook.sh helper 2018-04-16 14:29:14 +01:00
bench tests/bench: import "slightly more reliable time" script 2018-04-02 07:30:06 +00:00
data tests: support CentOS Docker images. 2018-04-16 14:24:39 +01:00
soak tests: Import Latch soak test 2018-03-29 14:31:57 +05:45
README.md tests: document selecting a target distribution. 2018-04-16 14:27:55 +01:00
__init__.py tests: Make the tests directory an importable package 2018-04-01 01:32:13 +01:00
build_docker_images.py tests: support CentOS Docker images. 2018-04-16 14:24:39 +01:00
call_error_test.py core: support CallError(str) for service.py. 2018-03-29 11:53:02 +05:45
call_function_test.py call_function_test: Fix assumption that we run as a script 2018-04-01 01:23:13 +01:00
channel_test.py Import and use unittest2 without aliasing it 2018-03-19 21:58:28 +05:45
fakessh_test.py tests: put unittest.skip() around fakessh tests for the time being 2018-04-16 14:28:07 +01:00
first_stage_test.py tests: first_stage_test regression due to 1ff27ada49 2018-03-29 21:33:18 +05:45
fork_test.py fork: ensure importer handle is installed on the new router. 2018-04-09 16:37:51 +01:00
id_allocation_test.py issue #155: allocate child IDs in batches of 1000. 2018-03-22 03:41:04 +05:45
importer_test.py tests: just call log_to_file() from testlib 2018-03-29 07:25:11 +00:00
io_op_test.py issue #174: test all io_op() logic. 2018-04-01 16:39:10 +01:00
latch_test.py core: support throwing LatchError in every sleeping thread 2018-03-19 21:58:35 +05:45
local_test.py Import and use unittest2 without aliasing it 2018-03-19 21:58:28 +05:45
master_test.py master_test: Don't assume __file__ points to source code 2018-04-01 01:21:42 +01:00
minimize_source_test.py tests: Clarify which minimize_source samples are the reference 2018-03-31 12:51:42 +01:00
module_finder_test.py Issue #160: Cache minimize_source() 2018-04-07 14:34:41 +01:00
nested_test.py Import and use unittest2 without aliasing it 2018-03-19 21:58:28 +05:45
parent_test.py parent_test: Add explanation. 2018-03-29 23:49:45 +05:45
receiver_test.py core: Rename Sender.put() to Sender.send(). 2018-03-29 15:43:48 +05:45
responder_test.py tests: mark some tests as skipped 2018-03-19 21:58:35 +05:45
router_test.py Introduce handler policy functions; closes #138. 2018-03-29 21:40:33 +05:45
select_test.py select: clean up API. 2018-03-19 21:58:28 +05:45
show_docker_hostname.py issue #164: utility to print Docker hostname for use from shell scripts. 2018-04-05 20:24:11 +01:00
ssh_test.py tests: support CentOS Docker images. 2018-04-16 14:24:39 +01:00
testlib.py tests: support CentOS Docker images. 2018-04-16 14:24:39 +01:00
utils_test.py Import and use unittest2 without aliasing it 2018-03-19 21:58:28 +05:45

README.md

Warning

This directory is full of disorganized crap, including random hacks I checked in that I'd like to turn into tests. The effort to write tests only really started in September 2017. Pull requests in this area are very welcome!

Running The Tests

Build Status

Your computer should have an Internet connection, and the docker command line tool should be able to connect to a working Docker daemon (localhost or elsewhere for OS X etc.) that can run new images.

The IP address of the Docker daemon must allow exposing ports from running containers, e.g. it should not be firewalled or port forwarded.

If in doubt, just install Docker on a Linux box in the default configuration and run the tests there.

Steps To Prepare Development Environment

  1. Get the code git clone https://github.com/dw/mitogen.git
  2. Go into the working directory cd mitogen
  3. Establish the docker image ./tests/build_docker_image.py
  4. Build the virtual environment virtualenv ../venv
  5. Enable the virtual environment we just built source ../venv/bin/activate
  6. Install Mitogen in pip editable mode pip install -e .
  7. Run test

Selecting a target distribution

Docker target images exist for testing against CentOS and Debian, with the default being Debian. To select CentOS, specify MITOGEN_TEST_DISTRO=centos in the environment.

User Accounts

A set of standard user account names are used by in the Docker container and also by Ansible's osx_setup.yml.

root In the Docker image only, the password is "rootpassword".

mitogen__has_sudo The login password is "has_sudo_password" and the account is capable of sudoing to root, by supplying the account password to sudo.

mitogen__has_sudo_pubkey The login password is "has_sudo_pubkey_password". Additionally tests/data/docker/mitogen__has_sudo_pubkey.key SSH key may be used to log in. It can sudo the same as mitogen__has_sudo.

mitogen__has_sudo_nopw The login password is "has_sudo_nopw_password". It can sudo to root without supplying a password.

mitogen__user1 .. mitogen__user21 These accounts do not have passwords set. They exist to test the Ansible interpreter recycling logic.

mitogen__webapp A plain old account with no sudo access, used as the target for fakessh tddests.