t.w.s.Site(http.HTTPFactory) : class documentation

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

A web site: manage log, sessions, and resources.
Instance Variable counter increment value used for generating unique sessions ID.
Instance Variable requestFactory factory creating requests objects. 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, by its unique ID. This raises a KeyError if the session is not found.
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 _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 HTTPFactory:

Method startFactory Set up request logging if necessary.
Method stopFactory This will be called before I stop listening on all Ports/Connectors.
Method log Write a line representing request to the access log file.
Instance Variable _logDateTime A cached datetime string for log messages, updated by _logDateTimeCall. (type: str)
Instance Variable _logDateTimeCall A delayed call for the next update to the cached log datetime string. (type: IDelayedCall provided)
Instance Variable _logFormatter See the logFormatter parameter to __init__
Instance Variable _nativeize A flag that indicates whether the log file being written to wants native strings (True) or bytes (False). This is only to support writing to twisted.python.log which, unfortunately, works with native strings.
Instance Variable _reactor An IReactorTime provider used to compute logging timestamps.
Method _updateLogDateTime Update log datetime periodically, so we aren't always recalculating it.

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 =
factory creating requests objects. 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, **kwargs): (source)
ParametersresourceThe root of the resource hierarchy. All request traversal for requests received by this factory will begin at this resource. (type: IResource provider)
See Alsotwisted.web.http.HTTPFactory.__init__
def _openLogFile(self, path): (source)
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, by its unique ID. This raises a KeyError if the session is not found.
def buildProtocol(self, addr): (source)
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 heirarchy, calling getChildWithDefault on each resource it finds for a path element, stopping when it hits an element where isLeaf is true.

API Documentation for Twisted, generated by pydoctor at 2014-05-12 18:27:00.