dt-extensions-sdk 1.7.3__tar.gz → 1.8.0__tar.gz

{dt_extensions_sdk-1.7.3 → dt_extensions_sdk-1.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dt-extensions-sdk
-Version: 1.7.3
+Version: 1.8.0
 Project-URL: Documentation, https://github.com/dynatrace-extensions/dt-extensions-python-sdk#readme
 Project-URL: Issues, https://github.com/dynatrace-extensions/dt-extensions-python-sdk/issues
 Project-URL: Source, https://github.com/dynatrace-extensions/dt-extensions-python-sdk
@@ -10,20 +10,21 @@ License-File: LICENSE.txt
 Classifier: Development Status :: 4 - Beta
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
-Requires-Python: <3.11,>=3.10
+Requires-Python: <3.15,>=3.10
 Provides-Extra: cli
 Requires-Dist: dt-cli>=1.6.13; extra == 'cli'
 Requires-Dist: pyyaml; extra == 'cli'
 Requires-Dist: ruff; extra == 'cli'
-Requires-Dist: typer[all]; extra == 'cli'
+Requires-Dist: typer; extra == 'cli'
 Description-Content-Type: text/markdown
 
 # Dynatrace Extensions Python SDK
 
 [![PyPI - Version](https://img.shields.io/pypi/v/dt-extensions-sdk.svg)](https://pypi.org/project/dt-extensions-sdk)
-[![PyPI - Python Version](https://img.shields.io/badge/python-3.10-blue)](https://img.shields.io/badge/python-3.10-blue)
+[![PyPI - Python Version](https://img.shields.io/badge/python-3.10%20%7C%203.14-blue)](https://img.shields.io/badge/python-3.10%20%7C%203.14-blue)
 
 -----
 
@@ -41,7 +42,7 @@ The documentation can be found on [github pages](https://dynatrace-extensions.gi
 
 ### Requirements:
 
-* Python 3.10
+* Python 3.10 or 3.14
 
 ### Install the SDK
 

{dt_extensions_sdk-1.7.3 → dt_extensions_sdk-1.8.0}/README.md

@@ -1,7 +1,7 @@
 # Dynatrace Extensions Python SDK
 
 [![PyPI - Version](https://img.shields.io/pypi/v/dt-extensions-sdk.svg)](https://pypi.org/project/dt-extensions-sdk)
-[![PyPI - Python Version](https://img.shields.io/badge/python-3.10-blue)](https://img.shields.io/badge/python-3.10-blue)
+[![PyPI - Python Version](https://img.shields.io/badge/python-3.10%20%7C%203.14-blue)](https://img.shields.io/badge/python-3.10%20%7C%203.14-blue)
 
 -----
 
@@ -19,7 +19,7 @@ The documentation can be found on [github pages](https://dynatrace-extensions.gi
 
 ### Requirements:
 
-* Python 3.10
+* Python 3.10 or 3.14
 
 ### Install the SDK
 

{dt_extensions_sdk-1.7.3 → dt_extensions_sdk-1.8.0}/docs/guides/building.rst

@@ -27,10 +27,12 @@ Native dependencies
 | Your extension will run on a Dynatrace **Activegate** or **OneAgent**, which is a Linux or Windows machine, and it has a specific version of python.
 | This means that your extension must be built on a machine that has the same version of python as the Activegate.
 |
-| At this time, Dynatrace extensions run on **python 3.10**.
+| Dynatrace extensions support **python 3.10** and **python 3.14**.
+| We plan to end support for **python 3.10** around October/2026.
 |
-| When you build the extension with **dt-sdk build**, it downloads the dependencies **whl** files and places them in the lib folder of the extension.  
+| When you build the extension with **dt-sdk build**, it downloads the dependencies **whl** files and places them in the lib folder of the extension.
 | To obtain whl files for different a operating system than what the build machine is, the SDK provides the **--extra-platform** flag.
+| To download wheels for multiple Python versions, use the **--python-version** flag (can be specified multiple times).
 |
 | In summary, when building from Windows, you should use:
 |
@@ -43,6 +45,14 @@ Native dependencies
 | To get the correct extra wheel files for linux. Note, **manylinux2014_x86_64** works for several packages, but not all of them.
 | You need to investigate the dependencies of your extension to find the correct extra platform if that is the case.
 |
+
+| To build for multiple Python versions:
+|
+
+.. code-block:: bash
+
+    dt-sdk build --python-version 3.10 --python-version 3.14
+
 | When building from Linux, you should use:
 |
 
@@ -120,7 +130,7 @@ Musl vs libc
 | Extensions run on `libc`_ based systems, like Ubuntu, CentOS, Windows, etc.
 | You should not use a  `musl`_ based system, like Alpine, to build extensions.
 |
-| This means that if you are using a docker container to build the extension, you should use the **python:3.10** image, or any other image that is based on a `libc`_ system.
+| This means that if you are using a docker container to build the extension, you should use a **python:3.10** or **python:3.14** image, or any other image that is based on a `libc`_ system.
 |
 | The reason for this is that a **musl** based system will download native whl files that are not compatible with **libc** based systems.
 

{dt_extensions_sdk-1.7.3 → dt_extensions_sdk-1.8.0}/docs/guides/installation.rst

@@ -9,7 +9,7 @@ Requirements
 ``dt-extensions-sdk`` requires only the following dependencies to be
 present in the environment.
 
-- Python 3.10
+- Python 3.10 or 3.14
 
 Installing from PyPI
 ^^^^^^^^^^^^^^^^^^^^

{dt_extensions_sdk-1.7.3 → dt_extensions_sdk-1.8.0}/docs/guides/migration.rst

@@ -6,7 +6,7 @@ Migrating EF1 Extensions
 Requirements
 ============
 
-* `Python 3.10 <https://www.python.org/downloads/>`_
+* `Python 3.10 or 3.14 <https://www.python.org/downloads/>`_
 * ``dt-extensions-sdk`` installed and in your ``PATH`` (you can run with ``dt-sdk --help``).
 * `VSCode <https://code.visualstudio.com>`_ with the `Dynatrace Extensions <https://marketplace.visualstudio.com/items?itemName=DynatracePlatformExtensions.dynatrace-extensions>`_ extension installed.
 

{dt_extensions_sdk-1.7.3 → dt_extensions_sdk-1.8.0}/dynatrace_extension/__about__.py

@@ -3,4 +3,4 @@
 # SPDX-License-Identifier: MIT
 
 
-__version__ = "1.7.3"
+__version__ = "1.8.0"

{dt_extensions_sdk-1.7.3 → dt_extensions_sdk-1.8.0}/dynatrace_extension/cli/main.py

@@ -17,10 +17,8 @@ from .schema import ExtensionYaml
 app = typer.Typer(pretty_exceptions_show_locals=False, pretty_exceptions_enable=False)
 console = Console()
 
-# if we are not python 3.10.X, exit with an error
-if sys.version_info < (3, 10) or sys.version_info >= (3, 11):
-    console.print(f"Python 3.10.X is required to build extensions, you are using {sys.version_info}", style="bold red")
-    sys.exit(1)
+SUPPORTED_PYTHON_VERSIONS = ["3.10", "3.14"]
+
 
 CERT_DIR_ENVIRONMENT_VAR = "DT_CERTIFICATES_FOLDER"
 CERTIFICATE_DEFAULT_PATH = Path.home() / ".dynatrace" / "certificates"
@@ -106,6 +104,12 @@ def build(
         "-o",
         help="Only build for the extra platforms, useful when building from arm64 (mac)",
     ),
+    python_versions: list[str] | None = typer.Option(
+        None,
+        "--python-version",
+        "-p",
+        help=f"Python versions to download wheels for. Supported: {', '.join(SUPPORTED_PYTHON_VERSIONS)}",
+    ),
 ):
     """
     Builds and signs an extension using the developer fused key-certificate
@@ -119,6 +123,7 @@ def build(
     :param extra_index_url: Extra index url to use when downloading dependencies
     :param find_links: Extra index url to use when downloading dependencies
     :param only_extra_platforms: If true, only build for the extra platforms, useful when building from arm64
+    :param python_versions: Python versions to download wheels for, defaults to ['3.10']
     """
     console.print(f"Building and signing extension from {extension_dir} to {target_directory}", style="cyan")
     if target_directory is None:
@@ -127,7 +132,7 @@ def build(
         target_directory.mkdir()
 
     console.print("Stage 1 - Download and build dependencies", style="bold blue")
-    wheel(extension_dir, extra_platforms, extra_index_url, find_links, only_extra_platforms)
+    wheel(extension_dir, extra_platforms, extra_index_url, find_links, only_extra_platforms, python_versions)
 
     console.print("Stage 2 - Create the extension zip file", style="bold blue")
     built_zip = assemble(extension_dir, target_directory)
@@ -184,6 +189,11 @@ def assemble(
     return output
 
 
+def _version_to_pip_version(version: str) -> str:
+    """Convert a version string like '3.10' to pip format '310'."""
+    return version.replace(".", "")
+
+
 @app.command(help="Downloads the dependencies of the extension to the lib folder")
 def wheel(
     extension_dir: Path = typer.Argument(".", help="Path to the python extension"),
@@ -202,6 +212,12 @@ def wheel(
         "-o",
         help="Only build for the extra platforms, useful when building from arm64 (mac)",
     ),
+    python_versions: list[str] | None = typer.Option(
+        None,
+        "--python-version",
+        "-p",
+        help=f"Python versions to download wheels for. Supported: {', '.join(SUPPORTED_PYTHON_VERSIONS)}",
+    ),
 ):
     """
     Builds the extension and it's dependencies into wheel files
@@ -212,27 +228,43 @@ def wheel(
     :param extra_index_url: Extra index url to use when downloading dependencies
     :param find_links: Extra index url to use when downloading dependencies
     :param only_extra_platforms: If true, only build for the extra platforms, useful when building from arm64
+    :param python_versions: Python versions to download wheels for, defaults to ['3.10']
     """
+    # Handle OptionInfo objects when called directly (not via CLI)
+    if python_versions is None or isinstance(python_versions, typer.models.OptionInfo):
+        python_versions = ["3.10"]
+    if only_extra_platforms is None or isinstance(only_extra_platforms, typer.models.OptionInfo):
+        only_extra_platforms = False
+
+    # Validate python versions
+    for version in python_versions:
+        if version not in SUPPORTED_PYTHON_VERSIONS:
+            msg = (
+                f"Python version {version} is not supported. Supported versions: {', '.join(SUPPORTED_PYTHON_VERSIONS)}"
+            )
+            console.print(msg, style="bold red")
+            raise typer.Exit(1)
+
     relative_lib_folder_dir = "extension/lib"
     lib_folder: Path = extension_dir / relative_lib_folder_dir
     _clean_directory(lib_folder)
 
     console.print(f"Downloading dependencies to {lib_folder}", style="cyan")
 
-    # Downloads the dependencies and places them in the lib folder
-    command = [sys.executable, "-m", "pip", "wheel", "-w", relative_lib_folder_dir]
+    # Build the wheel for the extension itself (no deps)
+    command = [sys.executable, "-m", "pip", "wheel", "-w", relative_lib_folder_dir, "--no-deps"]
     if extra_index_url is not None:
         command.extend(["--extra-index-url", extra_index_url])
     if find_links is not None:
         command.extend(["--find-links", find_links])
-    if only_extra_platforms:
-        command.append("--no-deps")
     command.append(".")
     run_process(command, cwd=extension_dir)
 
-    if extra_platforms:
-        for extra_platform in extra_platforms:
-            console.print(f"Downloading wheels for platform {extra_platform}", style="cyan")
+    # Download dependencies for the current platform for each requested python version
+    if not only_extra_platforms:
+        for version in python_versions:
+            pip_version = _version_to_pip_version(version)
+            console.print(f"Downloading wheels for Python {version} (current platform)", style="cyan")
             command = [
                 sys.executable,
                 "-m",
@@ -241,17 +273,43 @@ def wheel(
                 "-d",
                 relative_lib_folder_dir,
                 "--only-binary=:all:",
-                "--platform",
-                extra_platform,
+                "--python-version",
+                pip_version,
             ]
             if extra_index_url:
                 command.extend(["--extra-index-url", extra_index_url])
             if find_links:
                 command.extend(["--find-links", find_links])
             command.append(".")
-
             run_process(command, cwd=extension_dir)
 
+    # Download dependencies for extra platforms for each requested python version
+    if extra_platforms:
+        for extra_platform in extra_platforms:
+            for version in python_versions:
+                pip_version = _version_to_pip_version(version)
+                console.print(f"Downloading wheels for Python {version}, platform {extra_platform}", style="cyan")
+                command = [
+                    sys.executable,
+                    "-m",
+                    "pip",
+                    "download",
+                    "-d",
+                    relative_lib_folder_dir,
+                    "--only-binary=:all:",
+                    "--python-version",
+                    pip_version,
+                    "--platform",
+                    extra_platform,
+                ]
+                if extra_index_url:
+                    command.extend(["--extra-index-url", extra_index_url])
+                if find_links:
+                    command.extend(["--find-links", find_links])
+                command.append(".")
+
+                run_process(command, cwd=extension_dir)
+
     console.print(f"Installed dependencies to {lib_folder}", style="bold green")
 
 

{dt_extensions_sdk-1.7.3 → dt_extensions_sdk-1.8.0}/dynatrace_extension/sdk/callback.py

@@ -23,6 +23,7 @@ class WrappedCallback:
         kwargs: dict | None = None,
         running_in_sim=False,
         activation_type: ActivationType | None = None,
+        offset_seconds: float | None = None,
     ):
         self.callback: Callable = callback
         if args is None:
@@ -48,6 +49,7 @@ class WrappedCallback:
         self.timeouts_count = 0  # counter per interval = 1 min by default
         self.exception_count = 0  # counter per interval = 1 min by default
         self.iterations = 0  # how many times we ran the callback iterator for this callback
+        self.offset_seconds = offset_seconds or self.calculate_initial_wait_time()
 
     def get_current_time_with_cluster_diff(self):
         return datetime.now() + timedelta(milliseconds=self.cluster_time_diff)
@@ -97,24 +99,28 @@ class WrappedCallback:
     def name(self):
         return self.callback.__name__
 
+    def calculate_initial_wait_time(self) -> float:
+        """
+        Here we chose a random second between 5 and 55 to start the callback
+        This is to distribute load for extension running on this host
+        """
+
+        now = self.get_current_time_with_cluster_diff()
+        random_second = random.randint(5, 55)  # noqa: S311
+        next_execution = datetime.now().replace(second=random_second, microsecond=0)
+        if next_execution <= now:
+            # The random chosen second already passed this minute
+            next_execution += timedelta(minutes=1)
+        wait_time = (next_execution - now).total_seconds()
+        self.logger.debug(f"Randomly choosing next execution time for callback {self} to be {next_execution}")
+        return wait_time
+
     def initial_wait_time(self) -> float:
-        if not self.running_in_sim:
-            """
-            Here we chose a random second between 5 and 55 to start the callback
-            This is to distribute load for extension running on this host
-            When running from the simulator, this is not done
-            """
-
-            now = self.get_current_time_with_cluster_diff()
-            random_second = random.randint(5, 55)  # noqa: S311
-            next_execution = datetime.now().replace(second=random_second, microsecond=0)
-            if next_execution <= now:
-                # The random chosen second already passed this minute
-                next_execution += timedelta(minutes=1)
-            wait_time = (next_execution - now).total_seconds()
-            self.logger.debug(f"Randomly choosing next execution time for callback {self} to be {next_execution}")
-            return wait_time
-        return 0
+        # When running from the simulator, we don't want any offset
+        if self.running_in_sim:
+            return 0
+
+        return self.offset_seconds
 
     def get_adjusted_metric_timestamp(self) -> datetime:
         """
@@ -151,4 +157,8 @@ class WrappedCallback:
         This is done using execution total, the interval and the start timestamp
         :return: float
         """
-        return self.start_timestamp_monotonic + self.interval.total_seconds() * (self.iterations or 1)
+        return (
+            self.initial_wait_time()
+            + self.start_timestamp_monotonic
+            + self.interval.total_seconds() * (self.iterations or 1)
+        )

{dt_extensions_sdk-1.7.3 → dt_extensions_sdk-1.8.0}/dynatrace_extension/sdk/extension.py

@@ -385,6 +385,7 @@ class Extension:
         interval: timedelta | int,
         args: tuple | None = None,
         activation_type: ActivationType | None = None,
+        offset_seconds: float | None = None,
     ) -> None:
         """Schedule a method to be executed periodically.
 
@@ -398,6 +399,7 @@ class Extension:
             args: Arguments to the callback, if any
             activation_type: Optional activation type when this callback should run,
                 can be 'ActivationType.LOCAL' or 'ActivationType.REMOTE'
+            offset_seconds: Optional offset of first execution represented in seconds. Offset is random if `offset_seconds` is `None`.
         """
 
         if isinstance(interval, int):
@@ -407,7 +409,10 @@ class Extension:
             msg = f"Interval must be at least 1 second, got {interval.total_seconds()} seconds"
             raise ValueError(msg)
 
-        callback = WrappedCallback(interval, callback, api_logger, args, activation_type=activation_type)
+        callback = WrappedCallback(
+            interval, callback, api_logger, args, activation_type=activation_type, offset_seconds=offset_seconds
+        )
+
         if self._is_fastcheck:
             self._scheduled_callbacks_before_run.append(callback)
         else:

{dt_extensions_sdk-1.7.3 → dt_extensions_sdk-1.8.0}/pyproject.toml

@@ -7,7 +7,7 @@ name = "dt-extensions-sdk"
 dynamic = ["version"]
 description = ''
 readme = "README.md"
-requires-python = ">=3.10,<3.11"
+requires-python = ">=3.10,<3.15"
 license = "MIT"
 keywords = []
 authors = [
@@ -17,13 +17,14 @@ classifiers = [
     "Development Status :: 4 - Beta",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.14",
     "Programming Language :: Python :: Implementation :: CPython",
     "Programming Language :: Python :: Implementation :: PyPy",
 ]
 dependencies = []
 
 [project.optional-dependencies]
-cli = [ "dt-cli>=1.6.13", "typer[all]", "pyyaml", "ruff"]
+cli = [ "dt-cli>=1.6.13", "typer", "pyyaml", "ruff"]
 
 [project.urls]
 Documentation = "https://github.com/dynatrace-extensions/dt-extensions-python-sdk#readme"
@@ -45,7 +46,7 @@ packages = ["dynatrace_extension"]
 dependencies = [
     "coverage[toml]>=6.5",
     "pytest",
-    "typer[all]",
+    "typer",
     "pyyaml",
     "dt-cli>=1.6.13",
     "freezegun"
@@ -72,7 +73,7 @@ dependencies = [
     "black>=23.1.0",
     "mypy>=1.0.0",
     "ruff>=0.9.10",
-    "typer[all]",
+    "typer",
     "pyyaml",
     "pytest",    
     "freezegun"
@@ -101,7 +102,7 @@ dependencies = [
     "sphinxcontrib-programoutput",
     "wutch",
     "dt-cli",
-    "typer[all]",
+    "typer",
     "pyyaml",
     "tomli"
 ]

{dt_extensions_sdk-1.7.3 → dt_extensions_sdk-1.8.0}/tests/cli/test_dt_sdk.py

@@ -98,6 +98,8 @@ class TestDtSdk(TestCase):
             extra_platforms=None,
             extra_index_url=None,
             find_links=None,
+            only_extra_platforms=False,
+            python_versions=None,
         )
 
         # Check that the built extension file exists

{dt_extensions_sdk-1.7.3 → dt_extensions_sdk-1.8.0}/tests/sdk/test_extension.py

@@ -1,7 +1,7 @@
 import threading
 import time
 import unittest
-from datetime import timedelta
+from datetime import datetime, timedelta
 from unittest.mock import MagicMock, mock_open, patch
 
 import pytest
@@ -277,6 +277,51 @@ class TestExtension(unittest.TestCase):
             callback_wait.wait(timeout=5)
         self.assertEqual(callback_call_count, 2)
 
+    def test_schedule_callback_with_offset(self):
+        extension = Extension()
+        extension.logger = MagicMock()
+        extension._running_in_sim = False
+        extension._is_fastcheck = False
+        extension._client = MagicMock()
+
+        callback_call_dt = {"callback_random": [], "callback_offset_15": [], "callback_offset_45": []}
+
+        def callback_random():
+            nonlocal callback_call_dt
+            callback_call_dt["callback_random"].append(datetime.now())
+
+        def callback_offset_15():
+            nonlocal callback_call_dt
+            callback_call_dt["callback_offset_15"].append(datetime.now())
+
+        def callback_offset_45():
+            nonlocal callback_call_dt
+            callback_call_dt["callback_offset_45"].append(datetime.now())
+
+        extension.schedule(callback_random, timedelta(seconds=60))  # Random offset in range 5 - 55 second of the minute
+        extension.schedule(callback_offset_15, timedelta(seconds=60), offset_seconds=15)  # Offset from now
+        extension.schedule(callback_offset_45, timedelta(seconds=60), offset_seconds=45)  # Offset from now
+
+        dt_start = datetime.now()
+        while datetime.now() - dt_start < timedelta(seconds=125):
+            extension._scheduler.run(blocking=False)
+            time.sleep(0.1)
+
+        assert len(callback_call_dt["callback_random"]) >= 2
+        assert len(callback_call_dt["callback_offset_15"]) >= 2
+        assert len(callback_call_dt["callback_offset_45"]) >= 2
+
+        assert 4 <= callback_call_dt["callback_random"][0].second <= 56
+        assert 14 <= (callback_call_dt["callback_offset_15"][0] - dt_start).total_seconds() <= 16
+        assert 44 <= (callback_call_dt["callback_offset_45"][0] - dt_start).total_seconds() <= 46
+
+        def interval(x):
+            return (x[1] - x[0]).total_seconds()
+
+        assert 59 <= interval(callback_call_dt["callback_random"]) <= 61
+        assert 59 <= interval(callback_call_dt["callback_offset_15"]) <= 61
+        assert 59 <= interval(callback_call_dt["callback_offset_45"]) <= 61
+
     def test_schedule_method_decorator(self):
         class MyExt(Extension):
             def __init__(self) -> None: