You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

History

David Wilson 89676b1257 tests: put unittest.skip() around fakessh tests for the time being		7 years ago
..
ansible	issue #159 : make LRU size configurable.	7 years ago
bench	tests/bench: import "slightly more reliable time" script	7 years ago
data	tests: support CentOS Docker images.	7 years ago
soak	tests: Import Latch soak test	7 years ago
README.md	tests: document selecting a target distribution.	7 years ago
__init__.py	tests: Make the tests directory an importable package	7 years ago
build_docker_images.py	tests: support CentOS Docker images.	7 years ago
call_error_test.py	core: support CallError(str) for service.py.	7 years ago
call_function_test.py	call_function_test: Fix assumption that we run as a script	7 years ago
channel_test.py	Import and use unittest2 without aliasing it	7 years ago
fakessh_test.py	tests: put unittest.skip() around fakessh tests for the time being	7 years ago
first_stage_test.py	tests: first_stage_test regression due to `1ff27ada49`	7 years ago
fork_test.py	fork: ensure importer handle is installed on the new router.	7 years ago
id_allocation_test.py	issue #155 : allocate child IDs in batches of 1000.	7 years ago
importer_test.py	tests: just call log_to_file() from testlib	7 years ago
io_op_test.py	issue #174 : test all io_op() logic.	7 years ago
latch_test.py	core: support throwing LatchError in every sleeping thread	7 years ago
local_test.py	Import and use unittest2 without aliasing it	7 years ago
master_test.py	master_test: Don't assume __file__ points to source code	7 years ago
minimize_source_test.py	tests: Clarify which minimize_source samples are the reference	7 years ago
module_finder_test.py	Issue #160 : Cache minimize_source()	7 years ago
nested_test.py	Import and use unittest2 without aliasing it	7 years ago
parent_test.py	parent_test: Add explanation.	7 years ago
receiver_test.py	core: Rename Sender.put() to Sender.send().	7 years ago
responder_test.py	tests: mark some tests as skipped	7 years ago
router_test.py	Introduce handler policy functions; closes #138 .	7 years ago
select_test.py	select: clean up API.	7 years ago
show_docker_hostname.py	issue #164 : utility to print Docker hostname for use from shell scripts.	7 years ago
ssh_test.py	tests: support CentOS Docker images.	7 years ago
testlib.py	tests: support CentOS Docker images.	7 years ago
utils_test.py	Import and use unittest2 without aliasing it	7 years ago

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

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

Get the code git clone https://github.com/dw/mitogen.git
Go into the working directory cd mitogen
Establish the docker image ./tests/build_docker_image.py
Build the virtual environment virtualenv ../venv
Enable the virtual environment we just built source ../venv/bin/activate
Install Mitogen in pip editable mode pip install -e .
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.