mitogen/tests
dw 4356fdf027
Merge pull request #376 from Yannig/kubectl
Kubernetes connection support for mitogen.
2018-09-19 19:39:10 +01:00
..
ansible Kubernetes connection support for mitogen. 2018-09-19 16:52:20 +02:00
bench tests: more stable roundtrip.py. 2018-07-30 00:45:40 -07:00
data tests: data/fakessh.py 3.x fixes. 2018-09-10 01:23:29 +01:00
image_prep tests: fix debops tests (py-apt broken if /var/lbi/apt missing) 2018-08-18 16:43:59 +01:00
soak tests: make cpu_load.py more random. 2018-07-07 14:55:47 +01:00
README.md tests: add new users for conndel tests. 2018-08-18 16:43:59 +01:00
__init__.py tests: Make the tests directory an importable package 2018-04-01 01:32:13 +01:00
call_error_test.py tests: built-in exceptions live in a different module in 3.x 2018-07-07 14:55:47 +01:00
call_function_test.py core: call chains v3: abstract it into a new CallChain class. 2018-09-09 18:51:03 +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 Initial Python 3.x port work. 2018-07-07 14:55:47 +01:00
fork_test.py Initial Python 3.x port work. 2018-07-07 14:55:47 +01:00
id_allocation_test.py tests: remove stray hard-coded interpreter. 2018-07-07 14:55:47 +01:00
importer_test.py tests: must decode() zlib result for 3.x. 2018-07-07 14:55:47 +01:00
io_op_test.py issue #174: test all io_op() logic. 2018-04-01 16:39:10 +01:00
latch_test.py Initial Python 3.x port work. 2018-07-07 14:55:47 +01:00
local_test.py issue #291: permit supplying a full Python argv. 2018-07-22 16:24:42 -07:00
lxc_test.py issue #339: minimal tests for lxc/lxd modules. 2018-08-18 16:43:59 +01:00
lxd_test.py Use `lxc exec --mode=noninteractive` which is more widely compatible 2018-09-18 09:10:43 +01:00
master_test.py master: update scan_code_imports to cope with wordcode 2018-07-07 14:55:47 +01:00
minimize_source_test.py tests: importer fixes 2018-05-29 14:07:13 +01:00
module_finder_test.py tests: skip one test that triggers bug in ancient vendered six.py 2018-07-07 14:55:47 +01:00
nested_test.py Initial Python 3.x port work. 2018-07-07 14:55:47 +01:00
parent_test.py parent: raise a descriptive error when openpty fails. 2018-09-08 20:53:11 +01:00
receiver_test.py Initial Python 3.x port work. 2018-07-07 14:55:47 +01:00
responder_test.py tests: another smattering of 3.x type/API fixes. 2018-07-07 14:55:47 +01:00
router_test.py tests: another smattering of 3.x type/API fixes. 2018-07-07 14:55:47 +01:00
select_test.py master: split Select() into new module to reduce wire size. 2018-05-24 23:59:10 +01:00
serialization_test.py core: fix serialization of empty bytes() on 3.x. 2018-07-07 14:55:47 +01:00
service_test.py tests: another smattering of 3.x type/API fixes. 2018-07-07 14:55:47 +01:00
show_docker_hostname.py Initial Python 3.x port work. 2018-07-07 14:55:47 +01:00
ssh_test.py issue #337: ssh: disabling PTYs round 2: make it automatic. 2018-09-08 20:53:11 +01:00
testlib.py tests: log original traceback in assertRaises(). 2018-07-07 14:55:47 +01:00
two_three_compat_test.py tests: remove stray enable_debug() 2018-07-07 14:55:47 +01:00
types_test.py tests: another smattering of 3.x type/API fixes. 2018-07-07 14:55:47 +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. It has explicit sudoers rules forcing it to require a password for other accounts.

mitogen__pw_required The login password is "pw_required_password". When "sudo -u" is used to target this account, its password must be entered rather than the login user's password.

mitogen__require_tty The login password is "require_tty_password". When "sudo -u" is used to target this account, the parent session requires a TTY.

mitogen__require_tty_pw_required The login password is "require_tty_pw_required_password". When "sudo -u" is used to target this account, the parent session requires a TTY and the account password must be entered.

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

mitogen__sudo1 .. mitogen__sudo4 May passwordless sudo to any account.

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

Ansible Integration Test Environment

The integration tests expect to be run against a either one of the Docker images, or a similar target with the same set of UNIX accounts and sudo rules.

The login account should be able to sudo to root witout a password.