g-B dZddlZddlZddlmZmZddlmZddlZddl m Z m Z ddl m Z Gdd ejZd Zd Zd Zd ZGddeZGddeZejedZdZGddejZGddeZejddejdddd ejd!d"d#d$ ejd%dd& ejd'dd( ejd)dd* ejd+d,d- ed.Zejd/d0ed1Z ed2ej!d3krd4pd5ej!d3krd6pd7d8z9Z"d=d:Z#e$d;kre#d<dSdS)>z flask.cli ~~~~~~~~~ A simple command line application to run flask apps. :copyright: (c) 2015 by Armin Ronacher. :license: BSD, see LICENSE for more details. N)LockThread)update_wrapper) iteritemsreraise)get_debug_flagceZdZdZdS)NoAppExceptionz3Raised if an application cannot be found or loaded.N)__name__ __module__ __qualname____doc__?/granary/edev/quantum/lib/python3.11/site-packages/flask/cli.pyr r s====rr c ddlmdD])}t||d}|t|r|cS*fdt |jD}t |dkr|dStd|jz)zwGiven a module instance this tries to find the best possible application in the module or raises an exception. r)Flask)app applicationNc:g|]\}}t||Sr) isinstance).0kvrs r z!find_best_app..(s;(((TQQ&&(q(((rrzFailed to find application in module "%s". Are you sure it contains a Flask application? Maybe you wrapped it in a WSGI middleware or you are using a factory function.) rgetattrrr__dict__lenr r )module attr_namermatchesrs @r find_best_appr$s* fi.. ?z#u55?JJJ((((Yv77(((G 7||qqz 58>G H HHrcg}tj|ddkr tj|}n2|dr |dd}nt d|ztj|}|} tj|\}}||tjtj |dsnvtj d|d |ddd S) zGiven a filename this will try to calculate the python path, add it to the search path and return the actual module name that is expected. rz __init__.pyz.pyNzThe file provided (%s) does exist but is not a valid Python file. This means that it cannot be used as application. Please change the extension to .pyr.) ospathsplitdirnameendswithr realpathappendisfilejoinsysinsert)filenamer!dirpathextras rprepare_exec_for_filer73s0F w}}Xq!]227??8,,   5 ! !<CRC=03;;<< <w))HGw// ew~~bgll7MBBCC    HOOAw 88F44R4L ! !!rcd}d|vr|dd\}}n|}d}t|tj|}|t |}n%t ||d}|t d|z|S)z#Attempts to locate the application.T:rNz)Failed to find application in module "%s")r+ __import__r2modulesr$r RuntimeError)app_id__traceback_hide__r!app_objmodrs r locate_apprAPs f}} ,,sA..v +f CC  c7D)) ;J!' ()) ) Jrctjd}|dStj|rt |S|S)N FLASK_APP)r)environgetr*r0r7)rs rfind_default_import_pathrFfsH *.. % %C { w~~c*$S))) Jrc2eZdZdZd dZdZdZdZdZdS) DispatchingAppaSpecial application that dispatches to a flask application which is imported by name in a background thread. If an error happens it is is recorded and shows as part of the WSGI handling which in case of the Werkzeug debugger means that it shows up in the browser. Fc||_d|_t|_d|_|r|dS|dSN)loader_appr_lock_bg_loading_exc_info_load_unlocked_load_in_background)selfrKuse_eager_loadings r__init__zDispatchingApp.__init__vs[  VV $(!  '    ! ! ! ! !  $ $ & & & & &rc\fd}t|d}|dS)Ncd}j5 n(#t$rtj_YnwxYwddddS#1swxYwYdSNT)rMrO Exceptionr2exc_inforN)r>rQs r _load_appz5DispatchingApp._load_in_background.._load_apps!%  ? ??'')))) ???03 D---? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?s1A"A"AAAAAAr)targetargs)rstart)rQrYts` rrPz"DispatchingApp._load_in_backgroundsA ? ? ? ? ? )" - - -  rc@d}|j}|d|_t|dSdSrV)rNr)rQr>rXs r_flush_bg_loading_exceptionz*DispatchingApp._flush_bg_loading_exceptions7!,  (,D % X     rcNd}|x|_}d|_|SrV)rKrLrN)rQr>rvs rrOzDispatchingApp._load_unlockeds)!& B$(! rcd}|j|||S||j5|j|j}n|}|||cdddS#1swxYwYdSrV)rLr_rMrO)rQrDstart_responser>ras r__call__zDispatchingApp.__call__s! 9 99Wn55 5 ((*** Z / /y$Y((**2g~..  / / / / / / / / / / / / / / / / / /s/A77A;>A;NF) r r rrrSrPr_rOrdrrrrHrHosn ''''    / / / / /rrHc eZdZdZddZdZdS) ScriptInfoaHelp object to deal with Flask applications. This is usually not necessary to interface with as it's used internally in the dispatching to click. In future versions of Flask this object will most likely play a bigger role. Typically it's created automatically by the :class:`FlaskGroup` but you can also manually create it and pass it onwards as click object. Ncv||t}||_nd}||_||_i|_d|_dSrJ)rFapp_import_path create_appdata _loaded_app)rQrirjs rrSzScriptInfo.__init__sS  &":"<"<#2D "O /% rcd}|j|jS|j||}n*|jstdt |j}t }|||_||_|S)zLoads the Flask app (if not yet loaded) and returns it. Calling this multiple times will just result in the already loaded app to be returned. TNzCould not locate Flask application. You did not provide the FLASK_APP environment variable. For more information see http://flask.pocoo.org/docs/latest/quickstart/)rlrjrir rAr debug)rQr>rarns rload_appzScriptInfo.load_apps "   '# # ? &&&BB' F$EFFF D011B    BH r)NN)r r rrrSrorrrrgrgsA    $rrgT)ensurecRtjfd}t|S)zWraps a callback so that it's guaranteed to be executed with the script's application context. If callbacks are registered directly to the ``app.cli`` object then they are wrapped with this function by default unless it's disabled. c|t5|jg|Ri|cdddS#1swxYwYdSrJ) ensure_objectrgro app_contextinvoke)__ctxr[kwargsfs r decoratorz"with_appcontext..decorators   , , 5 5 7 7 C C E E 4 45<3D333F33 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4sAA"%A")click pass_contextr)rxrys` rwith_appcontextr|s>  44444 )Q ' ''rceZdZdZdZdZdS)AppGroupaThis works similar to a regular click :class:`~click.Group` but it changes the behavior of the :meth:`command` decorator so that it automatically wraps the functions in :func:`with_appcontext`. Not to be confused with :class:`FlaskGroup`. cJddfd}|S)zThis works exactly like the method of the same name on a regular :class:`click.Group` but it wraps callbacks in :func:`with_appcontext` unless it's disabled by passing ``with_appcontext=False``. r|Tclrt|}tjjgRi|SrJ)r|rzGroupcommand)rxr[rwrQ wrap_for_ctxs rryz#AppGroup.command..decoratorsE '#A&&=5;&t=d===f==a@@ @r)pop)rQr[rwryrs``` @rrzAppGroup.commandsT zz"3T::  A A A A A A A Arcl|dttjj|g|Ri|S)zThis works exactly like the method of the same name on a regular :class:`click.Group` but it defaults the group class to :class:`AppGroup`. cls) setdefaultr~rzrgroup)rQr[rws rrzAppGroup.groups= %***{ 7777777rN)r r rrrrrrrr~r~s<   88888rr~c2eZdZdZd dZdZdZdZdZdS) FlaskGroupa{Special subclass of the :class:`AppGroup` group that supports loading more commands from the configured Flask app. Normally a developer does not have to interface with this class but there are some very advanced use cases for which it makes sense to create an instance of this. For information as of why this is useful see :ref:`custom-scripts`. :param add_default_commands: if this is True then the default run and shell commands wil be added. :param create_app: an optional callback that is passed the script info and returns the loaded app. TNc tj|fi|||_|r4|t|t d|_dS)NF)r~rSrj add_command run_command shell_command_loaded_plugin_commands)rQadd_default_commandsrjr6s rrSzFlaskGroup.__init__s`$((%((($  ,   [ ) ) )   ] + + +',$$$rc|jrdS ddl}n#t$r d|_YdSwxYw|dD]/}|||j0d|_dS)NrTzflask.commands)r pkg_resources ImportErroriter_entry_pointsrloadname)rQreps r_load_plugin_commandsz FlaskGroup._load_plugin_commandss  '  F     +/D ( FF  112BCC 1 1B   RWWYY 0 0 0 0'+$$$s %%c(|t|||}||S|t} |j||}||SdS#t$rYdSwxYwrJ)rr~ get_commandrsrgroclir )rQctxrrainfos rrzFlaskGroup.get_command,s ""$$$ ! !$T 2 2 >I  ,, $00d;;B~ ~    DD s0B BBcx|ttj||}|t } ||j |n#t$rYnwxYwt|SrJ) rsetrzr list_commandsrsrgupdaterorrWsorted)rQrrars rrzFlaskGroup.list_commandsBs ""$$$**455 6 6  ,,  IIdmmoo)77<< = = = =    D   bzzs?B B*)B*c|d}|t|j}||d<|ddt j|g|Ri|S)Nobj)rjauto_envvar_prefixFLASK)rErgrjrr~main)rQr[rwrs rrzFlaskGroup.mainSsjjj ;888Cu .888}T3D333F333r)TN) r r rrrSrrrrrrrrrsn  ---- , , ,,"44444rrrunzRuns a development server.) short_helpz--hostz-hz 127.0.0.1zThe interface to bind to.)defaulthelpz--portz-pizThe port to bind to.z--reload/--no-reloadzWEnable or disable the reloader. By default the reloader is active if debug is enabled.z--debugger/--no-debuggerzWEnable or disable the debugger. By default the debugger is active if debug is enabled.z--eager-loading/--lazy-loaderzbEnable or disable eager loading. By default eager loading is enabled if the reloader is disabled.z --with-threads/--without-threadsFz!Enable or disable multithreading.c|ddlm}t}|t|}|t|}|| }t |j|} t jddkr6|j td|j z|td|rd pd z|||| ||| dS) aRuns a local development server for the Flask application. This local server is recommended for development purposes only but it can also be used for simple intranet deployments. By default it will not support any sort of concurrency at all to simplify debugging. This can be changed with the --with-threads option which will enable basic multithreading. The reloader and debugger are by default enabled if the debug flag of Flask is enabled and disabled otherwise. r) run_simpleN)rRWERKZEUG_RUN_MAINtruez * Serving Flask app "%s"z * Forcing debug mode %sonoff) use_reloader use_debuggerthreaded) werkzeug.servingrr boolrHror)rDrEriprint) rhostportreloaddebugger eager_loading with_threadsrrnrs rrr\s<,+++++   E ~e;;" - H H HC z~~)**f44   + -0DD E E E   ,$0G%H I I IJtT3V$|======rshellz Runs a shell in the app context.c Rddl}ddlm}|jj}dt jdt jd|j|j rdpdd |j  }i}tj d }|rxtj|rYt!|d 5}t#t%||d |dddn #1swxYwY||||| dS)a>Runs an interactive Python shell in the context of a given Flask application. The application will populate the default namespace of this shell according to it's configuration. This is useful for executing small snippets of management code without having to manually configuring the application. rN)_app_ctx_stackzPython z on z App: z [debug]rz Instance: PYTHONSTARTUPrexec)bannerlocal)code flask.globalsrtoprr2versionplatform import_namern instance_pathr)rDrEr*r0openevalcompilereadrmake_shell_contextinteract)rrrrrstartuprxs rrrseKKK,,,,,,   CC     j&B&&  F Cjnn_--G:27>>'**: '3   :1 7F33S 9 9 9 : : : : : : : : : : : : : : :JJs%%''(((MMsM+++++s 2CC"%C"aThis shell command acts as general utility script for Flask applications. It loads the application configured (either through the FLASK_APP environment variable) and then provides commands either provided by the application or Flask itself. The most useful commands are the "run" and "shell" command. Example usage:  %(prefix)s%(cmd)s FLASK_APP=hello %(prefix)s%(cmd)s FLASK_DEBUG=1 %(prefix)sflask run posixexportrz$ r)cmdprefix)rc4tdz}tjdd}|rYtjdkr d|dddz}nd|z}d|gtjddzt_nd}t ||dS) Nz.clir)z python -m r'rz-m)r[ prog_name) __package__r2argv version_inforsplitrr) as_module this_moduler[rs rrrs&K 8ABBrs """"""""$$$$$$ ''''''''######>>>>>U%>>>HHH0""":,3/3/3/3/3/V3/3/3/l11111111h-5,ZEEE ( ( (88888u{888:S4S4S4S4S4S4S4S4lu!=>>> hk.000 hd)+++ $d/000($/000-t@AAA0%6888&=&=88AA0000++00?>"&=Rw#EFFF,,GF,@j 7g  *( 3eg )T/R*((((( zD4r