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

nc_py_api/_version.py

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

nc_py_api/files/files.py

@@ -3,6 +3,7 @@
 import builtins
 import os
 from pathlib import Path
+from urllib.parse import quote
 
 from httpx import Headers
 
@@ -85,7 +86,7 @@ class FilesAPI:
     def download(self, path: str | FsNode) -> bytes:
         """Downloads and returns the content of a file."""
         path = path.user_path if isinstance(path, FsNode) else path
-        response = self._session.adapter_dav.get(dav_get_obj_path(self._session.user, path))
+        response = self._session.adapter_dav.get(quote(dav_get_obj_path(self._session.user, path)))
         check_error(response, f"download: user={self._session.user}, path={path}")
         return response.content
 
@@ -137,7 +138,7 @@ class FilesAPI:
         """
         path = path.user_path if isinstance(path, FsNode) else path
         full_path = dav_get_obj_path(self._session.user, path)
-        response = self._session.adapter_dav.put(full_path, content=content)
+        response = self._session.adapter_dav.put(quote(full_path), content=content)
         check_error(response, f"upload: user={self._session.user}, path={path}, size={len(content)}")
         return FsNode(full_path.strip("/"), **etag_fileid_from_response(response))
 
@@ -166,7 +167,7 @@ class FilesAPI:
         """
         path = path.user_path if isinstance(path, FsNode) else path
         full_path = dav_get_obj_path(self._session.user, path)
-        response = self._session.adapter_dav.request("MKCOL", full_path)
+        response = self._session.adapter_dav.request("MKCOL", quote(full_path))
         check_error(response)
         full_path += "/" if not full_path.endswith("/") else ""
         return FsNode(full_path.lstrip("/"), **etag_fileid_from_response(response))
@@ -201,7 +202,7 @@ class FilesAPI:
         :param not_fail: if set to ``True`` and the object is not found, it does not raise an exception.
         """
         path = path.user_path if isinstance(path, FsNode) else path
-        response = self._session.adapter_dav.delete(dav_get_obj_path(self._session.user, path))
+        response = self._session.adapter_dav.delete(quote(dav_get_obj_path(self._session.user, path)))
         if response.status_code == 404 and not_fail:
             return
         check_error(response)
@@ -218,11 +219,11 @@ class FilesAPI:
         full_dest_path = dav_get_obj_path(
             self._session.user, path_dest.user_path if isinstance(path_dest, FsNode) else path_dest
         )
-        dest = self._session.cfg.dav_endpoint + full_dest_path
+        dest = self._session.cfg.dav_endpoint + quote(full_dest_path)
         headers = Headers({"Destination": dest, "Overwrite": "T" if overwrite else "F"}, encoding="utf-8")
         response = self._session.adapter_dav.request(
             "MOVE",
-            dav_get_obj_path(self._session.user, path_src),
+            quote(dav_get_obj_path(self._session.user, path_src)),
             headers=headers,
         )
         check_error(response, f"move: user={self._session.user}, src={path_src}, dest={dest}, {overwrite}")
@@ -240,11 +241,11 @@ class FilesAPI:
         full_dest_path = dav_get_obj_path(
             self._session.user, path_dest.user_path if isinstance(path_dest, FsNode) else path_dest
         )
-        dest = self._session.cfg.dav_endpoint + full_dest_path
+        dest = self._session.cfg.dav_endpoint + quote(full_dest_path)
         headers = Headers({"Destination": dest, "Overwrite": "T" if overwrite else "F"}, encoding="utf-8")
         response = self._session.adapter_dav.request(
             "COPY",
-            dav_get_obj_path(self._session.user, path_src),
+            quote(dav_get_obj_path(self._session.user, path_src)),
             headers=headers,
         )
         check_error(response, f"copy: user={self._session.user}, src={path_src}, dest={dest}, {overwrite}")
@@ -276,7 +277,7 @@ class FilesAPI:
         path = path.user_path if isinstance(path, FsNode) else path
         root = build_setfav_req(value)
         webdav_response = self._session.adapter_dav.request(
-            "PROPPATCH", dav_get_obj_path(self._session.user, path), content=element_tree_as_str(root)
+            "PROPPATCH", quote(dav_get_obj_path(self._session.user, path)), content=element_tree_as_str(root)
         )
         check_error(webdav_response, f"setfav: path={path}, value={value}")
 
@@ -300,7 +301,7 @@ class FilesAPI:
         headers = Headers({"Destination": dest}, encoding="utf-8")
         response = self._session.adapter_dav.request(
             "MOVE",
-            f"/trashbin/{self._session.user}/{path}",
+            quote(f"/trashbin/{self._session.user}/{path}"),
             headers=headers,
         )
         check_error(response, f"trashbin_restore: user={self._session.user}, src={path}, dest={dest}")
@@ -312,7 +313,7 @@ class FilesAPI:
         :param not_fail: if set to ``True`` and the object is not found, it does not raise an exception.
         """
         path = path.user_path if isinstance(path, FsNode) else path
