/usr/share/pyshared/zope/preference/interfaces.py is in python-zope.preference 3.8.0-0ubuntu4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 | ##############################################################################
#
# Copyright (c) 2005 Zope Foundation and Contributors.
# All Rights Reserved.
#
# This software is subject to the provisions of the Zope Public License,
# Version 2.1 (ZPL). A copy of the ZPL should accompany this distribution.
# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
# FOR A PARTICULAR PURPOSE.
#
##############################################################################
"""User Preferences Interfaces
$Id: interfaces.py 113358 2010-06-11 17:17:44Z icemac $
"""
__docformat__ = "reStructuredText"
import zope.interface
import zope.schema
from zope.configuration.fields import MessageID
from zope.location.interfaces import ILocation
class IPreferenceGroup(ILocation):
"""A group of preferences.
This component represents a logical group of preferences. The preferences
contained by this group is defined through the schema. The group has also
a name by which it can be accessed.
The fields specified in the schema *must* be available as attributes and
items of the group instance. It is up to the implementation how this is
realized, however, most often one will implement __setattr__ and
__getattr__ as well as the common mapping API.
The reason all the API fields are doubly underlined is to avoid name
clashes.
"""
__id__ = zope.schema.TextLine(
title=u"Id",
description=u"The id of the group.",
required=True)
__schema__ = zope.schema.InterfaceField(
title=u"Schema",
description=u"Schema describing the preferences of the group.",
required=False)
__title__ = MessageID(
title=u"Title",
description=u"The title of the group used in the UI.",
required=True)
__description__ = MessageID(
title=u"Description",
description=u"The description of the group used in the UI.",
required=False)
class IPreferenceCategory(zope.interface.Interface):
"""A collection of preference groups.
Objects providing this interface serve as groups of preference
groups. This allows UIs to distinguish between high- and low-level
prefernce groups.
"""
class IUserPreferences(zope.interface.Interface):
"""Objects providing this interface have to provide the root preference
group API as well."""
class IDefaultPreferenceProvider(zope.interface.Interface):
"""A root object providing default values for the entire preferences tree.
Default preference providers are responsible for providing default values
for all preferences. The way they get these values are up to the
implementation.
"""
preferences = zope.schema.Field(
title = u"Default Preferences Root",
description = u"Link to the default preferences")
|