intersect-sdk-common 0.9.3__tar.gz → 0.9.5__tar.gz

{intersect_sdk_common-0.9.3 → intersect_sdk_common-0.9.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: intersect-sdk-common
-Version: 0.9.3
+Version: 0.9.5
 Summary: Python SDK to interact with INTERSECT
 Keywords: intersect
 Author: Lance Drane, Marshall McDonnell, Seth Hitefield, Andrew Ayres, Gregory Cage, Jesse McGaha, Robert Smith, Gavin Wiggins, Michael Brim, Rick Archibald, Addi Malviya Thakur
@@ -48,5 +48,5 @@ The INTERSECT-SDK MUST follow semantic versioning, and MUST update its semantic
 ```bash
 uv venv .venv
 source .venv/bin/activate
-uv sync --locked --all-extras --all-groups
+uv sync --all-extras --all-groups
 ```

{intersect_sdk_common-0.9.3 → intersect_sdk_common-0.9.5}/README.md

@@ -28,5 +28,5 @@ The INTERSECT-SDK MUST follow semantic versioning, and MUST update its semantic
 ```bash
 uv venv .venv
 source .venv/bin/activate
-uv sync --locked --all-extras --all-groups
+uv sync --all-extras --all-groups
 ```

intersect_sdk_common-0.9.5/pyproject.toml

@@ -0,0 +1,188 @@
+[project]
+name = "intersect-sdk-common"
+description = "Python SDK to interact with INTERSECT"
+authors = [
+  { name = "Lance Drane", email = "dranelt@ornl.gov" },
+  { name = "Marshall McDonnell", email = "mcdonnellmt@ornl.gov" },
+  { name = "Seth Hitefield", email = "hitefieldsd@ornl.gov" },
+  { name = "Andrew Ayres", email = "ayresaf@ornl.gov" },
+  { name = "Gregory Cage", email = "cagege@ornl.gov" },
+  { name = "Jesse McGaha", email = "mcgahajr@ornl.gov" },
+  { name = "Robert Smith", email = "smithrw@ornl.gov" },
+  { name = "Gavin Wiggins", email = "wigginsg@ornl.gov" },
+  { name = "Michael Brim", email = "brimmj@ornl.gov" },
+  { name = "Rick Archibald", email = "archibaldrk@ornl.gov" },
+  { name = "Addi Malviya Thakur", email = "malviyaa@ornl.gov" },
+]
+readme = "README.md"
+license = { text = "BSD-3-Clause" }
+requires-python = ">=3.10,<4.0"
+keywords = ["intersect"]
+version = "0.9.5"
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+  "pydantic>=2.7.0",
+  "paho-mqtt>=2.1.0,<3.0.0",
+  "pika>=1.3.2,<2.0.0",
+  "minio>=7.2.3",
+]
+
+[dependency-groups]
+dev = [
+  "pre-commit>=3.3.1",
+  "ruff==0.12.7",
+  "mypy>=1.10.0",
+  "codespell>=2.3.0",
+  "pytest>=7.3.2",
+  "pytest-cov>=4.1.0",
+  "httpretty>=1.1.4",
+]
+
+[build-system]
+requires = ["uv_build>=0.10.2,<0.11.0"]
+build-backend = "uv_build"
+
+[tool.ruff]
+line-length = 100
+format = { quote-style = 'single' }
+
+[tool.ruff.lint]
+isort = { known-first-party = ['src'] }
+pydocstyle = { convention = 'google' }
+flake8-quotes = { inline-quotes = 'single', multiline-quotes = 'double' }
+mccabe = { max-complexity = 20 }
+pylint = { max-args = 10, max-branches = 20, max-returns = 15, max-statements = 75 }
+# pyflakes and the relevant pycodestyle rules are already configured
+extend-select = [
+  'C90',   # mccabe complexity
+  'I',     # isort
+  'N',     # pep8-naming
+  'D',     # pydocstyle
+  'UP',    # pyupgrade
+  'YTT',   # flake8-2020
+  'ANN',   # flake8-annotations
+  'ASYNC', # flake8-async
+  'S',     # flake8-bandit
+  'BLE',   # flake8-blind-except
+  'B',     # flake8-bugbear
+  'A',     # flake8-builtins
+  'COM',   # flake8-commas
+  'C4',    # flake8-comprehensions
+  'DTZ',   # flake8-datetimez
+  'T10',   # flake8-debugger
+  'EM',    # flake8-error-message
+  'FA',    # flake8-future-annotations
+  'ISC',   # flake8-implicit-string-concat
+  'ICN',   # flake8-import-conventions
+  'G',     # flake8-logging-format
+  'INP',   # flake8-no-pep420
+  'PIE',   # flake8-PIE
+  'T20',   # flake8-T20
+  'PYI',   # flake8-pyi
+  'PT',    # flake8-pytest-style
+  'Q',     # flake8-quotes
+  'RSE',   # flake8-raise
+  'RET',   # flake8-return
+  'SLF',   # flake8-self
+  'SLOT',  # flake8-slots
+  'SIM',   # flake8-simplify
+  'TC',    # flake8-type-checking
+  'ARG',   # flake8-unused-arguments
+  'PTH',   # flake8-use-pathlib
+  'PGH',   # pygrep-hooks
+  'PL',    # pylint
+  'TRY',   # tryceratops
+  'FLY',   # flynt
+  'RUF',   # RUFF additional rules
+  'INT',   # flake8-gettext
+]
+# If you're seeking to disable a rule, first consider whether the rule is overbearing, or if it should only be turned off for your usecase.
+ignore = [
+  'COM812',  # formatter, handled by Ruff format
+  'ISC001',  # formatter, handled by Ruff format
+  'SIM105',  # "with contextlib.suppress():" is slower than try-except-pass
+  'ANN401',  # allow explicit "Any" typing, use with care
+  'PLR2004', # allow "magic numbers"
+]
+
+[tool.ruff.lint.flake8-type-checking]
+runtime-evaluated-base-classes = ["pydantic.BaseModel"]
+runtime-evaluated-decorators = [
+  "pydantic.dataclasses.dataclass",
+  "pydantic.validate_call",
+]
+
+[tool.ruff.lint.extend-per-file-ignores]
+'__init__.py' = [
+  'F401',  # __init__.py commonly has unused imports
+  'TC004', # do lazy imports when importing from the base module
+]
+'docs/*' = [
+  'D',      # the documentation folder does not need documentation
+  'INP001', # docs are not a namespace package
+]
+'tests/*' = [
+  'S101',   # allow assert statements in tests
+  'S106',   # don't care about credentials in tests
+  'S311',   # don't care about cryptographic security in tests
+  'SLF001', # allow private member access in tests
+  'ANN',    # tests in general don't need types, unless they are runtime types.
+  'ARG',    # allow unused parameters in tests
+  'D',      # ignore documentation in tests
+  'RUF012', # permit "mutable" class attributes to not be annotated with typing.ClassVar (these shouldn't be mutated anyways...)
+]
+
+# see https://mypy.readthedocs.io/en/stable/config_file.html for a complete reference
+[tool.mypy]
+strict = true
+ignore_missing_imports = true       # don't require typing for library stubs if they don't exist
+disallow_untyped_decorators = false # this is needed for library decorator compatibility, i.e. "retrying"
+plugins = ["pydantic.mypy"]
+
+[tool.pydantic-mypy]
+init_forbid_extra = true
+init_typed = true
+warn_required_dynamic_aliases = true
+warn_untyped_fields = true
+
+[tool.pytest.ini_options]
+log_cli = true
+addopts = "-ra"
+
+[tool.coverage.report]
+omit = [
+  '*__init__*', # __init__ files should just re-export other classes and functions
+]
+exclude_also = [
+  'pragma: no-cover',              # standard
+  'if (typing\\.)?TYPE_CHECKING:', # type checking blocks are not executed in coverage, but we don't care
+  '@(abc\\.)?abstractmethod',      # don't try to cover abstract methods
+  "class .*\\bProtocol\\):",       # don't cover protocol classes (similar to abstract classes)
+  'raise NotImplementedError',     # it's not implemented so shouldn't be covered
+  'except.* ImportError',          # these are usually used to throw a "friendlier" error and are not really worth testing
+]
+
+
+#[project.scripts]
+#test-all = "pytest tests/ --cov=src/intersect_sdk_common/ --cov-fail-under=80 --cov-report=html:reports/htmlcov/ --cov-report=xml:reports/coverage_report.xml --junitxml=reports/junit.xml"
+#test-all-debug = "pytest tests/ --cov=src/intersect_sdk_common/ --cov-fail-under=80 --cov-report=html:reports/htmlcov/ --cov-report=xml:reports/coverage_report.xml --junitxml=reports/junit.xml -s"
+#test-unit = "pytest tests/unit --cov=src/intersect_sdk_common/"
+#test-e2e = "pytest tests/e2e --cov=src/intersect_sdk_common/"
+#lint-docs = "sphinx-build -W --keep-going docs docs/_build"
+#lint-format = "ruff format"
+#lint-ruff = "ruff check --fix"
+#lint-mypy = "mypy src/intersect_sdk_common/"
+#lint-spelling = "codespell -w docs examples src tests *.md -S docs/_build"
+
+[tool.codespell]
+# Ref: https://github.com/codespell-project/codespell#using-a-config-file
+skip = '.git*,*.lock,.venv,.*cache/*,./docs/_build/*'
+check-hidden = true
+# ignore-regex = ''
+# ignore-words-list = ''

