70a6d0d7dc
Fixes include - Setting cloexec flag on pipe files, using set_inheritable on sockets, and close_fds=False on subprocess.Popen to work around file descriptors not being inheritable by default in new versions of python - Adding mitogen.exit_status variable and avoiding os.kill call so fake 'ssh' script is able to exit cleanly with correct status code - Fixing broken os.dup call in ExternalContext._setup_master when input and output streams have the same descriptor - Updating fakessh module to do necessary python3 string/byte conversions, and use updated mitogen Protocol, Stream, and Router apis - Simplifying fakessh startup sequence so there aren't unnecessary differences between ways control and data handles are passed, and ways master and slave processes are initialized - Fixing shutdown race conditions where subprocess exit handling or stdin EOF handling could result in a truncated stdout stream - Updating and adding a lot of docstrings and comments - Adding Process.proc is None / is not None assertions to be clear about which parts of fakessh.Process code are specific to the slave process, and which parts are specific to the master process. - Re-enabling unit test case and updating an outdated file path so it passes |
3 years ago | |
|---|---|---|
| .. | ||
| ansible | 3 years ago | |
| bench | 3 years ago | |
| data | 3 years ago | |
| image_prep | 4 years ago | |
| soak | 3 years ago | |
| README.md | 3 years ago | |
| __init__.py | 7 years ago | |
| broker_test.py | 3 years ago | |
| buildah_test.py | 3 years ago | |
| call_error_test.py | 3 years ago | |
| call_function_test.py | 3 years ago | |
| channel_test.py | 3 years ago | |
| connection_test.py | 3 years ago | |
| context_test.py | 3 years ago | |
| create_child_test.py | 3 years ago | |
| doas_test.py | 3 years ago | |
| docker_test.py | 3 years ago | |
| error_test.py | 3 years ago | |
| fakessh_test.py | 3 years ago | |
| file_service_test.py | 3 years ago | |
| first_stage_test.py | 3 years ago | |
| fork_test.py | 3 years ago | |
| id_allocation_test.py | 3 years ago | |
| importer_test.py | 3 years ago | |
| io_op_test.py | 3 years ago | |
| iter_split_test.py | 3 years ago | |
| jail_test.py | 3 years ago | |
| kubectl_test.py | 3 years ago | |
| latch_test.py | 3 years ago | |
| local_test.py | 3 years ago | |
| log_handler_test.py | 3 years ago | |
| lxc_test.py | 3 years ago | |
| lxd_test.py | 3 years ago | |
| master_test.py | 3 years ago | |
| message_test.py | 3 years ago | |
| minify_test.py | 3 years ago | |
| mitogen_protocol_test.py | 3 years ago | |
| module_finder_test.py | 3 years ago | |
| nested_test.py | 3 years ago | |
| os_fork_test.py | 3 years ago | |
| parent_test.py | 3 years ago | |
| podman_test.py | 3 years ago | |
| policy_function_test.py | 3 years ago | |
| poller_test.py | 3 years ago | |
| polyfill_functions_test.py | 3 years ago | |
| push_file_service_test.py | 3 years ago | |
| reaper_test.py | 3 years ago | |
| receiver_test.py | 3 years ago | |
| requirements.txt | 3 years ago | |
| responder_test.py | 3 years ago | |
| router_test.py | 3 years ago | |
| select_test.py | 3 years ago | |
| service_test.py | 3 years ago | |
| setns_test.py | 3 years ago | |
| signals_test.py | 3 years ago | |
| ssh_test.py | 3 years ago | |
| su_test.py | 3 years ago | |
| sudo_test.py | 3 years ago | |
| testlib.py | 3 years ago | |
| timer_test.py | 3 years ago | |
| two_three_compat_test.py | 3 years ago | |
| types_test.py | 3 years ago | |
| unix_test.py | 3 years ago | |
| utils_test.py | 3 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. 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.