OwlCyberSecurity - MANAGER
Edit File: resource.pyc
� �t�ac @ s� d Z d d l m Z d d l m Z m Z d d l m Z m Z m Z m Z d d l m Z 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 e f d � � YZ d d d d d g Z d S( sG I hold the lowest-level L{Resource} class and related mix-in classes. i����( t implements( t inlineCallbackst returnValue( t iwebt httpt servert responsecode( t maybeDeferredt RenderMixinc B s\ e Z d Z d � Z d � Z e d � � Z d � Z d � Z d � Z d � Z d � Z RS( so Mix-in class for L{iweb.IResource} which provides a dispatch mechanism for handling HTTP methods. c s> t � d � s7 t � f d � t � � D� � � _ n � j S( so @return: A tuple of HTTP methods that are allowed to be invoked on this resource. t _allowed_methodsc 3 s= | ]3 } | j d � r t � | � d k r | d Vq d S( t http_i N( t startswitht getattrt None( t .0t name( t self( s" /opt/cpanel-ccs/txweb2/resource.pys <genexpr>5 s ( t hasattrt tuplet dirR ( R ( ( R s" /opt/cpanel-ccs/txweb2/resource.pyt allowedMethods. s %c C sL | j d k r t j | � n t | d | j d � } | rH | | � Sd S( s Checks all preconditions imposed by this resource upon a request made against it. @param request: the request to process. @raise http.HTTPError: if any precondition fails. @return: C{None} or a deferred whose callback value is C{request}. t GETt HEADt preconditions_N( R R ( t methodR t checkPreconditionsR R ( R t requestR ( ( s" /opt/cpanel-ccs/txweb2/resource.pyR : s c c s� t | d | j d � } | d k r] t j t j � } | j j d | j � � t | � n | j | � Vt | | � } | j | j � t | V� d S( s� See L{iweb.IResource.renderHTTP}. This implementation will dispatch the given C{request} to another method of C{self} named C{http_}METHOD, where METHOD is the HTTP method used by C{request} (eg. C{http_GET}, C{http_POST}, etc.). Generally, a subclass should implement those methods instead of overriding this one. C{http_*} methods are expected provide the same interface and return the same results as L{iweb.IResource}C{.renderHTTP} (and therefore this method). C{etag} and C{last-modified} are added to the response returned by the C{http_*} header, if known. If an appropriate C{http_*} method is not found, a L{responsecode.NOT_ALLOWED}-status response is returned, with an appropriate C{allow} header. @param request: the request to process. @return: an object adaptable to L{iweb.IResponse}. R t allowN( R R R R t ResponseR t NOT_ALLOWEDt headerst setHeaderR R R R t addErrbackt methodRaisedException( R R R t responset result( ( s" /opt/cpanel-ccs/txweb2/resource.pyt renderHTTPU s c C s | S( s� An C{http_METHOD} method raised an exception; this is an errback for that exception. By default, simply propagate the error up; subclasses may override this for top-level exception handling. ( ( R t failure( ( s" /opt/cpanel-ccs/txweb2/resource.pyR! z s c C s/ t j t j � } | j j d | j � � | S( s� Respond to a OPTIONS request. @param request: the request to process. @return: an object adaptable to L{iweb.IResponse}. R ( R R R t OKR R R ( R R R" ( ( s" /opt/cpanel-ccs/txweb2/resource.pyt http_OPTIONS� s c C s | j | � S( s� Respond to a HEAD request. @param request: the request to process. @return: an object adaptable to L{iweb.IResponse}. ( t http_GET( R R ( ( s" /opt/cpanel-ccs/txweb2/resource.pyt http_HEAD� s c C s& | j j d k r t j S| j | � S( s3 Respond to a GET request. This implementation validates that the request body is empty and then dispatches the given C{request} to L{render} and returns its result. @param request: the request to process. @return: an object adaptable to L{iweb.IResponse}. i ( t streamt lengthR t REQUEST_ENTITY_TOO_LARGEt render( R R ( ( s" /opt/cpanel-ccs/txweb2/resource.pyR( � s c C s t d � � d S( s� Subclasses should implement this method to do page rendering. See L{http_GET}. @param request: the request to process. @return: an object adaptable to L{iweb.IResponse}. s& Subclass must implement render method.N( t NotImplementedError( R R ( ( s" /opt/cpanel-ccs/txweb2/resource.pyR- � s ( t __name__t __module__t __doc__R R R R$ R! R' R) R( R- ( ( ( s" /opt/cpanel-ccs/txweb2/resource.pyR ( s % t Resourcec B sN e Z d Z e e j � e Z d � Z d � Z d � Z d � Z d � Z RS( sh An L{iweb.IResource} implementation with some convenient mechanisms for locating children. c C s� | j | d � } | rS t j | d � } | r? | | d f S| | � | d f St | d d � } | d k r� | | | d � } | r� | | d f Sn d g f S( so Locates a child resource of this resource. @param request: the request to process. @param segments: a sequence of URL path segments. @return: a tuple of C{(child, segments)} containing the child of this resource which matches one or more of the given C{segments} in sequence, and a list of remaining segments. i i t childFactoryN( t getChildR t IResourceR R ( R R t segmentst wt rt factory( ( s" /opt/cpanel-ccs/txweb2/resource.pyt locateChild� s c C s& | j r" t | j � d k r" | Sd S( s� This method locates a child with a trailing C{"/"} in the URL. @param request: the request to process. i N( t addSlasht lent postpathR ( R R ( ( s" /opt/cpanel-ccs/txweb2/resource.pyt child_� s c C s t | d | f d � S( s� Get a static child - when registered using L{putChild}. @param path: the name of the child to get @type path: C{str} @return: the child or C{None} if not present @rtype: L{iweb.IResource} s child_%sN( R R ( R t path( ( s" /opt/cpanel-ccs/txweb2/resource.pyR4 � s c C s t | d | f | � d S( s Register a static child. This implementation registers children by assigning them to attributes with a C{child_} prefix. C{resource.putChild("foo", child)} is therefore same as C{o.child_foo = child}. @param path: the name of the child to register. You almost certainly don't want C{"/"} in C{path}. If you want to add a "directory" resource (e.g. C{/foo/}) specify C{path} as C{""}. @param child: an object adaptable to L{iweb.IResource}. s child_%sN( t setattr( R R? t child( ( s" /opt/cpanel-ccs/txweb2/resource.pyt putChild� s c C sR | j r< | j d d k r< t j | j d | j d � � St t | � j | � S( Ni����t R? t /( R; t prepathR t RedirectResponset unparseURLR? t superR2 R( ( R R ( ( s" /opt/cpanel-ccs/txweb2/resource.pyR( � s ( R/ R0 R1 R R R5 t FalseR; R: R> R4 RB R( ( ( ( s" /opt/cpanel-ccs/txweb2/resource.pyR2 � s t PostableResourcec B s) e Z d Z d Z d Z d Z d � Z RS( sQ A L{Resource} capable of handling the POST request method. @cvar maxMem: maximum memory used during the parsing of the data. @type maxMem: C{int} @cvar maxFields: maximum number of form fields allowed. @type maxFields: C{int} @cvar maxSize: maximum size of the whole post allowed. @type maxSize: C{int} id i i c s4 t j � � j � j � j � j � � f d � � S( s� Respond to a POST request. Reads and parses the incoming body data then calls L{render}. @param request: the request to process. @return: an object adaptable to L{iweb.IResponse}. c s � j � � S( N( R- ( t res( R R ( s" /opt/cpanel-ccs/txweb2/resource.pyt <lambda> RC ( R t parsePOSTDatat maxMemt maxFieldst maxSizet addCallback( R R ( ( R R s" /opt/cpanel-ccs/txweb2/resource.pyt http_POST s i � i ( i � ( R/ R0 R1 RN RO RP RR ( ( ( s" /opt/cpanel-ccs/txweb2/resource.pyRJ s t LeafResourcec B s$ e Z d Z e e j � d � Z RS( s) A L{Resource} with no children. c C s | t j f S( N( R t StopTraversal( R R R6 ( ( s" /opt/cpanel-ccs/txweb2/resource.pyR: ' s ( R/ R0 R1 R R R5 R: ( ( ( s" /opt/cpanel-ccs/txweb2/resource.pyRS ! s t RedirectResourcec B s- e Z d Z e e j � d � Z d � Z RS( s= A L{LeafResource} which always performs a redirect. c O s | | _ | | _ d S( s� Parameters are URL components and are the same as those for L{urlparse.urlunparse}. URL components which are not specified will default to the corresponding component of the URL of the request being redirected. N( t _argst _kwargs( R t argst kwargs( ( s" /opt/cpanel-ccs/txweb2/resource.pyt __init__1 s c C s t j | j | j | j � � S( N( R RF RG RV RW ( R R ( ( s" /opt/cpanel-ccs/txweb2/resource.pyR$ ; s ( R/ R0 R1 R R R5 RZ R$ ( ( ( s" /opt/cpanel-ccs/txweb2/resource.pyRU + s t WrapperResourcec B sH e Z d Z e e j � d � Z d � Z d � Z d � Z d � Z RS( s� An L{iweb.IResource} implementation which wraps a L{RenderMixin} instance and provides a hook in which a subclass can implement logic that is called before request processing on the contained L{Resource}. c C s | | _ d S( N( t resource( R R\ ( ( s" /opt/cpanel-ccs/txweb2/resource.pyRZ I s c C s t � � d S( sp Override this method in order to do something before passing control on to the wrapped resource's C{renderHTTP} and C{locateChild} methods. @return: None or a L{Deferred}. If a deferred object is returned, it's value is ignored, but C{renderHTTP} and C{locateChild} are chained onto the deferred as callbacks. N( R. ( R R ( ( s" /opt/cpanel-ccs/txweb2/resource.pyt hookL s c sA � j | � } | d k r4 | j � � f d � � S� j � f S( Nc s � j � f S( N( R\ ( t data( R6 R ( s" /opt/cpanel-ccs/txweb2/resource.pyRL Y RC ( R] R RQ R\ ( R R R6 t x( ( R6 R s" /opt/cpanel-ccs/txweb2/resource.pyR: V s c s8 � j | � } | d k r1 | j � f d � � S� j S( Nc s � j S( N( R\ ( R^ ( R ( s" /opt/cpanel-ccs/txweb2/resource.pyRL _ RC ( R] R RQ R\ ( R R R_ ( ( R s" /opt/cpanel-ccs/txweb2/resource.pyR$ \ s c C s | j j | � S( N( R\ R4 ( R R ( ( s" /opt/cpanel-ccs/txweb2/resource.pyR4 b s ( R/ R0 R1 R R R5 RZ R] R: R$ R4 ( ( ( s" /opt/cpanel-ccs/txweb2/resource.pyR[ A s N( R1 t zope.interfaceR t twisted.internet.deferR R t txweb2R R R R R t objectR R2 RJ RS RU R[ t __all__( ( ( s" /opt/cpanel-ccs/txweb2/resource.pyt <module> s "�P &