Файловый менеджер - Редактировать - /opt/imh-python/lib/python3.9/site-packages/tornado/__pycache__/routing.cpython-39.pyc
Ðазад
a _�h�c � @ s d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z m Z m Z ddl m Z ddlmZmZmZmZ dd lmZmZmZmZmZmZmZmZm Z G d d � d ej �Z G d d � d e �Z G dd� dej �Z!G dd� dej �Z"eedee eee#df ef eee#df eee#ef f eee#df eee#ef e#f f Z$G dd� de �Z%G dd� de e%�Z&G dd� de'�Z(G dd� de'�Z)G dd� de)�Z*G d d � d e)�Z+G d d � d e)�Z,G d d!� d!e)�Z-G d"d#� d#e(�Z.e e#e/d$�d%d&��Z0e ddd$�d'd&��Z0ee# ee/ d$�d(d&�Z0dS ))aq Flexible routing implementation. Tornado routes HTTP requests to appropriate handlers using `Router` class implementations. The `tornado.web.Application` class is a `Router` implementation and may be used directly, or the classes in this module may be used for additional flexibility. The `RuleRouter` class can match on more criteria than `.Application`, or the `Router` interface can be subclassed for maximum customization. `Router` interface extends `~.httputil.HTTPServerConnectionDelegate` to provide additional routing capabilities. This also means that any `Router` implementation can be used directly as a ``request_callback`` for `~.httpserver.HTTPServer` constructor. `Router` subclass must implement a ``find_handler`` method to provide a suitable `~.httputil.HTTPMessageDelegate` instance to handle the request: .. code-block:: python class CustomRouter(Router): def find_handler(self, request, **kwargs): # some routing logic providing a suitable HTTPMessageDelegate instance return MessageDelegate(request.connection) class MessageDelegate(HTTPMessageDelegate): def __init__(self, connection): self.connection = connection def finish(self): self.connection.write_headers( ResponseStartLine("HTTP/1.1", 200, "OK"), HTTPHeaders({"Content-Length": "2"}), b"OK") self.connection.finish() router = CustomRouter() server = HTTPServer(router) The main responsibility of `Router` implementation is to provide a mapping from a request to `~.httputil.HTTPMessageDelegate` instance that will handle this request. In the example above we can see that routing is possible even without instantiating an `~.web.Application`. For routing to `~.web.RequestHandler` implementations we need an `~.web.Application` instance. `~.web.Application.get_handler_delegate` provides a convenient way to create `~.httputil.HTTPMessageDelegate` for a given request and `~.web.RequestHandler`. Here is a simple example of how we can we route to `~.web.RequestHandler` subclasses by HTTP method: .. code-block:: python resources = {} class GetResource(RequestHandler): def get(self, path): if path not in resources: raise HTTPError(404) self.finish(resources[path]) class PostResource(RequestHandler): def post(self, path): resources[path] = self.request.body class HTTPMethodRouter(Router): def __init__(self, app): self.app = app def find_handler(self, request, **kwargs): handler = GetResource if request.method == "GET" else PostResource return self.app.get_handler_delegate(request, handler, path_args=[request.path]) router = HTTPMethodRouter(Application()) server = HTTPServer(router) `ReversibleRouter` interface adds the ability to distinguish between the routes and reverse them to the original urls using route's name and additional arguments. `~.web.Application` is itself an implementation of `ReversibleRouter` class. `RuleRouter` and `ReversibleRuleRouter` are implementations of `Router` and `ReversibleRouter` interfaces and can be used for creating rule-based routing configurations. Rules are instances of `Rule` class. They contain a `Matcher`, which provides the logic for determining whether the rule is a match for a particular request and a target, which can be one of the following. 1) An instance of `~.httputil.HTTPServerConnectionDelegate`: .. code-block:: python router = RuleRouter([ Rule(PathMatches("/handler"), ConnectionDelegate()), # ... more rules ]) class ConnectionDelegate(HTTPServerConnectionDelegate): def start_request(self, server_conn, request_conn): return MessageDelegate(request_conn) 2) A callable accepting a single argument of `~.httputil.HTTPServerRequest` type: .. code-block:: python router = RuleRouter([ Rule(PathMatches("/callable"), request_callable) ]) def request_callable(request): request.write(b"HTTP/1.1 200 OK\r\nContent-Length: 2\r\n\r\nOK") request.finish() 3) Another `Router` instance: .. code-block:: python router = RuleRouter([ Rule(PathMatches("/router.*"), CustomRouter()) ]) Of course a nested `RuleRouter` or a `~.web.Application` is allowed: .. code-block:: python router = RuleRouter([ Rule(HostMatches("example.com"), RuleRouter([ Rule(PathMatches("/app1/.*"), Application([(r"/app1/handler", Handler)]))), ])) ]) server = HTTPServer(router) In the example below `RuleRouter` is used to route between applications: .. code-block:: python app1 = Application([ (r"/app1/handler", Handler1), # other handlers ... ]) app2 = Application([ (r"/app2/handler", Handler2), # other handlers ... ]) router = RuleRouter([ Rule(PathMatches("/app1.*"), app1), Rule(PathMatches("/app2.*"), app2) ]) server = HTTPServer(router) For more information on application-level routing see docs for `~.web.Application`. .. versionadded:: 4.5 � N)�partial)�httputil)�_CallableAdapter)� url_escape� url_unescape�utf8)�app_log)�basestring_type� import_object� re_unescape� unicode_type) �Any�Union�Optional� Awaitable�List�Dict�Pattern�Tuple�overloadc @ s@ e Zd ZdZejeeej d�dd�Z e ej ejd�dd�Z dS ) �RouterzAbstract router interface.��request�kwargs�returnc K s t � �dS )a� Must be implemented to return an appropriate instance of `~.httputil.HTTPMessageDelegate` that can serve the request. Routing implementations may pass additional kwargs to extend the routing logic. :arg httputil.HTTPServerRequest request: current HTTP request. :arg kwargs: additional keyword arguments passed by routing implementation. :returns: an instance of `~.httputil.HTTPMessageDelegate` that will be used to process the request. N��NotImplementedError)�selfr r � r �/root/rpmbuild/BUILDROOT/imh-python39-modules-3.9.7-92.el8.x86_64/opt/imh-python/lib/python3.9/site-packages/tornado/routing.py� find_handler� s zRouter.find_handler)� server_conn� request_connr c C s t | ||�S �N)�_RoutingDelegate)r r! r" r r r � start_request� s zRouter.start_requestN) �__name__� __module__� __qualname__�__doc__r �HTTPServerRequestr r �HTTPMessageDelegater �object�HTTPConnectionr% r r r r r � s � �r c @ s& e Zd ZdZeeee d�dd�ZdS )�ReversibleRouterzxAbstract router interface for routers that can handle named routes and support reversing them to original urls. ��name�argsr c G s t � �dS )a Returns url string for a given route name and arguments or ``None`` if no match is found. :arg str name: route name. :arg args: url parameters. :returns: parametrized url string for a given route name (or ``None``). Nr )r r0 r1 r r r � reverse_url� s z ReversibleRouter.reverse_urlN)r& r' r( r) �strr r r2 r r r r r. � s r. c @ s~ e Zd Zeeejdd�dd�Zeej ej f ej e e d d�dd�Zee e d d�d d �Zdd �d d �Zdd �dd�ZdS )r$ N)�routerr! r" r c C s || _ || _d | _|| _d S r# )r! r" �delegater4 )r r4 r! r" r r r �__init__� s z_RoutingDelegate.__init__)� start_line�headersr c C sj t |tj�sJ �tj| j| j||d�}| j�|�| _| jd u r\t � d|j |j � t | j�| _| j�||�S )N)� connection�server_connectionr7 r8 z$Delegate for %s %s request not found)� isinstancer �RequestStartLiner* r" r! r4 r r5 r �debug�method�path�_DefaultMessageDelegate�headers_received)r r7 r8 r r r r rA � s � � z!_RoutingDelegate.headers_received)�chunkr c C s | j d usJ �| j �|�S r# )r5 � data_received)r rB r r r rC s z _RoutingDelegate.data_received�r c C s | j d usJ �| j �� d S r# )r5 �finish�r r r r rE s z_RoutingDelegate.finishc C s | j d usJ �| j �� d S r# )r5 �on_connection_closerF r r r rG s z$_RoutingDelegate.on_connection_close)r& r' r( r r, r r- r6 r r< �ResponseStartLine� HTTPHeadersr r rA �bytesrC rE rG r r r r r$ � s � � r$ c @ s, e Zd Zejdd�dd�Zdd�dd�ZdS )r@ N)r9 r c C s || _ d S r# )r9 )r r9 r r r r6 s z _DefaultMessageDelegate.__init__rD c C s* | j �t�ddd�t�� � | j �� d S )NzHTTP/1.1i� z Not Found)r9 Z write_headersr rH rI rE rF r r r rE s �z _DefaultMessageDelegate.finish)r& r' r( r r- r6 rE r r r r r@ s r@ �Rule�Matcherc @ sx e Zd ZdZdedd�dd�Zedd�dd�Zddd �d d �Zej e e ej d �d d�Z e ej e e ej d�dd�ZdS )� RuleRouterz!Rule-based router implementation.N��rulesr c C s g | _ |r| �|� dS )aI Constructs a router from an ordered list of rules:: RuleRouter([ Rule(PathMatches("/handler"), Target), # ... more rules ]) You can also omit explicit `Rule` constructor and use tuples of arguments:: RuleRouter([ (PathMatches("/handler"), Target), ]) `PathMatches` is a default matcher, so the example above can be simplified:: RuleRouter([ ("/handler", Target), ]) In the examples above, ``Target`` can be a nested `Router` instance, an instance of `~.httputil.HTTPServerConnectionDelegate` or an old-style callable, accepting a request argument. :arg rules: a list of `Rule` instances or tuples of `Rule` constructor arguments. N)rO � add_rules�r rO r r r r6 / s zRuleRouter.__init__c C sv |D ]l}t |ttf�r^t|�dv s&J �t |d t�rVtt|d �g|dd� �R � }nt|� }| j�| � |�� qdS )z�Appends new rules to the router. :arg rules: a list of Rule instances (or tuples of arguments, which are passed to Rule constructor). )� � � r � N) r; �tuple�list�lenr rK � PathMatchesrO �append� process_rule)r rO �ruler r r rP N s "zRuleRouter.add_rulesrK �r\ r c C s |S )z�Override this method for additional preprocessing of each rule. :arg Rule rule: a rule to be processed. :returns: the same or modified Rule instance. r �r r\ r r r r[ ^ s zRuleRouter.process_ruler c K sZ | j D ]N}|j�|�}|d ur|jr.|j|d< | j|j|fi |��}|d ur| S qd S )N� target_kwargs)rO �matcher�matchr_ �get_target_delegate�target)r r r r\ � target_paramsr5 r r r r f s �� zRuleRouter.find_handler)rc r rd r c K sx t |t�r |j|fi |��S t |tj�rF|jdus6J �|�|j|j�S t|�rt|jdus\J �t t |fi |��|j�S dS )a� Returns an instance of `~.httputil.HTTPMessageDelegate` for a Rule's target. This method is called by `~.find_handler` and can be extended to provide additional target types. :arg target: a Rule's target. :arg httputil.HTTPServerRequest request: current request. :arg target_params: additional parameters that can be useful for `~.httputil.HTTPMessageDelegate` creation. N) r; r r r � HTTPServerConnectionDelegater9 r% r: �callabler r )r rc r rd r r r rb x s �z RuleRouter.get_target_delegate)N)r& r' r( r) � _RuleListr6 rP r[ r r* r r r+ r rb r r r r rM , s � �rM c sT e Zd ZdZd edd�� fdd� Zddd�� fdd � Zeee e d �d d �Z � Z S )�ReversibleRuleRoutera A rule-based router that implements ``reverse_url`` method. Each rule added to this router may have a ``name`` attribute that can be used to reconstruct an original uri. The actual reconstruction takes place in a rule's matcher (see `Matcher.reverse`). NrN c s i | _ tt| ��|� d S r# )� named_rules�superrh r6 rQ �� __class__r r r6 � s z ReversibleRuleRouter.__init__rK r] c s@ t t| ��|�}|jr<|j| jv r0t�d|j� || j|j< |S )Nz4Multiple handlers named %s; replacing previous value)rj rh r[ r0 ri r �warningr^ rk r r r[ � s � z!ReversibleRuleRouter.process_ruler/ c G s\ || j v r | j | jj|� S | jD ]4}t|jt�r"|jj|g|�R � }|d ur"| S q"d S r# )ri r` �reverserO r; rc r. r2 )r r0 r1 r\ Z reversed_urlr r r r2 � s z ReversibleRuleRouter.reverse_url)N) r& r' r( r) rg r6 r[ r3 r r r2 � __classcell__r r rk r rh � s rh c @ sR e Zd ZdZd deeeef edd�dd�Zeee d�dd �Z ed �d d �Z dS )rK zA routing rule.NrL )r` rc r_ r0 r c C s6 t |t�rt|�}|| _|| _|r&|ni | _|| _dS )ad Constructs a Rule instance. :arg Matcher matcher: a `Matcher` instance used for determining whether the rule should be considered a match for a specific request. :arg target: a Rule's target (typically a ``RequestHandler`` or `~.httputil.HTTPServerConnectionDelegate` subclass or even a nested `Router`, depending on routing implementation). :arg dict target_kwargs: a dict of parameters that can be useful at the moment of target instantiation (for example, ``status_code`` for a ``RequestHandler`` subclass). They end up in ``target_params['target_kwargs']`` of `RuleRouter.get_target_delegate` method. :arg str name: the name of the rule that can be used to find it in `ReversibleRouter.reverse_url` implementation. N)r; r3 r r` rc r_ r0 )r r` rc r_ r0 r r r r6 � s z Rule.__init__�r1 r c G s | j j|� S r# )r` rn �r r1 r r r rn � s z Rule.reverserD c C s d| j j| j| j| j| jf S �Nz %s(%r, %s, kwargs=%r, name=%r))rl r& r` rc r_ r0 rF r r r �__repr__� s �z Rule.__repr__)NN) r& r' r( r) r r r3 r6 r rn rs r r r r rK � s � � !c @ sB e Zd ZdZejeeee f d�dd�Z e ee d�dd�Z dS ) rL z*Represents a matcher for request features.�r r c C s t � �dS )a1 Matches current instance against the request. :arg httputil.HTTPServerRequest request: current HTTP request :returns: a dict of parameters to be passed to the target handler (for example, ``handler_kwargs``, ``path_args``, ``path_kwargs`` can be passed for proper `~.web.RequestHandler` instantiation). An empty dict is a valid (and common) return value to indicate a match when the argument-passing features are not used. ``None`` must be returned to indicate that there is no match.Nr �r r r r r ra � s z Matcher.matchrp c G s dS )zEReconstructs full url from matcher instance and additional arguments.Nr rq r r r rn � s zMatcher.reverseN) r& r' r( r) r r* r r r3 r ra rn r r r r rL � s c @ s. e Zd ZdZejeeee f d�dd�Z dS )� AnyMatcheszMatches any request.rt c C s i S r# r ru r r r ra s zAnyMatches.matchN) r& r' r( r) r r* r r r3 r ra r r r r rv � s rv c @ sF e Zd ZdZeeef dd�dd�Zej e e ee f d�dd�Z dS ) � HostMatchesz@Matches requests from hosts specified by ``host_pattern`` regex.N)� host_patternr c C s4 t |t�r*|�d�s |d7 }t�|�| _n|| _d S )N�$)r; r �endswith�re�compilerx )r rx r r r r6 s zHostMatches.__init__rt c C s | j �|j�ri S d S r# )rx ra Z host_nameru r r r ra s zHostMatches.match)r& r' r( r) r r3 r r6 r r* r r r ra r r r r rw s rw c @ s@ e Zd ZdZeedd�dd�Zeje e e ef d�dd�Z dS ) �DefaultHostMatchesz�Matches requests from host that is equal to application's default_host. Always returns no match if ``X-Real-Ip`` header is present. N)� applicationrx r c C s || _ || _d S r# )r~ rx )r r~ rx r r r r6 s zDefaultHostMatches.__init__rt c C s" d|j vr | j�| jj�r i S d S )Nz X-Real-Ip)r8 rx ra r~ Z default_hostru r r r ra s zDefaultHostMatches.match) r& r' r( r) r r r6 r r* r r r3 ra r r r r r} s r} c @ sx e Zd ZdZeeef dd�dd�Zej e e ee f d�dd�Z e e e d �d d �Zee e e e f d �d d�ZdS )rY z@Matches requests with paths specified by ``path_pattern`` regex.N)� path_patternr c C sl t |t�r*|�d�s |d7 }t�|�| _n|| _t| jj�d| jjfv sXJ d| jj ��| � � \| _ | _ d S )Nry r zDgroups in url regexes must either be all named or all positional: %r) r; r rz r{ r| �regexrX � groupindex�groups�pattern� _find_groups�_path� _group_count)r r r r r r6 + s ��zPathMatches.__init__rt c C sp | j �|j�}|d u rd S | j js&i S g }i }| j jrRtdd� |�� �� D ��}ndd� |�� D �}t||d�S )Nc s s" | ]\}}t |�t|�fV qd S r# )r3 �_unquote_or_none)�.0�k�vr r r � <genexpr>I s z$PathMatches.match.<locals>.<genexpr>c S s g | ] }t |��qS r )r� )r� �sr r r � <listcomp>M � z%PathMatches.match.<locals>.<listcomp>)� path_args� path_kwargs)r� ra r? r� r� �dict� groupdict�items)r r ra r� r� r r r ra : s � zPathMatches.matchrp c G s� | j d u rtd| jj ��t|�| jks0J d��t|�s>| j S g }|D ]0}t|ttf�s`t |�}|� t t |�dd�� qF| j t |� S )NzCannot reverse url regex z&required number of arguments not foundF)�plus)r� � ValueErrorr� r� rX r� r; r rJ r3 rZ r r rV )r r1 Zconverted_args�ar r r rn Q s �zPathMatches.reverserD c C s� | j j}|�d�r |dd� }|�d�r4|dd� }| j j|�d�krJdS g }|�d�D ]h}d|v r�|�d�}|d kr�|�d ||d d� � qXz t |�}W n t y� Y dS 0 |�|� qXd � |�| j jfS ) z�Returns a tuple (reverse string, group count) for a url. For example: Given the url pattern /([0-9]{4})/([a-z-]+)/, this method would return ('/%s/%s/', 2). �^rU Nry ����()NN�)r z%s� ) r� r� � startswithrz r� �count�split�indexrZ r r� �join)r r� �pieces�fragmentZ paren_locZunescaped_fragmentr r r r� ` s& zPathMatches._find_groups)r& r' r( r) r r3 r r6 r r* r r r ra rn r �intr� r r r r rY ( s rY c sN e Zd ZdZd eeef eeeef edd�� fdd� Z ed�dd�Z � Z S ) �URLSpecz�Specifies mappings between URLs and handlers. .. versionchanged: 4.5 `URLSpec` is now a subclass of a `Rule` with `PathMatches` matcher and is preserved for backwards compatibility. N)r� �handlerr r0 r c s8 t |�}tt| ��||||� |j| _| j| _|| _dS )a� Parameters: * ``pattern``: Regular expression to be matched. Any capturing groups in the regex will be passed in to the handler's get/post/etc methods as arguments (by keyword if named, by position if unnamed. Named and unnamed capturing groups may not be mixed in the same rule). * ``handler``: `~.web.RequestHandler` subclass to be invoked. * ``kwargs`` (optional): A dictionary of additional arguments to be passed to the handler's constructor. * ``name`` (optional): A name for this handler. Used by `~.web.Application.reverse_url`. N)rY rj r� r6 r� rc � handler_classr )r r� r� r r0 r` rk r r r6 � s zURLSpec.__init__rD c C s d| j j| jj| j| j| jf S rr )rl r& r� r� r� r r0 rF r r r rs � s �zURLSpec.__repr__)NN) r& r' r( r) r r3 r r r r6 rs ro r r rk r r� � s � � r� )r� r c C s d S r# r �r� r r r r� � s r� c C s d S r# r r� r r r r� � s c C s | du r | S t | ddd�S )z�None-safe wrapper around url_unescape to handle unmatched optional groups correctly. Note that args are passed as bytes so the handler can decide what encoding to use. NF)�encodingr� )r r� r r r r� � s )1r) r{ � functoolsr �tornador Ztornado.httpserverr Ztornado.escaper r r Z tornado.logr Z tornado.utilr r r r �typingr r r r r r r r r re r r. r+ r$ r@ r3 rg rM rh r, rK rL rv rw r} rY r� rJ r� r r r r �<module> sJ $ ,. ��� h%1[1
| ver. 1.1 | |
.
| PHP 8.3.30 | Ð“ÐµÐ½ÐµÑ€Ð°Ñ†Ð¸Ñ Ñтраницы: 0 |
proxy
|
phpinfo
|
ÐаÑтройка