B ;=[s @sDdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z ddlmZmZddlZddlmZdd lmZdd lmZmZmZmZdd lmZdd lmZmZm Z y ddl!Z!Wne"k rdZ!YnXGd ddej#Z$ddZ%drddZ&ddZ'ddZ(ddZ)dsddZ*ddZ+ej,dgd d!e+ddd"Z-Gd#d$d$e.Z/Gd%d&d&e.Z0ej1e0dd'Z2d(d)Z3Gd*d+d+ej4Z5Gd,d-d-e5Z6d.d/Z7dtd0d1Z8d2d3Z9Gd4d5d5ej:Z;d6d7Zd;dd?ej>d@dAdBdCd?ej>dDe;dEdFej>dGej?dd!ddHedKddLd?ej>dMddNd?ej>dOddPd?ej>dQddRd?e2dSdTZ@ej=dUdVd:e3dWdXZAej=dYdZd:ej>d[d\eBd]d^d_d`ej>daddbdce3dddeZCe6dfjDejEdgkrdhndiejEdgkrdjndkdldmZFdudndoZGeHdpkr@eGddqdS)vu flask.cli ~~~~~~~~~ A simple command line application to run flask apps. :copyright: © 2010 by the Pallets team. :license: BSD, see LICENSE for more details. )print_functionN)update_wrapper) attrgetter)LockThread) import_string) __version__) getargspec iteritemsreraise text_type) current_app)get_debug_flagget_envget_load_dotenvc@seZdZdZdS)NoAppExceptionz3Raised if an application cannot be found or loaded.N)__name__ __module__ __qualname____doc__rr(lib/python3.7/site-packages/flask/cli.pyr'src sddlmx&dD]}t||d}t|r|SqWfddt|jD}t|dkr`|dSt|dkr~tdj|j d xrd D]j}t||d}t |ryt ||}t|r|SWqt k rt|sԂtd j||j d YqXqWtd j|j d dS)zwGiven a module instance this tries to find the best possible application in the module or raises an exception. r)Flask)appZ applicationNcsg|]\}}t|r|qSr) isinstance).0kv)rrr :sz!find_best_app..rztDetected multiple Flask applications in module "{module}". Use "FLASK_APP={module}:name" to specify the correct one.)module) create_appZmake_appzDetected factory "{factory}" in module "{module}", but could not call it without arguments. Use "FLASK_APP='{module}:{factory}(args)'" to specify arguments.)factoryr znFailed to find Flask application or factory in module "{module}". Use "FLASK_APP={module}:name to specify one.)rgetattrrr __dict__lenrformatrinspect isfunction call_factory TypeError_called_with_wrong_args) script_infor Z attr_namerZmatches app_factoryr)rr find_best_app+s8            r/rcCs\t|}|j}|j}d|kr*||d|iS|r6||S|sVt|dkrV|dkrV||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-r.Z argumentsZ args_specZ arg_namesZ arg_defaultsrrrr*dsr*cCs@td}z*x$|dk r2|jj|jkr*dS|j}qWdS~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,ws   r,c Csdddlm}td|}|s,tdj|d|\}}yt||}Wn0tk rv}zt|j dWdd}~XYnXt |r8|ryt dj|d}Wqttfk r}ztd j||d Wdd}~XYqXnd }yt|||} WnFtk r4}z&t|std j|||jd Wdd}~XYnXn|} t| |rL| Stdj|j|ddS)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.)nameNz ({args},))r0z.Could not parse the arguments in "{app_name}".)eapp_namerzc{e} The factory "{app_name}" in module "{module}" could not be called with the specified arguments.)r;r<r zFA valid Flask application was not obtained from "{module}:{app_name}".)r r<)flaskrrematchrr'groupsr$AttributeErrorr0r(r)astZ literal_eval ValueError SyntaxErrorr*r+r,rr) r-r r<rr?r:r0attrr;rrrrfind_app_by_stringsD        $ rFcCstj|}tj|ddkr0tj|d}tj|dkrLtj|}g}x6tj|\}}||tjtj |dsRPqRWt jd|krt j d|d |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. rz.pyr__init__z __init__.py.N) ospathrealpathsplitextbasenamedirnamesplitappendexistsjoinr3insert)rK module_namer:rrrprepare_imports   rVTcCsd}y t|WnTtk rdtdjrFtdj|tdn|r\tdj|dndSYnXtj |}|dkrt ||St |||SdS)NTrIz:While importing "{name}", an ImportError was raised: {tb})r:r9zCould not import "{name}".)r:) __import__ ImportErrorr3r4r8rr' traceback format_excmodulesr/rF)r-rUr<raise_if_not_found__traceback_hide__r rrr locate_apps     r^cCs:|r |jrdSd}tj|ttjd|jd|dS)Nz+Flask %(version)s Python %(python_version)s)versionZpython_version)color)Zresilient_parsingclickechor r3r_r`exit)ctxparamvaluemessagerrr get_versions   rhz --versionzShow the flask versionF)help expose_valuecallbackis_flagZis_eagerc@s:eZdZdZdddZddZddZd 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. FcCs4||_d|_t|_d|_|r(|n|dS)N)loader_appr_lock_bg_loading_exc_info_load_unlocked_load_in_background)selfrnuse_eager_loadingrrrrGs zDispatchingApp.__init__cs$fdd}t|dd}|dS)Nc sFd}j2y Wntk r6t_YnXWdQRXdS)NT)rprr Exceptionr3r4rq)r])rtrr _load_app*s  z5DispatchingApp._load_in_background.._load_appr)targetr0)rstart)rtrwtr)rtrrs)s  z"DispatchingApp._load_in_backgroundcCs$d}|j}|dk r d|_t|dS)NT)rqr )rtr]r4rrr_flush_bg_loading_exception4s z*DispatchingApp._flush_bg_loading_exceptioncCsd}||_}d|_|S)NT)rnrorq)rtr]rvrrrrr;szDispatchingApp._load_unlockedc CsXd}|jdk r|||S||j&|jdk r<|j}n|}|||SQRXdS)NT)ror{rprr)rtenvironZstart_responser]r|rrr__call__As   zDispatchingApp.__call__N)F) rrrrrGrsr{rrr~rrrrrms   rmc@s"eZdZdZdddZddZdS) 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. NcCs(|ptjd|_||_i|_d|_dS)NZ FLASK_APP)rJr}getapp_import_pathr!data _loaded_app)rtrr!rrrrGWszScriptInfo.__init__cCsd}|jdk r|jSd}|jdk r0t||j}nh|jrl|jdddgdd\}}t|}t|||}n,x*dD]"}t|}t||ddd}|rrPqrW|std t}|dk r||_ ||_|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. TN:rr2)zwsgi.pyzapp.pyF)r\zCould 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!r*rrPrVr^rrdebug)rtr]rrKr: import_namerrrrload_appbs0    zScriptInfo.load_app)NN)rrrrrGrrrrrrNs r)Zensurecstjfdd}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 s0|t|jf||SQRXdS)N) ensure_objectrrZ app_contextZinvoke)Z__ctxr0kwargs)frr decoratorsz"with_appcontext..decorator)raZ 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`. cs"ddfdd}|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$r t|}tjjf|S)N)rraGroupcommand)r)r0rrt wrap_for_ctxrrrsz#AppGroup.command..decorator)pop)rtr0rrr)r0rrtrrrs zAppGroup.commandcOs |dttjj|f||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) setdefaultrrargroup)rtr0rrrrrs zAppGroup.groupN)rrrrrrrrrrrs rcsBeZdZdZdddZddZdd Zd d Zfd d ZZ S) 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 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. .. versionchanged:: 1.0 If installed, python-dotenv will be used to load environment variables from :file:`.env` and :file:`.flaskenv` files. TNcKspt|ddpd}|r"|ttj|fd|i|||_||_|rf|t |t |t d|_ dS)NparamsrF) listrrQversion_optionrrGr! load_dotenv add_command run_command shell_commandroutes_command_loaded_plugin_commands)rtZadd_default_commandsr!Zadd_version_optionrZextrarrrrrGs    zFlaskGroup.__init__cCsb|jr dSy ddl}Wntk r0d|_dSXx$|dD]}|||jq>Wd|_dS)NrTzflask.commands)r pkg_resourcesrXZiter_entry_pointsrloadr:)rtrZeprrr_load_plugin_commandss z FlaskGroup._load_plugin_commandscCsh|t|||}|dk r"|S|t}y"|j||}|dk rL|SWntk rbYnXdS)N)rr get_commandrrrclir)rtrdr:r|inforrrrs  zFlaskGroup.get_commandcCsd|ttj||}|t}y||j |Wnt k rZt YnXt |S)N)rsetrar list_commandsrrupdaterrrvrY print_excsorted)rtrdr|rrrrr s zFlaskGroup.list_commandscs^dtjd<t|jrt|d}|dkr8t|jd}||d<|ddtt |j ||S)NtrueZFLASK_RUN_FROM_CLIobj)r!Zauto_envvar_prefixZFLASK) rJr}rrrrr!rsuperrmain)rtr0rr) __class__rrrs     zFlaskGroup.main)TNTT) rrrrrGrrrr __classcell__rr)rrrs  rcCs&tj||t|dtj|kS)zTake ``other`` and remove the length of ``path`` from it. Then join it to ``path``. If it is the original value, ``path`` is an ancestor of ``other``.N)rJrKrSr&lstripsep)rKotherrrr_path_is_ancestor0srcCstdkr6|s$tjds$tjdr2tjddddS|dk rHt|Sd}x>dD]6}tj|dd }|sjqR|dkr~tj|}t|qRW|rt |krt ||dk S) aLoad "dotenv" files in order of precedence to set environment variables. If an env var is already set it is not overwritten, so earlier files in the list are preferred over later files. Changes the current working directory to the location of the first file found, with the assumption that it is in the top level project directory and will be where the Python path should import local packages from. This is a no-op if `python-dotenv`_ is not installed. .. _python-dotenv: https://github.com/theskumar/python-dotenv#readme :param path: Load the file at this location instead of searching. :return: ``True`` if a file was loaded. .. versionadded:: 1.0 Nz.envz .flaskenvzQ * Tip: There are .env files present. Do "pip install python-dotenv" to use them.Zyellow)fg)z.envz .flaskenvT)Zusecwd) dotenvrJrKrRrasechorZ find_dotenvrOgetcwdchdir)rKZnew_dirr:rrrr7s&    rcCstjddkrdS|dk rEsz routes_command..cs g|]}dt|jqS)z, )rSrr)rr)ignored_methodsrrrHsz"routes_command..)ZEndpointZMethodsZRulecss|]}t|jVqdS)N)r&r)rrrrr Msz!routes_command..css|]}t|VqdS)N)r&)rrrrrrNscss|]}t|jVqdS)N)r&r)rrrrrrOscSsg|]\}}tt||qSr)maxr&)rhwrrrrQsz"{{0:<{0}}} {{1:<{1}}} {{2:<{2}}}css|]}d|VqdS)-Nr)rwidthrrrrUs)rrZurl_mapZ iter_rulesrarbrrrrzipr'striprrrstrip) sortZ all_methodsZrulesZ rule_methodsZheadersZwidthsrowrrr)rrr(s(  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 posixZexportrz$ z> )cmdprefix)ricCsVtjdd}|r@d}tjdkr(|d7}d|}d|g|t_nd}tj||ddS)Nrr=)r2rz.cliz python -m z-m)r0Z prog_name)r3argvrrr) as_moduler0Z this_moduler:rrrrms r__main__)r)r)T)N)F)IrZ __future__rrBr(rJr>rr3rY functoolsroperatorrZ threadingrrraZwerkzeug.utilsrr#r Z_compatr r r r globalsrZhelpersrrrrrXZ UsageErrorrr/r*r,rFrVr^rhZOptionrobjectrmrZmake_pass_decoratorZpass_script_inforrrrrrrZ ParamTyperrrZoptionrrrZChoicerr'r:rrrrrrr s        9 <  6B s 1('     ! $