File: //lib/python3/dist-packages/twisted/web/__pycache__/tap.cpython-310.pyc
o
�b( � @ s� d Z ddlZddlZddlZddlmZmZ ddlmZm Z ddl
m Z m Z m
Z
mZ ddlmZ ddlmZmZmZmZmZmZmZmZ G dd � d ej�Zd
d � ZG d d
� d
ej �Z dd� Z dS )z9
Support for creating a service which runs a web server.
� N)�service�strports)�
interfaces�reactor)� deprecate�reflect�
threadpool�usage)�pb)�demo�distrib�resource�script�server�static�twcgi�wsgic @ s e Zd ZdZdZg d�g d�g d�gZg d�g d�gZe�dd d
ej j
f d g� e j e �
d �e �
d
�e �
d
�d�d�ZdZdd� Zdd� ZeZdd� Zdd� Zdd� ZeZdd � ZeZd d � Zd d � Zd!d"� Zd#d$� Z d%d&� Z d'd(� Z e Z d)d*� Z d+d,� Z!d-d.� Z"d/d0� Z#d1S )2�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�c�
server.pemz=(DEPRECATED: use --listen) SSL certificate to use for HTTPS. )�privkey�kr z<(DEPRECATED: use --listen) SSL certificate to use for HTTPS.)� notracebacks�nzY(DEPRECATED: Tracebacks are disabled by default. See --enable-tracebacks to turn them on.)�display-tracebacks� z�Show uncaught exceptions during rendering tracebacks to the client. WARNING: This may be a security risk and expose private data!�personalr 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 )�
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' X s zOptions.__init__c C �6 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+ r5 ` �
� zOptions.opt_portc C r, ) zW
(DEPRECATED: use --listen)
Port to listen on for Secure HTTP.
r- r. r/ r r0 r1 r& N)r r4 � opt_httpsr6 r7 r8 r9 r: r; r* r* r+ r> m r= zOptions.opt_httpsc C � | 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_listenx � zOptions.opt_listenc C r? )zr
Add the name of a file used to check for directory indexes.
[default: index, index.html]
r! Nr@ )r) � indexNamer* r* r+ � opt_index rC 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_user� 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 � PythonScript�ResourceScript�
processorsr � CGIScript)r) rJ r* r* r+ �opt_path� s
�zOptions.opt_pathc C sB t | d tj�s
t�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 rH r �
UsageError�splitr �
namedClassrN )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 rV )r) � className�classObjr* 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 �ResourceScriptWrapper)r) �namer* r* r+ �opt_resource_script� s zOptions.opt_resource_scriptc C sl zt �|�}W n ttfy t�d|����w 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.
zNo such WSGI application: �after�shutdownr" N)r �namedAny�AttributeError�
ValueErrorr rT r �
ThreadPoolr �callWhenRunning�start�addSystemEventTrigger�stopr � WSGIResource)r) r_ � application�poolr* r* r+ �opt_wsgi� s � zOptions.opt_wsgic C s( t | d tj�s
t�d��|| d _dS )zA
Specify the default mime-type for static files.
r" z*You can only use --mime_type after --path.N)rS r rH r rT � defaultType)r) ro r* r* r+ �
opt_mime_type� s
zOptions.opt_mime_typec C s, t | d tj�s
t�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�rS r rH r rT � ignoreExtr( r* r* r+ �opt_allow_ignore_ext� s
�z Options.opt_allow_ignore_extc C s, t | d tj�s
t�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.Nrr )r) rX 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".
�:rR r# N)rU rA �strip)r) �headerr_ �valuer* r* r+ �opt_add_header� s zOptions.opt_add_headerc C s� | d dur| d � | d � | d dur=zt�d� W n ty( t�d��w d�| d | d | d �}| d � |� t| d �d
krj| d ratj �
tj � d t j
j��}| d � d
| � dS | d � d� dS 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)rA r � namedModule� ImportErrorr rT �format�lenrI rJ �
expanduser�joinr rF �userSocketName)r) �
sslStrportrJ r* r* r+ � postOptions� s,
����zOptions.postOptionsN)$�__name__�
__module__� __qualname__�__doc__�synopsis�
optParameters�optFlagsrA r rF r� r � Completions�
CompleteFiles�compData�longdescr' r5 �opt_pr> rB rE �opt_irG �opt_urP rZ r] r` rn rp �opt_mrt ru rz r� r* r* r* r+ r s^ ������ ��
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
�PBServerFactoryr �ResourcePublisher)�siter* r* r+ �makePersonalServerFactory s r� c @ s e Zd Zdd� Zdd� ZdS )�_AddHeadersResourcec C s || _ || _d S �N)�_originalResource�_headers)r) �originalResource�headersr* r* r+ r' s
z _AddHeadersResource.__init__c C s, | j D ] \}}|j�||� q| j�||�S r� )r� �responseHeaders� addRawHeaderr� �getChildWithDefault)r) r_ �requestr �vr* r* r+ r� s z'_AddHeadersResource.getChildWithDefaultN)r� r� r� r' r� r* r* r* r+ r� s r� c C s t �� }| d r| d }| d r| d | d _nt�� }t|tj�r*|j� t
j |� | d r5t || d �}| d rCt
j|| d d�}nt
�|�}| d rOd|_| d rgt�d t�d
d d d
��}tj|tdd� | d rot|�}| d D ]
}t� ||�}|�|� qs|S )Nr" r! r# r )�logPathr Tr z--notracebacksr- � � r r0 r1 r r$ )r � MultiService�
indexNamesr �TestrS r rH �registry� setComponentr �IServiceCollectionr� r �Site�displayTracebacksr � _getDeprecationWarningStringr6 r7 r8 r9 r: r� r �setServiceParent)�config�sr" r� r< r% �svcr* r* r+ � makeService s6 �
� r� ) r� rI r8 r6 �twisted.applicationr r �twisted.internetr r �twisted.pythonr r r r �twisted.spreadr
� twisted.webr r r
r r r r r r r� �Resourcer� r� r* r* r* r+ �<module> s ( s