nc-py-api 0.18.1__py3-none-any.whl → 0.19.0__py3-none-any.whl

nc_py_api/_session.py

@@ -12,6 +12,7 @@ from json import loads
 from os import environ
 
 from httpx import AsyncClient, Client, Headers, Limits, ReadTimeout, Request, Response
+from httpx import __version__ as httpx_version
 from starlette.requests import HTTPConnection
 
 from . import options
@@ -477,7 +478,6 @@ class NcSessionAppBasic(ABC):
 
     def sign_check(self, request: HTTPConnection) -> str:
         headers = {
-            "AA-VERSION": request.headers.get("AA-VERSION", ""),
             "EX-APP-ID": request.headers.get("EX-APP-ID", ""),
             "EX-APP-VERSION": request.headers.get("EX-APP-VERSION", ""),
             "AUTHORIZATION-APP-API": request.headers.get("AUTHORIZATION-APP-API", ""),
@@ -511,6 +511,7 @@ class NcSessionApp(NcSessionAppBasic, NcSessionBasic):
                 "AA-VERSION": self.cfg.aa_version,
                 "EX-APP-ID": self.cfg.app_name,
                 "EX-APP-VERSION": self.cfg.app_version,
+                "user-agent": f"ExApp/{self.cfg.app_name}/{self.cfg.app_version} (httpx/{httpx_version})",
             },
         )
 
@@ -535,6 +536,7 @@ class AsyncNcSessionApp(NcSessionAppBasic, AsyncNcSessionBasic):
                 "AA-VERSION": self.cfg.aa_version,
                 "EX-APP-ID": self.cfg.app_name,
                 "EX-APP-VERSION": self.cfg.app_version,
+                "User-Agent": f"ExApp/{self.cfg.app_name}/{self.cfg.app_version} (httpx/{httpx_version})",
             },
         )
 

nc_py_api/_version.py

@@ -1,3 +1,3 @@
 """Version of nc_py_api."""
 
-__version__ = "0.18.1"
+__version__ = "0.19.0"

nc_py_api/ex_app/__init__.py

@@ -10,7 +10,7 @@ from .integration_fastapi import (
     set_handlers,
     talk_bot_msg,
 )
