hardwarelibrary 1.3.2__tar.gz → 1.3.3__tar.gz

{hardwarelibrary-1.3.2 → hardwarelibrary-1.3.3}/CHANGELOG.md

@@ -6,6 +6,27 @@ API changes can land even when the minor version is unchanged.
 
 ## [Unreleased]
 
+## [1.3.3] - 2026-07-08
+
+### Changed
+- Heavy third-party modules are now imported lazily, at their point of use,
+  instead of at module load. `import hardwarelibrary` no longer pulls in
+  `matplotlib` or `numpy` (import time drops from ~336 ms to ~59 ms); they load
+  only when a plot is drawn or a spectrum is acquired. Affected: the
+  spectrometers package (`SpectraViewer` deferred into `display()`/`displayAny()`,
+  `numpy` into the methods that use it; `base.py` uses
+  `from __future__ import annotations` for its `-> np.array` hint),
+  `OscilloscopeDevice.displayWaveforms`, and the cameras module (`cv2`). Public
+  APIs are unchanged. Two behavioral notes: importing `hardwarelibrary.cameras`
+  no longer prints a warning when OpenCV is absent — a missing `cv2` now raises
+  `ModuleNotFoundError` when a camera operation is invoked; and the unused
+  matplotlib import block in `oceaninsight.py` was removed.
+
+### Removed
+- Dead `from pyftdi.ftdi import Ftdi` imports in `SutterDevice` and `EchoDevice`
+  (both were unused and flagged `# FIXME: should not be here`). FTDI access still
+  goes through `SerialPort`, which owns the `pyftdi` dependency.
+
 ## [1.3.2] - 2026-07-07
 
 ### Added

