re-export classes to package-level; extract out constants common to both

ads modules to the generic adsx module

Author: pantheraleo-7

adafruit_ads1x15/__init__.py

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2018 Carter Nelson for Adafruit Industries
+# SPDX-FileCopyrightText: 2025 Asadullah Shaikh <github.com/pantheraleo-7>
+#
+# SPDX-License-Identifier: MIT
+
+"""
+`adafruit_ads1x15`
+====================================================
+
+Support for the ADS1x15 series of analog-to-digital converters.
+
+* Author(s): Carter Nelson
+"""
+
+from .ads1015 import ADS1015
+from .ads1115 import ADS1115
+from .analog_in import AnalogIn
+
+__all__ = ["ADS1015", "ADS1115", "AnalogIn"]

adafruit_ads1x15/ads1015.py

@@ -33,16 +33,6 @@
     3300: 0x00C0,
 }
 
-# Pins
-P0 = 0
-"""Analog Pin 0"""
-P1 = 1
-"""Analog Pin 1"""
-P2 = 2
-"""Analog Pin 2"""
-P3 = 3
-"""Analog Pin 3"""
-
 
 class ADS1015(ADS1x15):
     """Class for the ADS1015 12 bit ADC."""

adafruit_ads1x15/ads1115.py

@@ -34,16 +34,6 @@
     860: 0x00E0,
 }
 
-# Pins
-P0 = 0
-"""Analog Pin 0"""
-P1 = 1
-"""Analog Pin 1"""
-P2 = 2
-"""Analog Pin 2"""
-P3 = 3
-"""Analog Pin 3"""
-
 
 class ADS1115(ADS1x15):
     """Class for the ADS1115 16 bit ADC."""

adafruit_ads1x15/ads1x15.py

@@ -53,6 +53,16 @@
     16: 0x0A00,
 }
 
+# Pins
+A0 = 0
+"""Analog Pin 0"""
+A1 = 1
+"""Analog Pin 1"""
+A2 = 2
+"""Analog Pin 2"""
+A3 = 3
+"""Analog Pin 3"""
+
 
 class Mode:
     """An enum-like class representing possible ADC operating modes."""
@@ -141,7 +151,9 @@ def __init__(
     ):
         self._last_pin_read = None
         self.buf = bytearray(3)
-        self.initialized = False  # Prevents writing to ADC until all values are initialized
+        self.initialized = (
+            False  # Prevents writing to ADC until all values are initialized
+        )
         self.i2c_device = I2CDevice(i2c, address)
         self.gain = gain
         self.data_rate = self._data_rate_default() if data_rate is None else data_rate
@@ -214,7 +226,9 @@ def comparator_queue_length(self) -> int:
     def comparator_queue_length(self, comparator_queue_length: int) -> None:
         possible_comp_queue_lengths = self.comparator_queue_lengths
         if comparator_queue_length not in possible_comp_queue_lengths:
-            raise ValueError(f"Comparator Queue must be one of: {possible_comp_queue_lengths}")
+            raise ValueError(
+                f"Comparator Queue must be one of: {possible_comp_queue_lengths}"
+            )
         self._comparator_queue_length = comparator_queue_length
         if self.initialized:
             self._write_config()
@@ -243,7 +257,9 @@ def comparator_low_threshold(self, value: int) -> None:
         :param int value: 16-bit signed integer to write to register
         """
         if value < -32768 or value > 32767:
-            raise ValueError("Comparator Threshold value must be between -32768 and 32767")
+            raise ValueError(
+                "Comparator Threshold value must be between -32768 and 32767"
+            )
 
         self._comparator_low_threshold = value
         self._write_register(_ADS1X15_POINTER_LO_THRES, self.comparator_low_threshold)
@@ -255,7 +271,9 @@ def comparator_high_threshold(self, value: int) -> None:
         :param int value: 16-bit signed integer to write to register
         """
         if value < -32768 or value > 32767:
-            raise ValueError("Comparator Threshold value must be between -32768 and 32767")
+            raise ValueError(
+                "Comparator Threshold value must be between -32768 and 32767"
+            )
 
         self._comparator_high_threshold = value
         self._write_register(_ADS1X15_POINTER_HI_THRES, self.comparator_high_threshold)
@@ -423,20 +441,28 @@ def _read_config(self) -> None:
         config_value = self._read_register(_ADS1X15_POINTER_CONFIG)
 
         self.gain = next(
-            key for key, value in _ADS1X15_CONFIG_GAIN.items() if value == (config_value & 0x0E00)
+            key
+            for key, value in _ADS1X15_CONFIG_GAIN.items()
+            if value == (config_value & 0x0E00)
         )
         self.data_rate = next(
-            key for key, value in self.rate_config.items() if value == (config_value & 0x00E0)
+            key
+            for key, value in self.rate_config.items()
+            if value == (config_value & 0x00E0)
         )
         self.comparator_queue_length = next(
             key
             for key, value in _ADS1X15_CONFIG_COMP_QUEUE.items()
             if value == (config_value & 0x0003)
         )
         self.mode = Mode.SINGLE if config_value & 0x0100 else Mode.CONTINUOUS
-        self.comparator_mode = Comp_Mode.WINDOW if config_value & 0x0010 else Comp_Mode.TRADITIONAL
+        self.comparator_mode = (
+            Comp_Mode.WINDOW if config_value & 0x0010 else Comp_Mode.TRADITIONAL
+        )
         self.comparator_polarity = (
-            Comp_Polarity.ACTIVE_HIGH if config_value & 0x0008 else Comp_Polarity.ACTIVE_LOW
+            Comp_Polarity.ACTIVE_HIGH
+            if config_value & 0x0008
+            else Comp_Polarity.ACTIVE_LOW
         )
         self.comparator_latch = (
             Comp_Latch.LATCHING if config_value & 0x0004 else Comp_Latch.NONLATCHING