
    gv                    j   d dl mZ d dlZd dlZd dlZd dlZd dlZd dl	m
Z
 d dlmZ d dlmZ d dlmZ d dlmZ d dlmZ d d	lmZ d
dlmZ d
dlmZ d
dlmZ ej6                  rd dlmZ  e       Z ej@                  dejB                  dejD                  f         Z# ej@                  dejH                  ejD                           Z% ej@                  dejL                        Z' ej@                  dejP                        Z) ej@                  dejT                        Z+ ej@                  dejX                        Z- ej@                  dej\                        Z/ ej@                  dej`                        Z1 ej@                  dejd                        Z3d dZ4 G d d      Z5d!dZ6d"dZ7d#dZ8y)$    )annotationsN)defaultdict)update_wrapper)
BaseLoader)FileSystemLoader)default_exceptions)HTTPException)cached_property   )typing)get_root_path)_default_template_ctx_processor)GroupF.)boundT_after_requestT_before_requestT_error_handler
T_teardownT_template_context_processorT_url_defaultsT_url_value_preprocessorT_routec                t      j                   d fd}t        j                  t        t	        |             S )Nc                >    | j                          | g|i |S N)_check_setup_finished)selfargskwargsff_names      r/var/www/html/FastMealFinder_FlaskServer-InitialRelease/venv/lib/python3.12/site-packages/flask/sansio/scaffold.pywrapper_funcz!setupmethod.<locals>.wrapper_func-   s&    ""6*''''    )r   Scaffoldr   t.Anyr    r'   returnr'   )__name__tcastr   r   )r!   r$   r"   s   ` @r#   setupmethodr,   *   s+    ZZF( 66!^L!455r%   c                     e Zd ZU dZded<   ded<   dZded<   dZded	<   	 	 	 	 d%	 	 	 	 	 	 	 	 	 d&d
Zd'dZd(dZ	e
d)d       Zej                  d*d       Ze
d+d       Ze
d)d       Zej                  d,d       Zed-d       Z	 	 	 	 	 	 	 	 d.dZed/d       Zed/d       Zed/d       Zed/d       Zed/d       Zed/d       Ze	 	 	 d0	 	 	 	 	 	 	 	 	 	 	 d1d       Zed2d       Zed3d       Zed4d       Zed5d       Ze	 	 	 	 d6d       Ze	 	 	 	 d7d        Zed8d!       Z e	 	 	 	 d9d"       Z!e	 	 	 	 	 	 d:d#       Z"e#	 	 	 	 d;d$       Z$y)<r&   a  Common behavior shared between :class:`~flask.Flask` and
    :class:`~flask.blueprints.Blueprint`.

    :param import_name: The import name of the module where this object
        is defined. Usually :attr:`__name__` should be used.
    :param static_folder: Path to a folder of static files to serve.
        If this is set, a static route will be added.
    :param static_url_path: URL prefix for the static route.
    :param template_folder: Path to a folder containing template files.
        for rendering. If this is set, a Jinja loader will be added.
    :param root_path: The path that static, template, and resource files
        are relative to. Typically not set, it is discovered based on
        the ``import_name``.

    .. versionadded:: 2.0
    r   clistrnameN
str | None_static_folder_static_url_pathc                   || _         || _        || _        || _        |t	        | j                         }|| _        i | _        t        d       | _        t        t              | _
        t        t              | _        t        t              | _        t        t        d t        gi      | _        t        t              | _        t        t              | _        y )Nc                      t        t              S r   )r   dict r%   r#   <lambda>z#Scaffold.__init__.<locals>.<lambda>~   s    D 1 r%   )import_namestatic_folderstatic_url_pathtemplate_folderr   	root_pathview_functionsr   error_handler_speclistbefore_request_funcsafter_request_funcsteardown_request_funcsr   template_context_processorsurl_value_preprocessorsurl_default_functions)r   r9   r:   r;   r<   r=   s         r#   __init__zScaffold.__init__K   s     '*.
  /%d&6&67I # <>$ 12 	"  	!   	 "  	#" t&E%FGH 	($  	$$  	"r%   c                N    dt        |       j                   d| j                  dS )N< >)typer)   r0   r   s    r#   __repr__zScaffold.__repr__   s&    4:&&'qQ77r%   c                    t         r   NotImplementedError)r   r"   s     r#   r   zScaffold._check_setup_finished   s    !!r%   c                    | j                   4t        j                  j                  | j                  | j                         S y)zhThe absolute path to the configured static folder. ``None``
        if no static folder is set.
        N)r2   ospathjoinr=   rM   s    r#   r:   zScaffold.static_folder   s2    
 *77<<0C0CDDr%   c                ^    |$t        j                  |      j                  d      }|| _        y )Nz\/)rS   fspathrstripr2   r   values     r#   r:   zScaffold.static_folder   s)    IIe$++E2E#r%   c                    | j                   duS )zQ``True`` if :attr:`static_folder` is set.

        .. versionadded:: 0.5
        N)r:   rM   s    r#   has_static_folderzScaffold.has_static_folder   s     !!--r%   c                    | j                   | j                   S | j                  =t        j                  j	                  | j                        }d| j                  d      S y)zThe URL prefix that the static route will be accessible from.

        If it was not configured during init, it is derived from
        :attr:`static_folder`.
        N/)r3   r:   rS   rT   basenamerX   )r   r_   s     r#   r;   zScaffold.static_url_path   s\       ,((()ww''(:(:;Hxj>((--r%   c                8    ||j                  d      }|| _        y )Nr^   )rX   r3   rY   s     r#   r;   zScaffold.static_url_path  s    LL%E %r%   c                    | j                   =t        t        j                  j	                  | j
                  | j                               S y)zThe Jinja loader for this object's templates. By default this
        is a class :class:`jinja2.loaders.FileSystemLoader` to
        :attr:`template_folder` if it is set.

        .. versionadded:: 0.5
        N)r<   r   rS   rT   rU   r=   rM   s    r#   jinja_loaderzScaffold.jinja_loader  s7     +#BGGLLAUAU$VWWr%   c                L    d|v rt        d       | j                  |fd|gi|S )Nmethodsz8Use the 'route' decorator to use the 'methods' argument.)	TypeErrorroute)r   methodruleoptionss       r#   _method_routezScaffold._method_route  s5     VWWtzz$<<G<<r%   c                (    | j                  d||      S )z\Shortcut for :meth:`route` with ``methods=["GET"]``.

        .. versionadded:: 2.0
        GETrj   r   rh   ri   s      r#   getzScaffold.get'       !!%w77r%   c                (    | j                  d||      S )z]Shortcut for :meth:`route` with ``methods=["POST"]``.

        .. versionadded:: 2.0
        POSTrm   rn   s      r#   postzScaffold.post/  s     !!&$88r%   c                (    | j                  d||      S )z\Shortcut for :meth:`route` with ``methods=["PUT"]``.

        .. versionadded:: 2.0
        PUTrm   rn   s      r#   putzScaffold.put7  rp   r%   c                (    | j                  d||      S )z_Shortcut for :meth:`route` with ``methods=["DELETE"]``.

        .. versionadded:: 2.0
        DELETErm   rn   s      r#   deletezScaffold.delete?  s     !!(D'::r%   c                (    | j                  d||      S )z^Shortcut for :meth:`route` with ``methods=["PATCH"]``.

        .. versionadded:: 2.0
        PATCHrm   rn   s      r#   patchzScaffold.patchG  s     !!'499r%   c                     d fd}|S )a  Decorate a view function to register it with the given URL
        rule and options. Calls :meth:`add_url_rule`, which has more
        details about the implementation.

        .. code-block:: python

            @app.route("/")
            def index():
                return "Hello, World!"

        See :ref:`url-route-registrations`.

        The endpoint name for the route defaults to the name of the view
        function if the ``endpoint`` parameter isn't passed.

        The ``methods`` parameter defaults to ``["GET"]``. ``HEAD`` and
        ``OPTIONS`` are added automatically.

        :param rule: The URL rule string.
        :param options: Extra options passed to the
            :class:`~werkzeug.routing.Rule` object.
        c                V    j                  dd       } j                  || fi  | S )Nendpoint)popadd_url_rule)r!   r   ri   rh   r   s     r#   	decoratorz!Scaffold.route.<locals>.decoratorh  s1    {{:t4HDdHa;7;Hr%   )r!   r   r(   r   r7   )r   rh   ri   r   s   ``` r#   rf   zScaffold.routeO  s    2	
 r%   c                    t         )a;  Register a rule for routing incoming requests and building
        URLs. The :meth:`route` decorator is a shortcut to call this
        with the ``view_func`` argument. These are equivalent:

        .. code-block:: python

            @app.route("/")
            def index():
                ...

        .. code-block:: python

            def index():
                ...

            app.add_url_rule("/", view_func=index)

        See :ref:`url-route-registrations`.

        The endpoint name for the route defaults to the name of the view
        function if the ``endpoint`` parameter isn't passed. An error
        will be raised if a function has already been registered for the
        endpoint.

        The ``methods`` parameter defaults to ``["GET"]``. ``HEAD`` is
        always added automatically, and ``OPTIONS`` is added
        automatically by default.

        ``view_func`` does not necessarily need to be passed, but if the
        rule should participate in routing an endpoint name must be
        associated with a view function at some point with the
        :meth:`endpoint` decorator.

        .. code-block:: python

            app.add_url_rule("/", endpoint="index")

            @app.endpoint("index")
            def index():
                ...

        If ``view_func`` has a ``required_methods`` attribute, those
        methods are added to the passed and automatic methods. If it
        has a ``provide_automatic_methods`` attribute, it is used as the
        default if the parameter is not passed.

        :param rule: The URL rule string.
        :param endpoint: The endpoint name to associate with the rule
            and view function. Used when routing and building URLs.
            Defaults to ``view_func.__name__``.
        :param view_func: The view function to associate with the
            endpoint name.
        :param provide_automatic_options: Add the ``OPTIONS`` method and
            respond to ``OPTIONS`` requests automatically.
        :param options: Extra options passed to the
            :class:`~werkzeug.routing.Rule` object.
        rP   )r   rh   r   	view_funcprovide_automatic_optionsri   s         r#   r   zScaffold.add_url_ruleo  s    D "!r%   c                     d fd}|S )a  Decorate a view function to register it for the given
        endpoint. Used if a rule is added without a ``view_func`` with
        :meth:`add_url_rule`.

        .. code-block:: python

            app.add_url_rule("/ex", endpoint="example")

            @app.endpoint("example")
            def example():
                ...

        :param endpoint: The endpoint name to associate with the view
            function.
        c                &    | j                   <   | S r   )r>   )r!   r   r   s    r#   r   z$Scaffold.endpoint.<locals>.decorator  s    ,-D)Hr%   r!   r   r(   r   r7   )r   r   r   s   `` r#   r   zScaffold.endpoint  s    $	 r%   c                \    | j                   j                  dg       j                  |       |S )a  Register a function to run before each request.

        For example, this can be used to open a database connection, or
        to load the logged in user from the session.

        .. code-block:: python

            @app.before_request
            def load_user():
                if "user_id" in session:
                    g.user = db.session.get(session["user_id"])

        The function will be called without any arguments. If it returns
        a non-``None`` value, the value is handled as if it was the
        return value from the view, and further request handling is
        stopped.

        This is available on both app and blueprint objects. When used on an app, this
        executes before every request. When used on a blueprint, this executes before
        every request that the blueprint handles. To register with a blueprint and
        execute before every request, use :meth:`.Blueprint.before_app_request`.
        N)rA   
setdefaultappendr   r!   s     r#   before_requestzScaffold.before_request  s*    0 	!!,,T26==a@r%   c                \    | j                   j                  dg       j                  |       |S )aW  Register a function to run after each request to this object.

        The function is called with the response object, and must return
        a response object. This allows the functions to modify or
        replace the response before it is sent.

        If a function raises an exception, any remaining
        ``after_request`` functions will not be called. Therefore, this
        should not be used for actions that must execute, such as to
        close resources. Use :meth:`teardown_request` for that.

        This is available on both app and blueprint objects. When used on an app, this
        executes after every request. When used on a blueprint, this executes after
        every request that the blueprint handles. To register with a blueprint and
        execute after every request, use :meth:`.Blueprint.after_app_request`.
        N)rB   r   r   r   s     r#   after_requestzScaffold.after_request  s*    $ 	  ++D"5<<Q?r%   c                \    | j                   j                  dg       j                  |       |S )a  Register a function to be called when the request context is
        popped. Typically this happens at the end of each request, but
        contexts may be pushed manually as well during testing.

        .. code-block:: python

            with app.test_request_context():
                ...

        When the ``with`` block exits (or ``ctx.pop()`` is called), the
        teardown functions are called just before the request context is
        made inactive.

        When a teardown function was called because of an unhandled
        exception it will be passed an error object. If an
        :meth:`errorhandler` is registered, it will handle the exception
        and the teardown will not receive it.

        Teardown functions must avoid raising exceptions. If they
        execute code that might fail they must surround that code with a
        ``try``/``except`` block and log any errors.

        The return values of teardown functions are ignored.

        This is available on both app and blueprint objects. When used on an app, this
        executes after every request. When used on a blueprint, this executes after
        every request that the blueprint handles. To register with a blueprint and
        execute after every request, use :meth:`.Blueprint.teardown_app_request`.
        N)rC   r   r   r   s     r#   teardown_requestzScaffold.teardown_request  s*    > 	##..tR8??Br%   c                B    | j                   d   j                  |       |S )a#  Registers a template context processor function. These functions run before
        rendering a template. The keys of the returned dict are added as variables
        available in the template.

        This is available on both app and blueprint objects. When used on an app, this
        is called for every rendered template. When used on a blueprint, this is called
        for templates rendered from the blueprint's views. To register with a blueprint
        and affect every template, use :meth:`.Blueprint.app_context_processor`.
        N)rD   r   r   s     r#   context_processorzScaffold.context_processor  s"     	((.55a8r%   c                B    | j                   d   j                  |       |S )al  Register a URL value preprocessor function for all view
        functions in the application. These functions will be called before the
        :meth:`before_request` functions.

        The function can modify the values captured from the matched url before
        they are passed to the view. For example, this can be used to pop a
        common language code value and place it in ``g`` rather than pass it to
        every view.

        The function is passed the endpoint name and values dict. The return
        value is ignored.

        This is available on both app and blueprint objects. When used on an app, this
        is called for every request. When used on a blueprint, this is called for
        requests that the blueprint handles. To register with a blueprint and affect
        every request, use :meth:`.Blueprint.app_url_value_preprocessor`.
        N)rE   r   r   s     r#   url_value_preprocessorzScaffold.url_value_preprocessor.  s"    , 	$$T*11!4r%   c                B    | j                   d   j                  |       |S )a  Callback function for URL defaults for all view functions of the
        application.  It's called with the endpoint and values and should
        update the values passed in place.

        This is available on both app and blueprint objects. When used on an app, this
        is called for every request. When used on a blueprint, this is called for
        requests that the blueprint handles. To register with a blueprint and affect
        every request, use :meth:`.Blueprint.app_url_defaults`.
        N)rF   r   r   s     r#   url_defaultszScaffold.url_defaultsG  s"     	""4(//2r%   c                     d fd}|S )a  Register a function to handle errors by code or exception class.

        A decorator that is used to register a function given an
        error code.  Example::

            @app.errorhandler(404)
            def page_not_found(error):
                return 'This page does not exist', 404

        You can also register handlers for arbitrary exceptions::

            @app.errorhandler(DatabaseError)
            def special_exception_handler(error):
                return 'Database connection failed', 500

        This is available on both app and blueprint objects. When used on an app, this
        can handle errors from every request. When used on a blueprint, this can handle
        errors from requests that the blueprint handles. To register with a blueprint
        and affect every request, use :meth:`.Blueprint.app_errorhandler`.

        .. versionadded:: 0.7
            Use :meth:`register_error_handler` instead of modifying
            :attr:`error_handler_spec` directly, for application wide error
            handlers.

        .. versionadded:: 0.7
           One can now additionally also register custom exception types
           that do not necessarily have to be a subclass of the
           :class:`~werkzeug.exceptions.HTTPException` class.

        :param code_or_exception: the code as integer for the handler, or
                                  an arbitrary exception
        c                ,    j                  |        | S r   )register_error_handler)r!   code_or_exceptionr   s    r#   r   z(Scaffold.errorhandler.<locals>.decorator{  s    ''(91=Hr%   )r!   r   r(   r   r7   )r   r   r   s   `` r#   errorhandlerzScaffold.errorhandlerU  s    L	 r%   c                V    | j                  |      \  }}|| j                  d   |   |<   y)zAlternative error attach function to the :meth:`errorhandler`
        decorator that is more straightforward to use for non decorator
        usage.

        .. versionadded:: 0.7
        N)_get_exc_class_and_coder?   )r   r   r!   	exc_classcodes        r#   r   zScaffold.register_error_handler  s3     667HI	49:%d+I6r%   c                H   t        | t              r	 t        |    }n| }t        |t
              rt        |d      t        |t
              st	        d|j                   d      t        |t              r||j                  fS |dfS # t        $ r t	        d|  d      dw xY w)a  Get the exception class being handled. For HTTP status codes
        or ``HTTPException`` subclasses, return both the exception and
        status code.

        :param exc_class_or_code: Any exception class, or an HTTP status
            code as an integer.
        'z^' is not a recognized HTTP error code. Use a subclass of HTTPException with that code instead.Nzh is an instance, not a class. Handlers can only be registered for Exception classes or HTTP error codes.zl' is not a subclass of Exception. Handlers can only be registered for Exception classes or HTTP error codes.)
isinstanceintr   KeyError
ValueError	Exceptionre   
issubclassr)   r	   r   )exc_class_or_coder   s     r#   r   z Scaffold._get_exc_class_and_code  s     '-./@A	 *Ii+-       )Y/I&&' (( (  i/inn,,d?"5   )* +* * 	s   	B B!)NNNN)
r9   r/   r:   str | os.PathLike[str] | Noner;   r1   r<   r   r=   r1   )r(   r/   )r"   r/   r(   None)r(   r1   )rZ   r   r(   r   )r(   bool)rZ   r1   r(   r   )r(   zBaseLoader | None)rg   r/   rh   r/   ri   zdict[str, t.Any]r(   t.Callable[[T_route], T_route])rh   r/   ri   r'   r(   r   )NNN)rh   r/   r   r1   r   zft.RouteCallable | Noner   zbool | Noneri   r'   r(   r   )r   r/   r(   zt.Callable[[F], F])r!   r   r(   r   )r!   r   r(   r   )r!   r   r(   r   )r!   r   r(   r   )r!   r   r(   r   )r!   r   r(   r   )r   type[Exception] | intr(   z.t.Callable[[T_error_handler], T_error_handler])r   r   r!   zft.ErrorHandlerCallabler(   r   )r   r   r(   z"tuple[type[Exception], int | None])%r)   
__module____qualname____doc____annotations__r2   r3   rG   rN   r   propertyr:   setterr\   r;   r
   rb   rj   r,   ro   rs   rv   ry   r|   rf   r   r   r   r   r   r   r   r   r   r   staticmethodr   r7   r%   r#   r&   r&   4   s/   " 
J
I!%NJ%#'j'
 8<&*9= $LL 5L $	L
 7L L\8"   $ $ . .   & & 
 
	=	= 	= "		=
 
(	= 8 8 9 9 8 8 ; ; : :  >   $-115A"A" A" +	A"
 $/A" A" 
A" A"F  .  4  (  B ' 
&   # 
" 0   )!6)	7) )V ;0; #; 
	; ; )#0)#	+)# )#r%   r&   c                ,    | J d       | j                   S )zsInternal helper that returns the default endpoint for a given
    function.  This always is the function name.
    z/expected view func if endpoint is not provided.)r)   )r   s    r#   _endpoint_from_view_funcr     s"      S"SS r%   c                v   | j                  d      \  }}}	 t        j                  j                  |      }|t	        d      	 |j                  r|j                  |j                  dk(  rt        j                  j                  |       }|g|j                  r[t        j                  t        j                  j                  |j                              t        fd|j                  D              }n|j                  d   }t        j                  j                  |      S t        j                  j                  t        j                  j                  |j                              S t        j                  j                  |j                        S # t
        t        f$ r t        j                         cY S w xY w)z2Find the path that contains the package or module..z	not found	namespacec              3  D   K   | ]  }j                  |      r|  y wr   )is_relative_to).0locationpackage_paths     r#   	<genexpr>z%_find_package_path.<locals>.<genexpr>  s'      ' #228< 's    r   )	partition	importlibutil	find_specr   ImportErrorrS   getcwdsubmodule_search_locationsoriginpathlibPathrT   
commonpathnextdirname)r9   root_mod_name_	root_specpackage_specsearch_locationr   s         @r#   _find_package_pathr     sa   %//4M1aNN,,];	[))  ++#y'7'7;'F$>>33K@L'L,S,S&||GG&&|'N'NO  #' '$-$H$H' # #,"F"Fq"I77???33 77??277??93C3C#DEE wwy//00C $  yy{s   ,F #F87F8c                P   t        |       }t        j                  j                  t        j
                        }t        j                  |      j                  |      r||fS t        j                  j                  |      \  }}|j                         dk(  rt        j                  j                  |      \  }}|j                         dk(  r||fS t        j                  j                  |      j                         dk(  r!t        j                  j                  |      |fS ||fS d|fS )a  Find the prefix that a package is installed under, and the path
    that it would be imported from.

    The prefix is the directory containing the standard directory
    hierarchy (lib, bin, etc.). If the package is not installed to the
    system (:attr:`sys.prefix`) or a virtualenv (``site-packages``),
    ``None`` is returned.

    The path is the entry in :attr:`sys.path` that contains the package
    for import. If the package is not installed, it's assumed that the
    package was imported from the current working directory.
    zsite-packageslibN)r   rS   rT   abspathsysprefixr   PurePathr   splitlowerr_   r   )r9   r   	py_prefixsite_parentsite_folderparentfolders          r#   find_packager     s     &k2L

+I %44Y?,&&!ww}}\:K o-{3 <<>U"<'' 77F#))+u477??6*L88 L(( r%   r   )r   zft.RouteCallabler(   r/   )r9   r/   r(   r/   )r9   r/   r(   ztuple[str | None, str])9
__future__r   importlib.utilr   rS   r   r   r   r*   collectionsr   	functoolsr   jinja2r   r   werkzeug.exceptionsr   r	   werkzeug.utilsr
    fthelpersr   
templatingr   TYPE_CHECKINGclickr   object	_sentinelTypeVarCallableAnyr   AfterRequestCallabler   BeforeRequestCallabler   ErrorHandlerCallabler   TeardownCallabler    TemplateContextProcessorCallabler   URLDefaultCallabler   URLValuePreprocessorCallabler   RouteCallabler   r,   r&   r   r   r   r7   r%   r#   <module>r      sg   "  	  
  # $  # 2 - *  # 8?? H	AIIcCJ/0!))-R5L5LQUU5ST199/r7O7OP !))-R5L5LMQYY|2+>+>?
(qyy""*M*M   +23H3HI$199b&E&E  !))IR%5%5
66F
# F
#R*1Z&r%   