Revision 4e5673a0

b/docs/source/devguide.rst
25 25
=========================  ================================
26 26
Revision                   Description
27 27
=========================  ================================
28
0.8 (Dec 2, 2011)          Update allowed versioning values.
28
0.8 (Dec 15, 2011)         Update allowed versioning values.
29 29
\                          Change policy/meta formatting in JSON/XML replies.
30 30
\                          Document that all non-ASCII characters in headers should be URL-encoded.
31
\                          Support metadata-based queries when listing objects at the container level.
31 32
0.7 (Nov 21, 2011)         Suggest upload/download methods using hashmaps.
32 33
\                          Propose syncing algorithm.
33 34
\                          Support cross-account object copy and move.
......
441 442
delimiter               Return objects up to the delimiter (discussion follows)
442 443
path                    Assume ``prefix=path`` and ``delimiter=/``
443 444
format                  Optional extended reply type (can be ``json`` or ``xml``)
444
meta                    Return objects having the specified meta keys (can be a comma separated list)
445
meta                    Return objects that satisfy the key queries in the specified comma separated list (use ``<key>``, ``!<key>`` for existence queries, ``<key><op><value>`` for value queries, where ``<op>`` can be one of ``=``, ``!=``, ``<=``, ``>=``, ``<``, ``>``)
445 446
shared                  Show only shared objects (no value parameter)
446 447
until                   Optional timestamp
447 448
======================  ===================================
......
489 490

  
490 491
Extended replies may also include virtual directory markers in separate sections of the ``json`` or ``xml`` results.
491 492
Virtual directory markers are only included when ``delimiter`` is explicitly set. They correspond to the substrings up to and including the first occurrence of the delimiter.
492
In JSON results they appear as dictionaries with only a ``"subdir"`` key. In XML results they appear interleaved with ``<object>`` tags as ``<subdir name="..." />``.
493
In JSON results they appear as dictionaries with only a ``subdir`` key. In XML results they appear interleaved with ``<object>`` tags as ``<subdir name="..." />``.
493 494
In case there is an object with the same name as a virtual directory marker, the object will be returned.
494 495

  
495 496
Example ``format=json`` reply:
b/pithos/backends/base.py
289 289
            
290 290
            'keys': Include objects that satisfy the key queries in the list.
291 291
                    Use 'key', '!key' for existence queries, 'key op value' for
292
                    value queries, where 'op' can be one of =, != <=, >=, <, >
292
                    value queries, where 'op' can be one of =, !=, <=, >=, <, >
293 293
            
294 294
            'shared': Only list objects with permissions set
295 295
        

Also available in: Unified diff