o i(@sdZddlZddlZddlZddlmZmZddlmZm Z ddl m Z m Z m Z mZddlmZddlmZmZmZmZmZmZmZmZGdd d ejZd d ZGd d d ejZddZdS)z9 Support for creating a service which runs a web server. N)servicestrports) interfacesreactor) deprecatereflect threadpoolusage)pb)demodistribresourcescriptserverstatictwcgiwsgic@seZdZdZdZgdgdgdgZgdgdgZedd d ej j fd ge j e d e d e d ddZdZddZddZeZddZddZddZeZddZeZddZdd Zd!d"Zd#d$Zd%d&Zd'd(ZeZd)d*Z d+d,Z!d-d.Z"d/d0Z#d1S)2OptionszB Define the options accepted by the I{twistd web} plugin. z [web options])logfilelNz/Path to web CLF (Combined Log Format) log file.) certificatec server.pemz=(DEPRECATED: use --listen) SSL certificate to use for HTTPS. )privkeykrz<(DEPRECATED: use --listen) SSL certificate to use for HTTPS.) notracebacksnzY(DEPRECATED: Tracebacks are disabled by default. See --enable-tracebacks to turn them on.)display-tracebackszShow uncaught exceptions during rendering tracebacks to the client. WARNING: This may be a security risk and expose private data!personalrzvInstead of generating a webserver, generate a ResourcePublisher which listens on the port given by --listen, or ~/%s zif --listen is not specified.z*.logz*.pem)rrr)Z optActionszThis 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.cCs@tj|g|d<d|d<g|d<g|d<d|d<|d<dS)Nindexesroot extraHeadersportsporthttps)r r__init__selfr)UC:\Users\psant\Downloads\PAF backend\school\venv\Lib\site-packages\twisted/web/tap.pyr&Xs zOptions.__init__c C6t|jtdddd}tj|tdd||d<dS) zh (DEPRECATED: use --listen) Strports description of port to start the server on Twistedrcategory stacklevelr$N)rgetDeprecationWarningStringopt_port incrementalVersionwarningswarnDeprecationWarningr(r$msgr)r)r*r4`  zOptions.opt_portc Cr+) zW (DEPRECATED: use --listen) Port to listen on for Secure HTTP. r,r-r.rr/r0r%N)rr3 opt_httpsr5r6r7r8r9r:r)r)r*r=mr<zOptions.opt_httpscC|d|dS)zi Add an strports description of port to start the server on. [default: tcp:8080] r#Nappend)r(r$r)r)r* opt_listenxzOptions.opt_listencCr>)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_indexrBzOptions.opt_indexcCst|d<dS)zc Makes a server with ~/public_html and ~/.twistd-web-pb support for users. r!N)r UserDirectoryr'r)r)r*opt_userszOptions.opt_usercCs>ttj||d<tjtjd|d_t j |djd<dS)z 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) rFileospathabspathrZ PythonScriptZResourceScript processorsrZ CGIScript)r(rHr)r)r*opt_paths  zOptions.opt_pathcCsBt|dtjs td|dd\}}t||dj|<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) isinstancerrFr UsageErrorsplitr namedClassrJ)r(procextklassr)r)r* opt_processors zOptions.opt_processorcCst|}||d<dS)zN Create a Resource subclass with a zero-argument constructor. r!N)rrQ)r(Z classNameZclassObjr)r)r* opt_classs zOptions.opt_classcCst||d<dS)zP An .rpy file to be used as the root resource of the webserver. r!N)rZResourceScriptWrapper)r(namer)r)r*opt_resource_scriptszOptions.opt_resource_scriptc Cslzt|}Wnttfytd|wt}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: aftershutdownr!N)rZnamedAnyAttributeError ValueErrorr rOrZ ThreadPoolrZcallWhenRunningstartZaddSystemEventTriggerstoprZ WSGIResource)r(rWZ applicationpoolr)r)r*opt_wsgis zOptions.opt_wsgicCs(t|dtjs td||d_dS)zA Specify the default mime-type for static files. r!z*You can only use --mime_type after --path.N)rNrrFr rO defaultType)r(rar)r)r* opt_mime_types zOptions.opt_mime_typecCs,t|dtjs td|dddS)zT Specify whether or not a request for 'foo' should return 'foo.ext' r!z1You can only use --allow_ignore_ext after --path.*NrNrrFr rOZ ignoreExtr'r)r)r*opt_allow_ignore_exts zOptions.opt_allow_ignore_extcCs,t|dtjs td|d|dS)zT Specify an extension to ignore. These will be processed in order. r!z+You can only use --ignore_ext after --path.Nrd)r(rSr)r)r*opt_ignore_exts zOptions.opt_ignore_extcCs.|dd\}}|d||fdS)z Specify an additional header to be included in all responses. Specified as "HeaderName: HeaderValue". :rMr"N)rPr@strip)r(headerrWvaluer)r)r*opt_add_headerszOptions.opt_add_headercCs|ddur|d|d|ddur=ztdWn ty(tdwd|d|d|d }|d|t|dd krj|d ratj tj d t j j}|dd |dS|dddSdS)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={}rrrr~zunix:ztcp:8080)r@rZ namedModule ImportErrorr rOformatlenrGrH expanduserjoinr rDuserSocketName)r(Z sslStrportrHr)r)r* postOptionss,    zOptions.postOptionsN)$__name__ __module__ __qualname____doc__ZsynopsisZ optParametersZoptFlagsr@r rDrrr Z CompletionsZ CompleteFilesZcompDataZlongdescr&r4Zopt_pr=rArCZopt_irEZopt_urKrUrVrXr`rbZopt_mrerfrkrsr)r)r)r*rs^       rcCstt|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} N)r ZPBServerFactoryr ZResourcePublisher)siter)r)r*makePersonalServerFactorysryc@seZdZddZddZdS)_AddHeadersResourcecCs||_||_dSN)_originalResource_headers)r(ZoriginalResourceheadersr)r)r*r&s z_AddHeadersResource.__init__cCs,|jD] \}}|j||q|j||Sr{)r}ZresponseHeadersZ addRawHeaderr|getChildWithDefault)r(rWrequestrvr)r)r*rsz'_AddHeadersResource.getChildWithDefaultN)rtrurvr&rr)r)r)r*rzs rzc Cst}|dr|d}|dr|d|d_nt}t|tjr*|j t j ||dr5t ||d}|drCt j||dd}nt |}|drOd|_|drgtd td d d d }tj|tdd|drot|}|dD] }t||}||qs|S)Nr!r r"r)ZlogPathrTrz--notracebacksr,rr/r0rr#)rZ MultiServiceZ indexNamesr ZTestrNrrFregistryZ setComponentrZIServiceCollectionrzrZSiteZdisplayTracebacksrZ_getDeprecationWarningStringr5r6r7r8r9ryrZsetServiceParent)configsr!rxr;r$Zsvcr)r)r* makeServices6     r)rwrGr7r5Ztwisted.applicationrrZtwisted.internetrrZtwisted.pythonrrrr Ztwisted.spreadr Z twisted.webr r r rrrrrrryResourcerzrr)r)r)r*s (s