thormotion 0.4.2

A cross-platform motion control library for Thorlabs systems, written in Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

/*
Project: thormotion
GitHub: https://github.com/MillieFD/thormotion

BSD 3-Clause License, Copyright (c) 2025, Amelia Fraser-Dale

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the conditions of the LICENSE are met.
*/

use crate::error::sn::Error;

pub(crate) trait CheckSerialNumber {
    /// The unique serial number prefix for the implementing Thorlabs device type.
    /// See the Thorlabs APT Protocol, Issue 39, Page 32.
    const SERIAL_NUMBER_PREFIX: &'static str;

    /// Returns [`Error::Invalid`] if the serial number:
    /// 1. Does not match the serial number prefix for the target device type
    /// 2. Is not exactly eight-digits long
    /// 3. Contains non-numeric characters
    fn check_serial_number(serial_number: &String) -> Result<(), Error> {
        if serial_number.starts_with(Self::SERIAL_NUMBER_PREFIX)
            && serial_number.len() == 8
            && serial_number.chars().all(|c| c.is_numeric())
        {
            Ok(())
        } else {
            Err(Error::Invalid(serial_number.clone()))
        }
    }
}