wsgidav.dav_provider.DAVCollection.get_ref_url#

DAVCollection.get_ref_url()#

Return the quoted, absolute, unique URL of a resource, relative to appRoot.

Byte string, UTF-8 encoded, quoted. Starts with a ‘/’. Collections also have a trailing ‘/’.

This is basically the same as get_preferred_path, but deals with ‘virtual locations’ as well.

e.g. ‘/a/b’ == ‘/A/b’ == ‘/bykey/123’ == ‘/byguid/abc532’

get_ref_url() returns the same value for all these URLs, so it can be used as a key for locking and persistence storage.

DAV providers that allow virtual-mappings must override this method.

See also comments in DEVELOPERS.txt glossary.