/usr/share/pyshared/zope/app/publication/interfaces.py is in python-zope.app.publication 3.13.2-0ubuntu2.
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 86 87 88 89 90 91 92 93 94 95 96 | ##############################################################################
#
# Copyright (c) 2001, 2002 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.
#
##############################################################################
"""Publication Interfaces
"""
__docformat__ = 'restructuredtext'
from zope import interface
# BBB: Re-import symbols to their old location.
from zope.publisher.interfaces import IEndRequestEvent
from zope.publisher.interfaces import EndRequestEvent
from zope.traversing.interfaces import IBeforeTraverseEvent
from zope.traversing.interfaces import BeforeTraverseEvent
class IPublicationRequestFactory(interface.Interface):
"""Publication request factory"""
def __call__(input_stream, env):
"""Create a request object to handle the given inputs
A request is created and configured with a publication object.
"""
class IRequestFactory(interface.Interface):
def __call__(input_stream, env):
"""Create a request object to handle input."""
class ISOAPRequestFactory(IRequestFactory):
"""SOAP request factory"""
class IHTTPRequestFactory(IRequestFactory):
# TODO: should SOAP, XMLRPC, and Browser extend this?
"""generic HTTP request factory"""
class IXMLRPCRequestFactory(IRequestFactory):
"""XMLRPC request factory"""
class IBrowserRequestFactory(IRequestFactory):
"""Browser request factory"""
class IFileContent(interface.Interface):
"""Marker interface for content that can be managed as files.
The default view for file content has effective URLs that don't end in
`/`. In particular, if the content included HTML, relative links in
the HTML are relative to the container the content is in.
"""
class IRequestPublicationFactory(interface.Interface):
""" request-publication factory """
def canHandle(environment):
"""Return ``True`` if it can handle the request, otherwise ``False``.
`environment` can be used by the factory to make a decision based on
the HTTP headers.
"""
def __call__():
"""Return a tuple (request, publication)"""
class IRequestPublicationRegistry(interface.Interface):
"""A registry to lookup a RequestPublicationFactory by
request method + mime-type. Multiple factories can be configured
for the same method+mimetype. The factory itself can introspect
the environment to decide if it can handle the request as given
by the environment or not. Factories are sorted in the order
of their registration in ZCML.
"""
def register(method, mimetype, name, priority, factory):
"""Registers a factory for method+mimetype."""
def lookup(method, mimetype, environment):
"""Lookup a factory for a given method+mimetype and a
environment.
"""
def getFactoriesFor(method, mimetype):
"""Return the internal datastructure representing the configured
factories (basically for testing, not for introspection).
"""
|