id3c.tests.test_check_ad_files_symlink

Tests for id3c.plans.flyscan_3idc._check_ad_files_symlink.

Verifies: - existing image-files symlink (symlink OR plain dir) is silently

accepted;

• a missing symlink emits a WARNING containing the suggested ln -s command and the verification steps;

• the warning fires once per (master_dir, target) combination;

• a custom read_path_template is reflected in the suggested target;

• when read_path_template is missing the helper uses a placeholder the operator must fill in;

• the helper never creates or modifies the link.

Functions

test_existing_ad_files_symlink_is_accepted_silently(...)	A pre-existing ad_files symlink (any target) means no warning.
test_existing_ad_files_directory_is_accepted_silently(...)	A plain directory named {det.name}_files (no symlink) is accepted.
test_missing_ad_files_emits_warning_with_ln_s_command(...)	Missing ad_files emits a WARNING with the ln -s recipe.
test_warning_fires_only_once_per_master_dir_target_combination(...)	Second call with the same (master_dir, target) is silent.
test_warning_fires_again_when_master_dir_changes(...)	A different master_dir legitimately warns again.
test_missing_read_path_template_uses_placeholder(...)	Missing read_path_template yields a placeholder target.
test_helper_never_creates_the_symlink(tmp_path)	Pure paranoia: the helper must never create the link.

Module Contents

id3c.tests.test_check_ad_files_symlink.test_existing_ad_files_symlink_is_accepted_silently(tmp_path, caplog)

A pre-existing ad_files symlink (any target) means no warning.

id3c.tests.test_check_ad_files_symlink.test_existing_ad_files_directory_is_accepted_silently(tmp_path, caplog)

A plain directory named {det.name}_files (no symlink) is accepted.

id3c.tests.test_check_ad_files_symlink.test_missing_ad_files_emits_warning_with_ln_s_command(tmp_path, caplog)

Missing ad_files emits a WARNING with the ln -s recipe.

Verifies the warning includes the suggested command, the verification step, and the audience-appropriate explanation.

id3c.tests.test_check_ad_files_symlink.test_warning_fires_only_once_per_master_dir_target_combination(tmp_path, caplog)

Second call with the same (master_dir, target) is silent.

id3c.tests.test_check_ad_files_symlink.test_warning_fires_again_when_master_dir_changes(tmp_path, caplog)

A different master_dir legitimately warns again.

id3c.tests.test_check_ad_files_symlink.test_missing_read_path_template_uses_placeholder(tmp_path, caplog)

Missing read_path_template yields a placeholder target.

The operator must fill it in; we explicitly do NOT guess /.

id3c.tests.test_check_ad_files_symlink.test_helper_never_creates_the_symlink(tmp_path)

Pure paranoia: the helper must never create the link.