twisted.web.server.Site(http.HTTPFactory) class documentation

Part of twisted.web.server View Source (View In Hierarchy)

Implements interfaces: twisted.internet.interfaces.IProtocolNegotiationFactory

A web site: manage log, sessions, and resources.

Instance Variable counter increment value used for generating unique sessions ID.
Instance Variable requestFactory A factory which is called with (channel) and creates Request instances. Default to Request.
Instance Variable displayTracebacks if set, Twisted internal errors are displayed on rendered pages. Default to True.
Instance Variable sessionFactory factory for sessions objects. Default to Session.
Instance Variable sessionCheckTime Deprecated. See Session.sessionTimeout instead.
Method __init__ No summary
Method __getstate__ Undocumented
Method makeSession Generate a new Session instance, and store it for future reference.
Method getSession Get a previously generated session.
Method buildProtocol Generate a channel attached to this site.
Method render Redirect because a Site is always a directory.
Method getChildWithDefault Emulate a resource's getChild method.
Method getResourceFor Get a resource for a request.
Method acceptableProtocols Protocols this server can speak.
Method _openLogFile Override in subclasses, e.g. to use twisted.python.logfile.
Method _mkuid (internal) Generate an opaque, unique ID for a user's session.

Inherited from Factory (via HTTPFactory, ServerFactory):

Class Method forProtocol Create a factory for the given protocol.
Method logPrefix Describe this factory for log messages.
Method doStart Make sure startFactory is called.
Method doStop Make sure stopFactory is called.

Inherited from Factory (via HTTPFactory, ServerFactory):

Class Method forProtocol Create a factory for the given protocol.
Method logPrefix Describe this factory for log messages.
Method doStart Make sure startFactory is called.
Method doStop Make sure stopFactory is called.
counter =
increment value used for generating unique sessions ID.
requestFactory =
A factory which is called with (channel) and creates Request instances. Default to Request.
displayTracebacks =
if set, Twisted internal errors are displayed on rendered pages. Default to True.
sessionFactory =
factory for sessions objects. Default to Session.
sessionCheckTime =
Deprecated. See Session.sessionTimeout instead.
def __init__(self, resource, *args, requestFactory=None, **kwargs): (source)
overrides twisted.web.http.HTTPFactory.__init__
ParametersresourceThe root of the resource hierarchy. All request traversal for requests received by this factory will begin at this resource. (type: IResource provider)
requestFactoryOverwrite for default requestFactory. (type: callable or class.)
See Alsotwisted.web.http.HTTPFactory.__init__
def _openLogFile(self, path): (source)
overrides twisted.web.http.HTTPFactory._openLogFile

Override in subclasses, e.g. to use twisted.python.logfile.

def __getstate__(self): (source)
Undocumented
def _mkuid(self): (source)

(internal) Generate an opaque, unique ID for a user's session.

def makeSession(self): (source)

Generate a new Session instance, and store it for future reference.

def getSession(self, uid): (source)

Get a previously generated session.

ParametersuidUnique ID of the session. (type: bytes.)
RaisesKeyError if the session is not found.
def buildProtocol(self, addr): (source)
from twisted.internet.interfaces.IProtocolFactory
overrides twisted.web.http.HTTPFactory.buildProtocol

Generate a channel attached to this site.

def render(self, request): (source)

Redirect because a Site is always a directory.

def getChildWithDefault(self, pathEl, request): (source)

Emulate a resource's getChild method.

def getResourceFor(self, request): (source)

Get a resource for a request.

This iterates through the resource hierarchy, calling getChildWithDefault on each resource it finds for a path element, stopping when it hits an element where isLeaf is true.

def acceptableProtocols(self): (source)
from twisted.internet.interfaces.IProtocolNegotiationFactory

Protocols this server can speak.

API Documentation for Twisted, generated by pydoctor at 2017-06-11 10:59:01.