taskcluster 93.0.0__tar.gz → 96.0.0__tar.gz

{taskcluster-93.0.0 → taskcluster-96.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: taskcluster
-Version: 93.0.0
+Version: 96.0.0
 Summary: Python client for Taskcluster
 Project-URL: Homepage, https://github.com/taskcluster/taskcluster
 Project-URL: Repository, https://github.com/taskcluster/taskcluster

{taskcluster-93.0.0 → taskcluster-96.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "taskcluster"
-version = "93.0.0"
+version = "96.0.0"
 description = "Python client for Taskcluster"
 readme = "README.md"
 license = {text = "MPL-2.0"}

{taskcluster-93.0.0 → taskcluster-96.0.0}/taskcluster/generated/aio/queue.py

@@ -368,6 +368,39 @@ class Queue(AsyncBaseClient):
 
         return await self._makeApiCall(self.funcinfo["cancelTask"], *args, **kwargs)
 
+    async def changeTaskPriority(self, *args, **kwargs):
+        """
+        Change Task Priority
+
+        This method updates the priority of a single unresolved task.
+
+        * Claimed or running tasks keep their current run priority until they are retried.
+        * Emits `taskPriorityChanged` events so downstream tooling can observe manual overrides.
+
+        This method is ``experimental``
+        """
+
+        return await self._makeApiCall(
+            self.funcinfo["changeTaskPriority"], *args, **kwargs
+        )
+
+    async def changeTaskGroupPriority(self, *args, **kwargs):
+        """
+        Change Task Group Priority
+
+        This method applies a new priority to unresolved tasks within a task group.
+
+        * Updates run in bounded batches to avoid long locks.
+        * Claimed or running tasks keep their current run priority until they are retried.
+        * Emits `taskGroupPriorityChanged` summary event at the end.
+
+        This method is ``experimental``
+        """
+
+        return await self._makeApiCall(
+            self.funcinfo["changeTaskGroupPriority"], *args, **kwargs
+        )
+
     async def claimWork(self, *args, **kwargs):
         """
         Claim Work
@@ -1051,6 +1084,24 @@ class Queue(AsyncBaseClient):
             "route": "/task-group/<taskGroupId>/cancel",
             "stability": "experimental",
         },
+        "changeTaskGroupPriority": {
+            "args": ["taskGroupId"],
+            "input": "v1/change-task-priority-request.json#",
+            "method": "post",
+            "name": "changeTaskGroupPriority",
+            "output": "v1/task-group-priority-change-response.json#",
+            "route": "/task-group/<taskGroupId>/priority",
+            "stability": "experimental",
+        },
+        "changeTaskPriority": {
+            "args": ["taskId"],
+            "input": "v1/change-task-priority-request.json#",
+            "method": "post",
+            "name": "changeTaskPriority",
+            "output": "v1/task-status-response.json#",
+            "route": "/task/<taskId>/priority",
+            "stability": "experimental",
+        },
         "claimTask": {
             "args": ["taskId", "runId"],
             "input": "v1/task-claim-request.json#",

{taskcluster-93.0.0 → taskcluster-96.0.0}/taskcluster/generated/aio/queueevents.py

@@ -758,6 +758,128 @@ class QueueEvents(AsyncBaseClient):
         }
         return self._makeTopicExchange(ref, *args, **kwargs)
 
+    def taskPriorityChanged(self, *args, **kwargs):
+        """
+        Task Priority Changed Messages
+
+        A message published when task priority was updated via `changeTaskPriority` API call.
+
+        This exchange takes the following keys:
+
+         * routingKeyKind: Identifier for the routing-key kind. This is always `'primary'` for the formalized routing key. (required)
+
+         * taskId: `taskId` for the task this message concerns (required)
+
+         * runId: `runId` of latest run for the task, `_` if no run is exists for the task.
+
+         * workerGroup: `workerGroup` of latest run for the task, `_` if no run is exists for the task.
+
+         * workerId: `workerId` of latest run for the task, `_` if no run is exists for the task.
+
+         * provisionerId: `provisionerId` this task is targeted at. (required)
+
+         * workerType: `workerType` this task must run on. (required)
+
+         * schedulerId: `schedulerId` this task was created by. (required)
+
+         * taskGroupId: `taskGroupId` this task was created in. (required)
+
+         * reserved: Space reserved for future routing-key entries, you should always match this entry with `#`. As automatically done by our tooling, if not specified.
+        """
+
+        ref = {
+            "exchange": "task-priority-changed",
+            "name": "taskPriorityChanged",
+            "routingKey": [
+                {
+                    "constant": "primary",
+                    "multipleWords": False,
+                    "name": "routingKeyKind",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "taskId",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "runId",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "workerGroup",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "workerId",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "provisionerId",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "workerType",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "schedulerId",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "taskGroupId",
+                },
+                {
+                    "multipleWords": True,
+                    "name": "reserved",
+                },
+            ],
+            "schema": "v1/task-priority-changed-message.json#",
+        }
+        return self._makeTopicExchange(ref, *args, **kwargs)
+
+    def taskGroupPriorityChanged(self, *args, **kwargs):
+        """
+        Task Group Priority Changed Messages
+
+        A message published when task group priority was changed via `changeTaskGroupPriority` API call.
+
+        This exchange takes the following keys:
+
+         * routingKeyKind: Identifier for the routing-key kind. This is always `'primary'` for the formalized routing key. (required)
+
+         * taskGroupId: `taskGroupId` for the task-group this message concerns (required)
+
+         * schedulerId: `schedulerId` for the task-group this message concerns (required)
+
+         * reserved: Space reserved for future routing-key entries, you should always match this entry with `#`. As automatically done by our tooling, if not specified.
+        """
+
+        ref = {
+            "exchange": "task-group-priority-changed",
+            "name": "taskGroupPriorityChanged",
+            "routingKey": [
+                {
+                    "constant": "primary",
+                    "multipleWords": False,
+                    "name": "routingKeyKind",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "taskGroupId",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "schedulerId",
+                },
+                {
+                    "multipleWords": True,
+                    "name": "reserved",
+                },
+            ],
+            "schema": "v1/task-group-priority-changed-message.json#",
+        }
+        return self._makeTopicExchange(ref, *args, **kwargs)
+
     funcinfo = {}
 
 

{taskcluster-93.0.0 → taskcluster-96.0.0}/taskcluster/generated/aio/workermanager.py

@@ -310,6 +310,25 @@ class WorkerManager(AsyncBaseClient):
 
         return await self._makeApiCall(self.funcinfo["removeWorker"], *args, **kwargs)
 
+    async def shouldWorkerTerminate(self, *args, **kwargs):
+        """
+        Should worker terminate
+
+        Informs if worker should terminate or keep working.
+        Worker might no longer be needed based on the set of factors:
+         - current capacity of the worker pool
+         - amount of pending and claimed tasks
+         - launch configuration changes
+
+        Decision is made during provision or scanning loop based on above mentioned conditions.
+
+        This method is ``experimental``
+        """
+
+        return await self._makeApiCall(
+            self.funcinfo["shouldWorkerTerminate"], *args, **kwargs
+        )
+
     async def listWorkersForWorkerPool(self, *args, **kwargs):
         """
         Workers in a Worker Pool
@@ -570,6 +589,14 @@ class WorkerManager(AsyncBaseClient):
             "route": "/worker/reregister",
             "stability": "experimental",
         },
+        "shouldWorkerTerminate": {
+            "args": ["workerPoolId", "workerGroup", "workerId"],
+            "method": "get",
+            "name": "shouldWorkerTerminate",
+            "output": "v1/should-worker-terminate-response.json#",
+            "route": "/workers/<workerPoolId>/<workerGroup>/<workerId>/should-terminate",
+            "stability": "experimental",
+        },
         "updateWorker": {
             "args": ["workerPoolId", "workerGroup", "workerId"],
             "input": "v1/create-worker-request.json#",

{taskcluster-93.0.0 → taskcluster-96.0.0}/taskcluster/generated/queue.py

@@ -364,6 +364,37 @@ class Queue(BaseClient):
 
         return self._makeApiCall(self.funcinfo["cancelTask"], *args, **kwargs)
 
+    def changeTaskPriority(self, *args, **kwargs):
+        """
+        Change Task Priority
+
+        This method updates the priority of a single unresolved task.
+
+        * Claimed or running tasks keep their current run priority until they are retried.
+        * Emits `taskPriorityChanged` events so downstream tooling can observe manual overrides.
+
+        This method is ``experimental``
+        """
+
+        return self._makeApiCall(self.funcinfo["changeTaskPriority"], *args, **kwargs)
+
+    def changeTaskGroupPriority(self, *args, **kwargs):
+        """
+        Change Task Group Priority
+
+        This method applies a new priority to unresolved tasks within a task group.
+
+        * Updates run in bounded batches to avoid long locks.
+        * Claimed or running tasks keep their current run priority until they are retried.
+        * Emits `taskGroupPriorityChanged` summary event at the end.
+
+        This method is ``experimental``
+        """
+
+        return self._makeApiCall(
+            self.funcinfo["changeTaskGroupPriority"], *args, **kwargs
+        )
+
     def claimWork(self, *args, **kwargs):
         """
         Claim Work
@@ -1021,6 +1052,24 @@ class Queue(BaseClient):
             "route": "/task-group/<taskGroupId>/cancel",
             "stability": "experimental",
         },
+        "changeTaskGroupPriority": {
+            "args": ["taskGroupId"],
+            "input": "v1/change-task-priority-request.json#",
+            "method": "post",
+            "name": "changeTaskGroupPriority",
+            "output": "v1/task-group-priority-change-response.json#",
+            "route": "/task-group/<taskGroupId>/priority",
+            "stability": "experimental",
+        },
+        "changeTaskPriority": {
+            "args": ["taskId"],
+            "input": "v1/change-task-priority-request.json#",
+            "method": "post",
+            "name": "changeTaskPriority",
+            "output": "v1/task-status-response.json#",
+            "route": "/task/<taskId>/priority",
+            "stability": "experimental",
+        },
         "claimTask": {
             "args": ["taskId", "runId"],
             "input": "v1/task-claim-request.json#",

{taskcluster-93.0.0 → taskcluster-96.0.0}/taskcluster/generated/queueevents.py

@@ -758,6 +758,128 @@ class QueueEvents(BaseClient):
         }
         return self._makeTopicExchange(ref, *args, **kwargs)
 
+    def taskPriorityChanged(self, *args, **kwargs):
+        """
+        Task Priority Changed Messages
+
+        A message published when task priority was updated via `changeTaskPriority` API call.
+
+        This exchange takes the following keys:
+
+         * routingKeyKind: Identifier for the routing-key kind. This is always `'primary'` for the formalized routing key. (required)
+
+         * taskId: `taskId` for the task this message concerns (required)
+
+         * runId: `runId` of latest run for the task, `_` if no run is exists for the task.
+
+         * workerGroup: `workerGroup` of latest run for the task, `_` if no run is exists for the task.
+
+         * workerId: `workerId` of latest run for the task, `_` if no run is exists for the task.
+
+         * provisionerId: `provisionerId` this task is targeted at. (required)
+
+         * workerType: `workerType` this task must run on. (required)
+
+         * schedulerId: `schedulerId` this task was created by. (required)
+
+         * taskGroupId: `taskGroupId` this task was created in. (required)
+
+         * reserved: Space reserved for future routing-key entries, you should always match this entry with `#`. As automatically done by our tooling, if not specified.
+        """
+
+        ref = {
+            "exchange": "task-priority-changed",
+            "name": "taskPriorityChanged",
+            "routingKey": [
+                {
+                    "constant": "primary",
+                    "multipleWords": False,
+                    "name": "routingKeyKind",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "taskId",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "runId",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "workerGroup",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "workerId",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "provisionerId",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "workerType",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "schedulerId",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "taskGroupId",
+                },
+                {
+                    "multipleWords": True,
+                    "name": "reserved",
+                },
+            ],
+            "schema": "v1/task-priority-changed-message.json#",
+        }
+        return self._makeTopicExchange(ref, *args, **kwargs)
+
+    def taskGroupPriorityChanged(self, *args, **kwargs):
+        """
+        Task Group Priority Changed Messages
+
+        A message published when task group priority was changed via `changeTaskGroupPriority` API call.
+
+        This exchange takes the following keys:
+
+         * routingKeyKind: Identifier for the routing-key kind. This is always `'primary'` for the formalized routing key. (required)
+
+         * taskGroupId: `taskGroupId` for the task-group this message concerns (required)
+
+         * schedulerId: `schedulerId` for the task-group this message concerns (required)
+
+         * reserved: Space reserved for future routing-key entries, you should always match this entry with `#`. As automatically done by our tooling, if not specified.
+        """
+
+        ref = {
+            "exchange": "task-group-priority-changed",
+            "name": "taskGroupPriorityChanged",
+            "routingKey": [
+                {
+                    "constant": "primary",
+                    "multipleWords": False,
+                    "name": "routingKeyKind",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "taskGroupId",
+                },
+                {
+                    "multipleWords": False,
+                    "name": "schedulerId",
+                },
+                {
+                    "multipleWords": True,
+                    "name": "reserved",
+                },
+            ],
+            "schema": "v1/task-group-priority-changed-message.json#",
+        }
+        return self._makeTopicExchange(ref, *args, **kwargs)
+
     funcinfo = {}
 
 

{taskcluster-93.0.0 → taskcluster-96.0.0}/taskcluster/generated/workermanager.py

@@ -292,6 +292,25 @@ class WorkerManager(BaseClient):
 
         return self._makeApiCall(self.funcinfo["removeWorker"], *args, **kwargs)
 
+    def shouldWorkerTerminate(self, *args, **kwargs):
+        """
+        Should worker terminate
+
+        Informs if worker should terminate or keep working.
+        Worker might no longer be needed based on the set of factors:
+         - current capacity of the worker pool
+         - amount of pending and claimed tasks
+         - launch configuration changes
+
+        Decision is made during provision or scanning loop based on above mentioned conditions.
+
+        This method is ``experimental``
+        """
+
+        return self._makeApiCall(
+            self.funcinfo["shouldWorkerTerminate"], *args, **kwargs
+        )
+
     def listWorkersForWorkerPool(self, *args, **kwargs):
         """
         Workers in a Worker Pool
@@ -550,6 +569,14 @@ class WorkerManager(BaseClient):
             "route": "/worker/reregister",
             "stability": "experimental",
         },
+        "shouldWorkerTerminate": {
+            "args": ["workerPoolId", "workerGroup", "workerId"],
+            "method": "get",
+            "name": "shouldWorkerTerminate",
+            "output": "v1/should-worker-terminate-response.json#",
+            "route": "/workers/<workerPoolId>/<workerGroup>/<workerId>/should-terminate",
+            "stability": "experimental",
+        },
         "updateWorker": {
             "args": ["workerPoolId", "workerGroup", "workerId"],
             "input": "v1/create-worker-request.json#",