qubesadmin.tests.tools package

Submodules

qubesadmin.tests.tools.init module

class qubesadmin.tests.tools.init.TC_00_PropertyAction(methodName='runTest')

Bases: QubesTestCase

test_000_default()

test_001_set_prop()

test_002_set_prop_2()

test_003_set_prop_override_default()

test_003_set_prop_with_default()

class qubesadmin.tests.tools.init.TC_01_SinglePropertyAction(methodName='runTest')

Bases: QubesTestCase

test_000_help()

test_001_help_const()

test_100_default()

test_101_set_prop()

test_102_set_prop_dest()

test_103_set_prop_const()

test_104_set_prop_positional()

qubesadmin.tests.tools.qubes_prefs module

class qubesadmin.tests.tools.qubes_prefs.TC_00_qubes_prefs(methodName='runTest')

Bases: QubesTestCase

test_000_list()

test_002_set_property()

test_003_invalid_property()

test_004_set_invalid_property()

qubesadmin.tests.tools.qvm_backup module

class qubesadmin.tests.tools.qvm_backup.TC_00_qvm_backup(methodName='runTest')

Bases: QubesTestCase

test_000_write_backup_profile()

test_001_write_backup_profile_include()

test_002_write_backup_profile_exclude()

test_003_write_backup_with_passphrase()

test_004_write_backup_profile_no_compress()

test_010_main_save_profile_cancel(mock_getpass, mock_input)

test_011_main_save_profile_confirm(mock_getpass, mock_input)

test_012_main_existing_profile(mock_getpass, mock_input)

test_013_main_new_profile_vm(mock_getpass, mock_input)

test_014_main_passphrase_file(mock_getpass, mock_input)

qubesadmin.tests.tools.qvm_backup_restore module

class qubesadmin.tests.tools.qvm_backup_restore.TC_00_qvm_backup_restore(methodName='runTest')

Bases: QubesTestCase

assertAppropriateLogging(missing_name, action)

Parameters:

• missing_name – NetVM or TemplateVM

• action – ‘skip_broken’, ‘ignore_missing’

Returns:

setUp()

Hook method for setting up the test fixture before exercising it.

tearDown()

Hook method for deconstructing the test fixture after testing it.

test_000_simple(mock_backup, mock_getpass, mock_input)

test_001_selected_vms(mock_backup, mock_getpass, mock_input)

test_010_handle_broken_no_problems()

test_011_handle_broken_missing_template()

test_012_handle_broken_missing_netvm()

test_100_restore_in_dispvm_parser()

Verify if qvm-backup-restore tool options matches un-parser for paranoid restore mode

qubesadmin.tests.tools.qvm_check module

class qubesadmin.tests.tools.qvm_check.TC_00_qvm_check(methodName='runTest')

Bases: QubesTestCase

test_000_exists()

test_001_exists_multi()

test_002_exists_verbose()

test_003_exists_multi_verbose()

test_004_running_verbose()

test_005_running_multi_verbose()

test_006_running_multi_verbose2()

test_007_not_running_verbose()

test_008_paused()

test_009_paused_multi()

test_010_template()

test_011_template_multi()

test_012_networked()

test_013_networked_multi()

qubesadmin.tests.tools.qvm_clone module

class qubesadmin.tests.tools.qvm_clone.TC_00_qvm_clone(methodName='runTest')

Bases: QubesTestCase

test_000_simple()

test_001_missing_vm()

test_002_ignore_errors()

test_004_pool()

test_005_pools()

test_006_new_cls()

qubesadmin.tests.tools.qvm_create module

class qubesadmin.tests.tools.qvm_create.TC_00_qvm_create(methodName='runTest')

Bases: QubesTestCase

test_000_just_appvm()

test_001_missing_vm()

test_002_custom_template()

test_003_properties()

test_004_pool()

test_005_pools()

test_005_root_copy_from()

test_006_root_move_from()

test_007_root_move_copy_both()

test_008_root_invalid_path()

test_009_help_classes()

test_011_standalonevm(check_output_mock)

test_012_invalid_label()

test_013_root_copy_from_template_based()

test_014_standalone_shortcut()

test_015_disp_shortcut()

qubesadmin.tests.tools.qvm_device module

Tests for the qvm-device tool.

class qubesadmin.tests.tools.qvm_device.TC_00_qvm_device(methodName='runTest')

Bases: QubesTestCase

Tests the output logic of the qvm-device tool

setUp()

Hook method for setting up the test fixture before exercising it.

test_000_list_all()

List all exposed vm devices. No devices are attached to other domains.

test_001_list_persistent_attach()

Attach the device exposed by the vm1 to the vm3 persistently.

test_002_list_list_temp_attach()

Attach the device exposed by the vm1 to the vm3 non-persistently.

test_010_attach()

Test attach action

test_011_attach_options()

Test attach action

test_011_attach_persistent()

Test attach action

test_012_attach_invalid()

Test attach action

test_013_attach_invalid2()

Test attach action

test_014_attach_invalid3()

Test attach action

test_020_detach()

Test detach action

test_021_detach_unknown()

Test detach action

test_022_detach_all()

Test detach action

qubesadmin.tests.tools.qvm_features module

class qubesadmin.tests.tools.qvm_features.TC_00_qvm_features(methodName='runTest')

Bases: QubesTestCase

test_000_list()

test_001_set()

test_002_get()

test_003_del()

qubesadmin.tests.tools.qvm_firewall module

class qubesadmin.tests.tools.qvm_firewall.TC_00_RuleAction(methodName='runTest')

Bases: QubesTestCase

setUp()

Hook method for setting up the test fixture before exercising it.

test_000_named_opts()

test_001_unnamed_opts()

test_002_unnamed_opts()

test_003_mixed_opts()

test_004_expire_absolute()

test_005_expire_relative()

test_006_dsthost_aliases()

test_007_none_errors()

class qubesadmin.tests.tools.qvm_firewall.TC_10_qvm_firewall(methodName='runTest')

Bases: QubesTestCase

setUp()

Hook method for setting up the test fixture before exercising it.

test_000_list()

test_001_list_default()

test_002_list_expire()

test_002_list_raw()

test_003_list_raw_reload()

test_010_add_after()

test_011_add_before()

test_020_del_number()

test_021_del_rule()

test_030_reset()

qubesadmin.tests.tools.qvm_kill module

class qubesadmin.tests.tools.qvm_kill.TC_00_qvm_kill(methodName='runTest')

Bases: QubesTestCase

test_000_with_vm()

test_001_missing_vm()

test_002_invalid_vm()

test_003_not_running()

test_004_other_error()

qubesadmin.tests.tools.qvm_ls module

class qubesadmin.tests.tools.qvm_ls.TC_00_Column(methodName='runTest')

Bases: QubesTestCase

test_100_init()

class qubesadmin.tests.tools.qvm_ls.TC_10_globals(methodName='runTest')

Bases: QubesTestCase

test_100_simple_flag()

test_900_formats_columns()

class qubesadmin.tests.tools.qvm_ls.TC_50_List(methodName='runTest')

Bases: QubesTestCase

test_100_list_with_status()

test_101_list_with_underscore()

test_102_list_selected()

test_102_raw_list()

test_103_list_all()

test_110_network_tree()

class qubesadmin.tests.tools.qvm_ls.TC_70_Tags(methodName='runTest')

Bases: QubesTestCase

setUp()

Hook method for setting up the test fixture before exercising it.

test_100_tag()

test_100_tag_nomatch()

test_100_tags()

test_100_tags_nomatch()

class qubesadmin.tests.tools.qvm_ls.TC_80_Power_state_filters(methodName='runTest')

Bases: QubesTestCase

setUp()

Hook method for setting up the test fixture before exercising it.

test_100_nofilter()

test_100_running()

test_100_running_or_halted()

class qubesadmin.tests.tools.qvm_ls.TC_90_List_with_qubesd_calls(methodName='runTest')

Bases: QubesTestCase

test_100_list_with_status()

test_101_list_selected()

class qubesadmin.tests.tools.qvm_ls.TestApp

Bases: object

qubesadmin.tests.tools.qvm_pause module

class qubesadmin.tests.tools.qvm_pause.TC_00_qvm_pause(methodName='runTest')

Bases: QubesTestCase

test_000_with_vm()

test_001_missing_vm()

test_002_invalid_vm()

test_003_not_running()

test_004_multiple_vms()

qubesadmin.tests.tools.qvm_pool module

class qubesadmin.tests.tools.qvm_pool.TC_00_qvm_pool(methodName='runTest')

Bases: QubesTestCase

test_000_list()

test_010_drivers()

test_020_add()

test_021_add_multiple()

test_030_remove()

test_031_remove_multiple()

test_040_info()

test_050_set()

test_051_set_invalid()

qubesadmin.tests.tools.qvm_prefs module

class qubesadmin.tests.tools.qvm_prefs.TC_00_qvm_prefs(methodName='runTest')

Bases: QubesTestCase

test_000_list()

test_001_no_vm()

test_002_set_property()

test_003_invalid_property()

test_004_set_invalid_property()

test_005_get_str()