{intersect_sdk_common-0.9.3 → intersect_sdk_common-0.9.5}/src/intersect_sdk_common/control_plane/brokers/amqp_client.py

@@ -223,17 +223,22 @@ class AMQPClient(BrokerClient):
         else:
             logger.error('Unable to publish message %s on topic %s', payload, topic)
 
-    def subscribe(self, topic: str, persist: bool) -> None:
+    def subscribe(self, topic: str, persist: bool, queue_name: str) -> None:
         """Subscribe to a topic.
 
         topic: system-of-system hierarchy. In AMQP parlance this gets translated to the routing key.
         persist: If True, we will create an idempotent queue name which should persist
           even on broker or application shutdown. If False, we will allow the server to create a unique
           queue name, and the queue will be destroyed once the associated channel is closed.
+        queue_name: The name of the queue to subscribe to.
         """
         topic = _hierarchy_2_amqp(topic)
         cb = functools.partial(
-            self._create_queue, channel=self._channel_in, topic=topic, persist=persist
+            self._create_queue,
+            channel=self._channel_in,
+            topic=topic,
+            persist=persist,
+            queue_name=queue_name,
         )
         self._connection.ioloop.add_callback_threadsafe(cb)
 

{intersect_sdk_common-0.9.3 → intersect_sdk_common-0.9.5}/src/intersect_sdk_common/control_plane/brokers/broker_client.py