-        response = self._session.adapter_dav.delete(f"/trashbin/{self._session.user}/{path}")
+        response = self._session.adapter_dav.delete(quote(f"/trashbin/{self._session.user}/{path}"))
         if response.status_code == 404 and not_fail:
             return
         check_error(response)
@@ -430,7 +431,7 @@ class FilesAPI:
         root, dav_path = build_listdir_req(user, path, properties, prop_type)
         webdav_response = self._session.adapter_dav.request(
             "PROPFIND",
-            dav_path,
+            quote(dav_path),
             content=element_tree_as_str(root),
             headers={"Depth": "infinity" if depth == -1 else str(depth)},
         )
@@ -439,16 +440,17 @@ class FilesAPI:
         )
 
     def __download2stream(self, path: str, fp, **kwargs) -> None:
-        with self._session.adapter_dav.stream("GET", dav_get_obj_path(self._session.user, path)) as response:
+        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:
-        _dav_path = dav_get_obj_path(self._session.user, "nc-py-api-" + random_string(56), root_path="/uploads")
+        _tmp_path = "nc-py-api-" + random_string(56)
+        _dav_path = quote(dav_get_obj_path(self._session.user, _tmp_path, root_path="/uploads"))
         _v2 = bool(self._session.cfg.options.upload_chunk_v2 and chunk_size >= 5 * 1024 * 1024)
         full_path = dav_get_obj_path(self._session.user, path)
-        headers = Headers({"Destination": self._session.cfg.dav_endpoint + full_path}, encoding="utf-8")
+        headers = Headers({"Destination": self._session.cfg.dav_endpoint + quote(full_path)}, encoding="utf-8")
         if _v2:
             response = self._session.adapter_dav.request("MKCOL", _dav_path, headers=headers)
         else:
@@ -547,7 +549,7 @@ class AsyncFilesAPI:
     async def download(self, path: str | FsNode) -> bytes:
         """Downloads and returns the content of a file."""
         path = path.user_path if isinstance(path, FsNode) else path
-        response = await self._session.adapter_dav.get(dav_get_obj_path(await self._session.user, path))
+        response = await self._session.adapter_dav.get(quote(dav_get_obj_path(await self._session.user, path)))
         check_error(response, f"download: user={await self._session.user}, path={path}")
         return response.content
 
@@ -601,7 +603,7 @@ class AsyncFilesAPI:
         """
         path = path.user_path if isinstance(path, FsNode) else path
         full_path = dav_get_obj_path(await self._session.user, path)
-        response = await self._session.adapter_dav.put(full_path, content=content)
+        response = await self._session.adapter_dav.put(quote(full_path), content=content)
         check_error(response, f"upload: user={await self._session.user}, path={path}, size={len(content)}")
         return FsNode(full_path.strip("/"), **etag_fileid_from_response(response))
 
@@ -630,7 +632,7 @@ class AsyncFilesAPI:
         """
         path = path.user_path if isinstance(path, FsNode) else path
         full_path = dav_get_obj_path(await self._session.user, path)
-        response = await self._session.adapter_dav.request("MKCOL", full_path)
+        response = await self._session.adapter_dav.request("MKCOL", quote(full_path))
         check_error(response)
         full_path += "/" if not full_path.endswith("/") else ""
         return FsNode(full_path.lstrip("/"), **etag_fileid_from_response(response))
