sjs/vdirsyncer
1
0
Fork 0
mirror of https://github.com/samsonjs/vdirsyncer.git synced 2026-04-16 12:35:53 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Elaborate on caldav item queries with Radicale

Browse source
This commit is contained in:
Markus Unterwaditzer 2014-07-02 19:14:45 +02:00
parent 0b6e3adf0e
commit f5f505f557
2 changed files with 18 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
docs/server_support.rst
View file

@ -23,12 +23,19 @@ Radicale.
and ``end_date`` for :py:class:`vdirsyncer.storage.CaldavStorage` will have
no or unpredicted consequences.
- Versions of Radicale older than 0.9b1 don't support the necessary
functionality for efficient querying for all items of a collection.
Vdirsyncer's defaults are supposed to deal with this situation, but if you're
using :py:class:`vdirsyncer.storage.CaldavStorage` and set ``item_types`` to
an empty value (``item_types =``), these versions of Radicale will not work
properly.
- `Versions of Radicale older than 0.9b1 choke on RFC-conform queries for all
items of a collection. <https://github.com/Kozea/Radicale/issues/143>`_.
Vdirsyncer's default value ``'VTODO, VEVENT'`` for
:py:class:`vdirsyncer.storage.CaldavStorage`'s ``item_types`` parameter will
work fine with these versions, and so will all values, except for the empty
one.
The empty value ``''`` will get vdirsyncer to send a single HTTP request to
fetch all items, instead of one HTTP request for each possible item type. As
the linked issue describes, old versions of Radicale expect a
non-RFC-compliant format for such queries, one which vdirsyncer doesn't
support.
ownCloud
========

8
vdirsyncer/storage/dav.py
View file

@ -444,9 +444,11 @@ class CaldavStorage(DavStorage):
''' + DavStorage.__doc__ + '''
:param start_date: Start date of timerange to show, default -inf.
:param end_date: End date of timerange to show, default +inf.
:param item_types: A tuple of collection types to show from the server.
For example, if you want to only get VEVENTs, pass ``VEVENT``.
Dependent on server functionality, no clientside validation of results.
:param item_types: Comma-separated collection types to show from the
server. Dependent on server functionality, no clientside validation of
results. The empty value ``''`` is the same as ``'VTODO, VEVENT,
VJOURNAL'``.
'''
storage_name = 'caldav'