@@ -55,7 +55,7 @@ class BrokerClient(Protocol):
         """
         ...
 
-    def subscribe(self, topic: str, persist: bool) -> None:
+    def subscribe(self, topic: str, persist: bool, queue_name: str) -> None:
         """Subscribe to a topic over the pre-existing connection (via connect()).
 
         This function should ALSO be called by reconnect handlers, and not just directly.
@@ -64,6 +64,7 @@ class BrokerClient(Protocol):
         Args:
             topic: Topic to subscribe to.
             persist: Whether or not the queue subscribed to is intended to be long-lived.
+            queue_name: The name of the queue to subscribe to. Used or ignored depending on the protocol.
         """
         ...
 

{intersect_sdk_common-0.9.3 → intersect_sdk_common-0.9.5}/src/intersect_sdk_common/control_plane/brokers/mqtt_client.py

@@ -35,7 +35,6 @@ _MQTT_MAX_RETRIES = 10
 # this will be a breaking change, so only add it when ready to break
 def _hierarchy_2_mqtt(hierarchy: str) -> str:
     """Take the hierarchy string format saved in the Service and map it to the MQTT topic format. Currently just covers wildcards."""
-    # return hierarchy.replace('#', '+')
     return hierarchy.replace('*', '+')
 
 
@@ -166,12 +165,13 @@ class MQTTClient(BrokerClient):
             resolved_topic, payload, qos=self._max_supported_qos if persist else 0, properties=props
         )
 
-    def subscribe(self, topic: str, persist: bool) -> None:
+    def subscribe(self, topic: str, persist: bool, queue_name: str) -> None:  # noqa: ARG002
         """Subscribe to a topic over the pre-existing connection (via connect()).
 
         Args:
             topic: Topic to subscribe to.
             persist: Determine if the associated message queue of the topic is long-lived (True) or not (False)
