nextcloud-client 0.211.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,102 @@
1
+ Metadata-Version: 2.3
2
+ Name: nextcloud-client
3
+ Version: 0.211.0
4
+ Summary: Async Python clients for the Nextcloud APIs: WebDAV, CalDAV, CardDAV, Notes, Deck, Tables, Talk, Mail and more
5
+ Keywords: nextcloud,webdav,caldav,carddav,deck,async,httpx
6
+ Author: Chris Coutinho
7
+ Author-email: Chris Coutinho <chris@coutinho.io>
8
+ License: AGPL-3.0-only
9
+ Classifier: Development Status :: 4 - Beta
10
+ Classifier: Intended Audience :: Developers
11
+ Classifier: License :: OSI Approved :: GNU Affero General Public License v3
12
+ Classifier: Programming Language :: Python :: 3
13
+ Classifier: Programming Language :: Python :: 3.11
14
+ Classifier: Programming Language :: Python :: 3.12
15
+ Classifier: Framework :: AnyIO
16
+ Classifier: Topic :: Internet :: WWW/HTTP
17
+ Requires-Dist: httpx2>=2.5.0
18
+ Requires-Dist: anyio>=4.0
19
+ Requires-Dist: pydantic>=2.11.4
20
+ Requires-Dist: lxml>=5.0
21
+ Requires-Dist: caldav>=3.0.1,<4.0
22
+ Requires-Dist: icalendar>=7.3.0,<7.4.0
23
+ Requires-Dist: recurring-ical-events>=3.8.0,<4.0
24
+ Requires-Dist: pythonvcard4>=0.2.0
25
+ Requires-Dist: pillow>=10.3.0
26
+ Requires-Python: >=3.11
27
+ Project-URL: Repository, https://github.com/cbcoutinho/nextcloud-mcp-server
28
+ Description-Content-Type: text/markdown
29
+
30
+ # nextcloud-client
31
+
32
+ Async Python clients for the Nextcloud APIs, built on `httpx2` and `anyio`. Supported:
33
+
34
+ - **Files (WebDAV):** read, write, search, tags, versions, trash, comments
35
+ - **Calendar and tasks (CalDAV)**
36
+ - **Contacts (CardDAV)**
37
+ - Notes, Deck, Tables, Talk, Mail, News, Collectives, Cookbook, Sharing, Users, Groups and Shopping List
38
+
39
+ They are the clients behind
40
+ [nextcloud-mcp-server](https://github.com/cbcoutinho/nextcloud-mcp-server).
41
+ The clients are released with it and share its version number. Installing them
42
+ does **not** pull in the MCP server's dependencies.
43
+
44
+ ```bash
45
+ pip install nextcloud-client
46
+ ```
47
+
48
+ ## Usage
49
+
50
+ ```python
51
+ import anyio
52
+ from httpx2 import BasicAuth
53
+
54
+ from nextcloud_client import NextcloudClient
55
+
56
+
57
+ async def main():
58
+ nc = NextcloudClient(
59
+ "https://cloud.example.com",
60
+ "alice",
61
+ BasicAuth("alice", "app-password"),
62
+ password="app-password", # CalDAV builds its own auth from the raw secret
63
+ )
64
+ async for note in nc.notes.get_all_notes():
65
+ print(note["title"])
66
+ print(await nc.webdav.list_directory("/"))
67
+
68
+
69
+ anyio.run(main)
70
+ ```
71
+
72
+ For OAuth, use `NextcloudClient.from_token(base_url, token, username)`.
73
+
74
+ ### TLS and connection reuse
75
+
76
+ ```python
77
+ import ssl
78
+
79
+ NextcloudClient(..., verify=ssl.create_default_context(cafile="ca.pem"))
80
+ NextcloudClient(..., verify=False) # self-signed dev instances only
81
+ NextcloudClient(..., keepalive=False) # fresh connection per request
82
+ ```
83
+
84
+ ### Metrics and tracing
85
+
86
+ The clients have no dependency on prometheus or OpenTelemetry. To observe them,
87
+ subclass `nextcloud_client.instrumentation.Instrumentation` and install it:
88
+
89
+ ```python
90
+ from nextcloud_client import instrumentation
91
+
92
+
93
+ class Hooks(instrumentation.Instrumentation):
94
+ def on_api_call(self, app, method, status_code, duration): ...
95
+
96
+
97
+ instrumentation.hooks = Hooks()
98
+ ```
99
+
100
+ ## License
101
+
102
+ AGPL-3.0-only.
@@ -0,0 +1,34 @@
1
+ nextcloud_client/__init__.py,sha256=8s8S6YZYcCxsulFhTar40Ib6IChfzA1CEkEzrS3bz_M,19251
2
+ nextcloud_client/auth.py,sha256=ViYzMai7HhBfi9mFhy9f_d_-qaXawOVHGOJ9v6Np6sc,818
3
+ nextcloud_client/availability.py,sha256=paHZcDZfAAQd8aGw5lW6HvUjf_U0VUNYUrYSEhyhHbc,10391
4
+ nextcloud_client/base.py,sha256=5080A9-5z_h5DyFyXB3Hra3OOo27z9-WAMZ_x-Rq93Y,18793
5
+ nextcloud_client/calendar.py,sha256=cgp2b84bRldlmaxQx7N1yZLCgc8kj1DSNbWLbwohLwg,147969
6
+ nextcloud_client/collectives.py,sha256=hu49lKw7tr9AZKychUu0MXN56z6enjzdgZoHVH1Qk9s,11663
7
+ nextcloud_client/contacts.py,sha256=-rWnaNSFGPGtf71nQHWerf-43M48WokMCZTSx4gbljo,56424
8
+ nextcloud_client/cookbook.py,sha256=wJoQQhawicVnaWw5jU6O_vhIP3m8iw4DackVolm-zH4,7584
9
+ nextcloud_client/dav_errors.py,sha256=zpD5hVmobUfQQtWkkFuC_iCfsgkbpim8HaaKDLDp8vk,7828
10
+ nextcloud_client/dav_urls.py,sha256=jq-quEoAqt2eR51gENz2JDkwge5PdDvRWGv_x8zkCWY,2795
11
+ nextcloud_client/deck.py,sha256=yaDXo4Fzg1tMaqhTM8ys7nsQuHF37tROdzrXJU15ZaY,36188
12
+ nextcloud_client/groups.py,sha256=sMORviPw1zrZ_BScn5gkdrU_N9lePZ_rOYt6n6TrEE0,4905
13
+ nextcloud_client/http.py,sha256=7K89YbZI5-wwaehB0WVlSEplsCoHhER2WEq_6OkZfkg,2931
14
+ nextcloud_client/instrumentation.py,sha256=oUB2pWgPGljZij-AoxnVERIh6GAawFGGFNs8eDZ10gY,1822
15
+ nextcloud_client/mail.py,sha256=5e5Jx3RFfpEeq0c3z9BqpY29DAypcMie-dO5krt7rw4,33365
16
+ nextcloud_client/models/__init__.py,sha256=VN_vpddxrbjFqbixYgMBsYPmzFCzILO0nl9jOOYEa7s,57
17
+ nextcloud_client/models/deck.py,sha256=Dm3aR_FhbA_483t7MdXebKi5JPNZFn2XrZberSeH7-o,9783
18
+ nextcloud_client/models/sharing.py,sha256=wocWg_tYCuEexKdIvdr03I9djHDclKnFLR-XMV2cvo8,632
19
+ nextcloud_client/models/talk.py,sha256=pBVF0WaYZ6Rt9QiWVDIP3vWppa2EmJhYBm1T-hMzkzY,4663
20
+ nextcloud_client/models/users.py,sha256=dqbEX3Z4jlV5Y0qO9GytcwrFC-fS1AsSQ8z9IiJkHaI,1155
21
+ nextcloud_client/news.py,sha256=whKUoHnpOkR78kqjylYig2JRH81zuRc0aBcDgMMkVEU,11595
22
+ nextcloud_client/notes.py,sha256=FN2HtoYVsi6zenerg7Fg9k5Ahxfcs8PeS0Xz9Qv4200,10751
23
+ nextcloud_client/notes_search.py,sha256=oLNvP68vik3ipmEZA4J4_yOcI5xhsrSdfenjDA9WR0E,3886
24
+ nextcloud_client/ocs.py,sha256=k9hDvvQV6HDW9eq_3FrHUd26ud7cEShZnGr8hSnA-AU,6277
25
+ nextcloud_client/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
26
+ nextcloud_client/sharing.py,sha256=05QYoVV9I5JEhOT97K4xeuupe8wU1pblS2Okbibpu88,13550
27
+ nextcloud_client/shopping_list.py,sha256=PUIOV50Nwg4GLmGsFe5jCI9JWbWe5-_XTooGVKe0QWU,5580
28
+ nextcloud_client/tables.py,sha256=_y9ISyvSW6LrbVuj9DC2rXtX6E5foNqzGdjVrUo_VpA,5288
29
+ nextcloud_client/talk.py,sha256=Md01pmtv4aenN5tDBIYqlb8CuBVzCKJpbUjfreFM5bg,19436
30
+ nextcloud_client/users.py,sha256=Z5hbTZ8XuUq6ViXODO6M5cyM3Q5rD7cRD7CZWcVYupM,8334
31
+ nextcloud_client/webdav.py,sha256=cxvWmfKY2wlcqYsgGQTnTyw4F5AJjGZH07qVld1NLYY,124331
32
+ nextcloud_client-0.211.0.dist-info/WHEEL,sha256=MWx7psoF7KNST9G72pGtiBYuaXRXQXBk9pw5R6FzYko,80
33
+ nextcloud_client-0.211.0.dist-info/METADATA,sha256=BFXul1vHn8h0LquhRgc_2oYM4ezfFEr3YYX4wkdtr5A,3036
34
+ nextcloud_client-0.211.0.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: uv 0.13.7
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any