o }e@sddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl mZddlmZddlZddlmZddlmZddlmZddlmZd d lmZd d lmZd d lmZe jrmd d l m!Z!Gdddej"Z#ddZ$ddZ%ddZ&ddZ'dddZ(ddZ)ej*dgdde)ddd Z+Gd!d"d"Z,ej-e,dd#Z.d$d%Z/Gd&d'd'ej0Z1dd/d0Z2ej*d1d2gd3d4dde2d5Z3dd8d9Z4ej*d:gd;de4d<Z5dd=d>Z6ej*d?d@gej7dddAdBdde6dCZ8GdDdEdEe1Z9dFdGZ:dddJdKZ;dLdMZdPdQZ?GdRdSdSej7Z@ejAdTdUdVejBdWdXdYdZd[ejBd\d]d^d_d[ejBd`e>daddbejBdcej7ddddde?ddedfejBdgddhd[ejBdiddjd[ejBdkddld[ejBdmde@dnejCjDdodpejBdqde@drejCjDdodpe.dsdtZEeEjFGde5ejAdudvdVe/ddxdyZHejAdzd{dVejBd|d}eId~dddejBdddde/dddZJe9dddZKdddZLeMdkreLdSdS)) annotationsN)update_wrapper) itemgetter)ParameterSource) run_simple)is_running_from_reloader) import_string) current_app)get_debug_flag)get_load_dotenvFlaskc@seZdZdZdS)NoAppExceptionz3Raised if an application cannot be found or loaded.N)__name__ __module__ __qualname____doc__rrR/Users/abhinavbhinder/Documents/map/venv/lib/python3.10/site-packages/flask/cli.pyrsrcs*ddlmdD]}t||d}t|r|Sqfdd|jD}t|dkr0|dSt|dkrCtd|jd |jd d D]B}t||d}t |rz|}t|r`|WSWqEt y}zt |sntd |d |jd|jd|d |d}~wwqEtd|jd |jd)zwGiven a module instance this tries to find the best possible application in the module or raises an exception. r r )appZ applicationNcsg|] }t|r|qSr) isinstance).0vr rr /sz!find_best_app..rz0Detected multiple Flask applications in module 'z'. Use 'z":name' to specify the correct one.) create_appZmake_appzDetected factory 'z ' in module 'z1', but could not call it without arguments. Use ':z(args)' to specify arguments.z7Failed to find Flask application or factory in module 'z:name' to specify one.) rgetattrr__dict__valueslenrrinspect isfunction TypeError_called_with_wrong_args)module attr_namermatchesZ app_factoryerr r find_best_app!s^         r*cCsFtd}z|dur|jj|jurW~dS|j}|dus W~dS~w)zCheck whether calling a function raised a ``TypeError`` because the call failed or because something in the factory raised the error. :param f: The function that was called. :return: ``True`` if the call failed. NFT)sysexc_infotb_framef_code__code__tb_next)ftbrrrr%Vs   r%c Csddlm}z tj|ddj}Wnty"td|ddwt|tj r1|j }g}i}nDt|tj rmt|j tj sFtd|d |j j }zd d |j D}d d |jD}Wntyltd|d dwtd|dzt||}Wnty}z td|d|jd |d}~wwt|rz ||i|} Wn ty}zt|std|d|jd|d}~ww|} t| |r| Std|jd|d)zCheck if the given string is a variable name or a function. Call a function to get the app instance, or return the variable directly. r r eval)modezFailed to parse z' as an attribute name or function call.Nz*Function reference must be a simple name: .cSsg|]}t|qSr)ast literal_eval)rargrrrrsz&find_app_by_string..cSsi|] }|jt|jqSr)r9r7r8value)rkwrrr sz&find_app_by_string..z-Failed to parse arguments as literal values: zFailed to find attribute z in z The factory z in module z2 could not be called with the specified arguments.z1A valid Flask application was not obtained from 'rz'.)rrr7parsestripbody SyntaxErrorrrNameidCallfuncargskeywords ValueErrorrAttributeErrorrr"r#r$r%) r&app_namerexprnamerEkwargsattrr)rrrrfind_app_by_stringps           rNcCstj|}tj|\}}|dkr|}tj|dkr"tj|}g} tj|\}}||tjtj |ds>nq%t jd|krMt 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. z.py__init__Tz __init__.pyrr6N) ospathrealpathsplitextbasenamedirnamesplitappendexistsjoinr,insert)rRfnameext module_namerKrrrprepare_imports   r_Tc Cszt|Wn)ty/tdjr!td|dtd|r,td|ddYdSwtj|}|dur=t |St ||S)Nr+zWhile importing z, an ImportError was raised: zCould not import r6) __import__ ImportErrorr,r-r1r traceback format_excmodulesr*rN)r^rIraise_if_not_foundr&rrr locate_apps&    rfcCsX|r|jrdStjd}tjd}tjdtd|d||jd| dS)NflaskwerkzeugPython z Flask z Werkzeug )color) Zresilient_parsing importlibmetadataversionclickechoplatformpython_versionrjexit)ctxparamr:Z flask_versionZwerkzeug_versionrrr get_versions     ruz --versionzShow the Flask version.F)help expose_valuecallbackis_flagis_eagerc@s,eZdZdZ   ddd d ZdddZdS) 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. NTapp_import_path str | Nonert.Callable[..., Flask] | Noneset_debug_flagboolreturnNonecCs"||_||_i|_||_d|_dSN)r|rdatar _loaded_app)selfr|rrrrrrOs  zScriptInfo.__init__rcCs|jdur|jS|jdur|}n3|jr1tjd|jdddgdd\}}t|}t||}ndD]}t|}t|ddd}|rDnq3|sKtd |jrRt |_ ||_|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. Nz :(?![\\/])r )maxsplitr+)zwsgi.pyzapp.pyF)rezCould not locate a Flask application. Use the 'flask --app' option, 'FLASK_APP' environment variable, or a 'wsgi.py' or 'app.py' file in the current directory.) rrr|rerWr_rfrrr debug)rrrRrK import_namerrrload_app%s0    zScriptInfo.load_app)NNT)r|r}rr~rrrr)rr)rrrrrOrrrrrr{ s  r{)Zensurecstjfdd}t|S)aWraps a callback so that it's guaranteed to be executed with the script's application context. Custom commands (and their options) registered under ``app.cli`` or ``blueprint.cli`` will always have an app context available, this decorator is not required in that case. .. versionchanged:: 2.2 The app context is active for subcommands as well as the decorated callback. The app context is always available to ``app.cli`` command and parameter callbacks. cs8ts|t}|||jg|Ri|Sr)r ensure_objectr{r with_resource app_contextZinvoke)Z__ctxrErLrr2rr decorator`sz"with_appcontext..decorator)rnZ pass_contextr)r2rrrrwith_appcontextRs rc@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*rt|}tjjgRi|Sr)rrnGroupcommandrrErLrZ wrap_for_ctxrrrzsz#AppGroup.command..decorator)pop)rrErLrrrrrss zAppGroup.commandcOs&|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) setdefaultrrnrgroup)rrErLrrrrs zAppGroup.groupN)rrrrrrrrrrrks rrs click.Contextrt click.Optionr:r}rcCs |durdS|t}||_|Sr)rr{r|)rsrtr:inforrr_set_apps  rz-Az--appZIMPORTzThe Flask application or factory function to load, in the form 'module:name'. Module can be a dotted import or file path. Name is not required if it is 'app', 'application', 'create_app', or 'make_app', and can be 'name(args)' to pass arguments.)metavarrvrzrwrxr bool | NonecCs>||j}|dur|tjtjfvrdS|rdndtjd<|S)N10Z FLASK_DEBUG)Zget_parameter_sourcerKrDEFAULTZ DEFAULT_MAPrQenviron)rsrtr:sourcerrr _set_debugs  rz--debug/--no-debugzSet debug mode.)rvrwrxcCsP|durdSddl}z|dWnty!tjd||ddwt||S)Nrdotenvz4python-dotenv must be installed to load an env file.)rsrt)rk import_modulerarn BadParameter load_dotenv)rsrtr:rkrrr_env_file_callbacks   rz-ez --env-file)rYdir_okayzKLoad environment variables from this file. python-dotenv must be installed.)typervrzrwrxcsneZdZdZ     d#d$fdd ZddZfddZfddZ d%d&fdd Zd'fd!d" Z Z S)( FlaskGroupa0Special 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. 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. .. versionchanged:: 2.2 Added the ``-A/--app``, ``--debug/--no-debug``, ``-e/--env-file`` options. .. versionchanged:: 2.2 An app context is pushed when running ``app.cli`` commands, so ``@with_appcontext`` is no longer required for those commands. .. versionchanged:: 1.0 If installed, python-dotenv will be used to load environment variables from :file:`.env` and :file:`.flaskenv` files. TNadd_default_commandsrrr~add_version_optionrrextrat.Anyrrc st|ddpd}|tttf|r|td|vr!i|d<|dddt j dd|i|||_ ||_ ||_ |rN|t|t|td|_dS)Nparamsrcontext_settingsZauto_envvar_prefixZFLASKF)listrextend_env_file_option _app_option _debug_optionrXversion_optionrsuperrOrrr add_command run_command shell_commandroutes_command_loaded_plugin_commands)rrrrrrrr __class__rrrOs       zFlaskGroup.__init__cCsX|jrdStjdkrddlm}nddl}|jddD] }|||j qd|_dS)N) r)rlzflask.commands)rT) rr, version_inforkrlZimportlib_metadataZ entry_pointsrloadrK)rrleprrr_load_plugin_commands$s  z FlaskGroup._load_plugin_commandsc s|t||}|dur|S|t}z|}Wn!ty=}ztjd| ddddWYd}~dSd}~wwt rFt |urM| | |j||SNzError:  Tred)errfg)rr get_commandrr{rrrnsechoformat_messager Z_get_current_objectrrcli)rrsrKrvrrr)rrrr5s  zFlaskGroup.get_commandc s|tt|}|t}z||j|Wt|St yD}zt j d| ddddWYd}~t|Sd}~wt y\t j tddddYt|Swr)rsetr list_commandsrr{updaterrrrnrr Exceptionrbrcsorted)rrsrrr)rrrrPs  & zFlaskGroup.list_commands info_namer}rE list[str]parentclick.Context | Nonerc sZdtjd<t|jr td|vr d|jvr t|j|jd|d<tj ||fd|i|S)NtrueZFLASK_RUN_FROM_CLIobj)rrr) rQrr rrr{rrr make_context)rrrErrrrrres  zFlaskGroup.make_contextrscs4|s|jrt|igt|igt||Sr)Zno_args_is_helprZhandle_parse_resultrr parse_args)rrsrErrrr}s zFlaskGroup.parse_args)TNTTT)rrrr~rrrrrrrrrrr) rr}rErrrrrrr)rsrrErrr) rrrrrOrrrrr __classcell__rrrrrs%  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)rQrRrZr!lstripsep)rRotherrrr_path_is_ancestors&rrRstr | os.PathLike | NonecCszddl}Wn ty&|stjdstjdr#tjddddYd Sw|dur:tj|r8|j|d d Sd Sd }d D]}|j|dd }|sJq>|j|d d d}q>|S)a?Load "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. 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. .. versionchanged:: 2.0 The current directory is not changed to the location of the loaded file. .. versionchanged:: 2.0 When loading the env files, set the default encoding to UTF-8. .. versionchanged:: 1.1.0 Returns ``False`` when python-dotenv is not installed, or when the given path isn't a file. .. versionadded:: 1.0 rN.env .flaskenvz^ * Tip: There are .env or .flaskenv files present. Do "pip install python-dotenv" to use them.yellowT)rrFzutf-8)encoding)rr)Zusecwd) rrarQrRisfilernrrZ find_dotenv)rRrZloadedrKrrrrs.   rcCsLtrdS|durtd|d|dur$td|rdnddSdS)z]Show extra startup messages the first time the server is run, ignoring the reloader. Nz * Serving Flask app ''z * Debug mode: onoff)rrnro)rr|rrrshow_server_bannersrc@s$eZdZdZdZddZddZdS) CertParamTypezClick option type for the ``--cert`` option. Allows either an existing file, the string ``'adhoc'``, or an import for a :class:`~ssl.SSLContext` object. rRcCstjdddd|_dS)NTFrYrZ resolve_path)rnPath path_type)rrrrrOszCertParamType.__init__c Cszddl}Wntytd||dwz||||WStjy]t|||}|dkrLz ddl}W|YStyKtd||dwt|dd}t ||j r\|YSw)Nrz?Using "--cert" requires Python to be compiled with SSL support.adhocz.)Zsplit_envvar_valuerr)rr:rtrsitemsrrrr3s zSeparatedPathType.convert)rrrrrrrrrrr-srrunzRun a development server.)Z short_helpz--hostz-hz 127.0.0.1zThe interface to bind to.)defaultrvz--portz-pizThe port to bind to.z--certz(Specify a certificate file to use HTTPS.)rrvrzz--keyrz2The key file to use when specifying a certificate.)rrxrwrvz--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 --with-threads/--without-threadsz!Enable or disable multithreading.z --extra-fileszMExtra files that trigger a reload on change. Multiple paths are separated by r6)rrrvz--exclude-patternsznFiles matching these fnmatch patterns will not trigger a reload on change. Multiple patterns are separated by c sz|} Wn%ty+} ztrt| fdd} n| dWYd} ~ nd} ~ wwt} |dur5| }|dur;| }t| |jt||| ||||||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 with the '--debug' option. csdrr)rZstart_responserrrrszrun_command..appN)Z use_reloaderZ use_debuggerZthreaded ssl_context extra_filesexclude_patterns) rrrrb print_excr rr|r) rhostportreloadZdebuggerZ with_threadsrrrrr)rrrrr9s8H    rshellzRun a shell in the app context.rcCsddl}dtjdtjdtjdtj}i}tj d}|rEtj |rEt |}t t||d|Wdn1s@wY|tttd d}|durwz ddl}dd lm}Wn tykYn w|||j||j||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 its configuration. This is useful for executing small snippets of management code without having to manually configure the application. rNriz on z App: z Instance: Z PYTHONSTARTUPexec__interactivehook__) Completer)bannerlocal)coder,rmrpr rZ instance_pathrQrrrRropenr4compilereadrZmake_shell_contextrreadline rlcompleterr raZ set_completerZcompleteZinteract)rrrsZstartupr2Zinteractive_hookrr rrrrs2     rZrouteszShow the routes for the app.z--sortz-s)endpointmethodsdomainrulematchrzgMethod to sort routes by. 'match' is the order that Flask will match routes when dispatching a request.)rrrvz --all-methodszShow HEAD and OPTIONS methods.)ryrvsortstr all_methodsc sttj}|stddS|rtnddh}tjjtfdd|D}g|D],}|j d t |j p8t|g}|rM| rG|jn|jpKd| |j |q,d d g}d d g}|rq| rid nd| d| d| dz jt||dWn tyYnwd|fddtt|D} ddd| Dd ddt| D} D] }t| j|qdS)z6Show all registered routes with endpoints and methods.zNo routes were registered.NHEADOPTIONSc3s |] }r |jn|jVqdSr)r subdomain)rr) host_matchingrr sz!routes_command..z, rZEndpointZMethodsrrHostZ SubdomainrZRuler)keyrcs"g|] tfddDqS)c3s|] }t|VqdSr)r!)rrowirrr"sz,routes_command...)max)r)rowsr&rrs"z"routes_command..r cSsg|]}d|qS)-r)rwrrrrsz css&|]\}}d|d|dVqdS){z:<}Nr)rr'r+rrrr"s$)rr Zurl_mapZ iter_rulesrnrorr!anyrrZrrrXrr rrrindexrGr[ranger! enumerateformat) rrrulesZignored_methodsZ has_domainrr%headersZsortsZwidthstemplater)r!r)rrsF        rrgzA general utility script for Flask applications. An application to load must be given with the '--app' option, 'FLASK_APP' environment variable, or with a 'wsgi.py' or 'app.py' file in the current directory. )rKrvcCs tdSr)rmainrrrrr6's r6__main__)T)rsrrtrr:r}rr})rsrrtrr:rrrr)rRrrr)rr)rrrrrr)N __future__rr7importlib.metadatarkr"rQrprr,rbtypingt functoolsroperatorrrnZ click.corerrhrZwerkzeug.servingrZwerkzeug.utilsrglobalsr Zhelpersr r TYPE_CHECKINGrrZ UsageErrorrr*r%rNr_rfruOptionrr{Zmake_pass_decoratorZpass_script_inforrrrrrrrrrrrrrZ ParamTyperrrroptionrRpathseprrr[rZChoicerrr6rrrrrs$           5L  D      ' =.%   ;  / 1