+            queue_name: The name of the queue to subscribe to. Ignored with current MQTT implementation.
         """
         resolved_topic = _hierarchy_2_mqtt(topic)
         # NOTE: RabbitMQ only works with QOS of 1 and 0, and seems to convert QOS2 to QOS1
@@ -302,7 +302,7 @@ class MQTTClient(BrokerClient):
 
             self._connected_flag.set()
             for topic, topic_handler in self._control_plane_manager.get_all_subscription_channels():
-                self.subscribe(topic, topic_handler.topic_persist)
+                self.subscribe(topic, topic_handler.topic_persist, topic_handler.queue_name)
         else:
             # This will generally suggest a misconfiguration
             self._connected = False

{intersect_sdk_common-0.9.3 → intersect_sdk_common-0.9.5}/src/intersect_sdk_common/control_plane/control_plane_manager.py

@@ -10,14 +10,17 @@ from .brokers.broker_client import BrokerClient
 from .definitions import MessageCallback
 from .topic_handler import TopicHandler
 
-_CHANNEL_REGEX = re.compile(r'^[a-zA-Z0-9*/-]+[a-zA-Z0-9*#/-]$')
+_CHANNEL_REGEX = re.compile(r'^[a-zA-Z0-9_*/-]+[a-zA-Z0-9_*#/-]$')
 """Allow for these patterns:
 
 - alphanumeric characters
 - hyphens
