nc-py-api 0.7.2__py3-none-any.whl → 0.8.0__py3-none-any.whl

nc_py_api/_session.py

@@ -1,5 +1,7 @@
 """Session represents one connection to Nextcloud. All related stuff for these live here."""
 
+import builtins
+import pathlib
 import re
 import typing
 from abc import ABC, abstractmethod
@@ -198,6 +200,8 @@ class NcSessionBasic(NcSessionBase, ABC):
             raise NextcloudException(408, info=info) from None
 
         check_error(response, info)
+        if response.status_code == 204:  # NO_CONTENT
+            return []
         response_data = loads(response.text)
         ocs_meta = response_data["ocs"]["meta"]
         if ocs_meta["status"] != "ok":
@@ -248,6 +252,15 @@ class NcSessionBasic(NcSessionBase, ABC):
     def set_user(self, user_id: str) -> None:
         self._user = user_id
 
+    def download2stream(self, url_path: str, fp, dav: bool = False, **kwargs):
+        if isinstance(fp, str | pathlib.Path):
+            with builtins.open(fp, "wb") as f:
+                self.download2fp(url_path, f, dav, **kwargs)
+        elif hasattr(fp, "write"):
+            self.download2fp(url_path, fp, dav, **kwargs)
+        else:
+            raise TypeError("`fp` must be a path to file or an object with `write` method.")
+
     def _get_adapter_kwargs(self, dav: bool) -> dict[str, typing.Any]:
         if dav:
             return {
@@ -274,6 +287,13 @@ class NcSessionBasic(NcSessionBase, ABC):
                 return
         self.response_headers = response.headers
 
+    def download2fp(self, url_path: str, fp, dav: bool, params=None, **kwargs):
+        adapter = self.adapter_dav if dav else self.adapter
+        with adapter.stream("GET", url_path, params=params) as response:
+            check_error(response)
+            for data_chunk in response.iter_raw(chunk_size=kwargs.get("chunk_size", 5 * 1024 * 1024)):
+                fp.write(data_chunk)
+
 
 class AsyncNcSessionBasic(NcSessionBase, ABC):
     adapter: AsyncClient
@@ -298,6 +318,8 @@ class AsyncNcSessionBasic(NcSessionBase, ABC):
             raise NextcloudException(408, info=info) from None
 
         check_error(response, info)
+        if response.status_code == 204:  # NO_CONTENT
+            return []
         response_data = loads(response.text)
         ocs_meta = response_data["ocs"]["meta"]
         if ocs_meta["status"] != "ok":
@@ -350,6 +372,15 @@ class AsyncNcSessionBasic(NcSessionBase, ABC):
     def set_user(self, user: str) -> None:
         self._user = user
 
+    async def download2stream(self, url_path: str, fp, dav: bool = False, **kwargs):
+        if isinstance(fp, str | pathlib.Path):
+            with builtins.open(fp, "wb") as f:
+                await self.download2fp(url_path, f, dav, **kwargs)
+        elif hasattr(fp, "write"):
+            await self.download2fp(url_path, fp, dav, **kwargs)
+        else:
+            raise TypeError("`fp` must be a path to file or an object with `write` method.")
+
     def _get_adapter_kwargs(self, dav: bool) -> dict[str, typing.Any]:
         if dav:
             return {
@@ -376,6 +407,13 @@ class AsyncNcSessionBasic(NcSessionBase, ABC):
                 return
         self.response_headers = response.headers
 
+    async def download2fp(self, url_path: str, fp, dav: bool, params=None, **kwargs):
+        adapter = self.adapter_dav if dav else self.adapter
+        async with adapter.stream("GET", url_path, params=params) as response:
+            check_error(response)
+            async for data_chunk in response.aiter_raw(chunk_size=kwargs.get("chunk_size", 5 * 1024 * 1024)):
+                fp.write(data_chunk)
+
 
 class NcSession(NcSessionBasic):
     cfg: Config

nc_py_api/_version.py

@@ -1,3 +1,3 @@
 """Version of nc_py_api."""
 
-__version__ = "0.7.2"
+__version__ = "0.8.0"

nc_py_api/ex_app/__init__.py

@@ -8,6 +8,6 @@ from .integration_fastapi import (
     set_handlers,
     talk_bot_app,
 )
-from .misc import persistent_storage, verify_version
+from .misc import get_model_path, persistent_storage, verify_version
 from .ui.files_actions import UiActionFileInfo
 from .uvicorn_fastapi import run_app

nc_py_api/ex_app/defs.py

@@ -39,7 +39,11 @@ class ApiScope(enum.IntEnum):
     """Allows access to Talk API endpoints."""
     TALK_BOT = 60
     """Allows to register Talk Bots."""
+    AI_PROVIDERS = 61
+    """Allows to register AI providers."""
     ACTIVITIES = 110
     """Activity App endpoints."""
     NOTES = 120
-    """Notes App endpoints"""
+    """Notes App endpoints."""
+    ALL = 9999
+    """All endpoints allowed."""

nc_py_api/ex_app/misc.py

@@ -43,3 +43,10 @@ def verify_version(finalize_update: bool = True) -> tuple[str, str] | None:
                 version_file.write(os.environ["APP_VERSION"])
                 version_file.truncate()
     return r
+
+
+def get_model_path(model_name: str) -> str:
+    """Wrapper around hugging_face's ``snapshot_download`` to return path to downloaded model directory."""
+    from huggingface_hub import snapshot_download  # noqa isort:skip pylint: disable=C0415 disable=E0401
+
+    return snapshot_download(model_name, local_files_only=True, cache_dir=persistent_storage())

nc_py_api/ex_app/providers/__init__.py

@@ -0,0 +1 @@
+"""APIs related to Nextcloud Providers."""

nc_py_api/ex_app/providers/providers.py

@@ -0,0 +1,31 @@
+"""Nextcloud API for AI Providers."""
+
+from ..._session import AsyncNcSessionApp, NcSessionApp
+from .speech_to_text import _AsyncSpeechToTextProviderAPI, _SpeechToTextProviderAPI
+from .text_processing import _AsyncTextProcessingProviderAPI, _TextProcessingProviderAPI
+
+
+class ProvidersApi:
+    """Class that encapsulates all AI Providers functionality."""
+
+    speech_to_text: _SpeechToTextProviderAPI
+    """SpeechToText Provider API."""
+    text_processing: _TextProcessingProviderAPI
+    """TextProcessing Provider API."""
+
+    def __init__(self, session: NcSessionApp):
+        self.speech_to_text = _SpeechToTextProviderAPI(session)
+        self.text_processing = _TextProcessingProviderAPI(session)
+
+
+class AsyncProvidersApi:
+    """Class that encapsulates all AI Providers functionality."""
+
+    speech_to_text: _AsyncSpeechToTextProviderAPI
+    """SpeechToText Provider API."""
+    text_processing: _AsyncTextProcessingProviderAPI
+    """TextProcessing Provider API."""
+
+    def __init__(self, session: AsyncNcSessionApp):
+        self.speech_to_text = _AsyncSpeechToTextProviderAPI(session)
+        self.text_processing = _AsyncTextProcessingProviderAPI(session)

nc_py_api/ex_app/providers/speech_to_text.py

@@ -0,0 +1,130 @@
+"""Nextcloud API for declaring SpeechToText provider."""
+
+import contextlib
+import dataclasses
+
+from ..._exceptions import NextcloudException, NextcloudExceptionNotFound
+from ..._misc import require_capabilities
+from ..._session import AsyncNcSessionApp, NcSessionApp
+
+
+@dataclasses.dataclass
+class SpeechToTextProvider:
+    """Speech2Text provider description."""
+
+    def __init__(self, raw_data: dict):
+        self._raw_data = raw_data
+
+    @property
+    def name(self) -> str:
+        """Unique ID for the provider."""
+        return self._raw_data["name"]
+
+    @property
+    def display_name(self) -> str:
+        """Providers display name."""
+        return self._raw_data["display_name"]
+
+    @property
+    def action_handler(self) -> str:
+        """Relative ExApp url which will be called by Nextcloud."""
+        return self._raw_data["action_handler"]
+
+    def __repr__(self):
+        return f"<{self.__class__.__name__} name={self.name}, handler={self.action_handler}>"
+
+
+class _SpeechToTextProviderAPI:
+    """API for registering Speech2Text providers."""
+
+    _ep_suffix: str = "ai_provider/speech_to_text"
+
+    def __init__(self, session: NcSessionApp):
+        self._session = session
+
+    def register(self, name: str, display_name: str, callback_url: str) -> None:
+        """Registers or edit the SpeechToText provider."""
+        require_capabilities("app_api", self._session.capabilities)
+        params = {
+            "name": name,
+            "displayName": display_name,
+            "actionHandler": callback_url,
+        }
+        self._session.ocs("POST", f"{self._session.ae_url}/{self._ep_suffix}", json=params)
+
+    def unregister(self, name: str, not_fail=True) -> None:
+        """Removes SpeechToText provider."""
+        require_capabilities("app_api", self._session.capabilities)
+        try:
+            self._session.ocs("DELETE", f"{self._session.ae_url}/{self._ep_suffix}", params={"name": name})
+        except NextcloudExceptionNotFound as e:
+            if not not_fail:
+                raise e from None
+
+    def get_entry(self, name: str) -> SpeechToTextProvider | None:
+        """Get information of the SpeechToText."""
+        require_capabilities("app_api", self._session.capabilities)
+        try:
+            return SpeechToTextProvider(
+                self._session.ocs("GET", f"{self._session.ae_url}/{self._ep_suffix}", params={"name": name})
+            )
+        except NextcloudExceptionNotFound:
+            return None
+
+    def report_result(self, task_id: int, result: str = "", error: str = "") -> None:
+        """Report results of speech to text task to Nextcloud."""
+        require_capabilities("app_api", self._session.capabilities)
+        with contextlib.suppress(NextcloudException):
+            self._session.ocs(
+                "PUT",
+                f"{self._session.ae_url}/{self._ep_suffix}",
+                json={"taskId": task_id, "result": result, "error": error},
+            )
+
+
+class _AsyncSpeechToTextProviderAPI:
+    """API for registering Speech2Text providers."""
+
+    _ep_suffix: str = "ai_provider/speech_to_text"
+
+    def __init__(self, session: AsyncNcSessionApp):
+        self._session = session
+
+    async def register(self, name: str, display_name: str, callback_url: str) -> None:
+        """Registers or edit the SpeechToText provider."""
+        require_capabilities("app_api", await self._session.capabilities)
+        params = {
+            "name": name,
+            "displayName": display_name,
+            "actionHandler": callback_url,
+        }
+        await self._session.ocs("POST", f"{self._session.ae_url}/{self._ep_suffix}", json=params)
+
+    async def unregister(self, name: str, not_fail=True) -> None:
+        """Removes SpeechToText provider."""
+        require_capabilities("app_api", await self._session.capabilities)
+        try:
+            await self._session.ocs("DELETE", f"{self._session.ae_url}/{self._ep_suffix}", params={"name": name})
+        except NextcloudExceptionNotFound as e:
+            if not not_fail:
+                raise e from None
+
+    async def get_entry(self, name: str) -> SpeechToTextProvider | None:
+        """Get information of the SpeechToText."""
+        require_capabilities("app_api", await self._session.capabilities)
+        try:
+            return SpeechToTextProvider(
+                await self._session.ocs("GET", f"{self._session.ae_url}/{self._ep_suffix}", params={"name": name})
+            )
+        except NextcloudExceptionNotFound:
+            return None
+
+    async def report_result(self, task_id: int, result: str = "", error: str = "") -> None:
+        """Report results of speech to text task to Nextcloud."""
+        require_capabilities("app_api", await self._session.capabilities)
+        with contextlib.suppress(NextcloudException):
+            await self._session.ocs(
+                "PUT",
+                f"{self._session.ae_url}/{self._ep_suffix}",
+                json={"taskId": task_id, "result": result, "error": error},
+            )

nc_py_api/ex_app/providers/text_processing.py

@@ -0,0 +1,137 @@
+"""Nextcloud API for declaring TextProcessing provider."""
+
+import contextlib
+import dataclasses
+
+from ..._exceptions import NextcloudException, NextcloudExceptionNotFound
+from ..._misc import require_capabilities
+from ..._session import AsyncNcSessionApp, NcSessionApp
+
+
+@dataclasses.dataclass
+class TextProcessingProvider:
+    """TextProcessing provider description."""
+
+    def __init__(self, raw_data: dict):
+        self._raw_data = raw_data
+
+    @property
+    def name(self) -> str:
+        """Unique ID for the provider."""
+        return self._raw_data["name"]
+
+    @property
+    def display_name(self) -> str:
+        """Providers display name."""
+        return self._raw_data["display_name"]
+
+    @property
+    def action_handler(self) -> str:
+        """Relative ExApp url which will be called by Nextcloud."""
+        return self._raw_data["action_handler"]
+
+    @property
+    def task_type(self) -> str:
+        """The TaskType provided by this provider."""
+        return self._raw_data["task_type"]
+
+    def __repr__(self):
+        return f"<{self.__class__.__name__} name={self.name}, type={self.task_type}, handler={self.action_handler}>"
+
+
+class _TextProcessingProviderAPI:
+    """API for registering TextProcessing providers."""
+
+    _ep_suffix: str = "ai_provider/text_processing"
+
+    def __init__(self, session: NcSessionApp):
+        self._session = session
+
+    def register(self, name: str, display_name: str, callback_url: str, task_type: str) -> None:
+        """Registers or edit the TextProcessing provider."""
+        require_capabilities("app_api", self._session.capabilities)
+        params = {
+            "name": name,
+            "displayName": display_name,
+            "actionHandler": callback_url,
+            "taskType": task_type,
+        }
+        self._session.ocs("POST", f"{self._session.ae_url}/{self._ep_suffix}", json=params)
+
+    def unregister(self, name: str, not_fail=True) -> None:
+        """Removes TextProcessing provider."""
+        require_capabilities("app_api", self._session.capabilities)
+        try:
+            self._session.ocs("DELETE", f"{self._session.ae_url}/{self._ep_suffix}", params={"name": name})
+        except NextcloudExceptionNotFound as e:
+            if not not_fail:
+                raise e from None
+
+    def get_entry(self, name: str) -> TextProcessingProvider | None:
+        """Get information of the TextProcessing."""
+        require_capabilities("app_api", self._session.capabilities)
+        try:
+            return TextProcessingProvider(
+                self._session.ocs("GET", f"{self._session.ae_url}/{self._ep_suffix}", params={"name": name})
+            )
+        except NextcloudExceptionNotFound:
+            return None
+
+    def report_result(self, task_id: int, result: str = "", error: str = "") -> None:
+        """Report results of the text processing to Nextcloud."""
+        require_capabilities("app_api", self._session.capabilities)
+        with contextlib.suppress(NextcloudException):
+            self._session.ocs(
+                "PUT",
+                f"{self._session.ae_url}/{self._ep_suffix}",
+                json={"taskId": task_id, "result": result, "error": error},
+            )
+
+
+class _AsyncTextProcessingProviderAPI:
+    """API for registering TextProcessing providers."""
+
+    _ep_suffix: str = "ai_provider/text_processing"
+
+    def __init__(self, session: AsyncNcSessionApp):
+        self._session = session
+
+    async def register(self, name: str, display_name: str, callback_url: str, task_type: str) -> None:
+        """Registers or edit the TextProcessing provider."""
+        require_capabilities("app_api", await self._session.capabilities)
+        params = {
+            "name": name,
+            "displayName": display_name,
+            "actionHandler": callback_url,
+            "taskType": task_type,
+        }
+        await self._session.ocs("POST", f"{self._session.ae_url}/{self._ep_suffix}", json=params)
+
+    async def unregister(self, name: str, not_fail=True) -> None:
+        """Removes TextProcessing provider."""
+        require_capabilities("app_api", await self._session.capabilities)
+        try:
+            await self._session.ocs("DELETE", f"{self._session.ae_url}/{self._ep_suffix}", params={"name": name})
+        except NextcloudExceptionNotFound as e:
+            if not not_fail:
+                raise e from None
+
+    async def get_entry(self, name: str) -> TextProcessingProvider | None:
+        """Get information of the TextProcessing."""
+        require_capabilities("app_api", await self._session.capabilities)
+        try:
+            return TextProcessingProvider(
+                await self._session.ocs("GET", f"{self._session.ae_url}/{self._ep_suffix}", params={"name": name})
+            )
+        except NextcloudExceptionNotFound:
+            return None
+
+    async def report_result(self, task_id: int, result: str = "", error: str = "") -> None:
+        """Report results of the text processing to Nextcloud."""
+        require_capabilities("app_api", await self._session.capabilities)
+        with contextlib.suppress(NextcloudException):
+            await self._session.ocs(
+                "PUT",
+                f"{self._session.ae_url}/{self._ep_suffix}",
+                json={"taskId": task_id, "result": result, "error": error},
+            )

nc_py_api/ex_app/ui/files_actions.py

@@ -150,7 +150,7 @@ class _UiFilesActionsAPI:
                 raise e from None
 
     def get_entry(self, name: str) -> UiFileActionEntry | None:
-        """Get information of the file action meny entry for current app."""
+        """Get information of the file action meny entry."""
         require_capabilities("app_api", self._session.capabilities)
         try:
             return UiFileActionEntry(

nc_py_api/files/files.py

@@ -98,14 +98,8 @@ class FilesAPI:
             The object must implement the ``file.write`` method and be able to write binary data.
         :param kwargs: **chunk_size** an int value specifying chunk size to write. Default = **5Mb**
         """
-        path = path.user_path if isinstance(path, FsNode) else path
-        if isinstance(fp, str | Path):
-            with builtins.open(fp, "wb") as f:
-                self.__download2stream(path, f, **kwargs)
-        elif hasattr(fp, "write"):
-            self.__download2stream(path, fp, **kwargs)
-        else:
-            raise TypeError("`fp` must be a path to file or an object with `write` method.")
+        path = quote(dav_get_obj_path(self._session.user, path.user_path if isinstance(path, FsNode) else path))
+        self._session.download2stream(path, fp, dav=True, **kwargs)
 
     def download_directory_as_zip(self, path: str | FsNode, local_path: str | Path | None = None, **kwargs) -> Path:
         """Downloads a remote directory as zip archive.
@@ -117,17 +111,11 @@ class FilesAPI:
         .. note:: This works only for directories, you should not use this to download a file.
         """
         path = path.user_path if isinstance(path, FsNode) else path
-        with self._session.adapter.stream(
-            "GET", "/index.php/apps/files/ajax/download.php", params={"dir": path}
-        ) as response:
-            check_error(response, f"download_directory_as_zip: user={self._session.user}, path={path}")
-            result_path = local_path if local_path else os.path.basename(path)
-            with open(
-                result_path,
-                "wb",
-            ) as fp:
-                for data_chunk in response.iter_raw(chunk_size=kwargs.get("chunk_size", 5 * 1024 * 1024)):
-                    fp.write(data_chunk)
+        result_path = local_path if local_path else os.path.basename(path)
+        with open(result_path, "wb") as fp:
+            self._session.download2fp(
+                "/index.php/apps/files/ajax/download.php", fp, dav=False, params={"dir": path}, **kwargs
+            )
         return Path(result_path)
 
     def upload(self, path: str | FsNode, content: bytes | str) -> FsNode:
@@ -439,12 +427,6 @@ class FilesAPI:
             self._session.cfg.dav_url_suffix, webdav_response, user, path, properties, exclude_self, prop_type
         )
 
-    def __download2stream(self, path: str, fp, **kwargs) -> None:
-        with self._session.adapter_dav.stream("GET", quote(dav_get_obj_path(self._session.user, path))) as response:
-            check_error(response, f"download_stream: user={self._session.user}, path={path}")
-            for data_chunk in response.iter_raw(chunk_size=kwargs.get("chunk_size", 5 * 1024 * 1024)):
-                fp.write(data_chunk)
-
     def __upload_stream(self, path: str, fp, chunk_size: int) -> FsNode:
         _tmp_path = "nc-py-api-" + random_string(56)
         _dav_path = quote(dav_get_obj_path(self._session.user, _tmp_path, root_path="/uploads"))
@@ -561,14 +543,8 @@ class AsyncFilesAPI:
             The object must implement the ``file.write`` method and be able to write binary data.
         :param kwargs: **chunk_size** an int value specifying chunk size to write. Default = **5Mb**
         """
-        path = path.user_path if isinstance(path, FsNode) else path
-        if isinstance(fp, str | Path):
-            with builtins.open(fp, "wb") as f:
-                await self.__download2stream(path, f, **kwargs)
-        elif hasattr(fp, "write"):
-            await self.__download2stream(path, fp, **kwargs)
-        else:
-            raise TypeError("`fp` must be a path to file or an object with `write` method.")
+        path = quote(dav_get_obj_path(await self._session.user, path.user_path if isinstance(path, FsNode) else path))
+        await self._session.download2stream(path, fp, dav=True, **kwargs)
 
     async def download_directory_as_zip(
         self, path: str | FsNode, local_path: str | Path | None = None, **kwargs
@@ -582,17 +558,11 @@ class AsyncFilesAPI:
         .. note:: This works only for directories, you should not use this to download a file.
         """
         path = path.user_path if isinstance(path, FsNode) else path
-        async with self._session.adapter.stream(
-            "GET", "/index.php/apps/files/ajax/download.php", params={"dir": path}
-        ) as response:
-            check_error(response, f"download_directory_as_zip: user={await self._session.user}, path={path}")
-            result_path = local_path if local_path else os.path.basename(path)
-            with open(
-                result_path,
-                "wb",
-            ) as fp:
-                async for data_chunk in response.aiter_raw(chunk_size=kwargs.get("chunk_size", 5 * 1024 * 1024)):
-                    fp.write(data_chunk)
+        result_path = local_path if local_path else os.path.basename(path)
+        with open(result_path, "wb") as fp:
+            await self._session.download2fp(
+                "/index.php/apps/files/ajax/download.php", fp, dav=False, params={"dir": path}, **kwargs
+            )
         return Path(result_path)
 
     async def upload(self, path: str | FsNode, content: bytes | str) -> FsNode:
@@ -909,14 +879,6 @@ class AsyncFilesAPI:
             self._session.cfg.dav_url_suffix, webdav_response, user, path, properties, exclude_self, prop_type
         )
 
-    async def __download2stream(self, path: str, fp, **kwargs) -> None:
-        async with self._session.adapter_dav.stream(
-            "GET", quote(dav_get_obj_path(await self._session.user, path))
-        ) as response:
-            check_error(response, f"download_stream: user={await self._session.user}, path={path}")
-            async for data_chunk in response.aiter_raw(chunk_size=kwargs.get("chunk_size", 5 * 1024 * 1024)):
-                fp.write(data_chunk)
-
     async def __upload_stream(self, path: str, fp, chunk_size: int) -> FsNode:
         _tmp_path = "nc-py-api-" + random_string(56)
         _dav_path = quote(dav_get_obj_path(await self._session.user, _tmp_path, root_path="/uploads"))

nc_py_api/nextcloud.py

@@ -31,6 +31,7 @@ from .activity import _ActivityAPI, _AsyncActivityAPI
 from .apps import _AppsAPI, _AsyncAppsAPI
 from .calendar import _CalendarAPI
 from .ex_app.defs import ApiScope, LogLvl
+from .ex_app.providers.providers import AsyncProvidersApi, ProvidersApi
 from .ex_app.ui.ui import AsyncUiApi, UiApi
 from .files.files import AsyncFilesAPI, FilesAPI
 from .notes import _AsyncNotesAPI, _NotesAPI
@@ -134,6 +135,10 @@ class _NextcloudBasic(ABC):  # pylint: disable=too-many-instance-attributes
         """Performs OCS call and returns OCS response payload data."""
         return self._session.ocs(method, path, content=content, json=json, params=params, **kwargs)
 
+    def download_log(self, fp) -> None:
+        """Downloads Nextcloud log file. Requires Admin privileges."""
+        self._session.download2stream("/index.php/settings/admin/log/download", fp)
+
 
 class _AsyncNextcloudBasic(ABC):  # pylint: disable=too-many-instance-attributes
     apps: _AsyncAppsAPI
@@ -228,6 +233,10 @@ class _AsyncNextcloudBasic(ABC):  # pylint: disable=too-many-instance-attributes
         """Performs OCS call and returns OCS response payload data."""
         return await self._session.ocs(method, path, content=content, json=json, params=params, **kwargs)
 
+    async def download_log(self, fp) -> None:
+        """Downloads Nextcloud log file. Requires Admin privileges."""
+        await self._session.download2stream("/index.php/settings/admin/log/download", fp)
+
 
 class Nextcloud(_NextcloudBasic):
     """Nextcloud client class.
@@ -294,6 +303,8 @@ class NextcloudApp(_NextcloudBasic):
     """Nextcloud User Preferences API for ExApps"""
     ui: UiApi
     """Nextcloud UI API for ExApps"""
+    providers: ProvidersApi
+    """API for registering providers for Nextcloud"""
 
     def __init__(self, **kwargs):
         """The parameters will be taken from the environment.
@@ -305,6 +316,7 @@ class NextcloudApp(_NextcloudBasic):
         self.appconfig_ex = AppConfigExAPI(self._session)
         self.preferences_ex = PreferencesExAPI(self._session)
         self.ui = UiApi(self._session)
+        self.providers = ProvidersApi(self._session)
 
     def log(self, log_lvl: LogLvl, content: str) -> None:
         """Writes log to the Nextcloud log file."""
@@ -431,6 +443,8 @@ class AsyncNextcloudApp(_AsyncNextcloudBasic):
     """Nextcloud User Preferences API for ExApps"""
     ui: AsyncUiApi
     """Nextcloud UI API for ExApps"""
+    providers: AsyncProvidersApi
+    """API for registering providers for Nextcloud"""
 
     def __init__(self, **kwargs):
         """The parameters will be taken from the environment.
@@ -442,6 +456,7 @@ class AsyncNextcloudApp(_AsyncNextcloudBasic):
         self.appconfig_ex = AsyncAppConfigExAPI(self._session)
         self.preferences_ex = AsyncPreferencesExAPI(self._session)
         self.ui = AsyncUiApi(self._session)
+        self.providers = AsyncProvidersApi(self._session)
 
     async def log(self, log_lvl: LogLvl, content: str) -> None:
         """Writes log to the Nextcloud log file."""

{nc_py_api-0.7.2.dist-info → nc_py_api-0.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: nc-py-api
-Version: 0.7.2
+Version: 0.8.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/
@@ -89,21 +89,21 @@ Python library that provides a robust and well-documented API that allows develo
  * **Sync + Async**: Provides both sync and async APIs.
 
 ### Capabilities
-| **_Capability_**      | Nextcloud 26 | Nextcloud 27 | Nextcloud 28 |
-|-----------------------|:------------:|:------------:|:------------:|
-| Calendar              |      ✅       |      ✅       |      ✅       |
-| File System & Tags    |      ✅       |      ✅       |      ✅       |
-| Nextcloud Talk        |      ✅       |      ✅       |      ✅       |
-| Notifications         |      ✅       |      ✅       |      ✅       |
-| Shares                |      ✅       |      ✅       |      ✅       |
-| Users & Groups        |      ✅       |      ✅       |      ✅       |
-| User & Weather status |      ✅       |      ✅       |      ✅       |
-| Other APIs***         |      ✅       |      ✅       |      ✅       |
-| Talk Bot API*         |     N/A      |      ✅       |      ✅       |
-| Text Processing*      |     N/A      |      ❌       |      ❌       |
-| SpeechToText*         |     N/A      |      ❌       |      ❌       |
-
-&ast;_available only for NextcloudApp_<br>
+| **_Capability_**      | Nextcloud 26 | Nextcloud 27 | Nextcloud 28 | Nextcloud 29 |
+|-----------------------|:------------:|:------------:|:------------:|:------------:|
+| Calendar              |      ✅       |      ✅       |      ✅       |      ✅       |
+| File System & Tags    |      ✅       |      ✅       |      ✅       |      ✅       |
+| Nextcloud Talk        |      ✅       |      ✅       |      ✅       |      ✅       |
+| Notifications         |      ✅       |      ✅       |      ✅       |      ✅       |
+| Shares                |      ✅       |      ✅       |      ✅       |      ✅       |
+| Users & Groups        |      ✅       |      ✅       |      ✅       |      ✅       |
+| User & Weather status |      ✅       |      ✅       |      ✅       |      ✅       |
+| Other APIs***         |      ✅       |      ✅       |      ✅       |      ✅       |
+| Talk Bot API*         |     N/A      |      ✅       |      ✅       |      ✅       |
+| AI Providers API**    |     N/A      |     N/A      |     N/A      |      ✅       |
+
+&ast;_available only for **NextcloudApp**_<br>
+&ast;&ast;_available only for **NextcloudApp**: SpeechToText, TextProcessing_<br>
 &ast;&ast;&ast;_Activity, Notes_
 
 ### Differences between the Nextcloud and NextcloudApp classes

{nc_py_api-0.7.2.dist-info → nc_py_api-0.8.0.dist-info}/RECORD

@@ -4,14 +4,14 @@ nc_py_api/_exceptions.py,sha256=7vbUECaLmD7RJBCU27t4fuP6NmQK6r4508u_gS4szhI,2298
 nc_py_api/_misc.py,sha256=dUzCP9VmyhtICTsn1aexlFAYUioBm40k6Zh-YE5WwCY,3333
 nc_py_api/_preferences.py,sha256=OtovFZuGHnHYKjdDjSnUappO795tW8Oxj7qVaejHWpQ,2479
 nc_py_api/_preferences_ex.py,sha256=gW9bWVHayE6TifoA5hY_RWYUkdFgWrd0OabPvuNSAe0,7091
-nc_py_api/_session.py,sha256=y1tKqootIRI7c2jS70fsnmcm1imEjviJ2GzFWYLB7dg,17895
+nc_py_api/_session.py,sha256=FEvwKofUkqH4b-s0ieDWeb_nFpaczFSHN4iQAuMs-JQ,19761
 nc_py_api/_talk_api.py,sha256=sIEBATbTVuLtLvcyOPwpUSURMyGl8ZpGB7hnEWKQbpM,51033
 nc_py_api/_theming.py,sha256=hTr3nuOemSuRFZaPy9iXNmBM7rDgQHECH43tHMWGqEY,1870
-nc_py_api/_version.py,sha256=cuGgTOEQlTm_RtlgmNF0Q5vGJv2Lb5zI0xfefSRw6EM,51
+nc_py_api/_version.py,sha256=21vz1dOI_hTdZ_xG9sYAdYVNNIUxBWfMJUMbAqsqFRI,51
 nc_py_api/activity.py,sha256=t9VDSnnaXRNOvALqOSGCeXSQZ-426pCOMSfQ96JHys4,9574
 nc_py_api/apps.py,sha256=6vOFFs6vNHCCvZ_SwXxPq5-X1xfgyLjW8uZSfJKduC8,9774
 nc_py_api/calendar.py,sha256=-T6CJ8cRbJZTLtxSEDWuuYpD29DMJGCTfLONmtxZV9w,1445
-nc_py_api/nextcloud.py,sha256=gATnAWslcbv1Lko3hJDnupSQwvL7r--ovqdWRxwwro4,21572
+nc_py_api/nextcloud.py,sha256=RsPX0Rqr01RGhUUNJHunNVEaSwF9MAqgK35vTYNS8Pw,22328
 nc_py_api/notes.py,sha256=ljO3TOe-Qg0bJ0mlFQwjg--Pxmj-XFknoLbcbJmII0A,15106
 nc_py_api/notifications.py,sha256=WgzV21TuLOhLk-UEjhBSbMsIi2isa5MmAx6cbe0pc2Y,9187
 nc_py_api/options.py,sha256=K5co-fIfFVbwF6r3sqWsJF3cKgAbS2CjLAXdyTOkP9s,1717
@@ -21,23 +21,27 @@ nc_py_api/user_status.py,sha256=AwixZTY_KBSbqTA-VLZs_auIs8hmi_wSrv-abf2lit8,1328
 nc_py_api/users.py,sha256=B6By-H9oUNvJj2omaRCMPIsQ17xeeDV_udn0VioRO7A,15488
 nc_py_api/users_groups.py,sha256=IPxw-Ks5NjCm6r8_HC9xmf3IYptH00ulITbp5iazhAo,6289
 nc_py_api/weather_status.py,sha256=wAkjuJPjxc0Rxe4za0BzfwB0XeUmkCXoisJtTH3-qdQ,7582
-nc_py_api/ex_app/__init__.py,sha256=bdUoi6IbjSam3w300C_bs7pi0yy-lfVhEpKJThz7Ej8,356
-nc_py_api/ex_app/defs.py,sha256=3CY-g9FO7dsH9loJLP3SfdqKaZnbUmZs41-w4qph_XE,1238
+nc_py_api/ex_app/__init__.py,sha256=g4Xrv86x1Z3JNvhYJQrmsmDCAqsHX-C2fgLsplJgpzA,372
+nc_py_api/ex_app/defs.py,sha256=CeUrY20Sf0zzhHrTVsfAvPn4N7PHwwPQh_4X49qAhHM,1352
 nc_py_api/ex_app/integration_fastapi.py,sha256=1wDNFIV238zkGeV8cdoGlj_pErytd63d3JroEMbu12I,8050
-nc_py_api/ex_app/misc.py,sha256=qOhcgobKIR_EyksDuyxK0jS6jyz47oHvU4ymJZ2-9Hg,1742
+nc_py_api/ex_app/misc.py,sha256=6tPZuDVQa3lyXhK9M66M0dLNFQvrECRtXmULMjIa8-w,2098
 nc_py_api/ex_app/persist_transformers_cache.py,sha256=ZoEBb1RnNaQrtxK_CjSZ8LZ36Oakz2Xciau_ZpNp8Ic,213
 nc_py_api/ex_app/uvicorn_fastapi.py,sha256=WLtNmWXMBKN6CMip2uhKcgy4mC2Ch9AmNfwRScBUsP0,752
+nc_py_api/ex_app/providers/__init__.py,sha256=jmUBdbAgzUCdYyHl8V5UCNYJI-FFpxPQQ4iEAoURKQs,43
+nc_py_api/ex_app/providers/providers.py,sha256=mcHh-5rK7gb_bVEeROlJRi4DlD0aHHONMqLEjjwklxc,1172
+nc_py_api/ex_app/providers/speech_to_text.py,sha256=aLqgsxeCwDmFCTfeQzI5hldeYAk8KNKTUkTFgKXPZLw,5017
+nc_py_api/ex_app/providers/text_processing.py,sha256=fqc1MSlKBXvteUy2LXJYfA1eYaedCwan7O7jqs11dpY,5325
 nc_py_api/ex_app/ui/__init__.py,sha256=jUMU7_miFF-Q8BQNT90KZYQiLy_a3OvEyK6y8eRMKRk,38
-nc_py_api/ex_app/ui/files_actions.py,sha256=0OX0cp_jpW4gIlaF2J3bxFUmAWxa46iAKmub9UPTg_U,7428
+nc_py_api/ex_app/ui/files_actions.py,sha256=j2e8PXFoEmpFKF2z4YLChj0GN3S94lmwiddii1VmQKs,7412
 nc_py_api/ex_app/ui/resources.py,sha256=Qgy3KB9n68EGGz8jRlHa2Y72WxXOdaqDy2iFbQ4pvhA,12457
 nc_py_api/ex_app/ui/top_menu.py,sha256=6BvNtm03rF-fqmOiGM2mVrn0sJRLOWLfhrvzXj7ND7U,5076
 nc_py_api/ex_app/ui/ui.py,sha256=dplr1ZIqjtHvOH3lIHBLWmP9vr-m7EIk_oJU5K62low,1284
 nc_py_api/files/__init__.py,sha256=sVidF669ocg9vSoo4TBKAwGRRVUJHxtyENNUko11qTs,11798
 nc_py_api/files/_files.py,sha256=IJibj0_y3UQyyVhVI2RgQapPFPsOAV6tyH2sFlLy09I,12226
-nc_py_api/files/files.py,sha256=y2syg5JPancawJDFqdu-12OnF6b_p9aytAsSWrYFhRk,46858
+nc_py_api/files/files.py,sha256=298GqszMB1ya2CYPld9q6O2QhNGEIFAZShjQ_O84XZs,44904
 nc_py_api/files/sharing.py,sha256=bZRSsFdlaXJKheXtyTjPJwpQSpYDnRcyDosMwrvRlRc,14395
-nc_py_api-0.7.2.dist-info/METADATA,sha256=nqjE4PEDCmWE5mPd8rYg9_Ppw9vRRCug097ZFy1QUic,8571
-nc_py_api-0.7.2.dist-info/WHEEL,sha256=mRYSEL3Ih6g5a_CVMIcwiF__0Ae4_gLYh01YFNwiq1k,87
-nc_py_api-0.7.2.dist-info/licenses/AUTHORS,sha256=Y1omFHyI8ned9k4jJXs2ATgmgi1GmQ7EZ6S1gxqnX2k,572
-nc_py_api-0.7.2.dist-info/licenses/LICENSE.txt,sha256=OLEMh401fAumGHfRSna365MLIfnjdTcdOHZ6QOzMjkg,1551
-nc_py_api-0.7.2.dist-info/RECORD,,
+nc_py_api-0.8.0.dist-info/METADATA,sha256=PR4pUcgSErWO3axutjUghxlsXoXMt4jnKNlkwJmYVQs,8778
+nc_py_api-0.8.0.dist-info/WHEEL,sha256=mRYSEL3Ih6g5a_CVMIcwiF__0Ae4_gLYh01YFNwiq1k,87
+nc_py_api-0.8.0.dist-info/licenses/AUTHORS,sha256=Y1omFHyI8ned9k4jJXs2ATgmgi1GmQ7EZ6S1gxqnX2k,572
+nc_py_api-0.8.0.dist-info/licenses/LICENSE.txt,sha256=OLEMh401fAumGHfRSna365MLIfnjdTcdOHZ6QOzMjkg,1551
+nc_py_api-0.8.0.dist-info/RECORD,,