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.
- nextcloud_client/__init__.py +477 -0
- nextcloud_client/auth.py +34 -0
- nextcloud_client/availability.py +290 -0
- nextcloud_client/base.py +443 -0
- nextcloud_client/calendar.py +3430 -0
- nextcloud_client/collectives.py +325 -0
- nextcloud_client/contacts.py +1321 -0
- nextcloud_client/cookbook.py +244 -0
- nextcloud_client/dav_errors.py +187 -0
- nextcloud_client/dav_urls.py +61 -0
- nextcloud_client/deck.py +930 -0
- nextcloud_client/groups.py +164 -0
- nextcloud_client/http.py +69 -0
- nextcloud_client/instrumentation.py +50 -0
- nextcloud_client/mail.py +825 -0
- nextcloud_client/models/__init__.py +1 -0
- nextcloud_client/models/deck.py +302 -0
- nextcloud_client/models/sharing.py +24 -0
- nextcloud_client/models/talk.py +136 -0
- nextcloud_client/models/users.py +41 -0
- nextcloud_client/news.py +394 -0
- nextcloud_client/notes.py +293 -0
- nextcloud_client/notes_search.py +113 -0
- nextcloud_client/ocs.py +140 -0
- nextcloud_client/py.typed +0 -0
- nextcloud_client/sharing.py +364 -0
- nextcloud_client/shopping_list.py +150 -0
- nextcloud_client/tables.py +146 -0
- nextcloud_client/talk.py +487 -0
- nextcloud_client/users.py +239 -0
- nextcloud_client/webdav.py +3046 -0
- nextcloud_client-0.211.0.dist-info/METADATA +102 -0
- nextcloud_client-0.211.0.dist-info/RECORD +34 -0
- nextcloud_client-0.211.0.dist-info/WHEEL +4 -0
|
@@ -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,,
|