shotgun-api3 3.9.0__py2.py3-none-any.whl → 3.9.2__py2.py3-none-any.whl

shotgun_api3/__init__.py

@@ -8,6 +8,40 @@
 # agreement to the Shotgun Pipeline Toolkit Source Code License. All rights
 # not expressly granted therein are reserved by Shotgun Software Inc.
 
+import os
+import sys
+import warnings
+
+if sys.version_info < (3, 7):
+    if os.environ.get("SHOTGUN_ALLOW_OLD_PYTHON", "0") != "1":
+        # This is our preferred default behavior when using an old
+        # unsupported Python version.
+        # This way, we can control where the exception is raised, and it provides a
+        # comprehensive error message rather than having users facing a random
+        # Python traceback and trying to understand this is due to using an
+        # unsupported Python version.
+
+        raise RuntimeError("This module requires Python version 3.7 or higher.")
+
+    warnings.warn(
+        "Python versions older than 3.7 are no longer supported as of January "
+        "2023. Since the SHOTGUN_ALLOW_OLD_PYTHON variable is enabled, this "
+        "module is raising a warning instead of an exception. "
+        "However, it is very likely that this module will not be able to work "
+        "on this Python version.",
+        RuntimeWarning,
+        stacklevel=2,
+    )
+elif sys.version_info < (3, 9):
+    warnings.warn(
+        "Python versions older than 3.9 are no longer supported as of March "
+        "2025 and compatibility will be discontinued after March 2026. "
+        "Please update to Python 3.11 or any other supported version.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+
+
 from .shotgun import (
     Shotgun,
     ShotgunError,

shotgun_api3/lib/mockgun/mockgun.py

@@ -115,6 +115,7 @@ Below is a non-exhaustive list of things that we still need to implement:
 """
 
 import datetime
+from typing import Any
 
 from ... import ShotgunError
 from ...shotgun import _Config
@@ -580,7 +581,7 @@ class Shotgun(object):
             row[field] = default_value
         return row
 
-    def _compare(self, field_type, lval, operator, rval):
+    def _compare(self, field_type: str, lval: Any, operator: str, rval: Any) -> bool:
         """
         Compares a field using the operator and value provide by the filter.
 
@@ -797,7 +798,7 @@ class Shotgun(object):
 
             return self._compare(field_type, lval, operator, rval)
 
-    def _rearrange_filters(self, filters):
+    def _rearrange_filters(self, filters: list) -> None:
         """
         Modifies the filter syntax to turn it into a list of three items regardless
         of the actual filter. Most of the filters are list of three elements, so this doesn't change much.

shotgun_api3/lib/mockgun/schema.py

@@ -47,7 +47,7 @@ class SchemaFactory(object):
     _schema_cache_path = None
 
     @classmethod
-    def get_schemas(cls, schema_path, schema_entity_path):
+    def get_schemas(cls, schema_path: str, schema_entity_path: str) -> tuple:
         """
         Retrieves the schemas from disk.