/usr/lib/python3/dist-packages/twisted/web/__pycache__
Edit: /usr/lib/python3/dist-packages/twisted/web/__pycache__/server.cpython-310.pyc (25995B)
o
bIs @ s d Z ddlZddlZddlZddlZddlmZ ddlmZ ddl m
Z
m Z ddl m
Z ddlmZ ddlmZ dd lmZ dd
lmZmZ dd lmZmZ dd lm Z dd
l m Z m Z m Z ddl!m"Z"m#Z# ddl$m%Z% ddl&m'Z'm(Z( ddl)m*Z*m+Z+m,Z,m-Z- ddl.m/Z/ ddl0m1Z1 dZ2g dZ3e%eddddddd e%eddddddd e*j4Z5e*j6Z7d Z8d d Z
d d! Z9ee+j:G d"d# d#e'e*j;e j<Z;ee+j=G d$d% d%Z>ee+j?G d&d' d'Z@G d(d) d)ZAG d*d+ d+e j<ZBe#d,ejC ZCeejDG d-d. d.e*jEZFdS )/a
This is a web server which integrates with the twisted.internet infrastructure.
@var NOT_DONE_YET: A token value which L{twisted.web.resource.IResource.render}
implementations can return to indicate that the application will later call
C{.write} and C{.finish} to complete the request, and that the HTTP
connection should be left open.
@type NOT_DONE_YET: Opaque; do not depend on any particular type for this
value.
N)hexlify)escape)ListOptionalquote) implementer)Version) copyright)address
interfaces)
AlreadyCalledAlreadyCancelled)Logger)
componentsfailurereflect) nativeString
networkString)deprecatedModuleAttribute)Copyable ViewPoint)httpiwebresourceutil)UnsupportedMethod)unquote )supportedMethodsRequestSessionSiteversion NOT_DONE_YETGzipEncoderFactoryTwisted z4Please use twisted.web.http.datetimeToString insteadztwisted.web.serverdate_time_stringz4Please use twisted.web.http.stringToDatetime insteadstring_date_time) GET HEADs POSTc O s" t | dg|R i |dS )Ncharmap)_quotedecodeencode)stringargskwargs r3 4/usr/lib/python3/dist-packages/twisted/web/server.pyr K s "r c C s8 t | tjr
d| j| jfS t | tjrd| jfS t| S )NINETUNIX)
isinstancer IPv4Addresshostport UNIXAddressnametuple)addrr3 r3 r4 _addressToTupleO s
r? c @ s@ e Zd ZU dZdZdZdZdZee e
e d< dZ ee e
e d< dZ
dZdZe Zdd Zd
d Zd d
Zdd Zdd Zdd Zdd Zdd Zdd Zdd Zd d Z d d Z d d! Z d"d# Z d$d% Z d&d' Z!d>d(d)Z"d*d+ Z#d,d- Z$dZ%dZ&e'd.d/ Z(d?d0d1Z)d2d3 Z*d4d5 Z+d6d7 Z,d8d9 Z-d:d; Z.d
} with it.
@see: L{Site.getResourceFor()}
s servers dater Nr] *)rI rK setHeaderr# r datetimeToStringrA rT mapr pathsplitrB _handleStargetResourceForr _IEncodingResource
providedBy
getEncoder_encoderrender
BaseExceptionprocessingFailedr Failure)rF resrcencoderr3 r3 r4 process s$
zRequest.processc C s | j s6| jtjtjfv}| jd}| jd}|o |d dk}|r6|du r6| jdur6|s6| jd| jg | j sK| j
rB| j
|}tj
| | dS dS )z
Write data to the transport (if not responding to a HEAD request).
@param data: A string to write to the response.
@type data: L{bytes}
content-type content-lengthr 0N)startedWritingcoder NOT_MODIFIED
NO_CONTENTresponseHeaders
getRawHeadersdefaultContentType
setRawHeaders _inFakeHeadro r/ r write)rF dataneedsCT contentType
contentLengthcontentLengthZeror3 r3 r4 r s&
z
Request.writec C s. | j r| j }|rtj| | tj| S )zH
Override C{http.Request.finish} for possible encoding.
)ro finishr r r rF r r3 r3 r4 r
s
zRequest.finishc C sZ z| | }W n ty } z|j}| jdkr\d|v r\| jjd|d d| _d| _| | }|tu r;| jjd|d n | ddt |f d | _d| _|
d
| W Y d }~d S | jt v r| d d
| dtt| jt| jt |dkr}dp~dd
dd |D d }ttjd|}| | }nttjddt| jdf }| | }W Y d }~nd }~ww |tu rd S t|tsttjddtt | d d tt | d d tt | | }| jdkrt |d kr| jjd | |d! | ddt |f |
d
n| ddt |f |
| | d S )"ah
Ask a resource to render itself.
If the resource does not support the requested method,
generate a C{NOT IMPLEMENTED} or C{NOT ALLOWED} response.
@param resrc: The resource to render.
@type resrc: L{twisted.web.resource.IResource}
@see: L{IResource.render()}
r+ r* z,Using GET to fake a HEAD request for {resrc})rt TzBTried to fake a HEAD request for {resrc}, but it got away from me.rx %dF N Allows , zzYour browser approached me (at %(URI)s) with the method "%(method)s". I only allow the method%(plural)s %(allowed)s here.r s z, c S s g | ]}t |qS r3 )r ).0rW r3 r3 r4
O s z"Request.render..)URImethodpluralallowedzMethod Not AllowedzHuh?z'I don't know how to treat a %s request.r, z Request did not return bytesz Request: z
z
Resource: zValue: r zbWarning: HEAD request {slf} for resource {resrc} is returning a message body. I think I'll eat it.)slfrt ) rp r allowedMethodsr _loginfor r$ re rZ r r r joinr r urir ErrorPager NOT_ALLOWEDNOT_IMPLEMENTEDr. r7 bytesINTERNAL_SERVER_ERRORr _PREr safe_repr)rF rt bodyer r epager3 r3 r4 rp s
9
zRequest.renderc C st | j jd|d | jjrdt| d }nd}| tj | dd | dd t
|f | | | |S )
aO
Finish this request with an indication that processing failed and
possibly display a traceback.
@param reason: Reason this request has failed.
@type reason: L{twisted.python.failure.Failure}
@return: The reason passed to this method.
@rtype: L{twisted.python.failure.Failure}
r )r s web.Server Traceback (most recent call last)web.Server Traceback (most recent call last):
s
s_ Processing FailedProcessing Failedrw r@ rx r )
r r rK displayTracebacksr
formatFailuresetResponseCoder r re rZ r r )rF reasonr r3 r3 r4 rr ~ s
zRequest.processingFailedc C | | dS )z(Remote version of write; same interface.N)r )rF rV r r3 r3 r4
view_write zRequest.view_writec C s | dS )z)Remote version of finish; same interface.N)r rF rV r3 r3 r4 view_finish s zRequest.view_finishc K s | j ||fi | dS )z,Remote version of addCookie; same interface.N) addCookie)rF rV kvr2 r3 r3 r4 view_addCookie s zRequest.view_addCookiec C | || dS )z,Remote version of setHeader; same interface.N)re )rF rV r r r3 r3 r4 view_setHeader s zRequest.view_setHeaderc C r )z2Remote version of setLastModified; same interface.N)setLastModified)rF rV whenr3 r3 r4 view_setLastModified r z Request.view_setLastModifiedc C r )z*Remote version of setETag; same interface.N)setETag)rF rV tagr3 r3 r4 view_setETag r zRequest.view_setETagc C r )zD
Remote version of setResponseCode; same interface.
N)r )rF rV r{ messager3 r3 r4 view_setResponseCode z Request.view_setResponseCodec C s | t|| dS )zbRemote version of registerProducer; same interface.
(requires a remote producer.)
N)registerProducer_RemoteProducerWrapper)rF rV producer streamingr3 r3 r4 view_registerProducer s z Request.view_registerProducerc C s | d S rC )unregisterProducerr r3 r3 r4 view_unregisterProducer z Request.view_unregisterProducerc C s | r| jS | jS )a
If a session has already been created or looked up with
L{Request.getSession}, this will return that object. (This will always
be the session that matches the security of the request; so if
C{forceNotSecure} is used on a secure request, this will not return
that session.)
@return: the session attribute
@rtype: L{Session} or L{None}
)isSecure_secureSession_insecureSessionrF r3 r3 r4 session s zRequest.sessionc C s | o| }|sd}d}nd}d}t| |}|dur/z| W n
ttfy. d}Y nw |du rfd|g| j }| |}|rUz| j |}W n t
yT Y nw |sf| j }| j ||j
d|d t| || |rs||S |S ) a
Check if there is a session cookie, and if not, create it.
By default, the cookie with be secure for HTTPS requests and not secure
for HTTP requests. If for some reason you need access to the insecure
cookie from a secure request you can set C{forceNotSecure = True}.
@param forceNotSecure: Should we retrieve a session that will be
transmitted over HTTP, even if this L{Request} was delivered over
HTTPS?
@type forceNotSecure: L{bool}
s TWISTED_SESSIONr s TWISTED_SECURE_SESSIONr N _r] )rh secure)r getattrtouchr
r r sitepath getCookierK
getSessionKeyError makeSessionr uidsetattr getComponent) rF sessionInterfaceforceNotSecurer cookieStringsessionAttributer
cookiename
sessionCookier3 r3 r4 r s:
zRequest.getSessionc C st | j}| r d}nd}||krd}nd| }td| r!dp"dt| |f }ddd |D }|| S )
Ni P r z:%dzhttp%s://%s%s/r r] c S s g | ]}t |d dqS )r )safer )r segmentr3 r3 r4 r ' s z'Request._prePathURL..)getHostr: r r r getRequestHostnamer )rF rA r: defaulthostportprefixrh r3 r3 r4 _prePathURL s"
zRequest._prePathURLc C s | | jS rC )r rA r r3 r3 r4
prePathURL* r zRequest.prePathURLc C s ddl m} |j| S )Nr )urlpath)twisted.pythonr URLPath fromRequest)rF r r3 r3 r4 r - s zRequest.URLPathc C s | | jdd }|| _dS )z_
Remember the currently-processed part of the URL for later
recalling.
Nr\ )r rA
appRootURL)rF urlr3 r3 r4 rememberRootURL2 s
zRequest.rememberRootURLc C s | j S )zn
Get a previously-remembered URL.
@return: An absolute URL.
@rtype: L{bytes}
)r r r3 r3 r4
getRootURL: s zRequest.getRootURLc C sH | j dkr | tj n | tj | dd | dd | dS )a
Handle receiving a request whose path is '*'.
RFC 7231 defines an OPTIONS * request as being something that a client
can send as a low-effort way to probe server capabilities or readiness.
Rather than bother the user with this, we simply fast-path it back to
an empty 200 OK. Any non-OPTIONS verb gets a 405 Method Not Allowed
telling the client they can only use OPTIONS.
s OPTIONSr s Content-Lengthry N)r r r OKr re r r r3 r3 r4 rj C s
zRequest._handleStarrC )NF)0__name__
__module__ __qualname____doc__r rK r rA r r r __annotations__rB
__pychecker__r ro r r rD rX r[ r_ rb rv r r rp rr r r r r r r r r r r r propertyr r r r r r r rj r3 r3 r3 r4 r X sR
$&
g#
7 r c @ s& e Zd ZdZedZdZdd ZdS )r% z~
@cvar compressLevel: The compression level used by the compressor, default
to 9 (highest).
@since: 12.3
s (:?^|[\s,])gzip(:?$|[\s,]) c C sf d |jdg }| j|r1|jd}|r!d |dg }nd}|jd|g t| j|S dS )zo
Check the headers if the client accepts gzip encoding, and encodes the
request if so.
,s accept-encodings content-encodings gzipN) r rO r _gzipCheckRegexsearchr~ r _GzipEncoder
compressLevel)rF request
acceptHeadersencodingr3 r3 r4 encoderForRequeste s z$GzipEncoderFactory.encoderForRequestN) r r r r recompiler r r r3 r3 r3 r4 r% Y s
r% c @ s, e Zd ZdZdZdd Zdd Zdd ZdS ) r z
An encoder which supports gzip.
@ivar _zlibCompressor: The zlib compressor instance used to compress the
stream.
@ivar _request: A reference to the originating request.
@since: 12.3
Nc C s" t |t jdt j | _|| _d S )N )zlib compressobjDEFLATED MAX_WBITS_zlibCompressor_request)rF r r r3 r3 r4 rD s
z_GzipEncoder.__init__c C s" | j js | j jd | j|S )zR
Write to the request, automatically compressing data on the fly.
rx )r rz r~ removeHeaderr compressr r3 r3 r4 r/ s z_GzipEncoder.encodec C s | j }d| _ |S )zf
Finish handling the request request, flushing any data from the zlib
buffer.
N)r flush)rF remainr3 r3 r4 r s
z_GzipEncoder.finish)r r r r r rD r/ r r3 r3 r3 r4 r x s
r c @ s e Zd Zdd ZdS )r c C s( | d| _| d| _| d| _d S )NresumeProducingpauseProducing
stopProducing) remoteMethodr r r )rF rM r3 r3 r4 rD s z _RemoteProducerWrapper.__init__N)r r r rD r3 r3 r3 r4 r s r c sJ e Zd ZdZdZdZd fdd Zdd Zdd Zd
d Z d d
Z
Z S )r! a
A user's session with a system.
This utility class contains no functionality, but is used to
represent a session.
@ivar site: The L{Site} that generated the session.
@type site: L{Site}
@ivar uid: A unique identifier for the session.
@type uid: L{bytes}
@ivar _reactor: An object providing L{IReactorTime} to use for scheduling
expiration.
@ivar sessionTimeout: Time after last modification the session will expire,
in seconds.
@type sessionTimeout: L{float}
@ivar lastModified: Time the C{touch()} method was last called (or time the
session was created). A UNIX timestamp as returned by
L{IReactorTime.seconds()}.
@type lastModified: L{float}
i Nc sB t |du r |j}|| _|| _|| _g | _| i | _dS )z
Initialize a session with a unique ID for that session.
@param reactor: L{IReactorTime} used to schedule expiration of the
session. If C{None}, the reactor associated with I{site} is used.
N) superrD reactor_reactorrK r expireCallbacksr sessionNamespaces)rF rK r r __class__r3 r4 rD s
zSession.__init__c C s | j | j| j| _dS )zF
Start expiration tracking.
@return: L{None}
N)r callLatersessionTimeoutexpire _expireCallr r3 r3 r4 startCheckingExpiration s z Session.startCheckingExpirationc C s | j | dS )zJ
Call this callback when the session expires or logs out.
N)r append)rF callbackr3 r3 r4 notifyOnExpire r zSession.notifyOnExpirec C sP | j j| j= | jD ]}| q g | _| jr$| j r&| j d| _dS dS dS )z/
Expire/logout of the session.
N)rK sessionsr r r activecancel)rF cr3 r3 r4 r s
zSession.expirec C s, | j | _| jdur| j| j dS dS )zN
Mark the session as modified, which resets expiration timer.
N)r seconds lastModifiedr resetr r r3 r3 r4 r s
z
Session.touchrC ) r r r r r r rD r r r r
__classcell__r3 r3 r r4 r! s
r! z TwistedWeb/c s e Zd ZdZdZeZdZeZ dZ
e j Z
d fdd Zdd Zd
d Zd d
Zdd Zdd Z fddZdZdd Zdd Zdd Zdd Z ZS ) r" a*
A web site: manage log, sessions, and resources.
@ivar requestFactory: A factory which is called with (channel)
and creates L{Request} instances. Default to L{Request}.
@ivar displayTracebacks: If set, unhandled exceptions raised during
rendering are returned to the client as HTML. Default to C{False}.
@ivar sessionFactory: factory for sessions objects. Default to L{Session}.
@ivar sessions: Mapping of session IDs to objects returned by
C{sessionFactory}.
@type sessions: L{dict} mapping L{bytes} to L{Session} given the default
C{sessionFactory}
@ivar counter: The number of sessions that have been generated.
@type counter: L{int}
@ivar sessionCheckTime: Deprecated and unused. See
L{Session.sessionTimeout} instead.
r Fi Nc s4 t j|i | i | _|| _|dur|| _dS dS )a
@param resource: The root of the resource hierarchy. All request
traversal for requests received by this factory will begin at this
resource.
@type resource: L{IResource} provider
@param requestFactory: Overwrite for default requestFactory.
@type requestFactory: C{callable} or C{class}.
@see: L{twisted.web.http.HTTPFactory.__init__}
N)r rD r! r requestFactory)rF r r) r1 r2 r r3 r4 rD s
z
Site.__init__c C s( ddl m} |tj|tj|S )Nr )logfile)r r* LogFileosrh basenamedirname)rF rh r* r3 r3 r4 _openLogFile1 s zSite._openLogFilec C s | j }i |d< |S )Nr! )rP rQ )rF dr3 r3 r4 __getstate__6 s
zSite.__getstate__c C s | j d | _ t| dS )zP
(internal) Generate an opaque, unique ID for a user's session.
r )counterr _entropyr r3 r3 r4 _mkuid; s z Site._mkuidc C s* | }| | | }| j|< | |S )zU
Generate a new Session instance, and store it for future reference.
)r5 sessionFactoryr! r )rF r r r3 r3 r4 r B s zSite.makeSessionc C s
| j | S )z
Get a previously generated session.
@param uid: Unique ID of the session.
@type uid: L{bytes}.
@raise KeyError: If the session is not found.
)r! )rF r r3 r3 r4 r K s
zSite.getSessionc s t |}| j|_| |_|S )z;
Generate a channel attached to this site.
)r
buildProtocolr) rK )rF r> rI r r3 r4 r7 V s zSite.buildProtocolc C s | | d | dS )z@
Redirect because a Site is always a directory.
r] N)redirectr r rF r r3 r3 r4 rp a s z Site.renderc C s | |_ | j||S )z7
Emulate a resource's getChild method.
)rK r getChildWithDefault)rF pathElr r3 r3 r4 r: h s zSite.getChildWithDefaultc C s" | |_ t|j|_t| j|S )z
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.
)rK rQ rA r r getChildForRequestr9 r3 r3 r4 rk o s zSite.getResourceForc C s dg}t jr |dd |S )z2
Protocols this server can speak.
s http/1.1r s h2)r
H2_ENABLEDinsert)rF
baseProtocolsr3 r3 r4 acceptableProtocols~ s zSite.acceptableProtocolsrC )r r r r r3 r r) r r! r6 sessionCheckTimer, urandomr4 rD r/ r1 r5 r r r7 isLeafrp r: rk r@ r( r3 r3 r r4 r" s( r" )Gr rQ r, r r binasciir htmlr typingr r urllib.parser r- zope.interfacer incrementalr twistedr
twisted.internetr r twisted.internet.errorr
r twisted.loggerr r r r r twisted.python.compatr r twisted.python.deprecater twisted.spread.pbr r twisted.webr r r r twisted.web.errorr twisted.web.httpr r$ __all__rf r( stringToDatetimer) r r? IRequestr rE _IRequestEncoderFactoryr% _IRequestEncoderr r r! r# IProtocolNegotiationFactory HTTPFactoryr" r3 r3 r3 r4 sp (U