Clean-up/Refactoring of old code (#177)

_Because initially the project was written for a different AppAPI
authentication, where all transmitted data was signed - there was a lot
of unnecessary code left._

This pull request will cover it all, total refactoring and
simplification of the code.

**After this, it will be possible to make public methods for
communicating with Nextcloud, which would make it easier to connect
third-party packages.**

**It is also necessary to clean up the code before adding asynchronous
methods.**


Changes proposed in this pull request:

 * set `AUTHORIZATION-APP-API` header with help of `event_hook`
 * set default `timeout` during `httpx.adapter` creation
 * set `base_url` during `httpx.adapter` creation
* download_directory_as_zip: directly call `session.adapter.stream`
(removed `_session.get_stream`)
* all DAV methods now directly call `_session.adapter_dav.XXX` (removed
`_session.dav` / `_session.dav_stream`)
* removed `_session.request` and `_sessions.request_json` - instead
directly call `session.adapter`
 * `response_headers` are now set with help of `httpx.event_hooks`
 * other internal code refactoring

---------

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

Author: bigcat88

nc_py_api/_exceptions.py

@@ -1,6 +1,6 @@
 """Exceptions for the Nextcloud API."""
 
-from httpx import codes
+from httpx import Response, codes
 
 
 class NextcloudException(Exception):
@@ -42,21 +42,24 @@ def __init__(self, reason="Missing capability", info: str = ""):
         super().__init__(412, reason=reason, info=info)
 
 
-def check_error(code: int, info: str = ""):
+def check_error(response: Response, info: str = ""):
     """Checks HTTP code from Nextcloud, and raises exception in case of error.
 
     For the OCS and DAV `code` be code returned by HTTP and not the status from ``ocs_meta``.
     """
-    if 996 <= code <= 999:
-        if code == 996:
+    status_code = response.status_code
+    if not info:
+        info = f"request: {response.request.method} {response.request.url}"
+    if 996 <= status_code <= 999:
+        if status_code == 996:
             phrase = "Server error"
-        elif code == 997:
+        elif status_code == 997:
             phrase = "Unauthorised"
-        elif code == 998:
+        elif status_code == 998:
             phrase = "Not found"
         else:
             phrase = "Unknown error"
-        raise NextcloudException(code, reason=phrase, info=info)
-    if not codes.is_error(code):
+        raise NextcloudException(status_code, reason=phrase, info=info)
+    if not codes.is_error(status_code):
         return
-    raise NextcloudException(code, reason=codes(code).phrase, info=info)
+    raise NextcloudException(status_code, reason=codes(status_code).phrase, info=info)

nc_py_api/_preferences.py

@@ -20,9 +20,9 @@ def available(self) -> bool:
     def set_value(self, app_name: str, key: str, value: str) -> None:
         """Sets the value for the key for the specific application."""
         require_capabilities("provisioning_api", self._session.capabilities)
-        self._session.ocs(method="POST", path=f"{self._ep_base}/{app_name}/{key}", params={"configValue": value})
+        self._session.ocs("POST", f"{self._ep_base}/{app_name}/{key}", params={"configValue": value})
 
     def delete(self, app_name: str, key: str) -> None:
         """Removes a key and its value for a specific application."""
         require_capabilities("provisioning_api", self._session.capabilities)
-        self._session.ocs(method="DELETE", path=f"{self._ep_base}/{app_name}/{key}")
+        self._session.ocs("DELETE", f"{self._ep_base}/{app_name}/{key}")

nc_py_api/_preferences_ex.py

@@ -44,9 +44,7 @@ def get_values(self, keys: list[str]) -> list[CfgRecord]:
             raise ValueError("`key` parameter can not be empty")
         require_capabilities("app_api", self._session.capabilities)
         data = {"configKeys": keys}
-        results = self._session.ocs(
-            method="POST", path=f"{self._session.ae_url}/{self._url_suffix}/get-values", json=data
-        )
+        results = self._session.ocs("POST", f"{self._session.ae_url}/{self._url_suffix}/get-values", json=data)
         return [CfgRecord(i) for i in results]
 
     def delete(self, keys: typing.Union[str, list[str]], not_fail=True) -> None:
@@ -59,9 +57,7 @@ def delete(self, keys: typing.Union[str, list[str]], not_fail=True) -> None:
             raise ValueError("`key` parameter can not be empty")
         require_capabilities("app_api", self._session.capabilities)
         try:
-            self._session.ocs(
-                method="DELETE", path=f"{self._session.ae_url}/{self._url_suffix}", json={"configKeys": keys}
-            )
+            self._session.ocs("DELETE", f"{self._session.ae_url}/{self._url_suffix}", json={"configKeys": keys})
         except NextcloudExceptionNotFound as e:
             if not not_fail:
                 raise e from None
@@ -78,7 +74,7 @@ def set_value(self, key: str, value: str) -> None:
             raise ValueError("`key` parameter can not be empty")
         require_capabilities("app_api", self._session.capabilities)
         params = {"configKey": key, "configValue": value}
-        self._session.ocs(method="POST", path=f"{self._session.ae_url}/{self._url_suffix}", json=params)
+        self._session.ocs("POST", f"{self._session.ae_url}/{self._url_suffix}", json=params)
 
 
 class AppConfigExAPI(_BasicAppCfgPref):
@@ -99,4 +95,4 @@ def set_value(self, key: str, value: str, sensitive: typing.Optional[bool] = Non
         params: dict = {"configKey": key, "configValue": value}
         if sensitive is not None:
             params["sensitive"] = sensitive
-        self._session.ocs(method="POST", path=f"{self._session.ae_url}/{self._url_suffix}", json=params)
+        self._session.ocs("POST", f"{self._session.ae_url}/{self._url_suffix}", json=params)