fixed CI for NC30, last adjustments for webhooks

Signed-off-by: Alexander Piskun <bigcat88@icloud.com>

Author: bigcat88

CHANGELOG.md

@@ -2,7 +2,17 @@
 
 All notable changes to this project will be documented in this file.
 
-## [0.14.0 - 2024-07-0X]
+## [0.15.0 - 2024-07-19]
+
+### Added
+
+- Initial Webhooks API support for the upcoming Nextcloud 30. #272
+
+### Changed
+
+- NextcloudApp: `fetch_models_task` function now saves paths to downloaded models. #274 Thanks to @kyteinsky
+
+## [0.14.0 - 2024-07-09]
 
 ### Added
 

docs/reference/Webhooks.rst

@@ -0,0 +1,10 @@
+.. py:currentmodule:: nc_py_api.webhooks
+
+Webhooks API
+============
+
+.. autoclass:: nc_py_api.webhooks.WebhookInfo
+    :members:
+
+.. autoclass:: nc_py_api.webhooks._WebhooksAPI
+    :members:

docs/reference/index.rst

@@ -17,3 +17,4 @@ Reference
    Notes
    Session
    LoginFlowV2
+   Webhooks

nc_py_api/webhooks.py

@@ -26,7 +26,7 @@ def app_id(self) -> str:
     @property
     def user_id(self) -> str:
         """`UserID` if webhook was registered in user context."""
-        return self._raw_data["userId"]
+        return self._raw_data["userId"] if self._raw_data["userId"] else ""
 
     @property
     def http_method(self) -> str:
@@ -45,7 +45,7 @@ def event(self) -> str:
 
     @property
     def event_filter(self):
-        """Currently unknown."""
+        """Mongo filter to apply to the serialized data to decide if firing."""
         return self._raw_data["eventFilter"]
 
     @property
@@ -138,7 +138,7 @@ def update(
         return WebhookInfo(self._session.ocs("POST", f"{self._ep_base}/{webhook_id}", json=params))
 
     def unregister(self, webhook_id: int) -> bool:
-        return self._session.ocs("DELETE", f"{self._session.ae_url}/{webhook_id}")
+        return self._session.ocs("DELETE", f"{self._ep_base}/{webhook_id}")
 
 
 class _AsyncWebhooksAPI:
@@ -207,4 +207,4 @@ async def update(
         return WebhookInfo(await self._session.ocs("POST", f"{self._ep_base}/{webhook_id}", json=params))
 
     async def unregister(self, webhook_id: int) -> bool:
-        return await self._session.ocs("DELETE", f"{self._session.ae_url}/{webhook_id}")
+        return await self._session.ocs("DELETE", f"{self._ep_base}/{webhook_id}")

tests/actual_tests/files_sharing_test.py

@@ -83,9 +83,12 @@ async def test_share_fields_async(anc_any):
 def test_create_permissions(nc_any):
     new_share = nc_any.files.sharing.create("test_empty_dir", ShareType.TYPE_LINK, FilePermissions.PERMISSION_CREATE)
     nc_any.files.sharing.delete(new_share)
+    # starting from Nextcloud 30 permissions are: FilePermissions.PERMISSION_CREATE | FilePermissions.PERMISSION_SHARE
+    # https://github.com/nextcloud/server/commit/0bde47a39256dfad3baa8d3ffa275ac3d113a9d5#diff-dbbe017dd357504abc442a6f1d0305166520ebf80353f42814b3f879a3e241bc
     assert (
         new_share.permissions
         == FilePermissions.PERMISSION_READ | FilePermissions.PERMISSION_CREATE | FilePermissions.PERMISSION_SHARE
+        or new_share.permissions == FilePermissions.PERMISSION_CREATE | FilePermissions.PERMISSION_SHARE
     )
     new_share = nc_any.files.sharing.create("test_empty_dir", ShareType.TYPE_LINK, FilePermissions.PERMISSION_DELETE)
     nc_any.files.sharing.delete(new_share)
@@ -107,9 +110,12 @@ async def test_create_permissions_async(anc_any):
         "test_empty_dir", ShareType.TYPE_LINK, FilePermissions.PERMISSION_CREATE
     )
     await anc_any.files.sharing.delete(new_share)
+    # starting from Nextcloud 30 permissions are: FilePermissions.PERMISSION_CREATE | FilePermissions.PERMISSION_SHARE
+    # https://github.com/nextcloud/server/commit/0bde47a39256dfad3baa8d3ffa275ac3d113a9d5#diff-dbbe017dd357504abc442a6f1d0305166520ebf80353f42814b3f879a3e241bc
     assert (
         new_share.permissions
         == FilePermissions.PERMISSION_READ | FilePermissions.PERMISSION_CREATE | FilePermissions.PERMISSION_SHARE
+        or new_share.permissions == FilePermissions.PERMISSION_CREATE | FilePermissions.PERMISSION_SHARE
     )
     new_share = await anc_any.files.sharing.create(
         "test_empty_dir", ShareType.TYPE_LINK, FilePermissions.PERMISSION_DELETE

tests/gfixture_set_env.py

@@ -3,8 +3,8 @@
 if not environ.get("CI", False):  # For local tests
     environ["NC_AUTH_USER"] = "admin"
     environ["NC_AUTH_PASS"] = "admin"  # "MrtGY-KfY24-iiDyg-cr4n4-GLsNZ"
-    environ["NEXTCLOUD_URL"] = environ.get("NEXTCLOUD_URL", "http://stable27.local")
-    # environ["NEXTCLOUD_URL"] = environ.get("NEXTCLOUD_URL", "http://stable28.local")
+    environ["NEXTCLOUD_URL"] = environ.get("NEXTCLOUD_URL", "http://stable29.local")
+    # environ["NEXTCLOUD_URL"] = environ.get("NEXTCLOUD_URL", "http://stable30.local")
     # environ["NEXTCLOUD_URL"] = environ.get("NEXTCLOUD_URL", "http://nextcloud.local")
     environ["APP_ID"] = "nc_py_api"
     environ["APP_VERSION"] = "1.0.0"