-from .logging import setup_nextcloud_logging
+from .logger import setup_nextcloud_logging
 from .misc import (
     get_computation_device,
     get_model_path,

nc_py_api/ex_app/integration_fastapi.py

@@ -241,7 +241,7 @@ class AppAPIAuthMiddleware:
 
     async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None:
         """Method that will be called by Starlette for each event."""
-        if scope["type"] != "http":
+        if scope["type"] not in ("http", "websocket"):
             await self.app(scope, receive, send)
             return
 

nc_py_api/files/__init__.py

@@ -86,6 +86,7 @@ class FsNodeInfo:
     is_version: bool
     """Flag indicating if the object is File Version representation"""
     _last_modified: datetime.datetime
+    _creation_date: datetime.datetime
     _trashbin: dict
 
     def __init__(self, **kwargs):
@@ -102,6 +103,10 @@ class FsNodeInfo:
             self.last_modified = kwargs.get("last_modified", datetime.datetime(1970, 1, 1))
         except (ValueError, TypeError):
             self.last_modified = datetime.datetime(1970, 1, 1)
+        try:
+            self.creation_date = kwargs.get("creation_date", datetime.datetime(1970, 1, 1))
+        except (ValueError, TypeError):
+            self.creation_date = datetime.datetime(1970, 1, 1)
         self._trashbin: dict[str, str | int] = {}
         for i in ("trashbin_filename", "trashbin_original_location", "trashbin_deletion_time"):
             if i in kwargs:
@@ -142,6 +147,18 @@ class FsNodeInfo:
         else:
             self._last_modified = value
 
+    @property
+    def creation_date(self) -> datetime.datetime:
+        """Time when the object was created."""
+        return self._creation_date
+
+    @creation_date.setter
+    def creation_date(self, value: str | datetime.datetime):
+        if isinstance(value, str):
+            self._creation_date = email.utils.parsedate_to_datetime(value)
+        else:
+            self._creation_date = value
+
     @property
     def in_trash(self) -> bool:
         """Returns ``True`` if the object is in trash."""

nc_py_api/files/_files.py

@@ -16,6 +16,7 @@ from . import FsNode, SystemTag
 PROPFIND_PROPERTIES = [
     "d:resourcetype",
     "d:getlastmodified",
+    "d:creationdate",
     "d:getcontentlength",
     "d:getcontenttype",
     "d:getetag",
@@ -45,6 +46,7 @@ SEARCH_PROPERTIES_MAP = {
     "name": "d:displayname",  # like, eq
     "mime": "d:getcontenttype",  # like, eq
     "last_modified": "d:getlastmodified",  # gt, eq, lt
+    "creation_date": "d:creationdate",  # gt, eq, lt
     "size": "oc:size",  # gt, gte, eq, lt
     "favorite": "oc:favorite",  # eq
     "fileid": "oc:fileid",  # eq
@@ -286,6 +288,8 @@ def _parse_record(full_path: str, prop_stats: list[dict]) -> FsNode:  # noqa pyl
             fs_node_args["etag"] = prop["d:getetag"]
         if "d:getlastmodified" in prop_keys:
             fs_node_args["last_modified"] = prop["d:getlastmodified"]
+        if "d:creationdate" in prop_keys:
+            fs_node_args["creation_date"] = prop["d:creationdate"]
         if "d:getcontenttype" in prop_keys:
             fs_node_args["mimetype"] = prop["d:getcontenttype"]
         if "oc:permissions" in prop_keys:

nc_py_api/nextcloud.py

@@ -29,7 +29,7 @@ from ._talk_api import _AsyncTalkAPI, _TalkAPI
 from ._theming import ThemingInfo, get_parsed_theme
 from .activity import _ActivityAPI, _AsyncActivityAPI
 from .apps import _AppsAPI, _AsyncAppsAPI
-from .calendar import _CalendarAPI
+from .calendar_api import _CalendarAPI
 from .ex_app.defs import LogLvl
 from .ex_app.events_listener import AsyncEventsListenerAPI, EventsListenerAPI
 from .ex_app.occ_commands import AsyncOccCommandsAPI, OccCommandsAPI

nc_py_api/options.py

@@ -33,11 +33,22 @@ NPA_NC_CERT: bool | str
 SSL certificates (a.k.a CA bundle) used to  verify the identity of requested hosts. Either **True** (default CA bundle),
 a path to an SSL certificate file, or **False** (which will disable verification)."""
 str_val = environ.get("NPA_NC_CERT", "True")
-NPA_NC_CERT = True
+# https://github.com/encode/httpx/issues/302
+# when "httpx" will switch to use "truststore" by default - uncomment next line
+# NPA_NC_CERT = True
 if str_val.lower() in ("false", "0"):
     NPA_NC_CERT = False
 elif str_val.lower() not in ("true", "1"):
     NPA_NC_CERT = str_val
+else:
+    # Temporary workaround, see comment above.
+    # Use system certificate stores
+
+    import ssl
+
+    import truststore
+
+    NPA_NC_CERT = truststore.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
 
 CHUNKED_UPLOAD_V2 = environ.get("CHUNKED_UPLOAD_V2", True)
 """Option to enable/disable **version 2** chunked upload(better Object Storages support).

{nc_py_api-0.18.1.dist-info → nc_py_api-0.19.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nc-py-api
-Version: 0.18.1
+Version: 0.19.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/
@@ -34,6 +34,7 @@ Requires-Dist: fastapi>=0.109.2
 Requires-Dist: httpx>=0.25.2
 Requires-Dist: pydantic>=2.1.1
 Requires-Dist: python-dotenv>=1
+Requires-Dist: truststore==0.10
 Requires-Dist: xmltodict>=0.13
 Provides-Extra: app
 Requires-Dist: uvicorn[standard]>=0.23.2; extra == 'app'
@@ -86,7 +87,7 @@ Description-Content-Type: text/markdown
 [![Docs](https://github.com/cloud-py-api/nc_py_api/actions/workflows/docs.yml/badge.svg)](https://cloud-py-api.github.io/nc_py_api/)
 [![codecov](https://codecov.io/github/cloud-py-api/nc_py_api/branch/main/graph/badge.svg?token=C91PL3FYDQ)](https://codecov.io/github/cloud-py-api/nc_py_api)
 
-![NextcloudVersion](https://img.shields.io/badge/Nextcloud-27%20%7C%2028%20%7C%2029%20%7C%2030-blue)
+![NextcloudVersion](https://img.shields.io/badge/Nextcloud-%2028%20%7C%2029%20%7C%2030%20%7C%2031-blue)
 ![PythonVersion](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12-blue)
 ![impl](https://img.shields.io/pypi/implementation/nc_py_api)
 ![pypi](https://img.shields.io/pypi/v/nc_py_api.svg)
@@ -94,6 +95,7 @@ Description-Content-Type: text/markdown
 Python library that provides a robust and well-documented API that allows developers to interact with and extend Nextcloud's functionality.
 
 ### The key features are:
+
  * **Fast**: High performance, and as low-latency as possible.
  * **Intuitive**: Fast to code, easy to use.
  * **Reliable**: Minimum number of incompatible changes.
@@ -101,24 +103,6 @@ Python library that provides a robust and well-documented API that allows develo
  * **Easy**: Designed to be easy to use with excellent documentation.
  * **Sync + Async**: Provides both sync and async APIs.
 
-### Capabilities
-| **_Capability_**             | Nextcloud 27 | Nextcloud 28 | Nextcloud 29 | Nextcloud 30 |
-|------------------------------|:------------:|:------------:|:------------:|:------------:|
-| Calendar                     |      ✅       |      ✅       |      ✅       |      ✅       |
-| File System & Tags           |      ✅       |      ✅       |      ✅       |      ✅       |
-| Nextcloud Talk               |      ✅       |      ✅       |      ✅       |      ✅       |
-| Notifications                |      ✅       |      ✅       |      ✅       |      ✅       |
-| Shares                       |      ✅       |      ✅       |      ✅       |      ✅       |
-| Users & Groups               |      ✅       |      ✅       |      ✅       |      ✅       |
-| User & Weather status        |      ✅       |      ✅       |      ✅       |      ✅       |
-| Other APIs**                 |      ✅       |      ✅       |      ✅       |      ✅       |
-| Talk Bot API*                |      ✅       |      ✅       |      ✅       |      ✅       |
-| Settings UI API*             |     N/A      |     N/A      |      ✅       |      ✅       |
-| TaskProcessing Provider API* |     N/A      |     N/A      |     N/A      |      ✅       |
-
-&ast;_available only for **NextcloudApp**_<br>
-&ast;&ast;_Activity, Notes_
-
 ### Differences between the Nextcloud and NextcloudApp classes
 
 The **Nextcloud** class functions as a standard Nextcloud client,
@@ -135,8 +119,6 @@ but NextcloudApp has a broader selection since applications typically require ac
 Any code written for the Nextcloud class can easily be adapted for use with the NextcloudApp class,
 as long as it doesn't involve calls that require user password verification.
 
-**NextcloudApp** avalaible only from Nextcloud 27.1.2 and greater version with installed **AppAPI**.
-
 ### Nextcloud skeleton app in Python
 
 ```python3

{nc_py_api-0.18.1.dist-info → nc_py_api-0.19.0.dist-info}/RECORD

@@ -4,18 +4,18 @@ 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=tThj6U0ZZMaBZ-jUkjrbaI0xDnafWsBowQKsC6gjOQs,7179
-nc_py_api/_session.py,sha256=ZD0TKrL-tOpxYtV6AO0cwRrYzbnjBr_ylCEUirrykjU,20242
+nc_py_api/_session.py,sha256=mIxppN59t4u0mSqcZjRWqiVPl4EBt_ZK0c1Q-Vi6cec,20438
 nc_py_api/_talk_api.py,sha256=0Uo7OduYniuuX3UQPb468RyGJJ-PWBCgJ5HoPuz5Qa0,51068
 nc_py_api/_theming.py,sha256=hTr3nuOemSuRFZaPy9iXNmBM7rDgQHECH43tHMWGqEY,1870
-nc_py_api/_version.py,sha256=vPHaIX0sBYHr1ilh-YTVqasI6cM7TDtyHmVDvps_3zY,52
+nc_py_api/_version.py,sha256=pjQIAjVuhhl9yT96je-tolLueZcoR9gYqLvoFS2QzH0,52
 nc_py_api/activity.py,sha256=t9VDSnnaXRNOvALqOSGCeXSQZ-426pCOMSfQ96JHys4,9574
 nc_py_api/apps.py,sha256=Us2y2lszdxXlD8t6kxwd5_Nrrmazc0EvZXIH9O-ol80,9315
-nc_py_api/calendar.py,sha256=-T6CJ8cRbJZTLtxSEDWuuYpD29DMJGCTfLONmtxZV9w,1445
+nc_py_api/calendar_api.py,sha256=-T6CJ8cRbJZTLtxSEDWuuYpD29DMJGCTfLONmtxZV9w,1445
 nc_py_api/loginflow_v2.py,sha256=UjkK3gMouzNrIS7BFhjbmB_9m4fP2UY5sfpmvJ2EXWk,5760
-nc_py_api/nextcloud.py,sha256=Uc4hOtLNkvl8sjKmAGS-vyKdiA1gEZwRr1wj0Sd_ONk,23005
+nc_py_api/nextcloud.py,sha256=MTuskKYKu3nSaP2uwR-IoC714ejV_HqtfdO71Ro4-iI,23009
 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
+nc_py_api/options.py,sha256=ZKJqVLhWVwJ6YxAKzGWlPXJhd1vg9GluyFzr-jX4Jp0,2038
 nc_py_api/talk.py,sha256=OZFemYkDOaM6o4xAK3EvQbjMFiK75E5qnsCDyihIElg,29368
 nc_py_api/talk_bot.py,sha256=_RuImwb3jYvUKX3ywcX095ucOjECCxsuc59heIxNoTM,16725
 nc_py_api/user_status.py,sha256=I101nwYS8X1WvC8AnLa2f3qJUCPDPHrbq-ke0h1VT4E,13282
@@ -23,11 +23,11 @@ nc_py_api/users.py,sha256=SQG8Agplaxy7XJgguK-rxV-azpc-QdktbDmLmQtJkXo,15476
 nc_py_api/users_groups.py,sha256=IPxw-Ks5NjCm6r8_HC9xmf3IYptH00ulITbp5iazhAo,6289
 nc_py_api/weather_status.py,sha256=wAkjuJPjxc0Rxe4za0BzfwB0XeUmkCXoisJtTH3-qdQ,7582
 nc_py_api/webhooks.py,sha256=14nAMy-tnOvmRnJbo42zUHyjX-z6kc9OMDUVKzNmplY,7769
-nc_py_api/ex_app/__init__.py,sha256=hFbu6wTXs-wmjs1tavm_HYLwiqgrp7_qJe-stzCiqfI,692
+nc_py_api/ex_app/__init__.py,sha256=6Lwid4bBXOSrZf_ocf5m8qkkO1OgYxG0GTs4q6Nw72o,691
 nc_py_api/ex_app/defs.py,sha256=FaQInH3jLugKxDUqpwrXdkMT-lBxmoqWmXJXc11fa6A,727
 nc_py_api/ex_app/events_listener.py,sha256=pgQ4hSQV39NuP9F9IDWxo0Qle6oG15-Ol2FlItnIBGY,4682
-nc_py_api/ex_app/integration_fastapi.py,sha256=xh-gSxYH6_FE8GluajlrVAHZg1HZeaAxJ-jIUP6uot4,11022
-nc_py_api/ex_app/logging.py,sha256=nAHLObuPvl3UBLrlqZulgoxxVaAJ661iP4F6bTW-V-Y,1475
+nc_py_api/ex_app/integration_fastapi.py,sha256=a3mhbBFrv_IaRqaYfKa26duiufZL-hSDFqcPDr59Vts,11041
+nc_py_api/ex_app/logger.py,sha256=nAHLObuPvl3UBLrlqZulgoxxVaAJ661iP4F6bTW-V-Y,1475
 nc_py_api/ex_app/misc.py,sha256=c7B0uE8isaIi4SQbxURGUuWjZaaXiLg3Ov6cqvRYplE,2298
 nc_py_api/ex_app/occ_commands.py,sha256=hb2BJuvFKIigvLycSCyAe9v6hedq4Gfu2junQZTaK_M,5219
 nc_py_api/ex_app/persist_transformers_cache.py,sha256=ZoEBb1RnNaQrtxK_CjSZ8LZ36Oakz2Xciau_ZpNp8Ic,213
@@ -41,13 +41,13 @@ nc_py_api/ex_app/ui/resources.py,sha256=Vwx69oZ93Ouh6HJtGUqaKFUr4Reo74H4vT1YCpb-
 nc_py_api/ex_app/ui/settings.py,sha256=f0R17lGhBfo2JQULVw_hFxhpfoPw_CW7vBu0Rb1ABJw,6623
 nc_py_api/ex_app/ui/top_menu.py,sha256=oCgGtIoMYbp-5iN5aXEbT7Q88HtccR7hg6IBFgbbyX4,5118
 nc_py_api/ex_app/ui/ui.py,sha256=OqFHKn6oIZli8T1wnv6YtQ4glNfeNb90WwGCvtWI1Z4,1632
-nc_py_api/files/__init__.py,sha256=uSjqZyYAq9x3xOb_yz15KNNAcPo1PhbpPLtPz_ej-Eo,17303
-nc_py_api/files/_files.py,sha256=_s_f8xbzQPEH2F2LNwomI9CxscYHryus1pMZ_vW00C4,13666
+nc_py_api/files/__init__.py,sha256=aN6Lhc0km5eAIGFA8YoG-xXDOzIJILV2izCzHeC-a78,17949
+nc_py_api/files/_files.py,sha256=l1oGcXIKmuhlNthXkwL8qbINQgiMJ9wmFega9IP-wNk,13850
 nc_py_api/files/files.py,sha256=7x4hfnVa2y1R5bxK9f8cdggi1gPnpUYnsBj0e4p-4qc,24926
 nc_py_api/files/files_async.py,sha256=nyDeWiGx_8CHuVrNThSgfZy0l-WlC4El-TzJONo0TsM,25773
 nc_py_api/files/sharing.py,sha256=VRZCl-TYK6dbu9rUHPs3_jcVozu1EO8bLGZwoRpiLsU,14439
-nc_py_api-0.18.1.dist-info/METADATA,sha256=kNiYxJLCeclDF7NYY0B3sa9nXkqqm7T1yfZfE4Yx7GE,9502
-nc_py_api-0.18.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-nc_py_api-0.18.1.dist-info/licenses/AUTHORS,sha256=B2Q9q9XH3PAxJp0V3GiKQc1l0z7vtGDpDHqda-ISWKM,616
-nc_py_api-0.18.1.dist-info/licenses/LICENSE.txt,sha256=OLEMh401fAumGHfRSna365MLIfnjdTcdOHZ6QOzMjkg,1551
-nc_py_api-0.18.1.dist-info/RECORD,,
+nc_py_api-0.19.0.dist-info/METADATA,sha256=JdeWl1GIKzsGQc3n7I0_WmT_OkPPFOJD15Qkr9MTUyQ,8055
+nc_py_api-0.19.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+nc_py_api-0.19.0.dist-info/licenses/AUTHORS,sha256=B2Q9q9XH3PAxJp0V3GiKQc1l0z7vtGDpDHqda-ISWKM,616
+nc_py_api-0.19.0.dist-info/licenses/LICENSE.txt,sha256=OLEMh401fAumGHfRSna365MLIfnjdTcdOHZ6QOzMjkg,1551
+nc_py_api-0.19.0.dist-info/RECORD,,