*j1U S r SSKJrJrJr SSKJrJr SSKrSSK r SSK
r
/ SQr / SQr / SQr
S r1 S
kR rS rS r " S
S5 r " S S\5 r " S S\5 r " S S\5 r " S S\5 rg)z/Base classes for server/gateway implementations ) FileWrapper guess_scheme
is_hop_by_hop)Headers_name_disallowed_re N) BaseHandler
SimpleHandlerBaseCGIHandler
CGIHandler
IISCGIHandler read_environ)MonTueWedThuFriSatSun)
NJanFebMarAprMayJunJulAugSepOctNovDecc j [ R " U 5 u pp4pVpxn S[ U U[ U XXV4- $ )Nz#%s, %02d %3s %4d %02d:%02d:%02d GMT)timegmtime _weekdayname
_monthname)
timestampyearmonthdayhhmmsswdyzs
7/opt/alt/python313/lib64/python3.13/wsgiref/handlers.pyformat_date_timer2 sB -1[[-C*D"" 0R#z% 0$B4 >
HTTPS AUTH_TYPE PATH_INFO REMOTE_USER SCRIPT_NAME CONTENT_TYPE QUERY_STRING REMOTE_IDENTCONTENT_LENGTHREQUEST_METHODc [ U 5 =( dV U R S5 =( d> U R S5 =( d& U R S5 =( a [ U SS 5 $ )NHTTP_SSL_ REDIRECT_ ) _is_request
startswith_needs_transcode)ks r1 rE rE sT q> CQ\\' 2 Call66J C
LL % A*:1QR5*ACr3 c [ R " 5 n Sn SR SU5 0 n[ R
R
5 GH* u p4[ U5 ( Ga [ R S:X a [ R
R SS5 R 5 nUR S5 ( a! UR S5 R S5 nOUR S 5 ( a OUR S
5 ( a' S U; a! UR S5 R S5 nOBUR U S5 R S5 nO UR X5 R S5 nXBU' GM- U$ ! [ a Sn GN`f = f) z'Read environment, fixing HTTP variablessurrogateescape zutf-8replacewin32SERVER_SOFTWAREzmicrosoft-iis/
iso-8859-1zapache/z simplehttp/zpython/3)
sysgetfilesystemencodingencode LookupErrorosenvironitemsrE platformgetlowerrD decode)encescrS rF vsoftwares r1 r r " sW
#
#
%C
C
'3 G
" A ||w& ::>>*;R@FFH &&'788)00 >A ((33 ''
66"h.)00 >A i077 EA
HHS&--l;
W #X Ng s E< < F F c
\ rS rSrSrSrSrSrSrSr Sr
Sr \ " 5 r
\r\rSrSrS /rS
rS=rrSrSrS rS rS
r S r S r S r S r S&S jr!S r"S r#S r$S r%S r&S r'S r(S r)S r*S r+S r,S r-S r.S r/S! r0S" r1S# r2S$ r3S%r4g)'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 U R 5 U" U R U R 5 U l U R 5 g! [
[ [ 4 a g U R 5 g! U R 5 e = f= f)zInvoke the applicationN)
setup_environrS start_responseresultfinish_responseConnectionAbortedErrorBrokenPipeErrorConnectionResetError handle_errorclose)self applications r1 runBaseHandler.run sv %dllD4G4GHDK "&9MN
!!#
s$ AA B B A00BBc U R R 5 =ol U R 5 U R 5 US' U R 5 US' U R US' U R US' U R 5 US' U R US' U R US' U R b U R US ' U R ( a/ U R ( a UR S
U R 5 ggg) z&Set up the environment for one requestz
wsgi.inputz wsgi.errorsz wsgi.versionz
wsgi.run_oncezwsgi.url_schemezwsgi.multithreadzwsgi.multiprocessNzwsgi.file_wrapperrL )
os_environcopyrS add_cgi_vars get_stdin
get_stderr wsgi_version
wsgi_run_once
get_schemewsgi_multithreadwsgi_multiprocesswsgi_file_wrapper
origin_serverserver_software
setdefault)ri envs r1 r` BaseHandler.setup_environ s "__ 1 1 33l #'>>#3L#'??#4M#'#4#4N#'#5#5O #'??#4 #'#8#8 #'#9#9 ! ! -'+'='=C# $ $"6"6 NN,T-A-A B #7 r3 c X U R 5 ( a U R 5 ( d4 U R H nU R U5 M U R 5 U R 5 g! [
U R S5 ( a U R R 5 e = f)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.
rh N)result_is_filesendfilerb writefinish_contentrh hasattrri datas r1 rc BaseHandler.finish_response s~ &&((
KKDJJt$ (##%
JJL t{{G,, !!# s A A1 18B)c , [ U R 5 $ )z Return the URL scheme being used)r rS ri s r1 ru BaseHandler.get_scheme s DLL))r3 c [ U R 5 nUS:X a# [ U R 5 U R S' gg! [
[ [ 4 a gf = f)z@Compute Content-Length or switch to chunked encoding if possibler Content-LengthN)lenrb str
bytes_sentheaders TypeErrorAttributeErrorNotImplementedError)ri blockss r1 set_content_length BaseHandler.set_content_length sZ %F qy14T__1E -. .)<= s A AAc F SU R ; a U R 5 gg)zaMake any necessary header changes or defaults
Subclasses can extend this to add other defaults.
r N)r r r s r1 cleanup_headersBaseHandler.cleanup_headers s!
4<< / # # % 0r3 c U( a U R ( a e SnOU R b [ S5 eXl U R U5 U l U R US5 nU R
U5 U R $ ! Snf = f)z4'start_response()' callable as specified by PEP 3333NzHeaders already set!Status) headers_sentr AssertionErrorstatus
headers_class_convert_string_type_validate_statusr )ri r r exc_infonamevals r1 ra BaseHandler.start_response s
$$ %
\\
% !78 8 ))'2 **68< f% zz! s B Bc [ R " U5 ( a [ S5 e[ U5 S: a [ S5 eUS S R 5 ( d [ S5 eUS S:w a [ S5 eg )Nz,Control characters are not allowed in status 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 search
ValueErrorr r isdigit)ri r s r1 r BaseHandler._validate_status st % %f - - KL L v;? !GH Hbqz!!## !KL L !9 !NO O r3 c r [ U5 [ L a U$ [ SR U[ U5 5 5 e)zConvert/check value type.z!{0} must be of type str (got {1}))typer r formatrepr)ri valuetitles r1 r BaseHandler._convert_string_type s4 ;# L / 6 6ud5k J
r3 c f U R ( a U R 5 ( a U R SU R < SU R < S3R S5 5 SU R ; a? U R S[ [ R " 5 5 - R S5 5 U R ( a? SU R ; a. U R SU R - R S5 5 g
g
g
g
U R S U R - R S5 5 g
) z6Transmit version/status/date/server, via self._write()zHTTP/r z
rM Datez
Date: %s
Serverz Server: %s
z Status: %s
N)
ry client_is_modern_write http_versionr rP r r2 r# rz r s r1
send_preambleBaseHandler.send_preamble
s $$&& 1B1B4;; O W WXd ef -KK'*:499;*GGOOP\] ''HDLL,HKK!1D4H4H!H P PQ] ^_ -I'
'
KK)DKK7?? M Nr3 c U R ( d [ S5 eU R ( d! [ U5 U l U R 5 O U =R [ U5 -
sl U R
U5 U R 5 g)z+'write()' callable as specified by PEP 3333z write() before start_response()N)r r r r r send_headersr _flushr s r1 r BaseHandler.write s` {{ !BC C"" !$iDO OOs4y (O
D
r3 c g)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 r1 r BaseHandler.sendfile0 s $ r3 c U R ( d- U R R SS5 U R 5 gg)z.Ensure headers and content have both been sentr 0N)r r r{ r r s r1 r BaseHandler.finish_contentE s1
LL # #$4c : r3 c " [ U R S5 ( a U R R 5 S=U l =U l =U l U l SU l SU l g! S=U l =U l =U l U l SU l SU l f = f)ztClose the iterable (if needed) and reset all instance vars
Subclasses may want to also drop the client connection.
rh Nr F)r rb rh r r rS r r r s r1 rh BaseHandler.closeO s
;t{{7++ !!#FJ JDK J$, Jt| DOU!2 GK JDK J$, Jt| DOU!2s 5A" ",Bc U R 5 SU l U R ( a U R 5 ( a5 U R 5 U R [
U R 5 5 gg)z1Transmit headers to the client, via self._write()TN)r r ry r r r bytesr r s r1 r BaseHandler.send_headers\ sS !!T%:%:%<%< KKdll+ , &=r3 c \ U R nUSL=( a [ U R U5 $ )z@True if 'self.result' is an instance of 'self.wsgi_file_wrapper'N)rx
isinstancerb )ri wrappers r1 r BaseHandler.result_is_filee s( ((d"Fz$++g'FFr3 c B U R S R 5 S:g $ )z,True if client can accept status and headersSERVER_PROTOCOLzHTTP/0.9)rS upperr s r1 r BaseHandler.client_is_modernk s || -.446*DDr3 c SSK Jn U R 5 nU" US US US U R U5 UR 5 Sng! Snf = f)zqLog the 'exc_info' tuple in the server log
Subclasses may override to retarget the output or change its format.
r )print_exceptionr N) tracebackr rr traceback_limitflush)ri r r stderrs r1
log_exceptionBaseHandler.log_exceptionp sR
1__&F Xa[(1+$$f
LLNHtHs AA
Ac U R [ R " 5 5 U R ( d< U R U R
U R 5 U l U R 5 gg)z>Log current error, and send error output to client if possibleN) r rN r r error_outputrS ra rb rc r s r1 rg BaseHandler.handle_error sN 3<<>* ++DLL$:M:MNDK " !r3 c U" U R U R SS [ R " 5 5 U R /$ )a 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_headersrN r
error_body)ri rS ra s r1 r BaseHandler.error_output s4 t((););A)>s||~N r3 c [ e)zOverride 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 r1 r BaseHandler._write s
"!r3 c [ e)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 r1 r BaseHandler._flush s
"!r3 c [ e)z4Override in subclass to return suitable 'wsgi.input'r r s r1 rq BaseHandler.get_stdin !!r3 c [ e)z5Override in subclass to return suitable 'wsgi.errors'r r s r1 rr BaseHandler.get_stderr r r3 c [ e)z>Override in subclass to insert CGI variables in 'self.environ'r r s r1 rp BaseHandler.add_cgi_vars r r3 )r rS r r rb r N)5__name__
__module__ __qualname____firstlineno____doc__rs rv rw rt ry r rz r rn r rx r r r r r r r rb r r r rk r` rc ru r r ra r r r r r r rh r r r r rg r r r rq rr rp __static_attributes__r r3 r1 r r ^ s 5 L MMLO
J $M O.L23MOJ FVLGJ0C*4*
&4P
O **
;-G E
#!&"""""r3 r c B \ rS rSrSr S S jrS rS rS rS r S r
S r g
) r
i aU 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 L Xl X l X0l X@l XPl X`l g r )stdinstdoutr base_envrv rw )ri r r r rS multithread multiprocesss r1 __init__SimpleHandler.__init__ s$
+ !- r3 c U R $ r )r r s r1 rq SimpleHandler.get_stdin s zzr3 c U R $ r )r r s r1 rr SimpleHandler.get_stderr s {{r3 c N U R R U R 5 g r )rS updater r s r1 rp SimpleHandler.add_cgi_vars s DMM*r3 c U R R U5 nUb U[ U5 :X a g SSKJn U" S[
5 XS =n( a) U R R U5 nXS =n( a M( g g )Nr )warnz9SimpleHandler.stdout.write() should not do partial writes)r r r warningsr DeprecationWarning)ri r rb r s r1 r SimpleHandler._write sq ""4( >Vs4y 0 !
H 7m#d#[[&&t,F 7m#d##r3 c n U R R 5 U R R U l g r )r r r r s r1 r SimpleHandler._flush s# kk'' r3 )r r r r r rw rv N)TF) r r r r r r rq rr rp r r r r r3 r1 r
r
s*
(-.+-(r3 r
c \ rS rSrSrSrSrg)r i 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.
Fr N)r r r r r ry r r r3 r1 r r s & Mr3 r c & \ rS rSrSrSr0 rS rSrg)r i 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
[ R U [ R R [ R
R [ R [ 5 SSS9 g )NFTr r )r r rN r bufferr r r r s r1 r CGIHandler.__init__ s? #))""CJJ$5$5szz ND
r3 r N r r r r r rt rn r r r r3 r1 r r s
M J
r3 r c & \ rS rSrSrSr0 rS rSrg)r
i zCGI-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
h [ 5 nUR SS5 nUR SS5 nUS- R US- 5 ( a U[ U5 S US' [ R U [ R R [ R R [ R USSS9 g )Nr6 rI r8 /FTr ) r rV rD r r r rN r r r r )ri rS pathscripts r1 r IISCGIHandler.__init__6 s {{;+]B/ H , ,#'F #5GK #))""CJJ$5$5szz T
r3 r Nr r r3 r1 r
r
s MJ
r3 r
)r utilr r r r r r rN rR r# __all__r% r& r2 __contains__rC rE r r r
r r r
r r3 r1 r s 5 : : 1 A 8
,
C9xX" X"v
,(K ,(^] 0