gjbdZddlZddlZddlZ eej fZddlZGdde Z dZ ddl Z dZ Gdd e Zej d kr4ej"ej$d eej$zZd Zn2ej#ej$d eej$zZd ZGdde ZGddeZGdde ZefdZedfdZy#e$reZYwxYw#e$rdZ YwxYw)aCherryPy dispatchers. A 'dispatcher' is the object which looks up the 'page handler' callable and collects config for the current request based on the path_info, other request attributes, and the application architecture. The core calls the dispatcher as early as possible, passing it a 'path_info' argument. The default dispatcher discovers the page handler by matching path_info to a hierarchical arrangement of objects, starting at request.app.root. NceZdZdZdZedZejdZedZejdZdZ y) PageHandlerz"Callable which sets response.body.c.||_||_||_yNcallableargskwargs)selfrr r s )/opt/Tautulli/lib/cherrypy/_cpdispatch.py__init__zPageHandler.__init__s    cJtjjjS)z?The ordered args should be accessible from post dispatch hooks.cherrypyservingrequestr r s r r zPageHandler.args s'',,,rc|tjj_tjjjSrr)r r s r r zPageHandler.args%s.(,  %'',,,rcJtjjjS)z?The named kwargs should be accessible from post dispatch hooks.rrrr rs r r zPageHandler.kwargs*s''...rc|tjj_tjjjSrrr r s r r zPageHandler.kwargs/s.*0  '''...rcb |j|ji|jS#t$r}t j d} t |j|j|j#tj$rt j dt$r|wxYwwxYw)N) rr r TypeErrorsysexc_infotest_callable_specr HTTPError Exception)r xs r __call__zPageHandler.__call__4s  4==$));t{{; ;  q!A "4==$))T[[I  %% (llnQ''    s!%( B. +A54B.55B**B.N) __name__ __module__ __qualname____doc__r propertyr setterr r#rr rrsg, -- [[--// ]]// rrcttjjdd} t |\}}}}|r&t|dstj|r|dd}t|Dcgc]}|dfc}} d} d} t} t|D]\} } | || xxdz cc<|j!D]} | |xxdz cc<|t'|xsg d}t|xsgD]!\} }| || dk(s| || xxdz cc<#g}g}| j)D]3\}}|dk(r|j+||dkDs#|j+|5|r/d}|rddj-|z}tj.d | |s| dkDrtj.d tjjj0j2xsi}t|j!}t|j!|z }|rN|j5t|rd }nd }d}|rd dj-|z}tj.|| |s| dkDrt|j5| }|r/d}|rd dj-|z}tj.d | t|j5| }|r/d}|rddj-|z}tj.d | yyy#t $r<t |tr't|drt |j\}}}}nYwxYwcc}w#t$r | dz } YwxYw#t"$r| dz } | j%|YwxYw)aiInspect callable and test to see if the given args are suitable for it. When an error occurs during the handler's invoking stage there are 2 erroneous cases: 1. Too many parameters passed to a function which doesn't define one of *args or **kwargs. 2. Too little parameters are passed to the function. There are 3 sources of parameters to a cherrypy handler. 1. query string parameters are passed as keyword parameters to the handler. 2. body parameters are also passed as keyword parameters. 3. when partial matching occurs, the final path atoms are passed as positional args. Both the query string and path atoms are part of the URI. If they are incorrect, then a 404 Not Found should be raised. Conversely the body parameters are part of the request; if they are invalid a 400 Bad Request. show_mismatched_paramsFr#rNrzMissing parameters: %s,i)messageiz"Multiple values for parameters: %sz&Unexpected query string parameters: %s, zUnexpected body parameters: %s)getattrrrr getargspecr isinstanceobjecthasattrr#inspectismethoddictset enumerate IndexErrorkeysKeyErroraddlenitemsappendjoinr bodyparams intersection)r callable_argscallable_kwargsr,r varargsvarkwdefaultsarg arg_usage vararg_usage varkw_usage extra_kwargsivaluekeyargs_with_defaultsval missing_args multiple_argsusager. body_params qs_paramserrorextra_qs_paramsextra_body_paramss r rrBs&%  ":EC +5h+?(wx Hj )   X &ABx40CsAi01ILK5Lm,5  d1g ! #  ##%" " cNa N"s8>r2234HN+23 '* +q 0 (+ , 1 ,2 LMoo'& U A:    $ QY   % &  !.,1GGG  g66 |a'  %%""**//66<"Kk&&()KO((*+k9I  ! !#m"4 5EE !xx ./G  88 [1_i.55lC G%%'+yy'AB$$S': : ,99,G G%99%678$$S': : %5y  h 'GHj,I#H$5$56 T7E   $1  A L   " 1 K   S ! "s<L( M M M%AMMM"!M"%NNc2tj|ddS)N)r5getfullargspec)rs r r1r1s%%h/33rcyrr*rs r rrsrcDeZdZdZedZej dZy)LateParamPageHandleraWhen passing cherrypy.request.params to the page handler, we do not want to capture that dict too early; we want to give tools like the decoding tool a chance to modify the params dict in-between the lookup of the handler and the actual calling of the handler. This subclass takes that into account, and allows request.params to be 'bound late' (it's more complicated than that, but that's the effect). ctjjjj }|j r|j |j |S)z=Page handler kwargs (with cherrypy.request.params copied in).)rrrrCcopy_kwargsupdaters r r zLateParamPageHandler.kwargss@!!))00557 << MM$,, ' rcP|tjj_||_yr)rrrr rdrs r r zLateParamPageHandler.kwargss*0  ' rN)r$r%r&r'r(r r)r*rr raras3 ]]rra)r_cVt|trt|dk7r tdy)Nz0The translate argument must be a str of len 256.)r2strr> ValueErrorts r validate_translatorros-!S!SVs]BD D&3rc:t|ts tdy)Nz&The translate argument must be a dict.)r2r7rlrms r roros!T"EF F#rc.eZdZdZdZ defdZdZdZy) DispatcheraCherryPy Dispatcher which walks a tree of objects to find a handler. The tree is rooted at cherrypy.request.app.root, and each hierarchical component in the path_info argument is matched to a corresponding nested attribute of the root object. Matching handlers must have an 'exposed' attribute which evaluates to True. The special method name "index" matches a URI which ends in a slash ("/"). The special method name "default" may match a portion of the path_info (but only when no longer substring of the path_info matches some other object). This is the default, built-in dispatcher for CherryPy. _cp_dispatchNc<t|||_|r||_yyr)ro translatedispatch_method_name)r rvrus r r zDispatcher.__init__s!I&" (.set_confsw??'')D-9 E(c4 D!(D069!L7,B!CD7ED23 E KrdefaultT)rrrapprrvstripsplitr>r4rerrrur0popr@CherryPyExceptionformatrArangerinsertendswithis_index)r pathrrr dispatch_namer"rnodeconfnode iternamesrobjnamesubnodepre_lendispatch index_name existing_lencurpathnew_segssegrnum_candidatesrO candidate defhandlerrrrrs @@@r r{zDispatcher.find_handler%s&""**kkxx11  $zz#44S9?!QA?7)K8}  4 & OODOO , #**  OOCJJsO ,x9: QK Q>'')D8T40D|x54.NN))$//:9>>15#.>>"6t"De"D"*"4"4S"9&//1GO->"?sFF,FN)r$r%r&r'r#r*rr rrs 2rrc0eZdZdZddZdZdZdZdZy) RoutesDispatcherz'A Routes based dispatcher for CherryPy.c ddl}||_i|_|jdi||_|jj |j_y)zRoutes dispatcher. Set full_result to True if you wish the controller and the action to be passed on to the page handler parameters. By default they won't be. rNr*)routes full_result controllersMappermapperr;controller_scan)r rmapper_optionsrs r r zRoutesDispatcher.__init__sD &#fmm5n5 &*&6&6&;&; #rc b||j|<|jj||fd|i|y)N controller)rrconnect)r rrouterr s r rzRoutesDispatcher.connects2!+ D%CDCFCrc,tj|r)r HTTPRedirect)r urls r redirectzRoutesDispatcher.redirects##C((rc|j|}|r)t|tjj_ytj tjj_y)rxN)r{rarrrr}r~)r rrs r r#zRoutesDispatcher.__call__sK  + /CD/IH   $ $ ,/7/@/@/BH   $ $ ,rc ddl}tjj}|j }|j |_t |dr|j|_|jjdd|_ |j|_ |j|_|j j|}||_i}|r|j#}|j$s$|j'dd|j'dd|j(j+|tj,j#x|_dfd}|j.}|j0} t | d r|| j2d |j,vr||j,d |j5d D cgc]} | s|  } } | r| j'} nd} | D]9} d j7| f|j,vs%||j,;d}|r|jd}|j8j||}|r5t;|t<r|}t |d r||j2|jd}|,t?||d}t |d r||j2n|}| r6d j7| f|j,vr||j,|Scc} w) z4Find the right page handler, and set request.config.rN wsgi_environHostractionrcBd|vr xsd|d<j|y)Nrrzr)re)rrrs r mergez,RoutesDispatcher.find_handler..merge's&$06=n23 KK !rrrz) rrrrrequest_configrr4renvironrgethostschemeprotocolrmatch mapper_dictrcrrrCrerrrrrrArr2 classtyper0)r rrrrresultrCrrrr"atomslastatomr}rrrrs @@r r{zRoutesDispatcher.find_handler s""**&&(  7N +$11FNoo))&$7 !..--""9-# [[]F JJ|T * JJx &f%!) 4 4 66 " kkxx 4 & $// " #**  #**S/ "&OOC06qA66 99;DD +Dhh/G#**$cjj)* +  L1J))--j*EJj)4!+J:|4*//0ZZ)F!!*fd;7L1',,-$ hh/G#**$cjj)*K7s <LLN)F) r$r%r&r'r rrr#r{r*rr rrs!1 <D)COrrc"ddlmfd}|S)Nr) xmlrpcutilc6j|}|Sr) patched_path)rnext_dispatcherrs r xmlrpc_dispatchz)XMLRPCDispatcher..xmlrpc_dispatch_s++I6 y))r) cherrypy.libr)rrrs` @r XMLRPCDispatcherr\s'* rTc *ddlmfd}|S)a Select a different handler based on the Host header. This can be useful when running multiple sites within one CP server. It allows several domains to point to different parts of a single website structure. For example:: http://www.domain.example -> root http://www.domain2.example -> root/domain2/ http://www.domain2.example:443 -> root/secure can be accomplished via the following config:: [/] request.dispatch = cherrypy.dispatch.VirtualHost( **{'www.domain2.example': '/domain2', 'www.domain2.example:443': '/secure', }) next_dispatcher The next dispatcher object in the dispatch chain. The VirtualHost dispatcher adds a prefix to the URL and calls another dispatcher. Defaults to cherrypy.dispatch.Dispatcher(). use_x_forwarded_host If True (the default), any "X-Forwarded-Host" request header will be used instead of the "Host" header. This is commonly added by HTTP servers (such as Apache) when proxying. ``**domains`` A dict of {host header value: virtual prefix} pairs. The incoming "Host" request header is looked up in this dict, and, if a match is found, the corresponding "virtual prefix" value will be prepended to the URL path before calling the next dispatcher. Note that you often need separate entries for "example.com" and "www.example.com". In addition, "Host" headers may contain the port number. r)httputilc`tjj}|jj}|dd} r |d|}j |d}|rj ||} |}|j j d}|r|t|d}||j d<|S)NrrzX-Forwarded-Hostr)rrrrrurljoinrr>) rrheaderdomainprefixrsectiondomainsrruse_x_forwarded_hosts r vhost_dispatchz#VirtualHost..vhost_dispatchs""**$$# .7FVR(  ((;I +..$$%>? c&kl+G8?GNN4 5 r)rr)rrrrrs``` @r VirtualHostresN&, r)r'stringrtypestype ClassTyperAttributeErrorrr3rrr5r1 ImportErrorra version_info maketrans punctuationr>rrorkrrrrrrr*rr rsB  u'I'&'TE;P4 4;0f!1!1!1C#f&8&8"99";D "%C#f&8&8"99";G AAH'2z'2Tnvnb&0\!+ 4?gIts"C/C</C98C9<DD