test_006_get_vm()

test_007_get_vm_none()

test_008_set_vm_prop_none()

qubesadmin.tests.tools.qvm_remove module

class qubesadmin.tests.tools.qvm_remove.TC_00_qvm_remove(methodName='runTest')

Bases: QubesTestCase

test_000_single()

test_100_dependencies(mock_dependencies)

qubesadmin.tests.tools.qvm_run module

class qubesadmin.tests.tools.qvm_run.TC_00_qvm_run(methodName='runTest')

Bases: QubesTestCase

default_filter_esc()

setUp()

Hook method for setting up the test fixture before exercising it.

test_000_run_single()

test_000_run_single_auto_nogui()

test_001_run_multiple()

test_002_color_output()

test_002_passio()

test_002_passio_service()

test_003_no_color_output()

test_004_no_filter_esc()

test_005_localcmd(mock_popen)

test_006_run_single_with_gui()

test_007_run_service_with_gui()

test_008_dispvm_remote()

test_009_dispvm_remote_specific()

test_010_dispvm_local()

test_011_dispvm_local_specific()

test_012_exclude()

test_013_no_autostart()

test_014_dispvm_local_gui()

test_015_dispvm_local_no_gui()

test_016_run_single_windows()

test_020_run_exec_with_vmexec_not_supported()

test_020_run_exec_with_vmexec_supported()

test_021_paused_vm()

test_022_no_shell()

test_023_dispvm_no_shell()

test_024_no_shell_dashdash()

test_025_no_shell_double_dashdash()

test_026_no_shell_double_dashdash()

test_027_no_shell_dispvm()

test_028_argparse_bug_workaround()

test_029_command_is_dashdash()

test_030_no_shell_dispvm()

test_031_argparse_bug_workaround()

test_032_argparse_bug_workaround_unnamed_dispvm()

qubesadmin.tests.tools.qvm_service module

class qubesadmin.tests.tools.qvm_service.TC_00_qvm_service(methodName='runTest')

Bases: QubesTestCase

test_000_list()

test_001_list_l()

test_002_enable()

test_003_enable_opt()

test_004_enable_opt_mixed()

test_005_disable()

test_006_disable_opt()

test_007_get()

test_008_del()

test_009_del_legacy()

test_010_set_invalid()

qubesadmin.tests.tools.qvm_shutdown module

class qubesadmin.tests.tools.qvm_shutdown.TC_00_qvm_shutdown(methodName='runTest')

Bases: QubesTestCase

test_000_with_vm()

test_001_missing_vm()

test_002_invalid_vm()

test_003_not_running()

test_004_multiple_vms()

test_010_wait()

test –wait option

test_012_wait_all()

test –wait option, with multiple VMs

test_015_wait_all_kill_timeout()

test –wait option, with multiple VMs and killing on timeout

qubesadmin.tests.tools.qvm_start module

class qubesadmin.tests.tools.qvm_start.TC_00_qvm_start(methodName='runTest')

Bases: QubesTestCase

test_000_with_vm()

test_001_missing_vm()

test_002_invalid_vm()

test_003_already_running()

test_010_drive_cdrom()

test_011_drive_disk()

test_012_drive_disk()

test_013_drive_loop_local(mock_subprocess)

test_014_drive_loop_remote()

test_015_drive_failed_start()

test_016_drive_failed_attach()

qubesadmin.tests.tools.qvm_start_daemon module

class qubesadmin.tests.tools.qvm_start_daemon.TC_00_qvm_start_gui(methodName='runTest')

Bases: QubesTestCase

async mock_coroutine(mock, *args, **kwargs)

run_common_args()

setUp()

Hook method for setting up the test fixture before exercising it.

setup_common_args()

test_000_kde_args(proc_mock)

test_010_common_args()

test_011_common_args_debug()

test_012_common_args_rpc_clipboard()

test_013_common_args_guid_config()

test_020_start_gui_for_vm(proc_mock)

test_021_start_gui_for_vm_hvm(proc_mock)

test_022_start_gui_for_vm_hvm_stubdom()

test_030_start_gui_for_stubdomain()

test_031_start_gui_for_stubdomain_forced()

test_040_start_gui()

test_041_start_gui_running()

test_042_start_gui_pvh()

test_050_get_monitor_layout1(proc_mock)

test_051_get_monitor_layout_multiple(proc_mock)

test_052_get_monitor_layout_hidpi1(proc_mock)

test_052_get_monitor_layout_hidpi2(proc_mock)

test_052_get_monitor_layout_hidpi3(proc_mock)

test_060_send_monitor_layout()

test_061_send_monitor_layout_exclude()