@@ -665,7 +667,7 @@ class AsyncFilesAPI:
         :param not_fail: if set to ``True`` and the object is not found, it does not raise an exception.
         """
         path = path.user_path if isinstance(path, FsNode) else path
-        response = await self._session.adapter_dav.delete(dav_get_obj_path(await self._session.user, path))
+        response = await self._session.adapter_dav.delete(quote(dav_get_obj_path(await self._session.user, path)))
         if response.status_code == 404 and not_fail:
             return
         check_error(response)
@@ -682,11 +684,11 @@ class AsyncFilesAPI:
         full_dest_path = dav_get_obj_path(
             await self._session.user, path_dest.user_path if isinstance(path_dest, FsNode) else path_dest
         )
-        dest = self._session.cfg.dav_endpoint + full_dest_path
+        dest = self._session.cfg.dav_endpoint + quote(full_dest_path)
         headers = Headers({"Destination": dest, "Overwrite": "T" if overwrite else "F"}, encoding="utf-8")
         response = await self._session.adapter_dav.request(
             "MOVE",
-            dav_get_obj_path(await self._session.user, path_src),
+            quote(dav_get_obj_path(await self._session.user, path_src)),
             headers=headers,
         )
         check_error(response, f"move: user={await self._session.user}, src={path_src}, dest={dest}, {overwrite}")
@@ -704,11 +706,11 @@ class AsyncFilesAPI:
         full_dest_path = dav_get_obj_path(
             await self._session.user, path_dest.user_path if isinstance(path_dest, FsNode) else path_dest
         )
-        dest = self._session.cfg.dav_endpoint + full_dest_path
+        dest = self._session.cfg.dav_endpoint + quote(full_dest_path)
         headers = Headers({"Destination": dest, "Overwrite": "T" if overwrite else "F"}, encoding="utf-8")
         response = await self._session.adapter_dav.request(
             "COPY",
-            dav_get_obj_path(await self._session.user, path_src),
+            quote(dav_get_obj_path(await self._session.user, path_src)),
             headers=headers,
         )
         check_error(response, f"copy: user={await self._session.user}, src={path_src}, dest={dest}, {overwrite}")
@@ -740,7 +742,7 @@ class AsyncFilesAPI:
         path = path.user_path if isinstance(path, FsNode) else path
         root = build_setfav_req(value)
         webdav_response = await self._session.adapter_dav.request(
-            "PROPPATCH", dav_get_obj_path(await self._session.user, path), content=element_tree_as_str(root)
+            "PROPPATCH", quote(dav_get_obj_path(await self._session.user, path)), content=element_tree_as_str(root)
         )
         check_error(webdav_response, f"setfav: path={path}, value={value}")
 
@@ -769,7 +771,7 @@ class AsyncFilesAPI:
         headers = Headers({"Destination": dest}, encoding="utf-8")
         response = await self._session.adapter_dav.request(
             "MOVE",
-            f"/trashbin/{await self._session.user}/{path}",
+            quote(f"/trashbin/{await self._session.user}/{path}"),
             headers=headers,
         )
         check_error(response, f"trashbin_restore: user={await self._session.user}, src={path}, dest={dest}")
@@ -781,7 +783,7 @@ class AsyncFilesAPI:
         :param not_fail: if set to ``True`` and the object is not found, it does not raise an exception.
         """
         path = path.user_path if isinstance(path, FsNode) else path
-        response = await self._session.adapter_dav.delete(f"/trashbin/{await self._session.user}/{path}")
+        response = await self._session.adapter_dav.delete(quote(f"/trashbin/{await self._session.user}/{path}"))
         if response.status_code == 404 and not_fail:
             return
         check_error(response)
@@ -899,7 +901,7 @@ class AsyncFilesAPI:
         root, dav_path = build_listdir_req(user, path, properties, prop_type)
         webdav_response = await self._session.adapter_dav.request(
             "PROPFIND",
-            dav_path,
+            quote(dav_path),
             content=element_tree_as_str(root),
             headers={"Depth": "infinity" if depth == -1 else str(depth)},
         )
