\d(dZddlZddlZddlZddlmZmZddlmZm Z ddl m Z m Z m Z mZddlmZddlmZmZmZmZmZmZmZmZGdd ejZd ZGd d ejZd ZdS)z9 Support for creating a service which runs a web server. N)servicestrports) interfacesreactor) deprecatereflect threadpoolusage)pb)demodistribresourcescriptserverstatictwcgiwsgiceZdZdZdZgdgdgdgZgdgdgZedd d ej j d d zge j e j d e j de j ddZdZdZdZeZdZdZdZeZdZeZdZdZdZdZdZdZeZdZ dZ!d Z"d!Z#d"S)#OptionszB 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!personalr zsInstead of generating a webserver, generate a ResourcePublisher which listens on the port given by --listen, or ~/ zif --listen is not specified.z*.logz*.pem)rrr) 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.ctj|g|d<d|d<g|d<g|d<dx|d<|d<dS)Nindexesroot extraHeadersportsporthttps)r r__init__selfs /lib/python3.11/site-packages/twisted/web/tap.pyr+zOptions.__init__XsS t$$$YV !^W '++V tG}}}c tj|jtjdddd}t j|td||d<dS) zh (DEPRECATED: use --listen) Strports description of port to start the server on Twistedrcategory stacklevelr)N)rgetDeprecationWarningStringopt_port incrementalVersionwarningswarnDeprecationWarningr-r)msgs r.r9zOptions.opt_port`sU 3 M;.y"aCC    c$61EEEEV r/c tj|jtjdddd}t j|td||d<dS) zW (DEPRECATED: use --listen) Port to listen on for Secure HTTP. r1r2r3rr4r5r*N)rr8 opt_httpsr:r;r<r=r>r?s r.rBzOptions.opt_httpsmsU 3 NK/ 2q!DD    c$61EEEEW r/c<|d|dS)zi Add an strports description of port to start the server on. [default: tcp:8080] r(Nappend)r-r)s r. opt_listenzOptions.opt_listenxs" W T"""""r/c<|d|dS)zr Add the name of a file used to check for directory indexes. [default: index, index.html] r%NrD)r- indexNames r. opt_indexzOptions.opt_indexs" Yy)))))r/c2tj|d<dS)zc Makes a server with ~/public_html and ~/.twistd-web-pb support for users. r&N)r UserDirectoryr,s r.opt_userzOptions.opt_users ,..V r/ctjtj||d<t jt jd|d_tj |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) rFileospathabspathr PythonScriptResourceScript processorsr CGIScript)r-rPs r.opt_pathzOptions.opt_paths_ {27??4#8#899V ')# # V +0/V '''r/ct|dtjstjd|dd\}}t j||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) isinstancerrNr UsageErrorsplitr namedClassrT)r-procextklasss r. opt_processorzOptions.opt_processorsh $v, 44 Q"#OPP PZZQ'' U'.'9%'@'@V $$$r/cHtj|}||d<dS)zN Create a Resource subclass with a zero-argument constructor. r&N)rr])r- classNameclassObjs r. opt_classzOptions.opt_classs'%i00xzzV r/c4tj||d<dS)zP An .rpy file to be used as the root resource of the webserver. r&N)rResourceScriptWrapper)r-names r.opt_resource_scriptzOptions.opt_resource_scripts3D99V r/cT tj|}n,#ttf$rt jd|wxYwt j}tj |j tj dd|j tjt|||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)rnamedAnyAttributeError ValueErrorr r[r ThreadPoolrcallWhenRunningstartaddSystemEventTriggerstopr WSGIResource)r-rh applicationpools r.opt_wsgizOptions.opt_wsgis  J!*400KK + J J J"#H#H#HII I J$&& +++%gz49EEE($ DDV s )Act|dtjstjd||d_dS)zA Specify the default mime-type for static files. r&z*You can only use --mime_type after --path.N)rZrrNr r[ defaultType)r-rzs r. opt_mime_typezOptions.opt_mime_typesA$v, 44 Q"#OPP P#.V    r/ct|dtjstjd|dddS)zT Specify whether or not a request for 'foo' should return 'foo.ext' r&z1You can only use --allow_ignore_ext after --path.*NrZrrNr r[ ignoreExtr,s r.opt_allow_ignore_extzOptions.opt_allow_ignore_extsT$v, 44 "F  V s#####r/ct|dtjstjd|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-r_s r.opt_ignore_extzOptions.opt_ignore_extsM$v, 44 U"#STT T V s#####r/c|dd\}}|d||fdS)z Specify an additional header to be included in all responses. Specified as "HeaderName: HeaderValue". :rYr'N)r\rEstrip)r-headerrhvalues r.opt_add_headerzOptions.opt_add_headersO ll3** e ^##TZZ\\5;;==$ABBBBBr/c|d!|d|d|d| tjdn"#t$rt jdwxYwd|d|d|d }|d|t|dd kr|d rltj tj d tj j}|dd |zdS|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)rEr namedModule ImportErrorr r[formatlenrOrP expanduserjoinr rKuserSocketName)r- sslStrportrPs r. postOptionszOptions.postOptionssb < # M f . . . = $ D#M2222 D D D&'BCCC D?FFW Y]#J M  , , , tG}   " "J 1w))GLLg&;&JKKW $$Wt^44444W $$Z00000 # "s AA'N)$__name__ __module__ __qualname____doc__synopsis optParametersoptFlagsrEr rKrr Completions CompleteFilescompDatalongdescr+r9opt_prBrFrIopt_irLopt_urVrarerirxr{opt_mrrrrr/r.rrs3H RQQ      M"      H( OO  B%,$9$H$H$H K. .    !u *u*733.5.w77*u*733  HGH,,,    E   ###*** E/// E : : :AAA"""::: E E E/// E$$$$$$CCC11111r/rcNtjtj|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)sites r.makePersonalServerFactoryrs   g7== > >>r/ceZdZdZdZdS)_AddHeadersResourcec"||_||_dSN)_originalResource_headers)r-originalResourceheaderss r.r+z_AddHeadersResource.__init__s!1 r/c|jD] \}}|j||!|j||Sr)rresponseHeaders addRawHeaderrgetChildWithDefault)r-rhrequestrvs r.rz'_AddHeadersResource.getChildWithDefaultsLM 7 7DAq  # 0 0A 6 6 6 6%99$HHHr/N)rrrr+rrr/r.rrs7   IIIIIr/rc (tj}|dr$|d}|dr|d|d_ntj}t |t jr%|j tj ||drt||d}|drtj||d}ntj|}|drd|_|drFt!jd t%jd d d d }t)j|t,d|drt/|}|dD],}t1j||}||-|S)Nr&r%r'r)logPathrTrz--notracebacksr1rr4r5r!r()r MultiService indexNamesr TestrZrrNregistry setComponentrIServiceCollectionrrSitedisplayTracebacksr_getDeprecationWarningStringr:r;r<r=r>rrsetServiceParent)configsr&rr@r)svcs r. makeServicersA f~f~ )  :(.y(9F6N %y{{$ $$E "":#@!DDD nA"4)?@@ i!{4 ):;;;{4   "#&!%nF4 k1)RAFF    c$61EEEE j/(..w  tT** Q Hr/)rrOr<r:twisted.applicationrrtwisted.internetrrtwisted.pythonrrr r twisted.spreadr twisted.webr r rrrrrrrrResourcerrrr/r.rsc   1111111100000000@@@@@@@@@@@@TTTTTTTTTTTTTTTTTTTTo1o1o1o1o1emo1o1o1d???IIIII(+III$ $ $ $ $ r/