OwlCyberSecurity - MANAGER
Edit File: util.pyc
� `��ac @` s� d Z d d l m Z m Z d d l Z d d l m Z d d l m Z m Z m Z m Z d d l m Z d d l m Z d d l m Z m Z m Z m Z d d l m Z d � Z d � Z d e j f d � � YZ d e f d � � YZ d e j f d � � YZ d e j f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ! d � Z" d d d d d d d g Z# d S(! s0 An assortment of web server-related utilities. i ( t divisiont absolute_importN( t urlpath( t _PY3t unicodet nativeStringt escape( t fullyQualifiedName( t resource( t TagLoadert XMLStringt Elementt renderer( t flattenStringc C` s d t | � f S( sK Wraps <pre> tags around some text and HTML-escape it. This is here since once twisted.web.html was deprecated it was hard to migrate the html.PRE from current code to twisted.web.template. For new code consider using twisted.web.template. @return: Escaped text wrapped in <pre> tags. @rtype: C{str} s <pre>%s</pre>( R ( t text( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyt _PRE s c C` sn t | t � r t d � � n | j d d � | j | � d i t | � d 6} t rj | j d � } n | S( s� Generate a redirect to the given location. @param URL: A L{bytes} giving the location to which to redirect. @type URL: L{bytes} @param request: The request object to use to generate the redirect. @type request: L{IRequest<twisted.web.iweb.IRequest>} provider @raise TypeError: If the type of C{URL} a L{unicode} instead of L{bytes}. @return: A C{bytes} containing HTML which tries to convince the client agent to visit the new location even if it doesn't respect the I{FOUND} response code. This is intended to be returned from a render method, eg:: def render_GET(self, request): return redirectTo(b"http://example.com/", request) s! Unicode object not allowed as URLs Content-Types text/html; charset=utf-8s� <html> <head> <meta http-equiv="refresh" content="0;URL=%(url)s"> </head> <body bgcolor="#FFFFFF" text="#000000"> <a href="%(url)s">click here</a> </body> </html> t urlt utf8( t isinstanceR t TypeErrort setHeadert redirectR R t encode( t URLt requestt content( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyt redirectTo( s t Redirectc B` s) e Z e Z d � Z d � Z d � Z RS( c C` s t j j | � | | _ d S( N( R t Resourcet __init__R ( t selfR ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR R s c C` s t | j | � S( N( R R ( R R ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyt renderV s c C` s | S( N( ( R t nameR ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyt getChildY s ( t __name__t __module__t Truet isLeafR R R! ( ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR O s t ChildRedirectorc B` s e Z d Z d � Z d � Z RS( i c C` s\ | j d � d k rH | j d � rH | j d � rH t d | � � n t j | | � d S( Ns ://i����s ..t /sv It seems you've given me a redirect (%s) that is a child of myself! That's not good, it'll cause an infinite redirect.( t findt startswitht ValueErrorR R ( R R ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR _ s c C` s9 | j } | j d � s% | d 7} n | | 7} t | � S( NR' ( R t endswithR& ( R R R t newUrl( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR! g s ( R" R# R% R R! ( ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR& ] s t ParentRedirectc B` s& e Z d Z d Z d � Z d � Z RS( s' I redirect to URLPath.here(). i c C` s t t j j | � j � | � S( N( R R t URLPatht fromRequestt here( R R ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR t s c C` s | S( N( ( R R ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR! w s ( R" R# t __doc__R% R R! ( ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR- o s t DeferredResourcec B` sA e Z d Z d Z d � Z d � Z d � Z d � Z d � Z RS( sT I wrap up a Deferred that will eventually result in a Resource object. i c C` s t j j | � | | _ d S( N( R R R t d( R R3 ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR � s c C` s | S( N( ( R R R ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR! � s c C` s9 | j j | j | � j | j | � d d l m } | S( Ni ( t NOT_DONE_YET( R3 t addCallbackt _cbChildt addErrbackt _ebChildt twisted.web.serverR4 ( R R R4 ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR � s c C` s | j t j | | � � d S( N( R R t getChildForRequest( R t childR ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR6 � s c C` s | j | � d S( N( t processingFailed( R t reasonR ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR8 � s ( R" R# R1 R% R R! R R6 R8 ( ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR2 { s t _SourceLineElementc B` s5 e Z d Z d � Z e d � � Z e d � � Z RS( s L{_SourceLineElement} is an L{IRenderable} which can render a single line of source code. @ivar number: A C{int} giving the line number of the source code to be rendered. @ivar source: A C{str} giving the source code to be rendered. c C` s& t j | | � | | _ | | _ d S( N( R R t numbert source( R t loaderR? R@ ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR � s c C` s | | j j d d � � S( sA Render the line of source as a child of C{tag}. s u ( R@ t replace( R R t tag( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyt sourceLine� s c C` s | t | j � � S( s> Render the line number as a child of C{tag}. ( t strR? ( R R RC ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyt lineNumber� s ( R" R# R1 R R RD RF ( ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR> � s t _SourceFragmentElementc B` s/ e Z d Z d � Z d � Z e d � � Z RS( s� L{_SourceFragmentElement} is an L{IRenderable} which can render several lines of source code near the line number of a particular frame object. @ivar frame: A L{Failure<twisted.python.failure.Failure>}-style frame object for which to load a source line to render. This is really a tuple holding some information from a frame object. See L{Failure.frames<twisted.python.failure.Failure>} for specifics. c C` s t j | | � | | _ d S( N( R R t frame( R RA RH ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR � s c c` s] | j d } | j d } x< t | d | d � D]# } | t j | | � j � f Vq2 Wd S( s$ Find the source line references by C{self.frame} and yield, in source line order, it and the previous and following lines. @return: A generator which yields two-tuples. Each tuple gives a source line number and the contents of that source line. i i N( RH t ranget linecachet getlinet rstrip( R t filenameRF t snipLineNumber( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyt _getSourceLines� s c c` sy xr | j � D]d \ } } | j � } | | j d k rA d } n d } t | i | d 6� � } t | | | � Vq Wd S( s� Render the source line indicated by C{self.frame} and several surrounding lines. The active line will be given a I{class} of C{"snippetHighlightLine"}. Other lines will be given a I{class} of C{"snippetLine"}. i t snippetHighlightLinet snippetLinet classN( RO t cloneRH R R> ( R R RC RF RD t newTagt cssClassRA ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyt sourceLines� s ( R" R# R1 R RO R RV ( ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyRG � s t _FrameElementc B` sS e Z d Z d � Z e d � � Z e d � � Z e d � � Z e d � � Z RS( s� L{_FrameElement} is an L{IRenderable} which can render details about one frame from a L{Failure<twisted.python.failure.Failure>}. @ivar frame: A L{Failure<twisted.python.failure.Failure>}-style frame object for which to load a source line to render. This is really a tuple holding some information from a frame object. See L{Failure.frames<twisted.python.failure.Failure>} for specifics. c C` s t j | | � | | _ d S( N( R R RH ( R RA RH ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR � s c C` s | | j d � S( sY Render the name of the file this frame references as a child of C{tag}. i ( RH ( R R RC ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyRM � s c C` s | t | j d � � S( sc Render the source line number this frame references as a child of C{tag}. i ( RE RH ( R R RC ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyRF � s c C` s | | j d � S( sV Render the function name this frame references as a child of C{tag}. i ( RH ( R R RC ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyt function s c C` s t t | � | j � S( sn Render the source code surrounding the line this frame references, replacing C{tag}. ( RG R RH ( R R RC ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR@ s ( R" R# R1 R R RM RF RX R@ ( ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyRW � s t _StackElementc B` s& e Z d Z d � Z e d � � Z RS( sW L{_StackElement} renders an L{IRenderable} which can render a list of frames. c C` s t j | | � | | _ d S( N( R R t stackFrames( R RA RZ ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR s c C` s/ g | j D]! } t t | j � � | � ^ q S( sW Render the list of frames in this L{_StackElement}, replacing C{tag}. ( RZ RW R RS ( R R RC RH ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyt frames# s ( R" R# R1 R R R[ ( ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyRY s t FailureElementc B` sS e Z d Z e d � Z d d � Z e d � � Z e d � � Z e d � � Z RS( s L{FailureElement} is an L{IRenderable} which can render detailed information about a L{Failure<twisted.python.failure.Failure>}. @ivar failure: The L{Failure<twisted.python.failure.Failure>} instance which will be rendered. @since: 12.1 so <div xmlns:t="http://twistedmatrix.com/ns/twisted.web.template/0.1"> <style type="text/css"> div.error { color: red; font-family: Verdana, Arial, helvetica, sans-serif; font-weight: bold; } div { font-family: Verdana, Arial, helvetica, sans-serif; } div.stackTrace { } div.frame { padding: 1em; background: white; border-bottom: thin black dashed; } div.frame:first-child { padding: 1em; background: white; border-top: thin black dashed; border-bottom: thin black dashed; } div.location { } span.function { font-weight: bold; font-family: "Courier New", courier, monospace; } div.snippet { margin-bottom: 0.5em; margin-left: 1em; background: #FFFFDD; } div.snippetHighlightLine { color: red; } span.code { font-family: "Courier New", courier, monospace; } </style> <div class="error"> <span t:render="type" />: <span t:render="value" /> </div> <div class="stackTrace" t:render="traceback"> <div class="frame" t:render="frames"> <div class="location"> <span t:render="filename" />:<span t:render="lineNumber" /> in <span class="function" t:render="function" /> </div> <div class="snippet" t:render="source"> <div t:render="sourceLines"> <span class="lineno" t:render="lineNumber" /> <code class="code" t:render="sourceLine" /> </div> </div> </div> </div> <div class="error"> <span t:render="type" />: <span t:render="value" /> </div> </div> c C` s t j | | � | | _ d S( N( R R t failure( R R] RA ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR � s c C` s | t | j j � � S( sA Render the exception type as a child of C{tag}. ( R R] t type( R R RC ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR^ � s c C` s | t | j j � j d � � S( sB Render the exception value as a child of C{tag}. R ( R R] t valueR ( R R RC ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR_ � s c C` s t t | � | j j � S( s� Render all the frames in the wrapped L{Failure<twisted.python.failure.Failure>}'s traceback stack, replacing C{tag}. ( RY R R] R[ ( R R RC ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyt traceback� s N( R" R# R1 R RA t NoneR R R^ R_ R` ( ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyR\ / s I c C` sg g } t d t | � � j | j � t | d t � rU | d j d � j d d � S| d j � d S( s Construct an HTML representation of the given failure. Consider using L{FailureElement} instead. @type myFailure: L{Failure<twisted.python.failure.Failure>} @rtype: C{bytes} @return: A string containing the HTML representation of the given failure. i s utf-8t asciit xmlcharrefreplaceN( R Ra R\ t addBotht appendR t bytest decodeR t raiseException( t myFailuret result( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyt formatFailure� s R Rk ($ R1 t __future__R R RJ t twisted.pythonR t twisted.python.compatR R R R t twisted.python.reflectR t twisted.webR t twisted.web.templateR R R R R R R R R R& R- R2 R> RG RW RY R\ Rk t __all__( ( ( sS /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/web/util.pyt <module> s, "" ' 12u