@@ -909,17 +911,18 @@ class AsyncFilesAPI:
 
     async def __download2stream(self, path: str, fp, **kwargs) -> None:
         async with self._session.adapter_dav.stream(
-            "GET", dav_get_obj_path(await self._session.user, path)
+            "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:
-        _dav_path = dav_get_obj_path(await self._session.user, "nc-py-api-" + random_string(56), root_path="/uploads")
+        _tmp_path = "nc-py-api-" + random_string(56)
+        _dav_path = quote(dav_get_obj_path(await self._session.user, _tmp_path, root_path="/uploads"))
         _v2 = bool(self._session.cfg.options.upload_chunk_v2 and chunk_size >= 5 * 1024 * 1024)
         full_path = dav_get_obj_path(await self._session.user, path)
-        headers = Headers({"Destination": self._session.cfg.dav_endpoint + full_path}, encoding="utf-8")
+        headers = Headers({"Destination": self._session.cfg.dav_endpoint + quote(full_path)}, encoding="utf-8")
         if _v2:
             response = await self._session.adapter_dav.request("MKCOL", _dav_path, headers=headers)
         else:

nc_py_api/nextcloud.py

@@ -113,6 +113,14 @@ class _NextcloudBasic(ABC):  # pylint: disable=too-many-instance-attributes
         """Returns Theme information."""
         return get_parsed_theme(self.capabilities["theming"]) if "theming" in self.capabilities else None
 
+    def perform_login(self) -> bool:
+        """Performs login into Nextcloud if not already logged in; manual invocation of this method is unnecessary."""
+        try:
+            self.update_server_info()
+        except Exception:  # noqa pylint: disable=broad-exception-caught
+            return False
+        return True
+
     def ocs(
         self,
         method: str,
@@ -199,6 +207,14 @@ class _AsyncNextcloudBasic(ABC):  # pylint: disable=too-many-instance-attributes
         """Returns Theme information."""
         return get_parsed_theme((await self.capabilities)["theming"]) if "theming" in await self.capabilities else None
 
+    async def perform_login(self) -> bool:
+        """Performs login into Nextcloud if not already logged in; manual invocation of this method is unnecessary."""
+        try:
+            await self.update_server_info()
+        except Exception:  # noqa pylint: disable=broad-exception-caught
+            return False
+        return True
+
     async def ocs(
         self,
         method: str,

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: nc-py-api
-Version: 0.7.1
+Version: 0.7.2
 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.7.1.dist-info → nc_py_api-0.7.2.dist-info}/RECORD

@@ -7,11 +7,11 @@ nc_py_api/_preferences_ex.py,sha256=gW9bWVHayE6TifoA5hY_RWYUkdFgWrd0OabPvuNSAe0,
 nc_py_api/_session.py,sha256=y1tKqootIRI7c2jS70fsnmcm1imEjviJ2GzFWYLB7dg,17895
 nc_py_api/_talk_api.py,sha256=sIEBATbTVuLtLvcyOPwpUSURMyGl8ZpGB7hnEWKQbpM,51033
 nc_py_api/_theming.py,sha256=hTr3nuOemSuRFZaPy9iXNmBM7rDgQHECH43tHMWGqEY,1870
-nc_py_api/_version.py,sha256=wKplGHRmG8XcnEoJl1Yx2Zhykyx1f7YBUfMrnHri8DI,51
+nc_py_api/_version.py,sha256=cuGgTOEQlTm_RtlgmNF0Q5vGJv2Lb5zI0xfefSRw6EM,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=xz5nnE-SJitvj5HQ2HY-n85KYbOs3jI39GnDXYA2QcA,20908
+nc_py_api/nextcloud.py,sha256=gATnAWslcbv1Lko3hJDnupSQwvL7r--ovqdWRxwwro4,21572
 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
@@ -34,10 +34,10 @@ nc_py_api/ex_app/ui/top_menu.py,sha256=6BvNtm03rF-fqmOiGM2mVrn0sJRLOWLfhrvzXj7ND
 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=n6SsuYJVO3BA1mofBuO6mOl0tflkMdgzgY3uxYlSGeo,46557
+nc_py_api/files/files.py,sha256=y2syg5JPancawJDFqdu-12OnF6b_p9aytAsSWrYFhRk,46858
 nc_py_api/files/sharing.py,sha256=bZRSsFdlaXJKheXtyTjPJwpQSpYDnRcyDosMwrvRlRc,14395
-nc_py_api-0.7.1.dist-info/METADATA,sha256=khc0FpYq3frTqngrbfcHaIlkuoR5gRQ8ACuXTOrkRno,8571
-nc_py_api-0.7.1.dist-info/WHEEL,sha256=mRYSEL3Ih6g5a_CVMIcwiF__0Ae4_gLYh01YFNwiq1k,87
-nc_py_api-0.7.1.dist-info/licenses/AUTHORS,sha256=Y1omFHyI8ned9k4jJXs2ATgmgi1GmQ7EZ6S1gxqnX2k,572
-nc_py_api-0.7.1.dist-info/licenses/LICENSE.txt,sha256=OLEMh401fAumGHfRSna365MLIfnjdTcdOHZ6QOzMjkg,1551
-nc_py_api-0.7.1.dist-info/RECORD,,
+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,,