test_062_send_monitor_layout_not_running()

test_063_send_monitor_layout_signal_existing()

test_070_send_monitor_layout_all()

qubesadmin.tests.tools.qvm_tags module

class qubesadmin.tests.tools.qvm_tags.TC_00_qvm_tags(methodName='runTest')

Bases: QubesTestCase

test_000_list()

test_001_list_action()

test_002_list_alias()

test_003_list_check()

test_004_list_check_missing()

test_005_list_empty()

test_010_add()

test_020_del()

qubesadmin.tests.tools.qvm_template_postprocess module

class qubesadmin.tests.tools.qvm_template_postprocess.QubesLocalMock

Bases: QubesTest

qubesd_call(dest, method, arg=None, payload=None, payload_stream=None)

Execute Admin API method.

If payload and payload_stream are both specified, they will be sent in that order.

Parameters:

• dest – Destination VM name

• method – Full API method name (‘admin…’)

• arg – Method argument (if any)

• payload – Payload send to the method

• payload_stream – file-like object to read payload from

Returns:

Data returned by qubesd (string)

Warning

payload_stream will get closed by this function

run_service(dest, service, **kwargs)

Run qrexec service in a given destination

kwargs are passed verbatim to subprocess.Popen().

Parameters:

• dest (str) – Destination - may be a VM name or empty string for default (for a given service)

• service (str) – service name

• filter_esc (bool) – filter escape sequences to protect terminal emulator

• user (str) – username to run service as

• localcmd (str) – Command to connect stdin/stdout to

• wait (bool) – Wait service run

• autostart (bool) – Automatically start the target VM

Return type:

subprocess.Popen

class qubesadmin.tests.tools.qvm_template_postprocess.TC_00_qvm_template_postprocess(methodName='runTest')

Bases: QubesTestCase

add_new_vm_side_effect(*args, **kwargs)

setUp()

Hook method for setting up the test fixture before exercising it.

tearDown()

Hook method for deconstructing the test fixture after testing it.

test_000_import_root_img_raw()

test_001_import_root_img_tar()

test_001_import_root_img_tar_pre_mar_2024()

test_002_import_root_img_no_overwrite()

test_005_reset_private_img()

test_010_import_appmenus()

test_011_import_appmenus_as_root(mock_getuid, mock_getgrnam)

test_012_import_appmenus_missing_user(mock_getuid, mock_getgrnam)

test_020_post_install(mock_import_root_img, mock_import_appmenus)

test_021_post_install_reinstall(mock_reset_private_img, mock_import_root_img, mock_import_appmenus)

test_022_post_install_skip_start(mock_reset_private_img, mock_import_root_img, mock_import_appmenus)

test_030_pre_remove()

test_031_pre_remove_existing_appvm()

test_040_missing_really()

test_050_template_config()

test_051_template_config_invalid()

test_052_template_config_virt_mode_pv()

async wait_for_shutdown(vm)

qubesadmin.tests.tools.qvm_unpause module

class qubesadmin.tests.tools.qvm_unpause.TC_00_qvm_unpause(methodName='runTest')

Bases: QubesTestCase

test_000_with_vm()

test_001_missing_vm()

test_002_invalid_vm()

test_003_not_running()

test_004_multiple_vms()

qubesadmin.tests.tools.qvm_volume module

class qubesadmin.tests.tools.qvm_volume.TC_00_qvm_volume(methodName='runTest')

Bases: QubesTestCase

setup_expected_calls_for_list(vms=('vm1', 'sys-net'))

test_000_list()

test_001_list_domain()

test_002_list_domain_pool()

test_003_list_pool()

test_004_list_multiple_domains()

test_005_list_default_action()

test_010_extend()

test_011_extend_error()

test_012_extend_deny_shrink()

test_013_resize_force_shrink()

test_020_revert()

test_021_revert_error()

test_022_revert_no_snapshots()

test_023_revert_specific()

test_030_set_revisions_to_keep()

test_031_set_rw()

test_032_set_invalid()

test_033_set_ephemeral()

test_040_info()

test_041_info_no_revisions()

test_042_info_single_prop()

test_043_info_revisions_only()

test_044_info_no_ephemeral()

test_050_import_file()

test_051_import_stdin()

test_052_import_file_size()

test_053_import_file_matching_size()

test_053_import_file_noresize()

Module contents

class qubesadmin.tests.tools.MockEventsReader(events, delay=0.05)

Bases: object

at_eof()

async readuntil(delim)

class qubesadmin.tests.tools.StderrBuffer

Bases: object

class qubesadmin.tests.tools.StdoutBuffer

Bases: object