[Zope3-checkins] CVS: Zope3/src/zope/app/interfaces - dav.py:1.1
Sidnei da Silva
sidnei@x3ng.com.br
Tue, 20 May 2003 12:28:02 -0400
Update of /cvs-repository/Zope3/src/zope/app/interfaces
In directory cvs.zope.org:/tmp/cvs-serv27205/src/zope/app/interfaces
Added Files:
dav.py
Log Message:
Adding IDAVSchema, correcting one URI, registering the IDAVSchema to DAV: namespace and some whitespace cleaning.
=== Added File Zope3/src/zope/app/interfaces/dav.py ===
from zope.interface import Interface
from zope.schema import Text
class IDAVCreationDate(Interface):
creationdate = Text(title=u'''Records the time and date the resource\
was created''',
description=u'''\
The creationdate property should be
defined on all DAV compliant
resources. If present, it contains a
timestamp of the moment when the
resource was created (i.e., the moment
it had non- null state).''')
class IDAVDisplayName(Interface):
displayname = Text(title=u'''Provides a name for the resource that\
is suitable for presentation to a\
user''',
description=u'''\
The displayname property should be
defined on all DAV compliant
resources. If present, the property
contains a description of the resource
that is suitable for presentation to a
user.''')
class IDAVSource(Interface):
source = Text(title=u'''The destination of the source link\
identifies the resource that contains\
the unprocessed source of the link\
source''',
description=u'''\
The source of the link (src) is
typically the URI of the output
resource on which the link is defined,
and there is typically only one
destination (dst) of the link, which
is the URI where the unprocessed
source of the resource may be
accessed. When more than one link
destination exists, this specification
asserts no policy on ordering.''')
class IOptionalDAVSchema(IDAVCreationDate, IDAVDisplayName, IDAVSource):
""" DAV properties that SHOULD be present but are not required """
pass
class IGETDependentDAVSchema(Interface):
""" DAV properties that are dependent on GET support of the resource """
getcontentlanguage = Text(title=u'''Contains the Content-Language\
header returned by a GET without\
accept headers''',
description=u'''\
The getcontentlanguage property MUST
be defined on any DAV compliant
resource that returns the
Content-Language header on a GET.''')
getcontentlength = Text(title=u'''Contains the Content-Length header\
returned by a GET without accept\
headers''',
description=u'''\
The getcontentlength property MUST be
defined on any DAV compliant resource
that returns the Content-Length header
in response to a GET.''')
getcontenttype = Text(title=u'''Contains the Content-Type header\
returned by a GET without accept\
headers''',
description=u'''\
This getcontenttype property MUST be
defined on any DAV compliant resource
that returns the Content-Type header
in response to a GET.''')
getetag = Text(title=u'''Contains the ETag header returned by a GET\
without accept headers''',
description=u'''\
The getetag property MUST be defined
on any DAV compliant resource that
returns the Etag header.''')
getlastmodified = Text(title=u'''Contains the Last-Modified header\
returned by a GET method without\
accept headers''',
description=u'''\
Note that the last-modified date on a
resource may reflect changes in any
part of the state of the resource, not
necessarily just a change to the
response to the GET method. For
example, a change in a property may
cause the last-modified date to
change. The getlastmodified property
MUST be defined on any DAV compliant
resource that returns the
Last-Modified header in response to a
GET.''')
class IDAV1Schema(IGETDependentDAVSchema):
""" DAV properties required for Level 1 compliance """
resourcetype = Text(title=u'''Specifies the nature of the resource''',
description=u'''\
The resourcetype property MUST be
defined on all DAV compliant
resources. The default value is
empty.''')
class IDAV2Schema(IDAV1Schema):
""" DAV properties required for Level 2 compliance """
lockdiscovery = Text(title=u'''Describes the active locks on a\
resource''',
description=u'''\
The lockdiscovery property returns a
listing of who has a lock, what type
of lock he has, the timeout type and
the time remaining on the timeout,
and the associated lock token. The
server is free to withhold any or all
of this information if the requesting
principal does not have sufficient
access rights to see the requested
data.''')
supportedlock = Text(title=u'''To provide a listing of the lock\
capabilities supported by the\
resource''',
description=u'''\
The supportedlock property of a
resource returns a listing of the
combinations of scope and access types
which may be specified in a lock
request on the resource. Note that
the actual contents are themselves
controlled by access controls so a
server is not required to provide
information the client is not
authorized to see.''')
class IDAVSchema(IOptionalDAVSchema, IDAV2Schema):
""" Full DAV properties schema """
pass