/usr/share/pyshared/zope/principalannotation/interfaces.py is in python-zope.principalannotation 3.6.1-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 | ##############################################################################
#
# Copyright (c) 2009 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.
#
##############################################################################
"""Utility for storing `IAnnotations` for principals.
$Id: interfaces.py 112036 2010-05-05 19:10:45Z tseaver $
"""
__docformat__ = 'restructuredtext'
from zope.interface import Interface
class IPrincipalAnnotationUtility(Interface):
"""Stores `IAnnotations` for `IPrinicipals`."""
def getAnnotations(principal):
"""Return object implementing `IAnnotations` for the given
`IPrinicipal`.
If there is no `IAnnotations` it will be created and then returned.
"""
def getAnnotationsById(principalId):
"""Return object implementing `IAnnotations` for the given
`prinicipalId`.
If there is no `IAnnotations` it will be created and then returned.
"""
def hasAnnotations(principal):
"""Return boolean indicating if given `IPrincipal` has
`IAnnotations`."""
|