Add comprehensive test suite with mocked hardware

[roesel]

Summary

This PR adds a comprehensive test suite for the elliptec library using mocked serial ports and controllers, eliminating the need for physical hardware during testing. The test suite covers all device classes (Rotator, Linear, Iris, Slider, Shutter) and core components (Controller, scan module).

Key Changes

New Test Files

• tests/test_devices_mock.py: Comprehensive tests for all device classes using mocked controllers

  • Tests for Rotator (ELL14/ELL18): angle conversions, get/set/shift operations
  • Tests for Linear (ELL20): distance conversions and movement operations
  • Tests for Iris (ELL15): aperture range checking and movement with bounds validation
  • Tests for Slider (ELL6/ELL9): slot positioning and multi-slot configurations
  • Tests for Shutter: open/close operations with normal and inverted modes
  • Tests for Motor and ContinuousMotor base classes: home, jog, offset, and status extraction

• tests/test_controller.py: Controller class tests with mocked serial ports

  • Connection initialization and error handling
  • Context manager behavior
  • Response parsing (position, status, info dict)
  • Instruction sending with various message formats (string, int, negative int)
  • Connection closing

• tests/test_scan.py: Scan module tests

  • Port discovery with and without serial numbers
  • Device scanning across address ranges
  • Error handling for serial exceptions

• tests/conftest.py: Shared test fixtures and utilities

  • make_info_response(): Factory function for creating canned info responses
  • mock_controller fixture: Pre-configured mocked Controller instance

Test Infrastructure

• Uses unittest.mock for mocking serial ports and controller responses
• Helper function _make_device() instantiates device classes with mocked controllers
• Canned protocol responses eliminate need for real hardware communication
• Tests cover both unit-level conversions and integration with mocked controller

Existing Code Updates

• tests/test_unit.py: Added tests for motor info parsing (I1, I2 response codes) and move_check error handling

Implementation Details

• Mock strategy: Controller.send_instruction is mocked to return canned protocol responses
• Device initialization properly loads motor info on first call, then returns position/status tuples
• Tests verify both low-level conversions (_pos_to_unit, _unit_to_pos) and high-level operations (get/set/shift)
• Comprehensive coverage of edge cases: out-of-range values, invalid commands, inverted modes
• All tests are isolated and can run without any physical hardware or serial ports

https://claude.ai/code/session_01P9qVe3TkpdEfGtupr8TxC4

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!