File: //lib/python3/dist-packages/twisted/web/__pycache__/tap.cpython-38.pyc
U
W[v& � @ s� d Z ddlmZmZ ddlZddlZddlZddlmZm Z ddl
m Z m Z ddl
mZmZmZmZ ddlmZ ddlmZ dd lmZmZmZmZmZmZ dd
lm Z G d d � d ej �Z d
d� Z G dd� dej �Z dd� Z!dS )z9
Support for creating a service which runs a web server.
� )�absolute_import�divisionN)�service�strports)�
interfaces�reactor)�usage�reflect�
threadpool� deprecate)�pb)�distrib)�resource�server�static�script�demo�wsgi)�twcgic @ s e Zd ZdZdZddddgddd d
gd d d d
ggZdddggZe�dddej j
f d g� e j e �
d�e �
d�e �
d�d�d�ZdZdd� Zd d � ZeZd d � Zd d!� Zd"d#� ZeZd$d%� ZeZd&d'� Zd(d)� Zd*d+� Zd,d-� Z d.d/� Z d0d1� Z e Z d2d3� Z d4d5� Z!d6d7� Z"d8d9� Z#dS ):�OptionszB
Define the options accepted by the I{twistd web} plugin.
z
[web options]�logfile�lNz/Path to web CLF (Combined Log Format) log file.� certificate�cz
server.pemz=(DEPRECATED: use --listen) SSL certificate to use for HTTPS. �privkey�kz<(DEPRECATED: use --listen) SSL certificate to use for HTTPS.� notracebacks�nzcDo not display tracebacks in broken web pages. Displaying tracebacks to users may be security risk!�personal� zvInstead of generating a webserver, generate a ResourcePublisher which listens on the port given by --listen, or ~/%s z if --listen is not specified.z*.logz*.pem)r r r )Z
optActionsz�This starts a webserver. If you specify no arguments, it will be a
demo webserver that has the Test class from twisted.web.demo in it.c C s@ t j�| � g | d< d | d< g | d< g | d< d | d< | d< d S )N�indexes�root� extraHeaders�ports�port�https)r r �__init__��self� r) �1/usr/lib/python3/dist-packages/twisted/web/tap.pyr& ? s zOptions.__init__c C s6 t �| jt�dddd��}tj|tdd� || d< dS ) zh
(DEPRECATED: use --listen)
Strports description of port to start the server on
�Twisted� � r � ��category�
stacklevelr$ N)r �getDeprecationWarningString�opt_port� incremental�Version�warnings�warn�DeprecationWarning�r( r$ �msgr) r) r* r3 H s �zOptions.opt_portc C s6 t �| jt�dddd��}tj|tdd� || d< dS ) zW
(DEPRECATED: use --listen)
Port to listen on for Secure HTTP.
r+ r, r- r r. r/ r% N)r r2 � opt_httpsr4 r5 r6 r7 r8 r9 r) r) r* r; T s �zOptions.opt_httpsc C s | d � |� dS )zi
Add an strports description of port to start the server on.
[default: tcp:8080]
r# N��append)r( r$ r) r) r* �
opt_listen_ s zOptions.opt_listenc C s | d � |� dS )zr
Add the name of a file used to check for directory indexes.
[default: index, index.html]
r Nr< )r( Z indexNamer) r) r* � opt_indexg s zOptions.opt_indexc C s t �� | d< dS )zc
Makes a server with ~/public_html and ~/.twistd-web-pb support for
users.
r! N)r
�
UserDirectoryr' r) r) r* �opt_userq s zOptions.opt_userc C s> t �tj�|��| d< tjtjd�| d _t j
| d jd< dS )z�
<path> is either a specific file or a directory to be set as the root
of the web server. Use this if you have a directory full of HTML, cgi,
epy, or rpy files or any other files that you want to be served up raw.
r! )z.epyz.rpyz.cgiN) r �File�os�path�abspathr Z PythonScriptZResourceScript�
processorsr Z CGIScript)r( rD r) r) r* �opt_path{ s
� zOptions.opt_pathc C sB t | d tj�st�d��|�dd�\}}t�|�| d j|< dS )zh
`ext=class' where `class' is added as a Processor for files ending
with `ext'.
r! z*You can only use --processor after --path.�=� N) �
isinstancer rB r �
UsageError�splitr �
namedClassrF )r( �proc�ext�klassr) r) r* �
opt_processor� s �zOptions.opt_processorc C s t �|�}|� | d< dS )zN
Create a Resource subclass with a zero-argument constructor.
r! N)r rM )r( Z classNameZclassObjr) r) r* � opt_class� s
zOptions.opt_classc C s t �|�| d< dS )zP
An .rpy file to be used as the root resource of the webserver.
r! N)r ZResourceScriptWrapper)r( �namer) r) r* �opt_resource_script� s zOptions.opt_resource_scriptc C sr zt �|�}W n( ttfk
r6 t�d|f ��Y nX t�� }t� |j
� t� dd|j � t
�t||�| d< dS )zo
The FQPN of a WSGI application object to serve as the root resource of
the webserver.
z No such WSGI application: %rZafterZshutdownr! N)r ZnamedAny�AttributeError�
ValueErrorr rK r
Z
ThreadPoolr ZcallWhenRunning�startZaddSystemEventTrigger�stopr Z WSGIResource)r( rS Z applicationZpoolr) r) r* �opt_wsgi� s zOptions.opt_wsgic C s( t | d tj�st�d��|| d _dS )zA
Specify the default mime-type for static files.
r! z*You can only use --mime_type after --path.N)rJ r rB r rK � defaultType)r( rZ r) r) r* �
opt_mime_type� s
�zOptions.opt_mime_typec C s, t | d tj�st�d��| d �d� dS )zT
Specify whether or not a request for 'foo' should return 'foo.ext'
r! z1You can only use --allow_ignore_ext after --path.�*N�rJ r rB r rK Z ignoreExtr' r) r) r* �opt_allow_ignore_ext� s
z Options.opt_allow_ignore_extc C s, t | d tj�st�d��| d �|� dS )zT
Specify an extension to ignore. These will be processed in order.
r! z+You can only use --ignore_ext after --path.Nr] )r( rO r) r) r* �opt_ignore_ext� s
zOptions.opt_ignore_extc C s. |� dd�\}}| d �|�� |�� f� dS )z
Specify an additional header to be included in all responses. Specified
as "HeaderName: HeaderValue".
�:rI r" N)rL r= �strip)r( �headerrS �valuer) r) r* �opt_add_header� s zOptions.opt_add_headerc C s� | d dk r | d � | d � | d dk r�zt�d� W n tk
rV t�d��Y nX d�| d | d | d �}| d � |� t| d �d
kr�| d r�tj �
tj � d t j
j��}| d � d
| � n| d � d� dS )a@
Set up conditional defaults and check for dependencies.
If SSL is not available but an HTTPS server was configured, raise a
L{UsageError} indicating that this is not possible.
If no server port was supplied, select a default appropriate for the
other options supplied.
r$ Nr# r% z OpenSSL.SSLzSSL support not installedz$ssl:port={}:privateKey={}:certKey={}r r r r �~zunix:ztcp:8080)r= r Z namedModule� ImportErrorr rK �format�lenrC rD �
expanduser�joinr
r@ �userSocketName)r( Z
sslStrportrD r) r) r* � postOptions� s(
��zOptions.postOptions)$�__name__�
__module__� __qualname__�__doc__ZsynopsisZ
optParametersZoptFlagsr= r
r@ rk r Z CompletionsZ
CompleteFilesZcompDataZlongdescr& r3 Zopt_pr; r> r? Zopt_irA Zopt_urG rQ rR rT rY r[ Zopt_mr^ r_ rd rl r) r) r) r* r sh ���� �� �����
r c C s t �t�| ��S )z�
Create and return a factory which will respond to I{distrib} requests
against the given site.
@type site: L{twisted.web.server.Site}
@rtype: L{twisted.internet.protocol.Factory}
)r ZPBServerFactoryr
ZResourcePublisher)�siter) r) r* �makePersonalServerFactory� s rr c @ s e Zd Zdd� Zdd� ZdS )�_AddHeadersResourcec C s || _ || _d S �N)�_originalResource�_headers)r( ZoriginalResourceZheadersr) r) r* r& s z _AddHeadersResource.__init__c C s, | j D ]\}}|j�||� q| j�||�S rt )rv ZresponseHeadersZ addRawHeaderru �getChildWithDefault)r( rS Zrequestr �vr) r) r* rw s z'_AddHeadersResource.getChildWithDefaultN)rm rn ro r& rw r) r) r) r* rs s rs c C s� t �� }| d r0| d }| d r8| d | d _nt�� }t|tj�rT|j� t
j |� | d rjt || d �}| d r�t
j|| d d�}n
t
�|�}| d |_| d r�t|�}| d D ]}t� ||�}|�|� q�|S ) Nr! r r" r )ZlogPathr r r# )r Z MultiServiceZ
indexNamesr ZTestrJ r rB �registryZ setComponentr ZIServiceCollectionrs r ZSiteZdisplayTracebacksrr r ZsetServiceParent)Zconfig�sr! rq r$ Zsvcr) r) r* � makeService s(
r{ )"rp Z
__future__r r rC r6 r4 Ztwisted.applicationr r Ztwisted.internetr r Ztwisted.pythonr r r
r Ztwisted.spreadr Z twisted.webr
r r r r r r r r rr ZResourcers r{ r) r) r) r* �<module> s e