/usr/local/lib64/python3.6/site-packages/flask/__pycache__
Edit: /usr/local/lib64/python3.6/site-packages/flask/__pycache__/blueprints.cpython-36.pyc (21895B)
3
^TBg\ @ s d dl Z d dlZd dlmZ d dlmZ ddlmZ ddlm Z ddlm
Z
ddlm Z dd lm Z dd
lm
Z
dd lmZ dd lmZ dd
lmZ ddlmZ ddlmZ ddlmZ ddlmZ ejrddlmZ ddlmZ ejdgejf ZG dd dZG dd de
Z dS ) N) defaultdict)update_wrapper )_endpoint_from_view_func) _sentinel)Scaffold)AfterRequestCallable)BeforeFirstRequestCallable)BeforeRequestCallable)TeardownCallable) TemplateContextProcessorCallable)TemplateFilterCallable)TemplateGlobalCallable)TemplateTestCallable)URLDefaultCallable) URLValuePreprocessorCallable)Flask)ErrorHandlerCallableBlueprintSetupStatec @ sP e Zd ZdZddejeddddZd eej e ej ej
ejddd d
Z dS ) r zTemporary holder object for registering a blueprint with the
application. An instance of this class is created by the
:meth:`~flask.Blueprint.make_setup_state` method and later passed
to all register callback functions.
Blueprintr N) blueprintappoptionsfirst_registrationreturnc C s || _ || _|| _|| _| jjd}|d kr4| jj}|| _| jjd}|d krV| jj}|| _| jjd|j| _| jjdd| _t | jj
| _ | j j | jjdf d S )N subdomain
url_prefixname name_prefix url_defaults)
r r r r getr r r r dicturl_values_defaultsr update)selfr r r r r r r& 1/tmp/pip-build-0s3hx122/flask/flask/blueprints.py__init__" s z BlueprintSetupState.__init__)ruleendpoint view_funcr r c K s | j dk r2|r,dj| j jd|jdf}n| j }|jd| j |dkrPt|}| j}d|krpt|f|j d}| j
j || j d| j
d| jd|fd|i| dS )zA helper method to register a rule (and optionally a view function)
to the application. The endpoint is automatically prefixed with the
blueprint's name.
N/r defaults.)r joinrstriplstrip
setdefaultr r r r" popr add_url_ruler r )r% r) r* r+ r r- r& r& r' r4 P s
z BlueprintSetupState.add_url_rule)NN) __name__
__module__ __qualname____doc__tAnyboolr( strOptionalCallabler4 r& r& r& r' r s + c s e Zd ZdZdZdZdZdZdddddddefe e e
j e
j e e
jf e
j e e
j e e
j e e
j e e
j e e
j e e
j e d
fdd
Zeddd Ze
jdd
d d Ze
jdd
d
dZd
e
j e e
je ge f d d d Z d?e e
j e dd d d!Z d@e
j e e
je ge f d d"d#Z dAe e
j e dd d$d%Z!dBe
j e e
je"ge"f d d&d'Z#dCe"e
j e dd d(d)Z$e%e%d*d+d,Z&e'e'd*d-d.Z(e)e)d*d/d0Z*e+e+d*d1d2Z,e-e-d*d3d4Z.e
j e
j/e0 e1f e
jd5d6d7Z2e3e3d*d8d9Z4e5e5d*d:d;Z6 Z7S )Dr a Represents a blueprint, a collection of routes and other
app-related functions that can be registered on a real application
later.
A blueprint is an object that allows defining application functions
without requiring an application object ahead of time. It uses the
same decorators as :class:`~flask.Flask`, but defers the need for an
application by recording them for later registration.
Decorating a function with a blueprint creates a deferred function
that is called with :class:`~flask.blueprints.BlueprintSetupState`
when the blueprint is registered on an application.
See :doc:`/blueprints` for more information.
:param name: The name of the blueprint. Will be prepended to each
endpoint name.
:param import_name: The name of the blueprint package, usually
``__name__``. This helps locate the ``root_path`` for the
blueprint.
:param static_folder: A folder with static files that should be
served by the blueprint's static route. The path is relative to
the blueprint's root path. Blueprint static files are disabled
by default.
:param static_url_path: The url to serve static files from.
Defaults to ``static_folder``. If the blueprint does not have
a ``url_prefix``, the app's static route will take precedence,
and the blueprint's static files won't be accessible.
:param template_folder: A folder with templates that should be added
to the app's template search path. The path is relative to the
blueprint's root path. Blueprint templates are disabled by
default. Blueprint templates have a lower precedence than those
in the app's templates folder.
:param url_prefix: A path to prepend to all of the blueprint's URLs,
to make them distinct from the rest of the app's routes.
:param subdomain: A subdomain that blueprint routes will match on by
default.
:param url_defaults: A dict of default values that blueprint routes
will receive by default.
:param root_path: By default, the blueprint will automatically set
this based on ``import_name``. In certain situations this
automatic detection can fail, so the path can be specified
manually instead.
.. versionchanged:: 1.1.0
Blueprints have a ``cli`` group to register nested CLI commands.
The ``cli_group`` parameter controls the name of the group under
the ``flask`` command.
.. versionadded:: 0.7
FN)
r import_name
static_folderstatic_url_pathtemplate_folderr r r root_path cli_groupc s` t j||||| d d|kr&td|| _|| _|| _g | _|d krJi }|| _|
| _g | _ d S )N)r? r@ rA rB rC r. z+'name' may not contain a dot '.' character.)
superr(
ValueErrorr r r deferred_functionsr# rD _blueprints) r% r r? r@ rA rB r r r rC rD ) __class__r& r' r( s"
zBlueprint.__init__)r c C s | j o
| jS )N)warn_on_modifications_got_registered_once)r% r& r& r' _is_setup_finished s z Blueprint._is_setup_finished)funcr c C s4 | j r$| jr$ddlm} |td | jj| dS )zRegisters a function that is called when the blueprint is
registered on the application. This function is called with the
state as argument as returned by the :meth:`make_setup_state`
method.
r )warnzfThe blueprint was already registered once but is getting modified now. These changes will not show up.N)rK rJ warningsrN WarningrG append)r% rM rN r& r& r' record s zBlueprint.recordc s$ t dd fdd }| jt| S )zWorks like :meth:`record` but wraps the function in another
function that will ensure the function is only called once. If the
blueprint is registered a second time on the application, the
function passed is not called.
N)stater c s | j r | d S )N)r )rS )rM r& r' wrapper s z&Blueprint.record_once..wrapper)r rR r )r% rM rT r& )rM r' record_once s zBlueprint.record_oncer )r r r r c C s t | |||S )zCreates an instance of :meth:`~flask.blueprints.BlueprintSetupState`
object that is later passed to the register callback functions.
Subclasses can override this to return a subclass of the setup state.
)r )r% r r r r& r& r' make_setup_state s zBlueprint.make_setup_state)r r r c K s$ || krt d| jj||f dS )a Register a :class:`~flask.Blueprint` on this blueprint. Keyword
arguments passed to this method will override the defaults set
on the blueprint.
.. versionchanged:: 2.0.1
The ``name`` option can be used to change the (pre-dotted)
name the blueprint is registered with. This allows the same
blueprint to be registered multiple times with unique names
for ``url_for``.
.. versionadded:: 2.0
z%Cannot register a blueprint on itselfN)rF rH rQ )r% r r r& r& r' register_blueprint s
z Blueprint.register_blueprint)r r r c s" |j dd}|j dj}| d| jd |jkr| krLd dnd}|j k rvtd| d| d n$d
d l}|jd| d | d
dd tfdd|jj D } |jk}|j < d_ j
|||} j r| j j
djdd |s|r fdd}
xVjj D ]H\} } | d kr< n d| } ttdd | j D } | |j| < q&W x"jj D ]\}
}||j|
< q~W |
j|j |
j|j |
j|j |
j|j |
j|j |
j|j xjD ]}|| qW |j dj}j j rr|d kr:|j j j j j n8|t kr\ j _|j j j n|j _|j j j xj!D ]\}}|j" }|j d}|d kr|j#}| j#d k r|d k r| j#j$d d |jd |d< n*|d k r||d< n| j#d k r| j#|d< |d< |j%|| qzW d S ) a\ Called by :meth:`Flask.register_blueprint` to register all
views and callbacks registered on the blueprint with the
application. Creates a :class:`.BlueprintSetupState` and calls
each :meth:`record` callback with it.
:param app: The application this blueprint is being registered
with.
:param options: Keyword arguments forwarded from
:meth:`~Flask.register_blueprint`.
.. versionchanged:: 2.0.1
Nested blueprints are registered with their dotted name.
This allows different blueprints with the same name to be
nested at different locations.
.. versionchanged:: 2.0.1
The ``name`` option can be used to change the (pre-dotted)
name the blueprint is registered with. This allows the same
blueprint to be registered multiple times with unique names
for ``url_for``.
.. versionchanged:: 2.0.1
Registering the same blueprint with the same name multiple
times is deprecated and will become an error in Flask 2.1.
r r r r. z ''z
The name 'z1' is already registered for a different blueprintz'. Use 'name=' to provide a unique name.r Nz*' is already registered for this blueprintzO. Use 'name=' to provide a unique name. This will become an error in Flask 2.1. )
stacklevelc 3 s | ]}| kV qd S )Nr& ).0Zbp)r% r& r' A s z%Blueprint.register..Tz/Zstatic)r+ r* c sB x<| j D ]0\}}|d kr n d| }|| j| q
W d S )Nr. )itemsextend)Zbp_dictZ parent_dictkeyvalues)r r& r' r^ R s z"Blueprint.register..extendc S s$ i | ] \}}d d |j D |qS )c S s i | ]\}}||qS r& r& )r[ Z exc_classrM r& r& r'
\ s z1Blueprint.register...)r] )r[ codeZ code_valuesr& r& r' ra [ s z&Blueprint.register..rD r r, )&r! r r1 Z
blueprintsrF rO rN anyr` rK rV Zhas_static_folderr4 rA Zsend_static_fileZerror_handler_specr] r r" Zview_functionsbefore_request_funcsafter_request_funcsteardown_request_funcsurl_default_functionsurl_value_preprocessorstemplate_context_processorsrG rD clicommandsr$ r Z add_commandrH copyr r0 register)r% r r r Z self_nameZ existing_atrO Zfirst_bp_registrationZfirst_name_registrationrS r^ r_ valuer* rM deferredZcli_resolved_groupr Z
bp_optionsZ
bp_url_prefixr& )r r% r' rm s
zBlueprint.register)r) r* r+ provide_automatic_optionsr r c sR rd krt dr4tdr4djkr4t d| j fdd dS )zLike :meth:`Flask.add_url_rule` but for a blueprint. The endpoint for
the :func:`url_for` function is prefixed with the name of the blueprint.
r. z/'endpoint' may not contain a dot '.' character.r5 z5'view_func' name may not contain a dot '.' character.c s | j fdiS )Nrp )r4 )s)r* r rp r) r+ r& r' s
z(Blueprint.add_url_rule..N)rF hasattrr5 rR )r% r) r* r+ rp r r& )r* r rp r) r+ r' r4 s zBlueprint.add_url_rule)r r c s t t d fdd }|S )zRegister a custom template filter, available application wide. Like
:meth:`Flask.template_filter` but for a blueprint.
:param name: the optional name of the filter, otherwise the
function name will be used.
)fr c s j | d | S )N)r )add_app_template_filter)rt )r r% r& r' decorator s z0Blueprint.app_template_filter..decorator)r
)r% r rv r& )r r% r' app_template_filter s
z Blueprint.app_template_filter)rt r r c s$ t dd fdd }| j| dS )aI Register a custom template filter, available application wide. Like
:meth:`Flask.add_template_filter` but for a blueprint. Works exactly
like the :meth:`app_template_filter` decorator.
:param name: the optional name of the filter, otherwise the
function name will be used.
N)rS r c s | j jjp j< d S )N)r jinja_envfiltersr5 )rS )rt r r& r' register_template s z.register_template)r rU )r% rt r rz r& )rt r r' ru s z!Blueprint.add_app_template_filterc s t t d fdd }|S )a Register a custom template test, available application wide. Like
:meth:`Flask.template_test` but for a blueprint.
.. versionadded:: 0.10
:param name: the optional name of the test, otherwise the
function name will be used.
)rt r c s j | d | S )N)r )add_app_template_test)rt )r r% r& r' rv s z.Blueprint.app_template_test..decorator)r )r% r rv r& )r r% r' app_template_test s zBlueprint.app_template_testc s$ t dd fdd }| j| dS )aa Register a custom template test, available application wide. Like
:meth:`Flask.add_template_test` but for a blueprint. Works exactly
like the :meth:`app_template_test` decorator.
.. versionadded:: 0.10
:param name: the optional name of the test, otherwise the
function name will be used.
N)rS r c s | j jjp j< d S )N)r rx testsr5 )rS )rt r r& r' rz s z:Blueprint.add_app_template_test..register_template)r rU )r% rt r rz r& )rt r r' r{ s
z Blueprint.add_app_template_testc s t t d fdd }|S )a Register a custom template global, available application wide. Like
:meth:`Flask.template_global` but for a blueprint.
.. versionadded:: 0.10
:param name: the optional name of the global, otherwise the
function name will be used.
)rt r c s j | d | S )N)r )add_app_template_global)rt )r r% r& r' rv s z0Blueprint.app_template_global..decorator)r )r% r rv r& )r r% r' app_template_global s z Blueprint.app_template_globalc s$ t dd fdd }| j| dS )ai Register a custom template global, available application wide. Like
:meth:`Flask.add_template_global` but for a blueprint. Works exactly
like the :meth:`app_template_global` decorator.
.. versionadded:: 0.10
:param name: the optional name of the global, otherwise the
function name will be used.
N)rS r c s | j jjp j< d S )N)r rx globalsr5 )rS )rt r r& r' rz s z.register_template)r rU )r% rt r rz r& )rt r r' r~ s
z!Blueprint.add_app_template_global)rt r c s | j fdd S )zLike :meth:`Flask.before_request`. Such a function is executed
before each request, even if outside of a blueprint.
c s | j jjd g j S )N)r rd r2 rQ )rq )rt r& r' rr s z.Blueprint.before_app_request..)rU )r% rt r& )rt r' before_app_request s z Blueprint.before_app_requestc s | j fdd S )zLike :meth:`Flask.before_first_request`. Such a function is
executed before the first request to the application.
c s | j jj S )N)r Zbefore_first_request_funcsrQ )rq )rt r& r' rr % s z4Blueprint.before_app_first_request..)rU )r% rt r& )rt r' before_app_first_request s z"Blueprint.before_app_first_requestc s | j fdd S )zLike :meth:`Flask.after_request` but for a blueprint. Such a function
is executed after each request, even if outside of the blueprint.
c s | j jjd g j S )N)r re r2 rQ )rq )rt r& r' rr - s z-Blueprint.after_app_request..)rU )r% rt r& )rt r' after_app_request( s zBlueprint.after_app_requestc s | j fdd S )zLike :meth:`Flask.teardown_request` but for a blueprint. Such a
function is executed when tearing down each request, even if outside of
the blueprint.
c s | j jjd g j S )N)r rf r2 rQ )rq )rt r& r' rr 7 s z0Blueprint.teardown_app_request..)rU )r% rt r& )rt r' teardown_app_request1 s z Blueprint.teardown_app_requestc s | j fdd S )zLike :meth:`Flask.context_processor` but for a blueprint. Such a
function is executed each request, even if outside of the blueprint.
c s | j jjd g j S )N)r ri r2 rQ )rq )rt r& r' rr B s z1Blueprint.app_context_processor..)rU )r% rt r& )rt r' app_context_processor; s z Blueprint.app_context_processor)rb r c s ddd fdd }|S )zLike :meth:`Flask.errorhandler` but for a blueprint. This
handler is used for all requests, even if outside of the blueprint.
z ErrorHandlerCallable[Exception])rt r c s j fdd S )Nc s | j j S )N)r Z errorhandler)rq )rb rt r& r' rr N s z?Blueprint.app_errorhandler..decorator..)rU )rt )rb r% )rt r' rv K s z-Blueprint.app_errorhandler..decoratorr& )r% rb rv r& )rb r% r' app_errorhandlerF s zBlueprint.app_errorhandlerc s | j fdd S )z.)rU )r% rt r& )rt r' app_url_value_preprocessorS s z$Blueprint.app_url_value_preprocessorc s | j fdd S )z2Same as :meth:`url_defaults` but application wide.c s | j jjd g j S )N)r rg r2 rQ )rq )rt r& r' rr _ s z,Blueprint.app_url_defaults..)rU )r% rt r& )rt r' app_url_defaults\ s zBlueprint.app_url_defaults)F)NNN)N)N)N)N)N)N)8r5 r6 r7 r8 rJ rK Z json_encoderZ json_decoderr r< r9 r= UnionosPathLiker" r( r; rL r> rR rU r rV r: rW rm r4 r
rw ru r r| r{ r r r~ r
r r r r r r r r r Type Exceptionintr r r r r
__classcell__r& r& )rI r' r p sb 3d
"r ) r Ztypingr9 collectionsr functoolsr Zscaffoldr r r r r r
r r r
r r r r Z
TYPE_CHECKINGr r r r> ZDeferredSetupFunctionr r r& r& r& r' s, U