֦iT d Z ddlmZmZmZ ddlmZ ddlZddlZddl Z g dZ
g dZ g dZ d Z
h d
j Zd Zd Z G d
d Z G d de Z G d de Z G d de Z G d de Zy)z/Base classes for server/gateway implementations ) FileWrapper guess_scheme
is_hop_by_hop)Headers N) BaseHandler
SimpleHandlerBaseCGIHandler
CGIHandler
IISCGIHandler read_environ)MonTueWedThuFriSatSun)
NJanFebMarAprMayJunJulAugSepOctNovDecc t t j | \ }}}}}}}}} dt | |t | ||||fz S )Nz#%s, %02d %3s %4d %02d:%02d:%02d GMT)timegmtime _weekdayname
_monthname)
timestampyearmonthdayhhmmsswdyzs
)/usr/lib64/python3.12/wsgiref/handlers.pyformat_date_timer1 sN -1[[-C*D%b"b"a 0R#z% 0$B4 >
HTTPS AUTH_TYPE PATH_INFO REMOTE_USER SCRIPT_NAME CONTENT_TYPE QUERY_STRING REMOTE_IDENTCONTENT_LENGTHREQUEST_METHODc t | xsG | j d xs4 | j d xs! | j d xr t | dd S )NHTTP_SSL_ REDIRECT_ ) _is_request
startswith_needs_transcode)ks r0 rD rD sT q> CQ\\' 2 Call66J C
LL % A*:1QR5*ACr2 c t j } d} dj d| i }t j
j
D ] \ }}t | rt j dk( rt j
j dd j }|j d r!|j d j d }n|j d rny|j d
r%d |v r!|j d j d }nC|j | d j d }n!|j | | j d }|||< |S # t $ r d}Y Hw xY w) z'Read environment, fixing HTTP variablessurrogateescape zutf-8replacewin32SERVER_SOFTWAREzmicrosoft-iis/
iso-8859-1zapache/z simplehttp/zpython/3)
sysgetfilesystemencodingencode LookupErrorosenvironitemsrD platformgetlowerrC decode)encescrR rE vsoftwares r0 r
r
" sQ
#
#
%C
C
'3 G
"1 A ||w& ::>>*;R@FFH &&'78)00 >A ((3 ''
6"h.)00 >A i077 EA
HHS#&--l;
W #X Ng s E$ $ E32E3c e Zd ZdZdZdZdZdZdZdZ dZ
e Z e
ZeZdZdZdgZd ZdxZZdZdZd
Zd Zd Zd
Z d Z d Z d Z d$dZ d Z!d Z"d Z#d Z$d Z%d Z&d Z'd Z(d Z)d Z*d Z+d Z,d Z-d Z.d Z/d! Z0d" Z1d# Z2y)%r z+Manage the invocation of a WSGI application)r r TFz1.0Nz500 Internal Server Error)z Content-Typez
text/plains; A server error occurred. Please contact the administrator.r c | j || j | j | _ | j y# t
t t f$ r Y y | j Y y# | j xY wxY w)zInvoke the applicationN)
setup_environrR start_responseresultfinish_responseConnectionAbortedErrorBrokenPipeErrorConnectionResetError handle_errorclose)self applications r0 runzBaseHandler.run sv %dllD4G4GHDK "&9MN
!!#
s$ AA BB A//BBc | j j x}| _ | j | j |d< | j |d< | j |d< | j |d< | j |d< | j |d< | j |d< | j | j |d < | j r*| j r |j d
| j yyy) z&Set up the environment for one requestz
wsgi.inputz wsgi.errorsz wsgi.versionz
wsgi.run_oncezwsgi.url_schemezwsgi.multithreadzwsgi.multiprocessNzwsgi.file_wrapperrK )
os_environcopyrR add_cgi_vars get_stdin
get_stderr wsgi_version
wsgi_run_once
get_schemewsgi_multithreadwsgi_multiprocesswsgi_file_wrapper
origin_serverserver_software
setdefault)rg envs r0 r^ zBaseHandler.setup_environ s "__ 1 1 33dl #'>>#3L#'??#4M#'#4#4N#'#5#5O #'??#4 #'#8#8 #'#9#9 ! ! -'+'='=C# $ $"6"6 NN,T-A-A B #7 r2 c 6 | j r| j s2| j D ] }| j | | j | j y# t
| j d r| j j xY w)a> Send any iterable data, then close self and the iterable
Subclasses intended for use in asynchronous servers will
want to redefine this method, such that it sets up callbacks
in the event loop to iterate over the data, and to call
'self.close()' once the response is finished.
rf N)result_is_filesendfiler` writefinish_contentrf hasattrrg datas r0 ra zBaseHandler.finish_response sv &&(
KKDJJt$ (##%
JJL t{{G, !!# s AA% %3Bc , t | j S )z Return the URL scheme being used)r rR rg s r0 rr zBaseHandler.get_scheme s DLL))r2 c t | j }|dk( r#t | j | j d< yy# t
t t f$ r Y yw xY w)z@Compute Content-Length or switch to chunked encoding if possibler Content-LengthN)lenr` str
bytes_sentheaders TypeErrorAttributeErrorNotImplementedError)rg blockss r0 set_content_lengthz BaseHandler.set_content_length sZ %F qy14T__1E -. .)<= s A AAc B d| j vr| j yy)zqMake any necessary header changes or defaults
Subclasses can extend this to add other defaults.
r N)r r r s r0 cleanup_headerszBaseHandler.cleanup_headers s!
4<< / # # % 0r2 c |r | j r d}n| j t d || _ | j | | _ | j |d }| j
| |D ]B \ }}| j |d }| j |d }t | s6J d| d| d | j S # d}w xY w) z4'start_response()' callable as specified by PEP 3333NzHeaders already set!Statusz Header namez Header valuezHop-by-hop header, 'z: z', not allowed) headers_sentr AssertionErrorstatus
headers_class_convert_string_type_validate_statusr r} )rg r r exc_infonamevals r0 r_ zBaseHandler.start_response s
$$ %
\\
% !78 8 ))'2 **68< f% $ c00}E//^D(. J-dV2cU.IJ. % zz! s
C Cc t | dk r t d |d d j s t d |d dk7 r t d y )N z$Status must be at least 4 characters z(Status message must begin w/3-digit code z+Status message must have a space after code)r r isdigit)rg r s r0 r z BaseHandler._validate_status sT v;? !GH Hbqz!!# !KL L !9 !NO O r2 c p t | t u r|S t dj |t | )zConvert/check value type.z!{0} must be of type str (got {1}))typer r formatrepr)rg valuetitles r0 r z BaseHandler._convert_string_type s4 ;# L / 6 6ud5k J
r2 c : | j r| j r| j d| j d| j dj d d| j vr>| j dt t j z j d | j r=d| j vr.| j d| j z j d y
y
y
y
| j d | j z j d y
) z6Transmit version/status/date/server, via self._write()zHTTP/r z
rL Datez
Date: %s
Serverz Server: %s
z Status: %s
N)
rv client_is_modern_write http_versionr rO r r1 r" rw r s r0
send_preamblezBaseHandler.send_preamble s $$& 1B1B4;; O W WXd ef -KK'*:499;*GGOOP\] ''HDLL,HKK!1D4H4H!H P PQ] ^_ -I'
'
KK)DKK7?? M Nr2 c : t | t u sJ d | j s t d | j s!t | | _ | j n | xj t | z
c_ | j | | j y)z+'write()' callable as specified by PEP 3333z)write() argument must be a bytes instancez write() before start_response()N)
r bytesr r r r r send_headersr _flushr s r0 r} zBaseHandler.write s~ DzU" 8 7 8" {{ !BC C"" !$iDO OOs4y (O
D
r2 c y)a Platform-specific file transmission
Override this method in subclasses to support platform-specific
file transmission. It is only called if the application's
return iterable ('self.result') is an instance of
'self.wsgi_file_wrapper'.
This method should return a true value if it was able to actually
transmit the wrapped file-like object using a platform-specific
approach. It should return a false value if normal iteration
should be used instead. An exception can be raised to indicate
that transmission was attempted, but failed.
NOTE: this method should call 'self.send_headers()' if
'self.headers_sent' is false and it is going to attempt direct
transmission of the file.
F r s r0 r| zBaseHandler.sendfile. s $ r2 c v | j s-| j j dd | j yy)z.Ensure headers and content have both been sentr 0N)r r rx r r s r0 r~ zBaseHandler.finish_contentC s1
LL # #$4c : r2 c t | j d r| j j dx| _ x| _ x| _ | _ d| _ d| _ y# dx| _ x| _ x| _ | _ d| _ d| _ w xY w)zClose the iterable (if needed) and reset all instance vars
Subclasses may want to also drop the client connection.
rf Nr F)r r` rf r r rR r r r s r0 rf zBaseHandler.closeM s
;t{{7+ !!#FJ JDK J$, Jt| DOU!2 GK JDK J$, Jt| DOU!2s 0A ,B c | j d| _ | j r| j r5| j | j t
| j yy)z1Transmit headers to the client, via self._write()TN)r r rv r r r r r r s r0 r zBaseHandler.send_headersZ sP !!T%:%:%< KKdll+ , &=r2 c R | j }|duxr t | j | S )z@True if 'self.result' is an instance of 'self.wsgi_file_wrapper'N)ru
isinstancer` )rg wrappers r0 r{ zBaseHandler.result_is_filec s( ((d"Fz$++g'FFr2 c B | j d j dk7 S )z,True if client can accept status and headersSERVER_PROTOCOLzHTTP/0.9)rR upperr s r0 r z BaseHandler.client_is_moderni s || -.446*DDr2 c ddl m} | j } ||d |d |d | j | |j d}y# d}w xY w)zLog the 'exc_info' tuple in the server log
Subclasses may override to retarget the output or change its format.
r )print_exceptionr N) tracebackr ro traceback_limitflush)rg r r stderrs r0
log_exceptionzBaseHandler.log_exceptionn sR
1__&F Xa[(1+$$f
LLNHtHs AA
Ac | j t j | j s<| j | j
| j | _ | j yy)z>Log current error, and send error output to client if possibleN) r rM r r error_outputrR r_ r` ra r s r0 re zBaseHandler.handle_error~ sN 3<<>* ++DLL$:M:MNDK " !r2 c || j | j dd t j | j gS )aZ WSGI mini-app to create error output
By default, this just uses the 'error_status', 'error_headers',
and 'error_body' attributes to generate an output page. It can
be overridden in a subclass to dynamically generate diagnostics,
choose an appropriate message for the user's preferred language, etc.
Note, however, that it's not recommended from a security perspective to
spit out diagnostics to any old user; ideally, you should have to do
something special to enable diagnostic output, which is why we don't
include any here!
N) error_status
error_headersrM r
error_body)rg rR r_ s r0 r zBaseHandler.error_output s4 t((););A)>s||~N r2 c t )a Override in subclass to buffer data for send to client
It's okay if this method actually transmits the data; BaseHandler
just separates write and flush operations for greater efficiency
when the underlying system actually has such a distinction.
r r s r0 r zBaseHandler._write s
"!r2 c t )zOverride in subclass to force sending of recent '_write()' calls
It's okay if this method is a no-op (i.e., if '_write()' actually
sends the data.
r r s r0 r zBaseHandler._flush s
"!r2 c t )z4Override in subclass to return suitable 'wsgi.input'r r s r0 rn zBaseHandler.get_stdin !!r2 c t )z5Override in subclass to return suitable 'wsgi.errors'r r s r0 ro zBaseHandler.get_stderr r r2 c t )z>Override in subclass to insert CGI variables in 'self.environ'r r s r0 rm zBaseHandler.add_cgi_vars r r2 N)3__name__
__module__ __qualname____doc__rp rs rt rq rv r rw r
rk r ru r r r r r r r r` r r r ri r^ ra rr r r r_ r r r r} r| r~ rf r r{ r r re r r r rn ro rm r r2 r0 r r ^ s 5 L MMLO
J $M O.L23MOJ FVLGJ0C*4*
&4P
O **
;-G E
#!&"""""r2 r c 8 e Zd ZdZ d dZd Zd Zd Zd Zd Z y)
r aq Handler that's just initialized with streams, environment, etc.
This handler subclass is intended for synchronous HTTP/1.0 origin servers,
and handles sending the entire response output, given the correct inputs.
Usage::
handler = SimpleHandler(
inp,out,err,env, multithread=False, multiprocess=True
)
handler.run(app)c X || _ || _ || _ || _ || _ || _ y r )stdinstdoutr base_envrs rt )rg r r r rR multithread multiprocesss r0 __init__zSimpleHandler.__init__ s0
+ !- r2 c | j S r )r r s r0 rn zSimpleHandler.get_stdin s zzr2 c | j S r )r r s r0 ro zSimpleHandler.get_stderr s {{r2 c N | j j | j y r )rR updater r s r0 rm zSimpleHandler.add_cgi_vars s DMM*r2 c | j j | }||t | k( ry ddlm} |dt
||d x}r$| j j | }||d x}r#y y )Nr )warnz9SimpleHandler.stdout.write() should not do partial writes)r r} r warningsr DeprecationWarning)rg r r` r s r0 r zSimpleHandler._write sr ""4( >Vs4y 0 !
H 67m#d#[[&&t,F 67m#d#r2 c n | j j | j j | _ y r )r r r r s r0 r zSimpleHandler._flush s# kk'' r2 N)TF)
r r r r r rn ro rm r r r r2 r0 r r s*
(-.+-(r2 r c e Zd ZdZdZy)r
a CGI-like systems using input/output/error streams and environ mapping
Usage::
handler = BaseCGIHandler(inp,out,err,env)
handler.run(app)
This handler class is useful for gateway protocols like ReadyExec and
FastCGI, that have usable input/output/error streams and an environment
mapping. It's also the base class for CGIHandler, which just uses
sys.stdin, os.environ, and so on.
The constructor also takes keyword arguments 'multithread' and
'multiprocess' (defaulting to 'True' and 'False' respectively) to control
the configuration sent to the application. It sets 'origin_server' to
False (to enable CGI-like output), and assumes that 'wsgi.run_once' is
False.
FN)r r r r rv r r2 r0 r
r
s & Mr2 r
c e Zd ZdZdZi Zd Zy)r a CGI-based invocation via sys.stdin/stdout/stderr and os.environ
Usage::
CGIHandler().run(app)
The difference between this class and BaseCGIHandler is that it always
uses 'wsgi.run_once' of 'True', 'wsgi.multithread' of 'False', and
'wsgi.multiprocess' of 'True'. It does not take any initialization
parameters, but always uses 'sys.stdin', 'os.environ', and friends.
If you need to override any of these parameters, use BaseCGIHandler
instead.
Tc t j | t j j t j
j t j t dd y )NFTr r )r
r rM r bufferr r r
r s r0 r zCGIHandler.__init__ s? #))""CJJ$5$5szz ND
r2 Nr r r r rq rk r r r2 r0 r r s
M J
r2 r c e Zd ZdZdZi Zd Zy)r a CGI-based invocation with workaround for IIS path bug
This handler should be used in preference to CGIHandler when deploying on
Microsoft IIS without having set the config allowPathInfo option (IIS>=7)
or metabase allowPathInfoForScriptMappings (IIS<7).
Tc d t }|j dd }|j dd }|dz j |dz r|t | d |d< t j | t j j t j j t j |dd y )Nr5 rH r7 /FTr ) r
rU rC r r
r rM r r r r )rg rR pathscripts r0 r zIISCGIHandler.__init__4 s {{;+]B/ H ,#'F #5GK #))""CJJ$5$5szz T
r2 Nr r r2 r0 r r s MJ
r2 r )r utilr r r r r rM rQ r" __all__r$ r% r1 __contains__rB rD r
r r r
r r r r2 r0 r s 5 : : A 8
,
C9xV" V"r
,(K ,(^] 0