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.
mitogen/tests
Alex Willmer fe435bb7d0 CI: Workaround "No module named 'setuptools.command.test'"
Pip 72 was released yesterday (2024-07-28), dropping `setup.py test` support.
hdrhistogram 0.6.1 requires it to install.

For now constrain Pip to earlier releases, so our tests can be run.

refs #1090
3 months ago
..
ansible CI: Workaround "No module named 'setuptools.command.test'" 3 months ago
bench Remove unused module imports 3 years ago
data Add Python 3.11 support 1 year ago
image_prep tests: Replace uses of ``include:``, unify skipping of mitogen only tests 7 months ago
soak Remove unused module imports 3 years ago
README.md Abandon Travis CI We have no credits, and its a PITA to maintain two CI platforms. The tests running on Travis provide very little extra coverage vs Azure Pipelines alone 3 years ago
__init__.py tests: Make the tests directory an importable package 7 years ago
broker_test.py prefer newer unittest.mock from the standad library 7 months ago
buildah_test.py Remove unused module imports 3 years ago
call_error_test.py tests: Replace uses of assertTrue() with specific methods 2 years ago
call_function_test.py Remove unused module imports 3 years ago
channel_test.py tests: Remove unittest2, use stdlib unittest 3 years ago
connection_test.py tests: Replace uses of assertTrue() with specific methods 2 years ago
constraints.txt CI: Workaround "No module named 'setuptools.command.test'" 3 months ago
context_test.py Remove unused module imports 3 years ago
create_child_test.py tests: Replace uses of assertTrue() with specific methods 2 years ago
doas_test.py tests: Replace uses of assertTrue() with specific methods 2 years ago
docker_test.py Remove unused module imports 3 years ago
error_test.py tests: Replace uses of assertTrue() with specific methods 2 years ago
fakessh_test.py Remove unused module imports 3 years ago
file_service_test.py tests: Replace uses of assertTrue() with specific methods 2 years ago
first_stage_test.py Remove unused module imports 3 years ago
fork_test.py tests: Check and/or suppress stderr of subprocesses, reduce shell=True uses 2 years ago
id_allocation_test.py tests: Use TestCase.assertEqual() 3 years ago
importer_test.py prefer newer unittest.mock from the standad library 7 months ago
io_op_test.py prefer newer unittest.mock from the standad library 7 months ago
iter_split_test.py Remove unused module imports 3 years ago
jail_test.py Remove unused module imports 3 years ago
kubectl_test.py Remove unused module imports 3 years ago
latch_test.py tests: Replace uses of assertTrue() with specific methods 2 years ago
local_test.py Remove unused module imports 3 years ago
log_handler_test.py prefer newer unittest.mock from the standad library 7 months ago
lxc_test.py tests: Replace uses of assertTrue() with specific methods 2 years ago
lxd_test.py Remove unused module imports 3 years ago
master_test.py Remove unused module imports 3 years ago
message_test.py prefer newer unittest.mock from the standad library 7 months ago
minify_test.py tests: Use TestCase.assertEqual() 3 years ago
mitogen_protocol_test.py prefer newer unittest.mock from the standad library 7 months ago
module_finder_test.py mitogen: Support PEP 451 ModuleSpec API, required for Python 3.12 8 months ago
nested_test.py tests: Remove unittest2, use stdlib unittest 3 years ago
os_fork_test.py tests: Use TestCase.assertEqual() 3 years ago
parent_test.py prefer newer unittest.mock from the standad library 7 months ago
podman_test.py Remove unused module imports 3 years ago
policy_function_test.py prefer newer unittest.mock from the standad library 7 months ago
poller_test.py tests: Clarify skipped Poller test reasons 2 years ago
polyfill_functions_test.py tests: Replace uses of assertTrue() with specific methods 2 years ago
push_file_service_test.py Remove unused module imports 3 years ago
reaper_test.py prefer newer unittest.mock from the standad library 7 months ago
receiver_test.py tests: Replace uses of assertTrue() with specific methods 2 years ago
requirements-tox.txt mitogen: Support Python 3.12 8 months ago
requirements.txt ansible_mitogen: Fix --ask-become-pass, add test coverage 7 months ago
responder_test.py prefer newer unittest.mock from the standad library 7 months ago
router_test.py tests: Replace uses of assertTrue() with specific methods 2 years ago
select_test.py Remove unused module imports 3 years ago
service_test.py tests: Replace uses of assertTrue() with specific methods 2 years ago
setns_test.py Remove unused module imports 3 years ago
signals_test.py Remove unused module imports 3 years ago
ssh_test.py tests: Support Ubuntu 22.04 as test suite runner (controller) 1 year ago
su_test.py tests: Replace uses of assertTrue() with specific methods 2 years ago
sudo_test.py tests: Replace uses of assertTrue() with specific methods 2 years ago
testlib.py mitogen: Support PEP 451 ModuleSpec API, required for Python 3.12 8 months ago
timer_test.py prefer newer unittest.mock from the standad library 7 months ago
two_three_compat_test.py CI: Migrate macOS integration tests to macOS 12, drop Python 2.7 jobs 3 months ago
types_test.py tests: Replace uses of assertTrue() with specific methods 2 years ago
unix_test.py tests: Check and/or suppress stderr of subprocesses, reduce shell=True uses 2 years ago
utils_test.py mitogen: Raise TypeError on `mitogen.utils.cast(custom_str)` failures 7 months 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

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.