^.hMdZddlZddlZddlZddlmZddlmZGddeZ Gdde Z Gd d e Z dd Z d Z d ZdZdZGddeZdZdZddZddZdZy)zUtility functions for use in templates / controllers *PLEASE NOTE*: Many of these functions expect an initialized RequestConfig object. This is expected to have been initialized for EACH REQUEST by the web framework. N)urllib)request_configceZdZdZy)RoutesExceptionzTossed during Route exceptionsN__name__ __module__ __qualname____doc___/var/www/html/School_Mangement_New/src/backend/venv/lib/python3.12/site-packages/routes/util.pyrrs(r rceZdZdZy)MatchExceptionz%Tossed during URL matching exceptionsNrr r rrrs/r rceZdZdZy)GenerationExceptionz'Tossed during URL generation exceptionsNrr r rrrs1r rc|j}tj|D]4\}}t|tjs!|j |||<6|j r|jr|s t|||S|j r|s|St|jd|}|r|jdr |ddd|d<|S|r d|vrd|d<|jd}|r|dj} ni} tj|D cgc] \}} |  | } }} | D]}||=| j|d| j||jr t| ||} | Scc} }w)z Private function that takes a dict, and screens it against the current request dict to determine what the dict should look like that is used. This is responsible for the requests "memory" of the current. controller/Nactionindexwsgiorg.routing_args)encodingsix iteritems isinstance text_typeencodeexplicit sub_domains_subdomain_check as_unicodeget startswithcopypopupdate) kargsmapperenvironforce_explicitrkeyvalcontroller_name route_args memory_kargsvalue empty_keyss r _screenargsr4svHMM%(.S c3== )H-E#J.6--nvw77   A  C)A,& &D)F,?,??F38tTly&//: 94 V66 6&_v5#d]E'N  r c8|rnt|tjr|j|}nMt|tjr|}n0tj|j|}n t |}t j j|dS)z+A Unicode handling version of urllib.quote.r)rrrrr=rparsequotestringrss r _url_quoterRpsm fcmm , h'A  .A f%,,X6A K <<  a %%r c|rot|tjr|j|}|St|tjr|}|Stj|j|}SN)rrrrrOs r _str_encoderUsd fcmm , h'A H  .A H f%,,X6A Hr c  |jd}|jd}|jdd}|jdd}dD]5}|j|r||=|dz|vs|j|dz||<7d|vr||d<t}d}d } |jj} d } t |d kDr |jj j|d }|sd } |d } | jd rEt|dr9|jjdr|jjd| z} | r|r| dz } g} tj|D]L\}} t| ttfr| D]}| jt j"j%tj&|j)| dt j"j%tj&|j)| | jt j"j%tj&|j)| dt j"j%tj&| j)| O| dj+| z } t-|di}d|vr9|j/}t-|dd}||j/}ni}d|f|d<| sg}|r|jj0r|j||j2j/}|j5||j6r|j7|}|j8s/t;||j|}nt=||j|}|jddxs|}|jddxs|}|jd|}|jj>|i|} || dtA|| zz } |s||rV|s!|s|jBjEdd }n|s |jB}| |jF}|d k7r|dz }| |dz|z| z} tI| s| tKd| z| tKd|d|| S)aGenerates a URL All keys given to url_for are sent to the Routes Mapper instance for generation except for:: anchor specified the anchor name to be appened to the path host overrides the default (current) host if provided protocol overrides the default (current) protocol if provided qualified creates the URL with the host/port information as needed The URL is generated based on the rest of the keys. When generating a new URL, values will be used from the current request's parameters (if present). The following rules are used to determine when and how to keep the current requests parameters: * If the controller is present and begins with '/', no defaults are used * If the controller is changed, action is set to 'index' unless otherwise specified For example, if the current request yielded a dict of {'controller': 'blog', 'action': 'view', 'id': 2}, with the standard ':controller/:action/:id' route, you'd get the following results:: url_for(id=4) => '/blog/view/4', url_for(controller='/admin') => '/admin', url_for(controller='admin') => '/admin/view/2' url_for(action='edit') => '/blog/edit/2', url_for(action='list', id=None) => '/blog/list' **Static and Named Routes** If there is a string present as the first argument, a lookup is done against the named routes table to see if there's any matching routes. The keyword defaults used with static routes will be sent in as GET query arg's if a route matches. If no route by that name is found, the string is assumed to be a raw URL. Should the raw URL begin with ``/`` then appropriate SCRIPT_NAME data will be added if present, otherwise the string will be used as the url with keyword args becoming GET query args. anchorrHprotocolN qualifiedrWrH_ protocol_Fr:rTrr+ SCRIPT_NAME?=&r mapper_dictr _anchorr< _protocol#r9//z9url_for can only return a string, got unicode instead: %sz2url_for could not generate URL. Called with args:  )&r$r'rr*rr? _routenamesr%hasattrr+rrrlisttupleappendrrMrNrrjoingetattrr&hardcode_namesdefaultsr(filterstaticr"r4generaterRrHr>rXascii_charactersr)argsr)rWrHrXrYr-configrouterqrurl query_argsr.r2r+ra match_dictr0newargss rurl_forr{skXYYx F 99V DyyT*H +t,I", 99S>c s7e 3s7+E#J , e%k  F E F}}%%H C 4y1} ))--d1g6Fq'C >># 769#=NN&&}5..$$]3c9C s  # e 4 VHC!#e}5%(\E&-- & 2 23==3E3L3LX3V W & 2 23==3G3N3Nx3X Y/[\\ #))"LL..s}}S/A/H/H/RS"LL..s}}S/A/H/H/RS+UV Vsxx ++fi,GW,,,.fmT:  "$))+JJ+-z*:&'  }}++!!%(nn))+G NN5 !||,,w/<<*7FMM7K!%@GY-7{{7D)1T;;{H5$fmm$$j OH ?T/D(3.C C S_!#.03#45 5 {! 5   Jr c"eZdZdZdZdZdZy) URLGeneratoraThe URL Generator generates URL's It is automatically instantiated by the RoutesMiddleware and put into the ``wsgiorg.routing_args`` tuple accessible as:: url = environ['wsgiorg.routing_args'][0][0] Or via the ``routes.url`` key:: url = environ['routes.url'] The url object may be instantiated outside of a web context for use in testing, however sub_domain support and fully qualified URL's cannot be generated without supplying a dict that must contain the key ``HTTP_HOST``. c2||_d|vrd|d<||_y)a Instantiate the URLGenerator ``mapper`` The mapper object to use when generating routes. ``environ`` The environment dict used in WSGI, alternately, any dict that contains at least an ``HTTP_HOST`` value. r]r:N)r*r+)selfr*r+s r__init__zURLGenerator.__init__1s$  '%'GM " r c  |jd}|jd}|jdd}|jdd}dD]5}|j|r||=|dz|vs|j|dz||<7d|vr||d<d}d |vxr|jd } d } |jj} d } t |d kD} | r(|jj j|d }|s| rd } |d } | j dr9|jjdr|jjd| z} | r|r| dz } g}tj|D]L\}}t|ttfr|D]}|jtjj!tj"|j%| dtjj!tj"|j%| |jtjj!tj"|j%| dtjj!tj"|j%| O| dj'|z } | sg}|r|jj(r|j||j*j-}|j/||j0r|j1|}|j2r|j2r|j4s|jdd}t7||j|j}d|j*vrT||d<nN| r$t9||j|jd }n(d|vr"t7||j|j}n|}|xs|jdd}|xs|jdd}||jdd}|j|d<|jj:|i|} || dt=|| zz } |s||rd|jvrt?|j|jd}|s|s|djAdd }n|s|d}||d}|d k7r|dz }| '|ddk7r|dz }|dz|z| jCdz} tE| s| tGd| z| tGd|d || S)!aGenerates a URL All keys given to url_for are sent to the Routes Mapper instance for generation except for:: anchor specified the anchor name to be appened to the path host overrides the default (current) host if provided protocol overrides the default (current) protocol if provided qualified creates the URL with the host/port information as needed rWrHrXNrYrZr[r\ _use_currentFr:rTrr]r^r_r`r6)r,rbr<rc_environrdroutes.cached_hostinfor9rez1Can only return a string, got unicode instead: %sz*Could not generate URL. Called with args: rf)$r$r'r*rr?rgr%r+rrrrirjrkrrMrNrrrlrnror&r(rprqexternalr"r4rrrRcache_hostinfor>lstriprsr)rrtr)rWrHrXrYr-rv use_currentrqrrw more_argsrxr.r2r0rzsubhostinfos r__call__zURLGenerator.__call__@s8$yy 99Z.IIk40 & 0Cyy~#J3w%"YYs3w/c  0 % !)E+ $-K%))N2K ;;''IM KK++//Q8EFq'C~~c"t||'7'7 'Fll&&}5;3JC!#J$'MM%$8 ZS%cD%=9),` * 1 1$*LL$6$6s}}S7I7P7PQY7Z$[$*LL$6$6s}}U7K7R7RS[7\$]3_!`` '-- & 2 23==3E3L3LX3V W & 2 23==3E3L3LX3V W/YZ Z388J//CJ;;--%%e,..--/u%<<#ll73G|| U^^!++lD9C.w /3||=G$u~~503 -%eT[[$,,W[\&*5$++t||L;w{{9d;F57;;w5D";;{D9"&,,GJ &$++&& >g>C   3FH55 5C H(Y't||;t||,||$<=H  '--c215'#J/2~C8s?CKDo,szz#>$%'247'89 9 ;%u  r c||ddi|S)a8Generate a route that includes params used on the current request The arguments for this method are identical to ``__call__`` except that arguments set to None will remove existing route matches of the same name from the set of arguments used to construct a URL. rTr )rrtkwargss rcurrentzURLGenerator.currents7777r N)rr r r rrrr r rr}r}s" {z 8r r}cNt|i|}t}|j|S)a6Issues a redirect based on the arguments. Redirect's *should* occur as a "302 Moved" header, however the web framework may utilize a different method. All arguments are passed to url_for to retrieve the appropriate URL, then the resulting URL it sent to the redirect function as the URL. )r{rredirect)rtr)targetrus r redirect_tors*d $e $F  F ??6 ""r ci}|jds7|jddk(s#d|jddjdvrd|d<nd|d<|jd r|d jdd d |d <nm|jd r |d |d <nS|d|d <|jddk(r|ddk7r/|d xxd|dzz cc<n|ddk7r|d xxd|dzz cc<||d<|S)adProcesses the host information and stores a copy This work was previously done but wasn't stored in environ, nor is it guaranteed to be setup in the future (Routes 2 and beyond). cache_hostinfo processes environ keys that may be present to determine the proper host, protocol, and port information to use when generating routes. HTTPSzwsgi.url_schemehttpsHTTP_X_FORWARDED_PROTOr:z, rXhttpHTTP_X_FORWARDED_HOSTrrrHr7r8 SERVER_PORT443r980r)r$r>)r+rs rrrs"H{{7w{{+<=H W[[!92>DDTJ J&%{{*+"#:;AA$J1M [ !";/"=1 ;;( )W 4}%. C'-*@$@@ }%- C'-*@$@@ (0G $% Or cZ|gSdfd |}|jtd|S)z=Scan a directory for python files and use them as controllerscg}tj|D]}tjj||}tjj |r.t j d|r|j||ddzptjj|s|j|||zdz|S)z!Locate controllers in a directoryz^[^_]{1,1}.*\.py$Nr)prefix) oslistdirpathrlisfiler@rArkisdirextend)dirnamer controllersfnamefilenamefind_controllerss rrz)controller_scan..find_controllerss ZZ( NEww||GU3Hww~~h'HH159""6E#2J#67x(""#3H;A%<;K$MN  Nr T)r-reverse)r:)sortr?) directoryrrs @rcontroller_scanrs8  #9-Kd+ r cN|"t|tr|j||S|SrT)rbytesdecode)r2rerrorss rr#r#s' Zu5||Hf-- Lr c,|ytd|DS)NTc38K|]}t|dkyw)N)ord).0cs r z#ascii_characters..s,s1v|,s)all)rPs rrsrss ~ ,V, ,,r )FrT)strict)r rr@r six.movesrroutesr Exceptionrrrr4r"rRrUr{objectr}rrrr#rsr r rrs !)i)0_02/2-` F &  Qhg86g8T #B.-r