_;y"@sdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z ddlmZddlmZddlZddlmZd d lmZd d lmZd d lmZd d lmZd dlmZd dlmZd dlmZd dlmZyddlZWne k rpdZYnXyddl!Z!Wne k rdZ!YnXGdddej"Z#ddZ$fddZ%ddZ&ddZ'ddZ(ddd Z)d!d"Z*ej+d#gd$d%d&d'd(e*d)dd*dZ,Gd+d,d,e-Z.Gd-d.d.e-Z/ej0e/d/dZ1d0d1Z2Gd2d3d3ej3Z4Gd4d5d5e4Z5d6d7Z6dd8d9Z7d:d;Z8Gd<d=d=ej9Z:d>d?Z;Gd@dAdAej<Z=ej>dBdCdDej?dEdFdGdHd$dIej?dJdKdGdLd$dMej?dNdOe:d$dPej?dQdOej<dRddSd'dTdd(e;d&d'd$dUej?dVdGdd$dWej?dXdGdd$dYej?dZdGdd$d[ej?d\dGdd$d]ej?d^dGddOe=d$d_j@ejAjBe1d`daZCej>dbdCdce2dddeZDej>dfdCdgej?dhdidOejEddGdjd$dnej?dod)dd$dpe2dqdrZFe5d$dsj@dtejGdukr9dvndwdxejGdukrTdyndzZHd'd{d|ZIeJd}kreId~ddS)z flask.cli ~~~~~~~~~ A simple command line application to run flask apps. :copyright: 2010 Pallets :license: BSD-3-Clause )print_functionN)update_wrapper) attrgetter)Lock)Thread) import_string) getargspec) itervalues)reraise) text_type) current_app)get_debug_flag)get_env)get_load_dotenvc@seZdZdZdS)NoAppExceptionz3Raised if an application cannot be found or loaded.N)__name__ __module__ __qualname____doc__rr*/tmp/pip-build-5gj8f0j9/flask/flask/cli.pyr0s rc skddlmx3dD]+}t||d}t|r|SqWfddt|jD}t|dkr|dSt|dkrtd jd |j xdD]}t||d}t j |ry&t ||}t|r|SWqt k rGt|s"td jd|d |j YqXqWtdjd |j dS)zwGiven a module instance this tries to find the best possible application in the module or raises an exception. r)Flaskapp applicationNcs%g|]}t|r|qSr) isinstance).0v)rrr Bs z!find_best_app..rztDetected multiple Flask applications in module "{module}". Use "FLASK_APP={module}:name" to specify the correct one.module create_appmake_appzDetected factory "{factory}" in module "{module}", but could not call it without arguments. Use "FLASK_APP='{module}:{factory}(args)'" to specify arguments.factoryznFailed to find Flask application or factory in module "{module}". Use "FLASK_APP={module}:name to specify one.)rr)r r!)rgetattrrr __dict__lenrformatrinspect isfunction call_factory TypeError_called_with_wrong_args) script_infor attr_namermatches app_factoryr)rr find_best_app4s8 "      r1cCst|}|j}|j}d|kr:||d|S|rJ||S| ryt|dkry|dkry||S|S)zTakes an app factory, a ``script_info` object and optionally a tuple of arguments. Checks for the existence of a script_info argument and calls the app_factory depending on that and the arguments provided. r-rN)r argsdefaultsr&)r-r0Z argumentsZ args_specZ arg_namesZ arg_defaultsrrrr*gs     % r*c CsXtjd}z=x2|dk rG|jj|jkr;dS|j}qWdSWd~XdS)zCheck whether calling a function raised a ``TypeError`` because the call failed or because something in the factory raised the error. :param factory: the factory function that was called :return: true if the call failed NFT)sysexc_infotb_framef_code__code__tb_next)r"tbrrrr,zs r,c 0Csddlm}tjd|}|s@tdjd||j\}}yt||}Wn8tk r}zt|j dWYdd}~XnXt j |r|r#yt j djd |}Wq)ttfk r}z#td jd |d |WYdd}~Xq)Xnf}yt|||} Wqtk r}z;t|sctd jd |d |d|jWYdd}~XqXn|} t| |r| Stdjd|jd |dS)zChecks if the given string is a variable name or a function. If it is a function, it checks for specified arguments and whether it takes a ``script_info`` argument and calls the function with the appropriate arguments. r)rz%^ *([^ ()]+) *(?:\((.*?) *,? *\))? *$z="{name}" is not a valid variable name or function expression.namerNz ({args},)r2z.Could not parse the arguments in "{app_name}".eapp_namezc{e} The factory "{app_name}" in module "{module}" could not be called with the specified arguments.rzFA valid Flask application was not obtained from "{module}:{app_name}".)r#rrematchrr'groupsr$AttributeErrorr2r(r)astZ literal_eval ValueError SyntaxErrorr*r+r,rr) r-rr>rr@r<r2attrr=rrrrfind_app_by_stringsD  & (  1 rGcCstjj|}tjj|\}}|dkr<|}tjj|dkrftjj|}g}xKtjj|\}}|j|tjjtjj |dsoPqoWt jd|krt jj d|dj |dddS) 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. z.py__init__z __init__.pyr.Nr) ospathrealpathsplitextbasenamedirnamesplitappendexistsjoinr5insert)rLfnameext module_namer<rrrprepare_imports  !rYTc Csd}yt|Wnqtk rtjdjr^tdjd|dtjn%|rtdjd|ndSYnXtj |}|dkrt ||St |||SdS)NTrz:While importing "{name}", an ImportError was raised: {tb}r<r;zCould not import "{name}".rJ) __import__ ImportErrorr5r6r:rr' traceback format_excmodulesr1rG)r-rXr>raise_if_not_found__traceback_hide__rrrr locate_apps      racCsy| s|jrdSddl}ddlm}d}tj|dtjd|d|jid|j|j dS) Nrr) __version__z7Python %(python)s Flask %(flask)s Werkzeug %(werkzeug)spythonZflaskwerkzeugcolor) Zresilient_parsingrdr#rbclickechoplatformpython_versionreexit)ctxparamvaluerdrbmessagerrr get_versions   roz --versionhelpzShow the flask versionZ expose_valueFcallbackZis_flagZis_eagerc@sUeZdZdZdddZddZddZd d Zd d Zd S)DispatchingAppaSpecial application that dispatches to a Flask application which is imported by name in a background thread. If an error happens it is recorded and shown as part of the WSGI handling which in case of the Werkzeug debugger means that it shows up in the browser. FcCsH||_d|_t|_d|_|r:|jn |jdS)N)loader_appr_lock_bg_loading_exc_info_load_unlocked_load_in_background)selfrsuse_eager_loadingrrrrH+s     zDispatchingApp.__init__cs5fdd}td|df}|jdS)NcsMd}j7yjWn!tk rAtj_YnXWdQRXdS)NT)rurw Exceptionr5r6rv)r`)ryrr _load_app6s   z5DispatchingApp._load_in_background.._load_apptargetr2)rstart)ryr|tr)ryrrx5sz"DispatchingApp._load_in_backgroundcCs2d}|j}|dk r.d|_t|dS)NT)rvr )ryr`r6rrr_flush_bg_loading_exceptionAs    z*DispatchingApp._flush_bg_loading_exceptioncCs&d}|j|_}d|_|S)NT)rsrtrv)ryr`rvrrrrwHs zDispatchingApp._load_unlockedc Csxd}|jdk r%|j||S|j|j9|jdk rT|j}n |j}|||SWdQRXdS)NT)rtrrurw)ryenvironZstart_responser`rrrr__call__Ns    zDispatchingApp.__call__N) rrrrrHrxrrwrrrrrrr$s   rrc@s7eZdZdZdddddZddZdS) ScriptInfoaHelper 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. NTcCsC|ptjjd|_||_i|_||_d|_dS)NZ FLASK_APP)rKrgetapp_import_pathr dataset_debug_flag _loaded_app)ryrr rrrrrHds    zScriptInfo.__init__cCsd}|jdk r|jSd}|jdk rFt||j}n|jrtjd|jddgdd\}}t|}t|||}n<x9d D]1}t|}t||ddd }|rPqW|std |j rt |_ ||_|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. TNz :(?![\\/])rr4wsgi.pyapp.pyr_FzCould not locate a Flask application. You did not provide the "FLASK_APP" environment variable, and a "wsgi.py" or "app.py" module was not found in the current directory.)rr) rr r*rr?rQrYrarrrdebug)ryr`rrLr< import_namerrrload_appps.        zScriptInfo.load_app)rrrrrHrrrrrr[s  rZensurecs(tjfdd}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 s:|jtjj|j||SWdQRXdS)N) ensure_objectrrZ app_contextZinvoke)Z__ctxr2kwargs)frr decoratorsz"with_appcontext..decorator)rfZ pass_contextr)rrr)rrwith_appcontextsrc@s.eZdZdZddZddZdS)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`. cs1jddfdd}|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``. rTcs.rt|}tjj|S)N)rrfGroupcommand)r)r2rry wrap_for_ctxrrrs z#AppGroup.command..decorator)pop)ryr2rrr)r2rryrrrszAppGroup.commandcOs&|jdttjj|||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) setdefaultrrfrgroup)ryr2rrrrrszAppGroup.groupN)rrrrrrrrrrrs  rcsgeZdZdZdddddddZddZdd Zd d Zfd d ZS) FlaskGroupajSpecial 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 will be added. :param add_version_option: adds the ``--version`` option. :param create_app: an optional callback that is passed the script info and returns the loaded app. :param load_dotenv: Load the nearest :file:`.env` and :file:`.flaskenv` files to set environment variables. Will also change the working directory to the directory containing the first file found. :param set_debug_flag: Set the app's debug flag based on the active environment .. versionchanged:: 1.0 If installed, python-dotenv will be used to load environment variables from :file:`.env` and :file:`.flaskenv` files. TNcKst|jddpf}|r1|jttj|d||||_||_||_|r|j t |j t |j t d|_ dS)NparamsF)listrrRversion_optionrrHr load_dotenvr add_command run_command shell_commandroutes_command_loaded_plugin_commands)ryZadd_default_commandsr Zadd_version_optionrrextrarrrrrHs        zFlaskGroup.__init__c Cs|jr dSyddl}Wntk r>d|_dSYnXx0|jdD]}|j|j|jqOWd|_dS)NrTzflask.commands)r pkg_resourcesr[iter_entry_pointsrloadr<)ryreprrr_load_plugin_commandss    z FlaskGroup._load_plugin_commandsc Cs|jtj|||}|dk r/|S|jt}y/|jjj||}|dk rl|SWntk rYnXdS)N)rr get_commandrrrclir)ryrkr<rinforrrrs    zFlaskGroup.get_commandc Cs|jttjj||}|jt}y#|j|jj j|Wnt k rut j YnXt |S)N)rsetrfr list_commandsrrupdaterrr{r\ print_excsorted)ryrkrrrrrr$s # zFlaskGroup.list_commandscsdtjd|j|}tt|jfdd|DS)Ncs"g|]}|qSrr)ritem)rkrl super_convertrrrs z-SeparatedPathType.convert..)Zsplit_envvar_valuerrr)ryrmrlrkitems)r)rkrlrrrszSeparatedPathType.convert)rrrrrrr)rrrs rrunZ short_helpzRun a development server.z--hostz-hdefaultz 127.0.0.1zThe interface to bind to.z--portz-pizThe port to bind to.z--certtypez(Specify a certificate file to use HTTPS.z--keyrSrrz2The key file to use when specifying a certificate.z--reload/--no-reloadzVEnable or disable the reloader. By default the reloader is active if debug is enabled.z--debugger/--no-debuggerzVEnable or disable the debugger. By default the debugger is active if debug is enabled.z--eager-loading/--lazy-loaderzaEnable or disable eager loading. By default eager loading is enabled if the reloader is disabled.z --with-threads/--without-threadsz!Enable or disable multithreading.z --extra-fileszRExtra files that trigger a reload on change. Multiple paths are separated by '{}'.c Cst} |dkr| }|dkr-| }|dkr@| }tt| |j|t|jd|} ddlm} | ||| d|d|d|d|d |dS) aRun a local development server. This server is for development purposes only. It does not provide the stability, security, or performance of production WSGI servers. The reloader and debugger are enabled by default if FLASK_ENV=development or FLASK_DEBUG=1. Nrzr) run_simpleZ use_reloaderZ use_debuggerthreaded ssl_context extra_files)rrrrrrrZwerkzeug.servingr) rhostportreloadZdebuggerrZ with_threadsrrrrrrrrr s&9    rshellzRun a shell in the app context.c Csddl}ddlm}|jj}dtjtj|j|j |j f}i}t j j d}|rt jj|rt|d&}tt|j|d|WdQRX|j|j|jd |d |dS) a;Run 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 configure the application. rNr)_app_ctx_stackz)Python %s on %s App: %s [%s] Instance: %sZ PYTHONSTARTUPrexecbannerlocal)codeglobalsrtoprr5versionrhrrZ instance_pathrKrrrLropenevalcompilereadrZmake_shell_contextZinteract)rrrrrkZstartuprrrrr`s   &rZrouteszShow the routes for the app.z--sortz-sendpointmethodsruler@zgMethod to sort routes by. "match" is the order that Flask will match routes when dispatching a request.z --all-methodszShow HEAD and OPTIONS methods.c sttjj}|s,tjddSt|r;fnd|dkrkt|dt|}n$|dkrt|dd d }fd d |D}d}t dd|Dt dd|Dt dd|Df}dd t ||D}dj |}tj|j |j tj|j dd|DxEt ||D]4\}}tj|j |j ||jjqpWdS)z6Show all registered routes with endpoints and methods.zNo routes were registered.NHEADOPTIONSrrkeyrcSs t|jS)N)rr)rrrrsz routes_command..cs,g|]"}djt|jqS)z, )rTrr)rr)ignored_methodsrrrs z"routes_command..EndpointMethodsRulecss|]}t|jVqdS)N)r&r)rrrrr sz!routes_command..css|]}t|VqdS)N)r&)rrrrrrscss|]}t|jVqdS)N)r&r)rrrrrrscSs+g|]!\}}tt||qSr)maxr&)rhwrrrrs z"{{0:<{0}}} {{1:<{1}}} {{2:<{2}}}css|]}d|VqdS)-Nr)rwidthrrrrs)rr)rr)rrr)rr Zurl_mapZ iter_rulesrfrgrrrrzipr'striprrrstrip) sortZ all_methodsrulesZ rule_methodsheadersZwidthsrowrrr)rrrs(   #raA general utility script for Flask applications. Provides commands from Flask, extensions, and the application. Loads the application defined in the FLASK_APP environment variable, or from a wsgi.py file. Setting the FLASK_ENV environment variable to 'development' will enable debug mode.  {prefix}{cmd} FLASK_APP=hello.py {prefix}{cmd} FLASK_ENV=development {prefix}flask run cmdposixexportrprefixz$ z> cCs3tjdtjddd|r(dnddS)Nr2rZ prog_namezpython -m flask)rrr5argv) as_modulerrrrsr__main__r)rrrr@)Kr __future__rrCr(rKrhr?r5r\ functoolsroperatorr threadingrrrfZwerkzeug.utilsr_compatr r r r rr helpersrrrrr[rZ UsageErrorrr1r*r,rGrYraroOptionrobjectrrrZmake_pass_decoratorZpass_script_inforrrrrrrZ ParamTyperrrrroptionr'rLpathseprrZChoicerr<rrrrrrr s             3  ;    7B  = . #  0("" !