nc-py-api 0.22.0__tar.gz → 0.23.0__tar.gz

{nc_py_api-0.22.0 → nc_py_api-0.23.0}/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.23.0 - 2025-11-25]
+
+### Added
+
+- TaskProcessing: Add next_task_batch endpoint (#383)
+
+### Fixed
+
+- handle bot join messages properly to get conversation id and name (#385)
+
+## [0.22.0 - 2025-10-24]
+
+### Added
+
+- TaskProcessing: Add trigger_handler to set_handlers() (#382)
+
 ## [0.21.1 - 2025-08-27]
 
 ### Changed

{nc_py_api-0.22.0 → nc_py_api-0.23.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nc-py-api
-Version: 0.22.0
+Version: 0.23.0
 Summary: Nextcloud Python Framework
 Project-URL: Changelog, https://github.com/cloud-py-api/nc_py_api/blob/main/CHANGELOG.md
 Project-URL: Documentation, https://cloud-py-api.github.io/nc_py_api/

{nc_py_api-0.22.0 → nc_py_api-0.23.0}/nc_py_api/_version.py

@@ -1,3 +1,3 @@
 """Version of nc_py_api."""
 
-__version__ = "0.22.0"
+__version__ = "0.23.0"

{nc_py_api-0.22.0 → nc_py_api-0.23.0}/nc_py_api/ex_app/providers/task_processing.py

@@ -142,6 +142,23 @@ class _TaskProcessingProviderAPI:
                 return r
         return {}
 
+    def next_task_batch(
+        self, provider_ids: list[str], task_types: list[str], number_of_tasks: int
+    ) -> dict[str, typing.Any]:
+        """Get the next n task processing tasks from Nextcloud.
+
+        Available starting with Nextcloud 33
+        Returns: {tasks: [{task: Task, provider: string}], has_more: bool}
+        """
+        with contextlib.suppress(NextcloudException):
+            if r := self._session.ocs(
+                "GET",
+                "/ocs/v2.php/taskprocessing/tasks_provider/next_batch",
+                json={"providerIds": provider_ids, "taskTypeIds": task_types, "numberOfTasks": number_of_tasks},
+            ):
+                return r
+        return {"tasks": [], "has_more": False}
+
     def set_progress(self, task_id: int, progress: float) -> dict[str, typing.Any]:
         """Report new progress value of the task to Nextcloud. Progress should be in range from 0.0 to 100.0."""
         with contextlib.suppress(NextcloudException):
@@ -220,6 +237,23 @@ class _AsyncTaskProcessingProviderAPI:
                 return r
         return {}
 
+    async def next_task_batch(
+        self, provider_ids: list[str], task_types: list[str], number_of_tasks: int
+    ) -> dict[str, typing.Any]:
+        """Get the next n task processing tasks from Nextcloud.
+
+        Available starting with Nextcloud 33
+        Returns: {tasks: [{task: Task, provider: string}], has_more: bool}
+        """
+        with contextlib.suppress(NextcloudException):
+            if r := await self._session.ocs(
+                "GET",
+                "/ocs/v2.php/taskprocessing/tasks_provider/next_batch",
+                json={"providerIds": provider_ids, "taskTypeIds": task_types, "numberOfTasks": number_of_tasks},
+            ):
+                return r
+        return {"tasks": [], "has_more": False}
+
     async def set_progress(self, task_id: int, progress: float) -> dict[str, typing.Any]:
         """Report new progress value of the task to Nextcloud. Progress should be in range from 0.0 to 100.0."""
         with contextlib.suppress(NextcloudException):

{nc_py_api-0.22.0 → nc_py_api-0.23.0}/nc_py_api/talk_bot.py

@@ -76,11 +76,17 @@ class TalkBotMessage:
 
         It can be used to react or reply to the given message.
         """
+        # bot join
+        if self.message_type == "Join":
+            return self._raw_data["object"]["id"]
         return self._raw_data["target"]["id"]
 
     @property
     def conversation_name(self) -> str:
         """The name of the conversation in which the message was posted."""
+        # bot join
+        if self.message_type == "Join":
+            return self._raw_data["object"]["name"]
         return self._raw_data["target"]["name"]
 
     def __repr__(self):