+- underscores
 - `/` (topic separator; note that this is '.' on the broker)
 - `*` (wildcard for exactly one word)
 - `#` (wildcard for any number of words, but can ONLY appear at the end of the topic string, see section 4.7.1.2 at https://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc398718107)
+
+This should be permissive relative to other patterns. You must cover system/service/hierarchy regexes, capability regexes, and event name regexes.
 """
 
 
@@ -75,7 +78,11 @@ class ControlPlaneManager:
         self._wildcards: dict[str, TopicHandler] = {}
 
     def add_subscription_channel(
-        self, channel: str, callbacks: set[MessageCallback], persist: bool, queue_name: str
+        self,
+        channel: str,
+        callbacks: set[MessageCallback],
+        persist: bool,
+        queue_name: str,
     ) -> None:
         """Start listening for messages on a channel on all configured brokers.
 
@@ -115,7 +122,7 @@ class ControlPlaneManager:
             topic_handler.queue_name = queue_name
         if self.is_connected():
             for provider in self._control_providers:
-                provider.subscribe(channel, persist)
+                provider.subscribe(channel, persist, queue_name)
 
     def remove_subscription_channel(self, channel: str) -> bool:
         """Stop subscribing to a channel on all configured brokers.
@@ -167,7 +174,9 @@ class ControlPlaneManager:
                 return wildcard, topic_handler
         return None
 
-    def get_all_subscription_channels(self) -> itertools.chain[tuple[str, TopicHandler]]:
+    def get_all_subscription_channels(
+        self,
+    ) -> itertools.chain[tuple[str, TopicHandler]]:
         """Get all subscription channels, including wildcard channels.
 
         This function is safe to call from the broker clients, as it does not mutate state.

intersect_sdk_common-0.9.5/src/intersect_sdk_common/control_plane/custom_binary_protocol.py

@@ -0,0 +1,77 @@
+"""This module contains the binary specification for an INTERSECT message IF the protocol does not provide any built-in header support. If it does, use the built-in functionality of the protocol.
+
+Some protocols do not have any built-in header support, leaving it up to us to define the binary structure of the message. We want to avoid "chunking" messages into multiple parts, so a message should be guaranteed to include all metadata.
+"""
+
+from intersect_sdk_common import IntersectApplicationError
+
+_HEADER_KV_SEPARATOR = b'\x02'
+"""Indicates end of a header key and start of a header value.
+
+Used because applications should generally assign no special meaning to this byte, and this byte has no reason to appear in header keys or values.
+"""
+_HEADER_VALUE_SEPARATOR = b'\x03'
+"""Indicates end of a header value and start of the next header key.
+
+Used because applications should generally assign no special meaning to this byte, and this byte has no reason to appear in header keys or values.
+"""
+_PAYLOAD_SEPARATOR = b'\x01'
+"""Indicates end of headers and start of the payload.
+
+Used because applications should generally assign no special meaning to this byte, and this byte has no reason to appear in header keys or values.
+"""
+
+_TOTAL_REASONABLE_HEADER_BYTES = 131072
+"""The total number of bytes that should be reasonably expected to be used for header keys, values, and header separators combined. This provides applications with some level of DOS protection.
+
+It is rare in practice for ANY application to use this number of bytes for the total amount of headers, for example http2_max_header_size in NGINX is rarely set above 128KB
+"""
+
+CONTENT_TYPE_HEADER_KEY = 'content_type'
+CONTENT_TYPE_HEADER_KEY_BYTES = CONTENT_TYPE_HEADER_KEY.encode()
+
+
+def create_binary_message(body: bytes, content_type: str, headers: dict[str, str]) -> bytes:
+    """Create a binary message from the body, headers, and content type."""
+    return b''.join(
+        [
+            # content-type 'header' first (this is generally handled separately from other headers in many protocols)
+            CONTENT_TYPE_HEADER_KEY_BYTES,
+            _HEADER_KV_SEPARATOR,
+            content_type.encode(),
+            _HEADER_VALUE_SEPARATOR if len(headers) else b'',
+            # headers
+            _HEADER_VALUE_SEPARATOR.join(
+                _HEADER_KV_SEPARATOR.join([key.encode(), value.encode()])
+                for key, value in headers.items()
+            ),
+            # end of headers
+            _PAYLOAD_SEPARATOR,
+            # body
+            body,
+        ]
+    )
+
+
+def parse_binary_message(message: bytes) -> tuple[bytes, str, dict[str, str]]:
+    """Parse a binary message into its body, content type, and headers."""
+    # IMPORTANT!!! ----- Total length of header keys and values combined should be limited to first several bytes, terminate header search early if headers aren't a reasonable length.
+    payload_sep_location = message.find(_PAYLOAD_SEPARATOR, 0, _TOTAL_REASONABLE_HEADER_BYTES)
+    if payload_sep_location == -1:
+        msg = 'Probable malformed message: no payload separator found in first expected bytes, .'
+        raise IntersectApplicationError(msg)
+    header_string = message[:payload_sep_location]
+    headers = {
+        key.decode(): value.decode()
+        for key, value in (
+            header.split(_HEADER_KV_SEPARATOR)
+            for header in header_string.split(_HEADER_VALUE_SEPARATOR)
+        )
+    }
+    try:
+        content_type = headers.pop(CONTENT_TYPE_HEADER_KEY)
+    except KeyError as e:
+        msg = 'Probable malformed message: no content_type header found in message, discarding it.'
+        raise IntersectApplicationError(msg) from e
+
+    return message[payload_sep_location + 1 :], content_type, headers

{intersect_sdk_common-0.9.3 → intersect_sdk_common-0.9.5}/src/intersect_sdk_common/control_plane/topic_handler.py

@@ -23,7 +23,10 @@ class TopicHandler:
     """If this is a wildcard topic, the regex pattern to match incoming topics against (if no wildcards, this will be None)."""
 
     def __init__(
-        self, topic_persist: bool, queue_name: str, regex_pattern: str | None = None
+        self,
+        topic_persist: bool,
+        queue_name: str,
+        regex_pattern: str | None = None,
     ) -> None:
         """Initialize a TopicHandler instance.
 
@@ -37,14 +40,15 @@ class TopicHandler:
         self.queue_name = queue_name
 
         if regex_pattern:
+            # the generated regex must be permissive and allow any non-special characters _CHANNEL_REGEX (ControlPlaneManager) allows
             regex_builder = ['^']
             for char in regex_pattern:
                 if char == '*':
                     # match a single word (do not include the separator)
-                    regex_builder.append('[a-zA-Z0-9-]+')
+                    regex_builder.append('[a-zA-Z0-9_-]+')
                 elif char == '#':
                     # match any sequence of 0 or more words (make sure to allow for the separator)
-                    regex_builder.append('[a-zA-Z0-9/-]*')
+                    regex_builder.append('[a-zA-Z0-9/_-]*')
                 elif char == '/':
                     # in-memory topics use '/' as the separator, it is the protocol handler's responsibility to convert topics to use '/' as the separator
                     regex_builder.append('/')

intersect_sdk_common-0.9.3/pyproject.toml

@@ -1,183 +0,0 @@
-[project]
-name = "intersect-sdk-common"
-description = "Python SDK to interact with INTERSECT"
-authors = [
-    { name = "Lance Drane", email = "dranelt@ornl.gov" },
-    { name = "Marshall McDonnell", email = "mcdonnellmt@ornl.gov" },
-    { name = "Seth Hitefield", email = "hitefieldsd@ornl.gov" },
-    { name = "Andrew Ayres", email = "ayresaf@ornl.gov" },
-    { name = "Gregory Cage", email = "cagege@ornl.gov" },
-    { name = "Jesse McGaha", email = "mcgahajr@ornl.gov" },
-    { name = "Robert Smith", email = "smithrw@ornl.gov" },
-    { name = "Gavin Wiggins", email = "wigginsg@ornl.gov" },
-    { name = "Michael Brim", email = "brimmj@ornl.gov" },
-    { name = "Rick Archibald", email = "archibaldrk@ornl.gov" },
-    { name = "Addi Malviya Thakur", email = "malviyaa@ornl.gov" },
-]
-readme = "README.md"
-license = { text = "BSD-3-Clause" }
-requires-python = ">=3.10,<4.0"
-keywords = ["intersect"]
-version = "0.9.3"
-classifiers = [
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
-]
-dependencies = [
-    "pydantic>=2.7.0",
-    "paho-mqtt>=2.1.0,<3.0.0",
-    "pika>=1.3.2,<2.0.0",
-    "minio>=7.2.3",
-]
-
-[dependency-groups]
-lint = [
-    "pre-commit>=3.3.1",
-    "ruff==0.12.7",
-    "mypy>=1.10.0",
-    "codespell>=2.3.0",
-]
-test = ["pytest>=7.3.2", "pytest-cov>=4.1.0", "httpretty>=1.1.4"]
-
-[build-system]
-requires = ["uv_build>=0.10.2,<0.11.0"]
-build-backend = "uv_build"
-
-[tool.ruff]
-line-length = 100
-format = { quote-style = 'single' }
-
-[tool.ruff.lint]
-isort = { known-first-party = ['src'] }
-pydocstyle = { convention = 'google' }
-flake8-quotes = { inline-quotes = 'single', multiline-quotes = 'double' }
-mccabe = { max-complexity = 20 }
-pylint = { max-args = 10, max-branches = 20, max-returns = 15, max-statements = 75 }
-# pyflakes and the relevant pycodestyle rules are already configured
-extend-select = [
-    'C90',   # mccabe complexity
-    'I',     # isort
-    'N',     # pep8-naming
-    'D',     # pydocstyle
-    'UP',    # pyupgrade
-    'YTT',   # flake8-2020
-    'ANN',   # flake8-annotations
-    'ASYNC', # flake8-async
-    'S',     # flake8-bandit
-    'BLE',   # flake8-blind-except
-    'B',     # flake8-bugbear
-    'A',     # flake8-builtins
-    'COM',   # flake8-commas
-    'C4',    # flake8-comprehensions
-    'DTZ',   # flake8-datetimez
-    'T10',   # flake8-debugger
-    'EM',    # flake8-error-message
-    'FA',    # flake8-future-annotations
-    'ISC',   # flake8-implicit-string-concat
-    'ICN',   # flake8-import-conventions
-    'G',     # flake8-logging-format
-    'INP',   # flake8-no-pep420
-    'PIE',   # flake8-PIE
-    'T20',   # flake8-T20
-    'PYI',   # flake8-pyi
-    'PT',    # flake8-pytest-style
-    'Q',     # flake8-quotes
-    'RSE',   # flake8-raise
-    'RET',   # flake8-return
-    'SLF',   # flake8-self
-    'SLOT',  # flake8-slots
-    'SIM',   # flake8-simplify
-    'TC',   # flake8-type-checking
-    'ARG',   # flake8-unused-arguments
-    'PTH',   # flake8-use-pathlib
-    'PGH',   # pygrep-hooks
-    'PL',    # pylint
-    'TRY',   # tryceratops
-    'FLY',   # flynt
-    'RUF',   # RUFF additional rules
-    'INT',   # flake8-gettext
-]
-# If you're seeking to disable a rule, first consider whether the rule is overbearing, or if it should only be turned off for your usecase.
-ignore = [
-    'COM812',  # formatter, handled by Ruff format
-    'ISC001',  # formatter, handled by Ruff format
-    'SIM105',  # "with contextlib.suppress():" is slower than try-except-pass
-    'ANN401',  # allow explicit "Any" typing, use with care
-    'PLR2004', # allow "magic numbers"
-]
-
-[tool.ruff.lint.flake8-type-checking]
-runtime-evaluated-base-classes = ["pydantic.BaseModel"]
-runtime-evaluated-decorators = ["pydantic.dataclasses.dataclass","pydantic.validate_call"]
-
-[tool.ruff.lint.extend-per-file-ignores]
-'__init__.py' = [
-    'F401', # __init__.py commonly has unused imports
-    'TC004', # do lazy imports when importing from the base module
-]
-'docs/*' = [
-    'D',      # the documentation folder does not need documentation
-    'INP001', # docs are not a namespace package
-]
-'tests/*' = [
-    'S101',   # allow assert statements in tests
-    'S106',   # don't care about credentials in tests
-    'S311',   # don't care about cryptographic security in tests
-    'SLF001', # allow private member access in tests
-    'ANN',    # tests in general don't need types, unless they are runtime types.
-    'ARG',    # allow unused parameters in tests
-    'D',      # ignore documentation in tests
-    'RUF012', # permit "mutable" class attributes to not be annotated with typing.ClassVar (these shouldn't be mutated anyways...)
- ]
-
-# see https://mypy.readthedocs.io/en/stable/config_file.html for a complete reference
-[tool.mypy]
-strict = true
-ignore_missing_imports = true       # don't require typing for library stubs if they don't exist
-disallow_untyped_decorators = false # this is needed for library decorator compatibility, i.e. "retrying"
-plugins = ["pydantic.mypy"]
-
-[tool.pydantic-mypy]
-init_forbid_extra = true
-init_typed = true
-warn_required_dynamic_aliases = true
-warn_untyped_fields = true
-
-[tool.pytest.ini_options]
-log_cli = true
-addopts = "-ra"
-
-[tool.coverage.report]
-omit = [
-    '*__init__*', # __init__ files should just re-export other classes and functions
-]
-exclude_also = [
-  'pragma: no-cover',              # standard
-  'if (typing\\.)?TYPE_CHECKING:', # type checking blocks are not executed in coverage, but we don't care
-  '@(abc\\.)?abstractmethod',      # don't try to cover abstract methods
-  "class .*\\bProtocol\\):",       # don't cover protocol classes (similar to abstract classes)
-  'raise NotImplementedError',     # it's not implemented so shouldn't be covered
-  'except.* ImportError',          # these are usually used to throw a "friendlier" error and are not really worth testing
-]
-
-
-#[project.scripts]
-#test-all = "pytest tests/ --cov=src/intersect_sdk_common/ --cov-fail-under=80 --cov-report=html:reports/htmlcov/ --cov-report=xml:reports/coverage_report.xml --junitxml=reports/junit.xml"
-#test-all-debug = "pytest tests/ --cov=src/intersect_sdk_common/ --cov-fail-under=80 --cov-report=html:reports/htmlcov/ --cov-report=xml:reports/coverage_report.xml --junitxml=reports/junit.xml -s"
-#test-unit = "pytest tests/unit --cov=src/intersect_sdk_common/"
-#test-e2e = "pytest tests/e2e --cov=src/intersect_sdk_common/"
-#lint-docs = "sphinx-build -W --keep-going docs docs/_build"
-#lint-format = "ruff format"
-#lint-ruff = "ruff check --fix"
-#lint-mypy = "mypy src/intersect_sdk_common/"
-#lint-spelling = "codespell -w docs examples src tests *.md -S docs/_build"
-
-[tool.codespell]
-# Ref: https://github.com/codespell-project/codespell#using-a-config-file
-skip = '.git*,*.lock,.venv,.*cache/*,./docs/_build/*'
-check-hidden = true
-# ignore-regex = ''
-# ignore-words-list = ''