a d`@sNdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlZddlmZddlmZddlmZddlmZddlmZdd lmZdd lmZmZmZm Z m!Z!m"Z"m#Z#ddl$Z$ddl%Z%ddl&Z&ddl'Z'dd l(m)Z)dd l*m+Z+m,Z,dd l-m.Z.ddl/Z/ddl0m1Z1ddl2m3Z3erzddl4m5Z5m6Z6m7Z7ddl8m9Z9e j:;e j:e ?e@dpdAdBZCe.dZDe"dZEddddZFddddZGddddZHddd d!ZId"dd#d$ZJddd%d&ZKd'd'd(d)d*ZLd+d,d-d.d/ZMd,dd0d1ZNd2d3d4d5d6ZOdd8d8d9d:d;d<ZPd'd=d>d?d@ZQdd8dd8dBdCdDZRdEdFdGdHdIZSd'dJdKdLdMZTd2dNdOdPZUdQdRZVGdSdTdTZWdUdVZXGdWdXdXZYedYdZd[d\ZZd]d]d^d_d`Z[d3d3dadbdcZ\d'dddedfdgZ]d'ddhdidjZ^dkdlZ_d2dmd2dndodpZ`ddqdrZad2dsd"dtdudvZbdwdxdydzZcd'd{dd|d}d~ZddddddZeddZfddZgd2dddddZhdddddZiGdddejZkGdddZlddZmdddddZndddddZodd"dddZpe qdZrd"d'dddZsd{dddZtdS)z Handy utility functions. ) annotationsN)contextmanager)Enum)BytesIO)Number)Path) GeneratorType) TYPE_CHECKINGAnyCallable GeneratorOptionalTypeVarUnion) Serializable) BaseModel parse_obj_as) ParamSpec)Context)en)Block BlockContextBlocks) Componentz launches.jsonz version.txtasciiPTboolreturnc CsFd}z&ddlm}|}dt|vr(d}Wnttfy@Yn0|S)zf Check if interface is launching from Google Colab :return is_colab (bool): True or False Fr get_ipythonz google.colabT)IPython.core.getipythonr"str ImportError NameError)Zis_colabr"Z from_ipynbr'U/var/www/html/stable-diffusion-webui/venv/lib/python3.9/site-packages/gradio/utils.py colab_check<s  r)cCsttjdptjdS)NZKAGGLE_KERNEL_RUN_TYPEZGFOOTBALL_DATA_DIR)rosenvirongetr'r'r'r( kaggle_checkMsr-cCsFz,ddl}|d}|}d|dvWSty@YdS0dS)NrstsZ sagemakerZArnF)boto3clientZget_caller_identitylower Exception)r/r0responser'r'r(sagemaker_checkSs  r4c Cs>d}zddlm}|dur d}Wnttfy8Yn0|S)zo Check if interface is launching from iPython (not colab) :return is_ipython (bool): True or False Frr!NT)r#r"r%r&)Z is_ipythonr"r'r'r( ipython_check^s  r5z str | NonecCstddkrtdSdS)NZSYSTEMspacesZSPACE_IDr*getenvr'r'r'r( get_spacens r9cCstddkS)NZSPACES_ZERO_GPUtruer7r'r'r'r(is_zero_gpu_spacetsr;r$)articler cCsBz&tj|dd}|jtjjkr$|j}Wntjjy<Yn0|S)N)timeout)requestsr, status_codecodesoktext exceptionsRequestException)r<r3r'r'r(readme_to_htmlxs rFz gradio.BlocksNone) interfacer cCs2|jr.tdkr.ttd}td|dS)Ng?ZTIPSzTip: )Z show_tipsrandomchoicerprint)rHZtipr'r'r(show_tipsrLcCsztjtsNddi}ttd}t||Wdq1sB0Yntt}t|}Wdn1sv0Y|dd7<|ddvrtt dttd }| t |Wdn1s0YWnt yYn0dS)Nlauncheszw+)2iiZ BETA_INVITEw) r*pathexists JSON_PATHopenjsondumploadrKrwritedumpsr2)rMjr'r'r(launch_counters  , (   2 r]r z list[Any])funcr cCst|}dd|jDS)NcSs$g|]}|jtjjur|jndqSN)defaultinspect Parameterempty.0vr'r'r( sz$get_default_args..)ra signature parametersvalues)r^rhr'r'r(get_default_argss rkmodedicttuple)config1config2 root_keyscsdtttjdd|D]"}||ks$Jd|q$tdtdkshJdfddfdd d d }d d }||td d D]\}}t|d |d D]\}} || qt|d|dD]\} } | | qt|d|dD]\} } | | q.||ksJ|d|qdS)aAllows you to test if two different Blocks configs produce the same demo. Parameters: config1 (dict): nested dict with config from the first Blocks instance config2 (dict): nested dict with config from the second Blocks instance root_keys (Tuple): an interable consisting of which keys to test for equivalence at the root level of the config. By default, only "mode" is tested, so keys like "version" are ignored. )indentzConfigs have different: componentsz# of components are differentcsttfdddd}ttfdddd}t|}|dt|}|dt|t|ksJ|d|dS)Ncs |dkSNidr'c) config1_idr'r(rz[assert_configs_are_equivalent_besides_ids..assert_same_components..rurcs |dkSrvr'rx) config2_idr'r(r{rrw does not match )listfiltercopydeepcopypoprWr[pprint)rzr|Zc1c2)rprqpp)rzr|r(assert_same_componentss     zIassert_configs_are_equivalent_besides_ids..assert_same_componentscsLt||D]<\}}|d|dd|vs4d|vr |d|dq dS)Nrwchildren)zip) children1Zchidren2Zchild1Zchild2)rsame_children_recursiver'r(rszJassert_configs_are_equivalent_besides_ids..same_children_recursiveZlayoutr dependenciestargetsinputsoutputsr}T)rrr PrettyPrinterlenrr)rprqrrkeyrZ children2d1Zd2t1t2i1i2Zo1Zo2r')rrprqrrr()assert_configs_are_equivalent_besides_idss0          rzlist[dict[str, str | int]]) input_string ner_groupscCst|dkr|dfgSg}d}d}|D]P}|d|d|d}}}||||df|||||f|}q&|||ddf|S)NrZ entity_groupstartend)rappend)rroutputrZprev_endgroupentityrr'r'r(format_ner_lists  rF)_dict skip_valuer cCs8t|D]&\}}|r$|dkr$q q |dur ||=q |S)z= Delete keys whose values are None from a dictionary valueN)r~items)rrrrr'r'r( delete_nones  rzlist[Any] | Anyr )_listr cCst|dkr|dS|SdS)NrNr)r)rr'r'r(resolve_singletons rz$type[Component] | type[BlockContext])cls_namer cCsddl}ddl}ddl}ddl}dd|jjD}dd|jjD}dd|jjD}|||D]@\}}| | ddkrnt ||jj st ||j jrn|Sqntd |dS) z Returns the component, template, or layout class with the given class name, or raises a ValueError if not found. Parameters: cls_name (str): lower-case string class name of a component Returns: cls: the component class rNcSs"g|]\}}t|tr||fqSr' isinstancetyperenameclsr'r'r(rgs z-component_or_layout_class..cSs"g|]\}}t|tr||fqSr'rrr'r'r(rgs cSs"g|]\}}t|tr||fqSr'rrr'r'r(rgs _zNo such component or layout: ) gradio.blocksgradio.componentsZgradio.layoutsZgradio.templatesru__dict__r templateslayoutsr1replace issubclassrblocksr ValueError)rgradiorurrrrr'r'r(component_or_layout_classs*       r)r^cOst}|||i|S)a? Runs coroutines in background. Warning, be careful to not use this function in other than FastAPI scope, because the event_loop has not started yet. You can use it in any scope reached by FastAPI app. correct scope examples: endpoints in routes, Blocks.process_api incorrect scope examples: Blocks.launch Use startup_events in routes.py if you need to run a coro in background in Blocks.launch(). Example: utils.run_coro_in_background(fn, *args, **kwargs) Args: func: *args: **kwargs: Returns: )asyncioZget_event_loopZ create_task)r^argskwargsZ event_loopr'r'r(run_coro_in_background'srcCs*z t|WSty$tdYn0dS)z;Helper for yielding StopAsyncIteration from sync iterators.N)next StopIterationStopAsyncIterationiteratorr'r'r(run_sync_iterator_asyncCs  rc@s.eZdZdZddddZddZdd Zd S) SyncToAsyncIteratorz*Treat a synchronous iterator as async one.rGrcCs||_||_dSr_)rlimiter)selfrrr'r'r(__init__OszSyncToAsyncIterator.__init__cCs|Sr_r'rr'r'r( __aiter__SszSyncToAsyncIterator.__aiter__cstjjt|j|jdIdHS)N)r)anyioZ to_threadZrun_syncrrrrr'r'r( __anext__Vs zSyncToAsyncIterator.__anext__N)__name__ __module__ __qualname____doc__rrrr'r'r'r(rLsrcs|IdHSr_)rrr'r'r(async_iteration\src @seZdZdZeZGdddeeZ dde ddddddd d d d d ddZ ddddZ ddddZ eddddddZddZddddZdd Zd0d d d!d"d#Zd$d%Zed&d'Zed(d)Zed*d+Zed,d-Zed.d/ZdS)1 AsyncRequesta The AsyncRequest class is a low-level API that allow you to create asynchronous HTTP requests without a context manager. Compared to making calls by using httpx directly, AsyncRequest offers several advantages: (1) Includes response validation functionality both using validation models and functions. (2) Exceptions are handled silently during the request call, which provides the ability to inspect each one request call individually in the case where there are multiple asynchronous request calls and some of them fail. (3) Provides HTTP request types with AsyncRequest.Method Enum class for ease of usage AsyncRequest also offers some util functions such as has_exception, is_valid and status to inspect get detailed information about executed request call. The basic usage of AsyncRequest is as follows: create a AsyncRequest object with inputs(method, url etc.). Then use it with the "await" statement, and then you can use util functions to do some post request checks depending on your use-case. Finally, call the get_validated_data function to get the response data. You can see example usages in test_utils.py. c@s8eZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d S) zAsyncRequest.Methodzf Method is an enumeration class that contains possible types of HTTP request methods. *CONNECTHEADGETDELETEOPTIONSPATCHPOSTPUTTRACEN)rrrrANYrrrrrrrrrr'r'r'r(MethodvsrNF)validation_modelvalidation_functionexception_typeraise_for_statusr0r$ztype[BaseModel] | NonezUnion[Callable, None]ztype[Exception]rzhttpx.AsyncClient | None)methodurlrrrrr0c KsPd|_d|_||_||_||_||_d|_|j||fi||_|pH|j |_ dS)aR Initialize the Request instance. Args: method(Request.Method) : method of the request url(str): url of the request * validation_model(Type[BaseModel]): a pydantic validation class type to use in validation of the response validation_function(Callable): a callable instance to use in validation of the response exception_class(Type[Exception]): a exception type to throw with its type raise_for_status(bool): a flag that determines to raise httpx.Request.raise_for_status() exceptions. N) _exception_status_raise_for_status_validation_model_validation_function_exception_type_validated_data_create_request_requestr0client_) rrrrrrrr0rr'r'r(rszAsyncRequest.__init__z"Generator[None, Any, AsyncRequest]rcCs |S)zq Wrap Request's __await__ magic function to create request calls which are executed in one line. )_AsyncRequest__run __await__rr'r'r(rszAsyncRequest.__await__c szN|j|jIdH|_|jj|_|jr2|j|j|_ | |j |_ Wn0t y~}z| ||_WYd}~n d}~00|S)a Manage the request call lifecycle. Execute the request by sending it through the client, then check its status. Then parse the request into Json format. And then validate it using the provided validation methods. If a problem occurs in this sequential process, an exception will be raised within the corresponding method, and allowed to be examined. Manage the request call lifecycle. Returns: Request N)rsendr _responser@rrrrW_json_response_data_validate_response_datarr2rr)r exceptionr'r'r(Z__runs     "zAsyncRequest.__runz httpx.Request)rrr cKstj||fi|}|S)z Create a request. This is a httpx request wrapper function. Args: method(Request.Method): request method type url(str): target url of the request **kwargs Returns: Request )httpxRequest)rrrrequestr'r'r(rs zAsyncRequest._create_requestc CsX|}z$|jr||}|jr&||}Wn*tyR}z||_WYd}~n d}~00|S)aA Validate response using given validation methods. If there is a validation method and response is not valid, validation functions will raise an exception for them. Args: response(ResponseJson): response object Returns: ResponseJson: Validated Json object. N)r_validate_response_by_modelr)_validate_response_by_validation_functionr2r)rr3Zvalidated_responserr'r'r(rs  z$AsyncRequest._validate_response_datarcCst}|jrt|j|}|S)z Validate response json using the validation model. Args: response(ResponseJson): response object Returns: ResponseJson: Validated Json object. )rrrrr3Zvalidated_datar'r'r(rs z(AsyncRequest._validate_response_by_modelcCsd}|jr||}|S)z Validate response json using the validation function. Args: response(ResponseJson): response object Returns: ResponseJson: Validated Json object. N)rrr'r'r(rs z6AsyncRequest._validate_response_by_validation_function)raise_exceptionsr cCs"|jr|jr|r|jdSdSdS)z Check response object's validity+. Raise exceptions if raise_exceptions flag is True. Args: raise_exceptions(bool) : a flag to raise exceptions in this check Returns: bool: validity of the data FTN has_exceptionr)rrr'r'r(is_valids  zAsyncRequest.is_validcCs|jSr_)rrr'r'r(get_validated_data#szAsyncRequest.get_validated_datacCs|jSr_)rrr'r'r(rW&szAsyncRequest.jsoncCs|jSr_)rrr'r'r(r*szAsyncRequest.exceptioncCs |jduSr_)rrr'r'r(r.szAsyncRequest.has_exceptioncCs|jr|jr|jdSr_rrr'r'r(r2s zAsyncRequest.raise_exceptionscCs|jSr_)rrr'r'r(status7szAsyncRequest.status)F)rrrrrZ AsyncClientr0r$rrr2rrr staticmethodrrrrrrpropertyrWrrrrr'r'r'r(ras8"      rz Path | str)rSc cs:t}zt|dVWt|n t|0dS)zBContext manager that sets the working directory to the given path.N)rabsoluter*chdir)rSoriginr'r'r( set_directory<s   rz str | Number)rr csXttrSgd}gd}tfdd|DsJtfdd|DrTdS)z Sanitizes a value that is being written to a CSV file to prevent CSV injection attacks. Reference: https://owasp.org/www-community/attacks/CSV_Injection )=+-@  )z,=z,+z,-z,@z, z, c3s|]}|VqdSr_) startswith)reprefixrr'r( Prz)sanitize_value_for_csv..c3s|]}|vVqdSr_r')resequencerr'r(rPs')rrany)rZunsafe_prefixesZunsafe_sequencesr'rr(sanitize_value_for_csvGs " r)rjr cCsHg}|D]:}t|tr0dd|D}||qt|}||q|S)z Sanitizes a list of values (or a list of list of values) that is being written to a CSV file to prevent CSV injection attacks. cSsg|] }t|qSr')rrdr'r'r(rg_rz)sanitize_list_for_csv..)rr~rr)rjZsanitized_valuesrZsanitized_valuer'r'r(sanitize_list_for_csvWs   rz list[str])r list_of_namescCsNt|}||vr|Sd}|d|}||vrF|d7}|d|}q&|SdS)zSAppends a numerical suffix to `name` so that it does not appear in `list_of_names`.rNrN)set)rrZ set_of_namesZsuffix_counternew_namer'r'r(append_unique_suffixgsr) possible_urlr cCs^ddi}ztj||djWS|jWStyXYdS0dS)Nz User-Agentz-gradio (https://gradio.app/; team@gradio.app))headersiiF)r?headr@r,rBr2)rrZ head_requestr'r'r( validate_urlus rcCst|tod|ddvS)NupdateZ__type__r)rrnr,)valr'r'r( is_updatesr"float)fneveryr csfdd}|S)Nc7s4|}t|tr|EdHn|VtqdSr_)rrtimesleep)rrr%r$r'r( continuous_fns   z(get_continuous_fn..continuous_fnr')r$r%r)r'r(r(get_continuous_fns r*c sdur gndurgntrLtfdd}|Strxtfdd}|Strtfdd}|Stfdd}|SdS) Ncs@r |i|2z3dHW}|Vq6r<dSr_r'rrr3 after_argsafter_fn before_args before_fnfr'r(asyncgen_wrappers  z*function_wrapper..asyncgen_wrappercs0r |i|IdH}r,|Sr_r'r+r,r'r( async_wrappers z'function_wrapper..async_wrapperc?s0r |i|EdHr,dSr_r')rrr,r'r( gen_wrappers z%function_wrapper..gen_wrappercs*r |i|}r&|Sr_r'r+r,r'r(wrappers z!function_wrapper..wrapper)raisasyncgenfunction functoolswrapsriscoroutinefunctionisgeneratorfunction) r1r0r/r.r-r2r3r4r5r'r,r(function_wrappers"   r;r)r$revent_idcCsdd}t||||fdS)NcSsddlm}||_||_dS)Nr) thread_data)gradio.contextr=rr<)rr<r=r'r'r(r0s z+get_function_with_locals..before_fn)r0r/)r;)r$rr<r0r'r'r(get_function_with_localssr?zset[str]task_idscsBfddtD}|D] }|qtj|ddiIdHdS)Ncsg|]}|vr|qSr')get_name)retaskr@r'r(rgsz cancel_tasks..Zreturn_exceptionsT)rZ all_taskscancelZgather)rAZmatching_tasksrCr'r@r( cancel_taskss   rEint) session_hashfn_indexbatchcCs|s||d|dS)Nr)set_name)rCrGrHrIr'r'r( set_task_namesrKzlist[dict[str, Any]]ztuple[Callable, list[int]])rr csli|D]>tjrtfddttjjD}dddD|<qdddfd d }|tfS) Nc3s|]\}}|kr|VqdSr_r')reid)depr'r(rsz&get_cancel_function..cSsg|]}tjj|qSr')r root_blockr)reor'r'r(rgsz'get_cancel_function..rr$rG)rGr cs$fddD}t|IdHdS)Ncsh|]}d|qS)rr')rer$rGr'r( rz6get_cancel_function..cancel..)rE)rGrA) fn_to_comprQr(rDsz#get_cancel_function..cancel)rrOr enumeraterr~keys)rrHrDr')rNrSr(get_cancel_functions    rVc Csddl}ddlm}m}t|sBt|r.nt|r>|j}niSz t |WSt yi}t |}|j D]x\}}|jtjjurqt|jdkrt|||<dt|jvrqtz"tt|jtt||<Wqttt fyYqt0qt|YS0dS)Nr) OAuthProfilerzgr.OAuthProfile | None|)rrWrra isfunctionismethodcallable__call__typingget_type_hints TypeErrorrhrir annotationrbrcr r$ _eval_type ForwardRefglobalslocalsr&)r$ZgrrWrZ type_hintssigrparamr'r'r(r^s4      r^c Csnddlm}ddlm}ddlm}||}|s6dS||k}||t|fv}t |o`t ||}|pl|pl|S)Nr) EventData)rW)rF) Zgradio.helpersrgZ gradio.oauthrWZ gradio.routesrr,r raisclassr) rparameter_typesrgrWrhintZ is_requestZ is_oauth_argZ is_event_datar'r'r(is_special_typed_parameter#s    rkr~)r$rinputs_as_dictc Cs<t|}t|}d}d}d}|jD]v\}} | j| jk} | j| j| j fvrnt ||s| sd|d7}|d7}q(| j| j kr|}q(| j| j kr(| s(d|Sq(|rdnt |} ||kr|| krtd|d|d| d| |krtd |d|d| d||kr8| |kr8td |d|d| dd S) z Checks if the input component set matches the function Returns: None if valid, a string error message if mismatch rrNz8Keyword-only args must have default values for function z Expected z arguments for function z , received .zExpected at least zExpected maximum N)rarhr^rirr`rckindPOSITIONAL_ONLYPOSITIONAL_OR_KEYWORDrkVAR_POSITIONAL KEYWORD_ONLYrwarningswarn) r$rrlrhriZmin_argsZmax_argsZinfinityrrfZ has_default arg_countr'r'r(check_function_inputs_match2s:      rwzCallable[P, T])queuer cs$tddddfdd }|S)NzP.argszP.kwargsr)rrr cs:|^}}tr,t|dks"d|vr,td|i|S)NrNZconcurrency_countzQueue concurrency_count on ZeroGPU Spaces cannot be overriden and is always equal to Block's max_threads. Consider setting max_threads value on the Block instead)r;rrtru)rr_self positionalrxr'r(r5Xs z*concurrency_count_warning..wrapper)r7r8)rxr5r'r{r(concurrency_count_warningWs r|c@seZdZddZddZdS) TupleNoPrintcCsdSNrr'rr'r'r(__repr__jszTupleNoPrint.__repr__cCsdSr~r'rr'r'r(__str__mszTupleNoPrint.__str__N)rrrrrr'r'r'r(r}hsr}c@seZdZddZddZdS)MatplotlibBackendManangercCst|_tddS)NZagg) matplotlib get_backend_original_backenduserr'r'r( __enter__rs z#MatplotlibBackendMananger.__enter__cCst|jdSr_)rrr)rexc_typeexc_valexc_tbr'r'r(__exit__vsz"MatplotlibBackendMananger.__exit__N)rrrrrr'r'r'r(rqsrc Gs>tddlm}d}d}|jddd|jdd}|jddd |d |d t}|j||d d d dd||| d| d}| d}||d} t jdd| t jd} t dd| } t d| } | rt| d} | |} t dd| d| } d|d} Wdn1s(0Y| | S)Nri,Zmathtextcm)Zfontset){Gz?r)Zfigsize$)fontsizeTsvgZtightg)dpiZ transparentformatZ bbox_inchesZ pad_incheszutf-8z.*<\/metadata>r���)flagsz width="[^"]+"zheight="([\d.]+)pt"rN���zheight="[\d.]+pt"zheight="zem"zz)rZmatplotlib.pyplotZpyplotrcfigurerCrZsavefigcloseseekreaddecodeindexresubDOTALLsearchr#r)ZformularZpltrrZfigrZxml_codeZ svg_startZsvg_codeZ height_matchheightZ new_heightZ copy_coder'r'r(tex2svgzs@        ,rz str | Pathr)rSr cCsXt|}|r|S|p.tdd|jD}|s@||krLt|S|SdS)zKReturns absolute path of a str or Path path, but does not resolve symlinks.css|]}|VqdSr_) is_symlink)reparentr'r'r(rszabspath..N)r is_absoluterrparentsresolvecwd)rSrr'r'r(abspaths rZpath_1Zpath_2cCsJt|t|}}zt||dr.WdSWntyDYdS0dS)z True if path_1 is a descendant (i.e. located within) path_2 or if the paths are the same, returns False otherwise. Parameters: path_1: str or Path (should be a file) path_2: str or Path (can be a file or directory) z..FT)rr$ relative_torrrr'r'r(is_in_or_equals  rr)blockr cs8t|dsdSddfdd |j}|r4|jSdS)N serializer )methcst|tjr|jSt|sHt|rt|dddurt|jddrt |jj D]4}t |t rvd|j vrv|S|j|jvrV|SqVt|d|}t|rtt||jddddddd}t|tr|St|d dS) N__self__ __class__Z gradio_client__func__z .rNrrn __objclass__)rr7partialr^rarZ isbuiltingetattrrgetmrorrrrrrrY getmodulersplitrsplitr)rrget_class_that_defined_methodr'r(rs0         z:get_serializer_name..get_class_that_defined_method)hasattrrr)rrr'rr(get_serializer_names   rz<.*?>)raw_htmlr cCsttd|pdSr~)rr HTML_TAG_RE)rr'r'r(remove_html_tagssrcCsBt}d}|r>t|}d|tjdvr.q>|j}|d7}q |S)z7 Find the first stack frame not inside Gradio. rz/gradio//rN)ra currentframegetfilerr*sepf_back)framenfnamer'r'r(find_user_stack_levels  r)rl)F)NNNN)ur __future__rrrr7rarWZ json.decoderr*pkgutilrrIrr&r]rt contextlibrenumriorZnumbersrpathlibrtypesrr r r r r rrrrrr?Zgradio_client.serializingrZpydanticrrZtyping_extensionsrrr>rZgradio.stringsrrrrrrrrSjoindirname__file__rUget_datarrstripZGRADIO_VERSIONrrr)r-r4r5r9r;rFrLr]rkrrrrrrrrrrrrrrrr"r*r;r?rErKrVr^rkrwr|ror}rrrrrcompilerrrr'r'r'r(s       $         9 ' \   9  )%  $#