Skip to main content
Ctrl+K

3-ID-C BITS 0.0.1

  • Tutorials
  • How-to guides
  • Reference
  • Explanation
  • Contributing
  • API Reference
  • GitHub
  • Issue tracker
  • Tutorials
  • How-to guides
  • Reference
  • Explanation
  • Contributing
  • API Reference
  • GitHub
  • Issue tracker

Section Navigation

  • Cheat sheet
  • Quick reference
  • Configuration files
  • Presentations
  • API Reference
    • id3c
      • id3c.callbacks
        • id3c.callbacks.demo_nexus_callback
        • id3c.callbacks.demo_spec_callback
      • id3c.configs
      • id3c.devices
        • id3c.devices.area_detector
        • id3c.devices.interlocked_motor
        • id3c.devices.laser_optics
        • id3c.devices.omega_laser_interlock
      • id3c.plans
        • id3c.plans.ad_plugins
        • id3c.plans.flyscan_3idc
        • id3c.plans.sim_plans
      • id3c.startup
      • id3c.suspenders
      • id3c.tests
        • id3c.tests.test_ad_plugins
        • id3c.tests.test_check_ad_files_symlink
        • id3c.tests.test_check_cam_armed
        • id3c.tests.test_effective_num_images
        • id3c.tests.test_ensure_ad_files_symlink
        • id3c.tests.test_expected_frame_count
        • id3c.tests.test_external_link_target
        • id3c.tests.test_flyscan_3idc_analysis
        • id3c.tests.test_flyscan_repair
        • id3c.tests.test_pair_frames_from_ad_file
        • id3c.tests.test_path_templates
        • id3c.tests.test_wait_for_openable
        • id3c.tests.test_write_flyscan_data
      • id3c.user
        • id3c.user.s3idc_plans
      • id3c.utils
        • id3c.utils.flyscan_3idc_analysis
        • id3c.utils.flyscan_repair
  • Reference
  • API Reference
  • id3c
  • id3c.tests
  • id3c.tests.test_ensure_ad_files_symlink

id3c.tests.test_ensure_ad_files_symlink#

Tests for id3c.plans.flyscan_3idc._ensure_ad_files_symlink.

The plan auto-creates the per-detector image-files symlink ({det.name}_files) next to the master file when it is safe to do so, and falls back to a descriptive WARNING otherwise. It must never raise.

Functions#

test_creates_symlink_when_target_exists(tmp_path)

A resolvable mount yields a real symlink named {det.name}_files.

test_symlink_name_follows_detector_name(tmp_path)

The link name tracks det.name (e.g. pilatus -> pilatus_files).

test_idempotent_when_link_already_present(tmp_path)

An existing link of any kind is left untouched and accepted.

test_existing_plain_directory_is_accepted(tmp_path)

A plain directory of the right name is accepted, not replaced.

test_warns_when_target_unknown(tmp_path, caplog)

No read_path_template -> no link created, a WARNING is emitted.

test_warns_when_target_does_not_exist(tmp_path, caplog)

A read_path_template that points nowhere -> no link, WARNING.

test_never_raises_on_unwritable_master_dir(tmp_path, ...)

A non-existent master_dir (cannot symlink into) -> False, no raise.

Module Contents#

id3c.tests.test_ensure_ad_files_symlink.test_creates_symlink_when_target_exists(tmp_path)[source]#

A resolvable mount yields a real symlink named {det.name}_files.

id3c.tests.test_ensure_ad_files_symlink.test_symlink_name_follows_detector_name(tmp_path)[source]#

The link name tracks det.name (e.g. pilatus -> pilatus_files).

id3c.tests.test_ensure_ad_files_symlink.test_idempotent_when_link_already_present(tmp_path)[source]#

An existing link of any kind is left untouched and accepted.

id3c.tests.test_ensure_ad_files_symlink.test_existing_plain_directory_is_accepted(tmp_path)[source]#

A plain directory of the right name is accepted, not replaced.

id3c.tests.test_ensure_ad_files_symlink.test_warns_when_target_unknown(tmp_path, caplog)[source]#

No read_path_template -> no link created, a WARNING is emitted.

id3c.tests.test_ensure_ad_files_symlink.test_warns_when_target_does_not_exist(tmp_path, caplog)[source]#

A read_path_template that points nowhere -> no link, WARNING.

id3c.tests.test_ensure_ad_files_symlink.test_never_raises_on_unwritable_master_dir(tmp_path, caplog)[source]#

A non-existent master_dir (cannot symlink into) -> False, no raise.

previous

id3c.tests.test_effective_num_images

next

id3c.tests.test_expected_frame_count

On this page
  • Functions
  • Module Contents
    • test_creates_symlink_when_target_exists()
    • test_symlink_name_follows_detector_name()
    • test_idempotent_when_link_already_present()
    • test_existing_plain_directory_is_accepted()
    • test_warns_when_target_unknown()
    • test_warns_when_target_does_not_exist()
    • test_never_raises_on_unwritable_master_dir()
Edit on GitHub
Show Source

© Copyright 2014-2026, APS.

Created using Sphinx 9.0.4.

Built with the PyData Sphinx Theme 0.20.0.