{hardwarelibrary-1.3.2 → hardwarelibrary-1.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hardwarelibrary
-Version: 1.3.2
+Version: 1.3.3
 Summary: Cross-platform (macOS, Windows, Linux, etc...) library to control various hardware devices mostly for scientific applications.
 Author-email: Daniel Cote <dccote@cervo.ulaval.ca>
 License: MIT

{hardwarelibrary-1.3.2 → hardwarelibrary-1.3.3}/hardwarelibrary/cameras/camera.py

@@ -4,12 +4,6 @@ from enum import Enum
 from hardwarelibrary.physicaldevice import PhysicalDevice
 from hardwarelibrary.notificationcenter import NotificationCenter, Notification
 from threading import Thread, RLock
-try:
-    import cv2
-except Exception as err:
-    print("No support for OpenCVcameras")
-    pass
-    
 import re
 
 class CameraDeviceNotification(Enum):
@@ -71,6 +65,8 @@ class CameraDevice(PhysicalDevice):
             raise RuntimeError("No monitoring loop running")
 
     def captureLoopSynchronous(self):
+        import cv2
+
         frame = None
         NotificationCenter().postNotification(notificationName=CameraDeviceNotification.didStartCapture,
                                               notifyingObject=self)
@@ -114,6 +110,8 @@ class OpenCVCamera(CameraDevice):
             self.cvCameraIndex = int(serialNumber)
 
     def openCVProperties(self):
+        import cv2
+
         properties = {}
         for property in dir(cv2):
             if re.search('CAP_', property) is not None:
@@ -139,6 +137,8 @@ class OpenCVCamera(CameraDevice):
         return wasAcquired
 
     def doInitializeDevice(self):
+        import cv2
+
         super().doInitializeDevice()
         with self.lock:
             # FIXME: Open the first camera we find

{hardwarelibrary-1.3.2 → hardwarelibrary-1.3.3}/hardwarelibrary/echodevice.py

@@ -8,8 +8,6 @@ import re
 import time
 from struct import *
 
-from pyftdi.ftdi import Ftdi #FIXME: should not be here.
-
 
 class EchoDevice(PhysicalDevice):
     classIdProduct = 0x6001

{hardwarelibrary-1.3.2 → hardwarelibrary-1.3.3}/hardwarelibrary/motion/sutterdevice.py

@@ -10,8 +10,6 @@ import re
 import time
 from struct import *
 
-from pyftdi.ftdi import Ftdi #FIXME: should not be here.
-
 class SutterDevice(LinearMotionDevice):
     classIdVendor = 4930
     classIdProduct = 1

{hardwarelibrary-1.3.2 → hardwarelibrary-1.3.3}/hardwarelibrary/oscilloscope/oscilloscopedevice.py

@@ -4,7 +4,6 @@ import struct
 from hardwarelibrary.communication.serialport import SerialPort
 from hardwarelibrary.physicaldevice import *
 from hardwarelibrary.notificationcenter import NotificationCenter, Notification
-import matplotlib.pyplot as plt
 
 class Channels(Enum):
     CH1     = "CH1"
@@ -35,6 +34,8 @@ class OscilloscopeDevice(PhysicalDevice):
         self.delay = None
 
     def displayWaveforms(self, channels=None):
+        import matplotlib.pyplot as plt
+
         if channels is None:
             channels = [Channels.CH1, Channels.CH2]
 

{hardwarelibrary-1.3.2 → hardwarelibrary-1.3.3}/hardwarelibrary/spectrometers/__init__.py

@@ -22,12 +22,12 @@ else:
 
 from .base import Spectrometer, getAllSubclasses
 from .oceaninsight import OISpectrometer, USB2000, USB4000, USB2000Plus, USB4000_2000Plus, USB650
-from .viewer import SpectraViewer
 
 def any() -> Spectrometer:
     return Spectrometer.any()
 
 def displayAny():
+    from .viewer import SpectraViewer
     spectrometer = Spectrometer.any()
     if spectrometer is not None:
         spectrometer.initializeDevice()

{hardwarelibrary-1.3.2 → hardwarelibrary-1.3.3}/hardwarelibrary/spectrometers/base.py

@@ -1,5 +1,6 @@
+from __future__ import annotations
+
 import time
-import numpy as np
 from abc import abstractmethod
 from struct import *
 import csv
@@ -17,7 +18,6 @@ import usb.backend.libusb1
 
 from pathlib import *
 from hardwarelibrary.physicaldevice import PhysicalDevice, DeviceState
-from hardwarelibrary.spectrometers.viewer import *
 
 class NoSpectrometerConnected(RuntimeError):
     pass
@@ -32,6 +32,8 @@ class Spectrometer(PhysicalDevice):
     idVendor = None
     idProduct = None
     def __init__(self, serialNumber=None, idProduct:int = None, idVendor:int = None):
+        import numpy as np
+
         PhysicalDevice.__init__(self, serialNumber=serialNumber, idProduct=idProduct, idVendor=idVendor)
         self.model = ""
         self.wavelength = np.linspace(400,1000,1024)
@@ -57,6 +59,7 @@ class Spectrometer(PhysicalDevice):
         """
         if self.state != DeviceState.Ready:
             self.initializeDevice()
+        from hardwarelibrary.spectrometers.viewer import SpectraViewer
         viewer = SpectraViewer(spectrometer=self)
         viewer.display()
 

{hardwarelibrary-1.3.2 → hardwarelibrary-1.3.3}/hardwarelibrary/spectrometers/oceaninsight.py

@@ -1,6 +1,5 @@
 try:
     import time
-    import numpy as np
     from struct import *
     import csv
     from typing import NamedTuple
@@ -17,18 +16,12 @@ try:
     import usb.util
     import usb.backend.libusb1
 
-    import matplotlib.backends as backends
-    import matplotlib.pyplot as plt
-    import matplotlib.animation as animation
-    from matplotlib.widgets import Button, TextBox
-
 
 except Exception as err:
     print('** Error importing modules. {0}'.format(err))
     print('We will attempt to continue and hope for the best.')
 
 from hardwarelibrary.spectrometers.base import *
-from hardwarelibrary.spectrometers.viewer import *
     
 """
 This is a simple script to use an Ocean Insight USB2000 spectrometer. You can
@@ -627,6 +620,8 @@ class USB2000(OISpectrometer):
             The spectrum, in 16-bit integers corresponding to each wavelength
             available in self.wavelength.
         """
+        import numpy as np
+
         spectrum = []
 
         for packet in range(32):
@@ -726,6 +721,8 @@ class USB4000_2000Plus(OISpectrometer):
             The spectrum, in 16-bit integers corresponding to each wavelength
             available in self.wavelength.
         """
+        import numpy as np
+
         spectrum = []
 
         if not self.lastStatus.isHighSpeed:
@@ -847,6 +844,8 @@ class DebugSpectro:
         intensity:float = None
 
     def __init__(self):
+        import numpy as np
+
         self.model = "Debug - Nothing is connected"
         self.wavelength = np.linspace(400,1000,1024)
         self.integrationTime = 10
@@ -862,6 +861,8 @@ class DebugSpectro:
         return "000-000-000"
 
     def getSpectrum(self):
+        import numpy as np
+
         spectrum = []
         time = self.getIntegrationTime()
         for wavelength in self.wavelength:
@@ -880,6 +881,7 @@ class DebugSpectro:
 
     def display(self):
         """ Display the spectrum with the SpectraViewer class."""
+        from hardwarelibrary.spectrometers.viewer import SpectraViewer
         viewer = SpectraViewer(spectrometer=self)
         viewer.display()
 

{hardwarelibrary-1.3.2 → hardwarelibrary-1.3.3}/hardwarelibrary.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hardwarelibrary
-Version: 1.3.2
+Version: 1.3.3
 Summary: Cross-platform (macOS, Windows, Linux, etc...) library to control various hardware devices mostly for scientific applications.
 Author-email: Daniel Cote <dccote@cervo.ulaval.ca>
 License: MIT

hardwarelibrary-1.3.3/hardwarelibrary.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "1.3.3",
+  "distance": 0,
+  "node": "g01bb7217e81f978dc03e5d4b7181f4e8a002b197",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-07-08"
+}

hardwarelibrary-1.3.2/hardwarelibrary.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "1.3.2",
-  "distance": 0,
-  "node": "g5d0a1c547033222aa72af252455ff6d0c7b9995d",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-07-07"
-}