← Back
Editing: server.cpython-38.pyc
U ��W[uk � @ sV d Z ddlmZmZ ddlZddlZddlZzddlmZ W n( e k rd ddl mZ dd� ZY nX ddl Z ddl mZ ddlmZ dd lmZmZmZ dd lmZmZ dd lmZmZ dd lm Z m Z dd l m Z m Z m!Z! ddl"m#Z# ddl$m%Z%m&Z&m'Z' ddl(m)Z) ddl m*Z* ddl+m,Z, ddl-m.Z. ddl/m0Z0 ddlm1Z1 ddl2m3Z3 dZ4ddddd d d gZ5e0e.d d dd�d!d"d#� e0e.d d dd�d$d"d%� e j6Z7e j8Z9d&Z:d'd(� Z;ee j<�G d)d� dee j=e'j>��Z=ee j?�G d*d � d e@��ZAee jB�G d+d,� d,e@��ZCG d-d.� d.�ZDG d/d� de'j>�ZEed0e)jFf �ZFeejG�G d1d� de jH��ZIdS )2a� 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. � )�division�absolute_importN��quotec O s t | �d�f|�|��d�S )N�charmap)�_quote�decode�encode)�string�args�kwargs� r �4/usr/lib/python3/dist-packages/twisted/web/server.pyr s ����r )�hexlify)� implementer)� networkString� nativeString� intToBytes)�Copyable� ViewPoint)�address� interfaces)� AlreadyCalled�AlreadyCancelled)�iweb�http�util)�unquote)�reflect�failure� components)� copyright)�resource)�UnsupportedMethod)�Version)�deprecatedModuleAttribute)�escape)�Logger� �supportedMethods�Request�Session�Site�version� NOT_DONE_YET�GzipEncoderFactoryZTwisted� z4Please use twisted.web.http.datetimeToString insteadztwisted.web.server�date_time_stringz4Please use twisted.web.http.stringToDatetime instead�string_date_time)� GET� HEADs POSTc C s< t | tj�rd| j| jfS t | tj�r0d| jfS t| �S d S )NZINETZUNIX)� isinstancer Z IPv4Address�host�portZ UNIXAddress�name�tuple)�addrr r r �_addressToTupleR s r; c @ s e Zd ZdZdZdZdZdZdZdZ e � Z dd� Z dd � Z d d � Zd d � Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd:d$d%�Zd&d'� Z d(d)� Z dZ dZ e d*d+� �Z!d;d,d-�Z"d.d/� Z#d0d1� Z$d2d3� Z%d4d5� Z&d6d7� Z'd8d9� Z(dS )<r* a� An HTTP request. @ivar defaultContentType: A C{bytes} giving the default I{Content-Type} value to send in responses if no other value is set. L{None} disables the default. @ivar _insecureSession: The L{Session} object representing state that will be transmitted over plain-text HTTP. @ivar _secureSession: The L{Session} object representing the state that will be transmitted only over HTTPS. � text/htmlNzunusednames=issuerFc O s$ t jj| f|�|� tj�| � d S �N)r r* �__init__r � Componentized)�selfr �kwr r r r> u s zRequest.__init__c C s� | j �� }|d= |d= |d= |d= | j�dd� | j�� |d< t|| �|d< t|d �|d< t|d �|d < t|d �� �|d < |S ) NZ transport�channel�content�siter Z content_data�remoter6 Zclient�requestHeaders) �__dict__�copyrC �seek�readr r; �listZgetAllRawHeaders)r@ �issuer�xr r r �getStateToCopyForz s zRequest.getStateToCopyForc C s | j rt| j �d | S |S dS )zT Return the text that links to a sibling of the requested resource. � ../N)�postpath�len)r@ r8 r r r �sibLink� s zRequest.sibLinkc C s\ t | j�}|dkr"|d d | S |dkr.|S t | j�rT| jd rT| jd d | S |S dS )zR Return the text that links to a child of the requested resource. r( rO ���� /N)rQ rP �prepath)r@ r8 Zlppr r r � childLink� s zRequest.childLinkc C s� | j j| _| �dt� | �dt�� � g | _ttt | j dd� � d���| _ | j dkrb| � � dS z>| j�| �}tj�|�r�|�| �}|dk r�|| _| �|� W n | �t�� � Y nX dS )z$ Process a request. s servers dater( NrT � *)rB rD � setHeaderr- r �datetimeToStringrU rK �mapr �path�splitrP � _handleStar�getResourceForr" Z_IEncodingResourceZ providedByZ getEncoder�_encoder�render�processingFailedr ZFailure)r@ �resrc�encoderr r r �process� s" zRequest.processc C s� | j sl| jtjtjfk}| j�d�}| j�d�}|o>|d dk}|rl|dkrl| jdk rl|sl| j�d| jg� | j s�| j r�| j � |�}tj � | |� dS )z� Write data to the transport (if not responding to a HEAD request). @param data: A string to write to the response. � content-type� content-lengthr � 0N)�startedWriting�coder Z NOT_MODIFIEDZ NO_CONTENT�responseHeaders� getRawHeaders�defaultContentType� setRawHeaders� _inFakeHeadr_ r r* �write)r@ �dataZneedsCTZ contentTypeZ contentLengthZcontentLengthZeror r r ro � s( � �� � z Request.writec C s. | j r"| j �� }|r"tj�| |� tj�| �S )zH Override C{http.Request.finish} for possible encoding. )r_ �finishr r* ro �r@ rp r r r rq � s zRequest.finishc C s\ z|� | �}W �nd tk �rt } �zB|j}| jdkr�d|kr�| jjd|d� d| _d| _|� | �}|tkr~| jjd|d� n| �dt t |��� d| _d| _| � d � | � � W Y ��d S | jt k�r8| �d d �|�� d tt| j��t| j�t |�dko�d�pdd�dd� |D ��d� }t�tjd|�}|� | �}n,t�tjddt| j�d��f �}|� | �}W 5 d }~X Y nX |tk�r�d S t|t��s�t�tjddt� t � | �� d d t� t � |�� d d t� t � |�� �� | �}| jdk�r2t |�d k�r&| jjd | |d � | �dt t |��� | � d � n | �dt t |��� | � |� | � � d S )!zn Ask a resource to render itself. @param resrc: a L{twisted.web.resource.IResource}. r4 r3 z,Using GET to fake a HEAD request for {resrc})rb TzBTried to fake a HEAD request for {resrc}, but it got away from me.rf F� 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 r )r )�.0rM r r r � <listcomp>- s z"Request.render.<locals>.<listcomp>)ZURI�methodZpluralZallowedzMethod Not AllowedzHuh?z'I don't know how to treat a %s request.r z Request did not return bytesz Request: z<br />z Resource: zValue: r zbWarning: HEAD request {slf} for resource {resrc} is returning a message body. I think I'll eat it.)Zslfrb ) r` r# �allowedMethodsry �_log�inforn r. rX r rQ ro rq r) �joinr& r Zurir" Z ErrorPager � NOT_ALLOWEDZNOT_IMPLEMENTEDr r5 �bytes�INTERNAL_SERVER_ERRORr Z_PREr Z safe_repr)r@ rb �body�erz ru Zepager r r r` � s� � � ��� � �� ������� � � � zRequest.renderc C sr | j jd|d� | jjr,dt�|� d }nd}| �tj� | � dd� | � dt t |��� | � |� | � � |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} rv )r s� <html><head><title>web.Server Traceback (most recent call last)</title></head><body><b>web.Server Traceback (most recent call last):</b> s </body></html> s_ <html><head><title>Processing Failed</title></head><body><b>Processing Failed</b></body></html>re r< rf )r{ r rD �displayTracebacksr Z formatFailure�setResponseCoder r� rX r rQ ro rq )r@ �reasonr� r r r ra W s �� zRequest.processingFailedc C s | � |� dS )z1Remote version of write; same interface. N)ro )r@ rL rp r r r � view_writew s zRequest.view_writec C s | � � dS )z2Remote version of finish; same interface. N)rq �r@ rL r r r � view_finish} s zRequest.view_finishc K s | j ||f|� dS )z5Remote version of addCookie; same interface. N)� addCookie)r@ rL �k�vr r r r �view_addCookie� s zRequest.view_addCookiec C s | � ||� dS )z5Remote version of setHeader; same interface. N)rX )r@ rL r� r� r r r �view_setHeader� s zRequest.view_setHeaderc C s | � |� dS )z;Remote version of setLastModified; same interface. N)ZsetLastModified)r@ rL Zwhenr r r �view_setLastModified� s z Request.view_setLastModifiedc C s | � |� dS )z3Remote version of setETag; same interface. N)ZsetETag)r@ rL �tagr r r � view_setETag� s zRequest.view_setETagc C s | � ||� dS )zD Remote version of setResponseCode; same interface. N)r� )r@ rL ri �messager r r �view_setResponseCode� s z Request.view_setResponseCodec C s | � t|�|� dS )zbRemote version of registerProducer; same interface. (requires a remote producer.) N)ZregisterProducer�_RemoteProducerWrapper)r@ rL ZproducerZ streamingr r r �view_registerProducer� s z Request.view_registerProducerc C s | � � d S r= )ZunregisterProducerr� r r r �view_unregisterProducer� s z Request.view_unregisterProducerc C s | � � r| jS | jS dS )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} N)�isSecure�_secureSession�_insecureSession�r@ r r r �session� s zRequest.sessionc C s� | � � o | }|s d}d}nd}d}t| |�}|dk r`z |�� W n ttfk r^ d}Y nX |dkr�d�|g| j �}| �|�}|r�z| j� |�}W n t k r� Y nX |s�| j� � }| j ||j d|d� t| ||� |r�|�|�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� _rT )r[ �secure)r� �getattr�touchr r r} �sitepathZ getCookierD � getSession�KeyError� makeSessionr� �uid�setattrZ getComponent) r@ ZsessionInterfaceZforceNotSecurer� Z cookieStringZsessionAttributer� Z cookienameZ sessionCookier r r r� � s: � zRequest.getSessionc C st | � � j}| �� rd}nd}||kr*d}nd| }td| �� rBdpDdt| �� �|f �}d�dd � |D ��}|| S ) Ni� �P rv z:%dzhttp%s://%s%s/ru rT c S s g | ]}t |d d��qS )rs )Zsafer )rw Zsegmentr r r rx s z'Request._prePathURL.<locals>.<listcomp>)ZgetHostr7 r� r r ZgetRequestHostnamer} )r@ rU r7 �defaultZhostport�prefixr[ r r r � _prePathURL� s �zRequest._prePathURLc C s | � | j�S r= )r� rU r� r r r � prePathURL s zRequest.prePathURLc C s ddl m} |j�| �S )Nr )�urlpath)�twisted.pythonr� �URLPathZ fromRequest)r@ r� r r r r� s zRequest.URLPathc C s | � | jdd� �}|| _dS )z_ Remember the currently-processed part of the URL for later recalling. NrS )r� rU � appRootURL)r@ Zurlr r r �rememberRootURL s zRequest.rememberRootURLc C s | j S )z2 Get a previously-remembered URL. )r� r� r r r � 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 OPTIONSrt s Content-Lengthrg N)ry r� r ZOKr~ rX rq r� r r r r] ' s zRequest._handleStar)N)NF))�__name__� __module__� __qualname__�__doc__rl rD r� Z __pychecker__rn r_ r' r{ r> rN rR rV rd ro rq r` ra r� r� r� r� r� r� r� r� r� r� r� �propertyr� r� r� r� r� r� r� r] r r r r r* \ sJ % [ 9 c @ s& e Zd ZdZe�d�ZdZdd� 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� |j�dg ��}| j�|�rb|j�d�}|rBd� |dg �}nd}|j�d|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} rF rk �_gzipCheckRegex�searchrj rm � _GzipEncoder� compressLevel)r@ �requestZ acceptHeaders�encodingr r r �encoderForRequestH s � ��z$GzipEncoderFactory.encoderForRequestN) r� r� r� r� �re�compiler� r� r� r r r r r/ = s 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� )�zlibZ compressobjZDEFLATEDZ MAX_WBITS�_zlibCompressor�_request)r@ r� r� r r r r> l s �z_GzipEncoder.__init__c C s" | j js| j j�d� | j�|�S )zR Write to the request, automatically compressing data on the fly. rf )r� rh rj Z removeHeaderr� �compressrr r r r r 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)r@ Zremainr r r rq } s z_GzipEncoder.finish)r� r� r� r� r� r> r rq r r r r r� ] s r� c @ s e Zd Zdd� ZdS )r� c C s( |� d�| _|� d�| _|� d�| _d S )N�resumeProducing�pauseProducing� stopProducing)Z remoteMethodr� r� r� )r@ rE r r r r> � s z _RemoteProducerWrapper.__init__N)r� r� r� r> r r r r r� � s r� c @ sB e Zd ZdZdZdZddd�Zdd� Zdd � Zd d � Z d d � Z dS )r+ ap A user's session with a system. This utility class contains no functionality, but is used to represent a session. @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: timeout of a session, in seconds. i� Nc C sJ t j�| � |dkr ddlm} || _|| _|| _g | _| � � i | _ dS )zI Initialize a session with a unique ID for that session. Nr )�reactor) r r? r> �twisted.internetr� �_reactorrD r� �expireCallbacksr� ZsessionNamespaces)r@ rD r� r� r r r r> � s zSession.__init__c C s | j �| j| j�| _dS )zF Start expiration tracking. @return: L{None} N)r� Z callLater�sessionTimeout�expire� _expireCallr� r r r �startCheckingExpiration� s �z Session.startCheckingExpirationc C s | j �|� dS )zJ Call this callback when the session expires or logs out. N)r� �append)r@ �callbackr r r �notifyOnExpire� s zSession.notifyOnExpirec C sH | j j| j= | jD ] }|� qg | _| jrD| j�� rD| j�� d| _dS )z/ Expire/logout of the session. N)rD �sessionsr� r� r� ZactiveZcancel)r@ �cr r r r� � s zSession.expirec C s( | j �� | _| jdk r$| j�| j� dS )z. Notify session modification. N)r� ZsecondsZ lastModifiedr� �resetr� r� r r r r� � s z Session.touch)N) r� r� r� r� r� r� r> r� r� r� r� r r r r r+ � s z TwistedWeb/%sc @ s� e Zd ZdZdZeZdZeZ dZ e j Z d dd�Zdd � Zd d � Zd d � Zdd� Zdd� Zdd� ZdZdd� Zdd� Zdd� Zdd� ZdS ) r, a# A web site: manage log, sessions, and resources. @ivar counter: increment value used for generating unique sessions ID. @ivar requestFactory: A factory which is called with (channel) and creates L{Request} instances. Default to L{Request}. @ivar displayTracebacks: if set, Twisted internal errors are displayed on rendered pages. Default to C{True}. @ivar sessionFactory: factory for sessions objects. Default to L{Session}. @ivar sessionCheckTime: Deprecated. See L{Session.sessionTimeout} instead. r Ti Nc O s2 t jj| f|�|� i | _|| _|dk r.|| _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 � HTTPFactoryr> r� r" �requestFactory)r@ r" r� r r r r r r> � s z Site.__init__c C s( ddl m} |�tj�|�tj�|��S )Nr )�logfile)r� r� ZLogFile�osr[ �basename�dirname)r@ r[ r� r r r � _openLogFile s zSite._openLogFilec C s | j �� }i |d< |S )Nr� )rG rH )r@ �dr r r � __getstate__ s zSite.__getstate__c C s | j d | _ t| �d��S )zP (internal) Generate an opaque, unique ID for a user's session. r( � )�counterr �_entropyr� r r r �_mkuid s z Site._mkuidc C s* | � � }| �| |� }| j|< |�� |S )zU Generate a new Session instance, and store it for future reference. )r� �sessionFactoryr� r� )r@ r� r� r r r r� 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: L{KeyError} if the session is not found. )r� )r@ r� r r r r� " s zSite.getSessionc C s t j�| |�}| j|_| |_|S )z; Generate a channel attached to this site. )r r� � buildProtocolr� rD )r@ r: rB r r r r� . s zSite.buildProtocolc C s |� |�� d � |�� dS )z@ Redirect because a Site is always a directory. rT N)Zredirectr� rq �r@ r� r r r r` 9 s z Site.renderc C s | |_ | j�||�S )z7 Emulate a resource's getChild method. )rD r" �getChildWithDefault)r@ ZpathElr� r r r r� A 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. )rD rH rU r� r" ZgetChildForRequestr� r r r r^ I s zSite.getResourceForc C s dg}t jr|�dd� |S )z2 Protocols this server can speak. s http/1.1r s h2)r Z H2_ENABLED�insert)r@ Z baseProtocolsr r r �acceptableProtocolsX s zSite.acceptableProtocols)N)r� r� r� r� r� r* r� r� r+ r� ZsessionCheckTimer� �urandomr� r> r� r� r� r� r� r� ZisLeafr` r� r^ r� r r r r r, � s& )Jr� Z __future__r r rH r� r� Zurllibr � ImportErrorZ urllib.parser r� Zbinasciir Zzope.interfacer Ztwisted.python.compatr r r Ztwisted.spread.pbr r r� r r Ztwisted.internet.errorr r Z twisted.webr r r Ztwisted.web.httpr r� r r r Ztwistedr! r" Ztwisted.web.errorr# Z incrementalr$ Ztwisted.python.deprecater% r& Ztwisted.loggerr' r. �__all__rY r1 ZstringToDatetimer2 r) r; ZIRequestr* r? Z_IRequestEncoderFactory�objectr/ Z_IRequestEncoderr� r� r+ r- ZIProtocolNegotiationFactoryr� r, r r r r �<module> s� � � � c *K
Save File
Cancel