MfNydZddlZddlZddlZddlZddlmZmZmZddl Z ddl m Z m Z ddl m Z mZddlmZddlmZddlmZd d lmZmZd d lmZd d lmZd d lmZd dlmZmZ ddlm Z e dGddZ!n#GddZ!YnxYwda"ia#da$dZ%dZ&dZ'dZ(GddZ)GddZ*GddeZ+dZ,Gd d!e Z-dS)"a dash_wrapper This module provides a DjangoDash class that can be used to expose a Plotly Dasb application through a Django server Copyright (c) 2018 Gibbs Consulting and others - see CONTRIBUTIONS.md Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. N)DictListCallable)Dash dependencies)split_callback_idinputs_to_dict)reverse)slugify)Flask)app_namemain_view_label)EmbeddedHolder) serve_locally)stateless_app_lookup_hook)static_asset_pathDjangoPlotlyJSONEncoder) dataclassT)frozencVeZdZUeed<eed<eed<eed<eed<eed<eed<dS) CallbackContext inputs_listinputs states_liststates outputs_listoutputs triggeredN)__name__ __module__ __qualname__r__annotations__r^/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/django_plotly_dash/dash_wrapper.pyrr1sX   r%rceZdZdZedZedZedZedZedZ edZ edZ d S) rc ||_dSN_args)selfkwargss r&__init__zCallbackContext.__init__>s DJJJr%c|jdS)Nrr*r,s r&rzCallbackContext.inputs_listA:m, ,r%c|jdS)Nrr*r0s r&rzCallbackContext.inputsE:h' 'r%c|jdS)Nrr*r0s r&rzCallbackContext.states_listIr1r%c|jdS)Nrr*r0s r&rzCallbackContext.statesMr3r%c|jdS)Nrr*r0s r&rzCallbackContext.outputsQs:i( (r%c|jdS)Nrr*r0s r&rzCallbackContext.outputs_listUs:n- -r%c|jdS)Nrr*r0s r&rzCallbackContext.triggeredXs:k* *r%N) r r!r"r.propertyrrrrrrrr$r%r&rr=s     - -  -  ( (  (  - -  -  ( (  (  ) )  )  . .  .  + +  + + +r%c|t|<|S)z!Add app to local registry by name usable_apps)nameapps r&add_usable_appr?csK Kr%ctS)zLReturn a dictionary of all locally registered apps with the slug name as keyr;r$r%r&all_appsrAis r%c*ttS)z;Return a list of all locally registered stateless apps )listr<r$r%r&get_local_stateless_listrDms   r%ct|d}|s$ttat|}|st d|z|S)zg Locate a registered dash app by name, and return a DjangoDash instance encapsulating the app. Nz,Unable to find stateless DjangoApp called %s)r<get_stateless_app_lookup_funcrKeyError)r=sas r&get_local_stateless_by_namerJrsb t $ $B . & -)B)D)D & ' - - LEdJKKK Ir%c$eZdZdZdZdZdZdS)Holderz.Helper class for holding configuration optionscg|_dSr))itemsr0s r&r.zHolder.__init__s  r%c:|j|dS)z,Add extra css file name to component packageNrNappend)r, stylesheets r& append_csszHolder.append_csss *%%%%%r%c:|j|dS)z/Add extra script file name to component packageNrP)r,scripts r& append_scriptzHolder.append_scripts &!!!!!r%N)r r!r"__doc__r.rSrVr$r%r&rLrLsG44&&&"""""r%rLceZdZdZ ddZdZddZdZdZd Z d Z dd Z dd Z e d ZdZeZdZdZdS) DjangoDashz Wrapper class that provides Dash functionality in a form that can be served by Django To use, construct an instance of DjangoDash() in place of a Dash() one. NFc |pg|_|pg|_||_|r(tjd||t dz adt z|_n||_d|_g|_ g|_ t|_ t|_ t|j||t|_n||_||_|r ddlm}|d} n#ddlm}|d} YnxYw|jr=d } | d d } |j | g| | d n|j d | git/jd} t/j| d|_ t/j|j|_n#d|_YnxYwd|_dS)NzYou are passing extra arguments {kwargs} that will be passed to Dash(...) but may not be properly handled by django-plotly-dash.r-r z djdash_%ir)css_urlhrefurldpd_static_support/) external_urlrelative_package_path namespacerbassets)external_stylesheetsexternal_scripts_kwargswarningswarnformat uid_counter_uidlayout_callback_sets_clientside_callback_setsrLcssscriptsr?serve_locally_setting_serve_locally_suppress_callback_exceptionsbootstrap4.bootstrapr\django_bootstrap5.coresplitrVinspectstack getmodule caller_modulegetfilecaller_module_location assets_folder) r,r=radd_bootstrap_linkssuppress_callback_exceptionsrfrgr-r\bootstrap_sourcehard_coded_package_namebase_file_name caller_frames r&r.zDjangoDash.__init__sC%9$>B! 0 6B  j MSSYSYagSYShSh j j j < 1 K#k1DIIDI  )+&88xx ty     "7"9"9D  "/D -I*  N 4888888#*799V#4   4::::::#*799U#3   " N*>'!1!7!7!z@DjangoDash.get_expanded_arguments...1s!=!=!=Q!&!=!=!=r%r$)rkind parameterss r& z5DjangoDash.get_expanded_arguments..1s@mmmBR$ 4!=!=*!=!=!=mmmr%c|jSr))r)rs r&z3DjangoDash.get_expanded_arguments..2s dedjr%N) len itertoolsgroupbyry signaturervalues Parameter VAR_KEYWORDVAR_POSITIONALrF KEYWORD_ONLYPOSITIONAL_OR_KEYWORD)rrstaten_dash_parametersparameter_typesexpandeds r&get_expanded_argumentsz!DjangoDash.get_expanded_arguments(s  "--EKR0@0@@mm$,W->t-D-D-O-V-V-X-XZjZjkkmmm   (O ; ;HH   - @ @'**7+<+I2NNHH'**7+<+RTVWW())+-<-@-@ARA_ac-d-deHr%c`tj||\}}||dfd}|S)acForm a callback function by wrapping, in the same way as the underlying Dash application would but handling extra arguments provided by dpd. It will inspect the signature of the function to ensure only relevant expanded arguments are passed to the callback. If the function accepts a **kwargs => all expanded arguments are sent to the function in the kwargs. If the function has a *args => expanded arguments matching parameters after the *args are injected. Otherwise, take all arguments beyond the one provided by Dash (based on the Inputs/States provided). )outputrrprevent_initial_callcj|ft||_|Sr))rorQrYrr)r callback_setrr,rs r& wrap_funcz&DjangoDash.callback..wrap_funcVs?   & & d'; < < < '==dFERRDMKr%)rhandle_callback_args) r,r+rhrrrrrrs ` @@@r&rzDjangoDash.callbackAsv7C6W 77 7 33#)"(!&0DFF         r%c~tj||\}}}}|||||d}|j|dS)z^Form a callback function by wrapping, in the same way as the underlying Dash application would)clientside_functionrrrrN)rrrprQ) r,rr+rhrrrrrs r&rzDjangoDash.clientside_callbackbsb6B6W 77 7 331D#)#)"'1E GG &--l;;;;;r%c&dt|zS)zcURL of an asset associated with this component Use a placeholder and insert later zassets/)str)r, asset_names r& get_asset_urlzDjangoDash.get_asset_urlqs 3z??**r%)NNFFNNr)NNN)r r!r"rWr.rrrrrrrr staticmethodrrexpanded_callbackrrr$r%r&rYrYs# 15%*.3&*"& A&A&A&A&F:::====          (JJJJ 8\0>! < < <+++++r%rYc<eZdZdZdZdZdZdZdZdZ dZ d S) PseudoFlaskzFDummy implementation of a Flask instance, providing stub functionalityc^ddi|_i|_d|_i|_d|_i|_dS)NDEBUGFPseudoFlaskDummyName)r endpointsr= blueprints_got_first_requestbefore_request_funcsr0s r&r.zPseudoFlask.__init__}s9& * "'$&!!!r%cdSr)r$r,argsr-s r& after_requestzPseudoFlask.after_request r%cfd}|S)NcdS)Nrr$)frs r&eh_funcz)PseudoFlask.errorhandler..eh_funcs 7Nr%r$)r,rr-rs ` r& errorhandlerzPseudoFlask.errorhandlers!     r%c*|d}||j|<dS)Nendpoint)r)r,rr-routes r& add_url_rulezPseudoFlask.add_url_rulesz" &ur%cdSr)r$rs r&before_first_requestz PseudoFlask.before_first_requestrr%cdSr)r$rs r&runzPseudoFlask.runrr%cdSr)r$rs r&register_blueprintzPseudoFlask.register_blueprintrr%N) r r!r"rWr.rrrrrrr$r%r&rr{sLL'''   '''           r%rct|tr|Sddt|D}d|dS)zConvert an python id (str or dict) into its Dash representation. see https://github.com/plotly/dash/blob/c5ba38f0ae7b7f8c173bda10b4a8ddd035f1d867/dash-renderer/src/actions/dependencies.js#L114,c3rK|]2\}}tj|dtj|V3dS)rN)jsondumps)rkvs r& zwid2str..sDWW41atz!}}66tz!}}66WWWWWWr%{}) isinstancerjoinsortedrN)rdatas r&wid2strrsY#s 88WW6#))++CVCVWWW W WD ===r%ceZdZdZ dfd ZdZdZddZdZd Z d Z d Z d Z d Z ddZejjdZdZdZdZfdZfdZdZdZddZdZfdZddZdZxZS)rz3Wrapper around the Plotly Dash application instanceNFc ||_t|j|_t|_||_|j|d<|j|d<t jtfi|||j j _ ||j j _ d|_ |r||_nt|_t!|jdk|_d|_dS)Nurl_base_pathnameserverFr )rmr _flask_appr _notflask_base_pathnamesuperr.r rqrrrr _adjust_id _replacementsdictr_use_dash_layout_return_embedded)r,rrrrr- __class__s r&r.zWrappedDash.__init__s  **$+&*&9"#>x ,,V,,,(5%,9 )  (!-D  !%D  #D$6 7 7! ; %r%cdS)aAReturn True if underlying dash dispatching should be used. This stub is present to allow older code to work. Following PR #304 (see https://github.com/GibbsConsulting/django-plotly-dash/pull/304/files for details) this function is no longer needed and therefore should always return FalseFr$r0s r&use_dash_dispatchzWrappedDash.use_dash_dispatchs ur%c|jS)z Indicate if the underlying dash layout can be used. If application state is in use, then the underlying dash layout functionality has to be augmented with the state information and this function returns False )rr0s r&use_dash_layoutzWrappedDash.use_dash_layouts $$r%cZ|r|s |j}tj|d}|si}t |j}||| ||}tj |t}||jfS)z'Add application state to initial valuesFzutf-8)cls) rrmimetyperloadsdecoderr updatewalk_tree_and_replacerr)r, base_responseinitial_argumentsbaseDataInBytesbaseData overrides reworked_data response_datas r&augment_initial_layoutz"WrappedDash.augment_initial_layouts    ! ! >*; > >(,:o44W==>>! # " +,, *+++228YGG  ='>@@@ m444r%ct|trdD],}|||d|-|dd}|Ot |}||i}|D]\}}|dvr|||<|r|||<t|t r|D]}|||dSdS)zEWalk tree of properties and extract identifiers and associated values)childrenpropsNid)r'optionsr&r()rrwalk_tree_and_extractrFrrNrC)r,rtargetrridValsrelements r&r*z!WrappedDash.walk_tree_and_extracts dD ! ! +, H H**488C+>+>GGGGHHT4((E E2.."&**,,,,JC"HHH&+s +$*F5M dD ! ! < < <**7F;;;; < < < .s)KKKD..q)<<KKKr%)rrrFrrNrrC) r,rr!responserthisIDrrrs ` ` r&rz!WrappedDash.walk_tree_and_replaces2 dD ! ! HLXXdD))F&$'' 9 %OO--DAq{{'( ##(}}VR88    1 $$Q--9221i@@A O dD ! ! LKKKKKdKKK K r%c|jS)z4Underlying flask application for stub implementation)rr0s r& flask_appzWrappedDash.flask_app s r%c|jS)zBase url of this component)r r0s r&base_urlzWrappedDash.base_url$s ""r%c&|jj|i|S)z=Extract application context from underlying flask application)r app_contextrs r&r9zWrappedDash.app_context(s%*t*D5-355 5r%c&|jj|i|S)z>Request context for testing from underluying flask application)rtest_request_contextrs r&r;z WrappedDash.test_request_context-s%3t3T>6<>> >r%c^| |jd|}n|j}|jj|dS)z+Locate endpoint function given name of viewN_ view_func)r r r)r,r=eps r&locate_endpoint_functionz$WrappedDash.locate_endpoint_function2sA  ...4!BB$B~'+K88r%cz|jr||tj||S)z;Overloaded layout function to fix component names as needed)r _fix_component_idrrnfset)r,rs r&rnzWrappedDash.layout<s: ? *  " "5 ) ) ){e,,,r%ct|dd}|$t|d|| |jD]}||dS#YdSxYw)z,Fix name of component ad all of its childrenr(N)getattrsetattr_fix_idr&rB)r, componenttheIDcs r&rBzWrappedDash._fix_component_idDs 4..   ItT\\%%8%8 9 9 9 ' * *&&q)))) * *  DDs AAc,|js|S|jd|S)z+Adjust identifier to include component namez_-_)r rm)r,r=s r&rGzWrappedDash._fix_idPs) K9994! !r%cD||j|_|S)zUpdate component identifier)rG component_id)r,items r&_fix_callback_itemzWrappedDash._fix_callback_itemWs LL):;; r%ct|ttfrfd|D}n|}t |fd|Dfd|D|S)3Invoke callback, adjusting variable names as neededc:g|]}|Sr$rOrr0r,s r&rz(WrappedDash.callback..`'HHHAT44Q77HHHr%c:g|]}|Sr$rSrTs r&rz(WrappedDash.callback..es' L L L!8!8!;!; L L Lr%c:g|]}|Sr$rSrTs r&rz(WrappedDash.callback..fs' K K K!8!8!;!; K K Kr%r)rrCtuplerOr r)r,rrrr fixed_outputsrs` r&rzWrappedDash.callback\s ftUm , , <HHHHHHHMM 33F;;Mww L L L LV L L L K K K KU K K K5I KK Kr%ct|ttfrfd|D}n|}t ||fd|Dfd|D|S)rQc:g|]}|Sr$rSrTs r&rz3WrappedDash.clientside_callback..mrUr%c:g|]}|Sr$rSrTs r&rz3WrappedDash.clientside_callback..ss'+W+W+W1D,C,CA,F,F+W+W+Wr%c:g|]}|Sr$rSrTs r&rz3WrappedDash.clientside_callback..ts'+V+V+V1D,C,CA,F,F+V+V+Vr%rX)rrCrYrOr r)r,rrrrrrZrs` r&rzWrappedDash.clientside_callbackis ftUm , , <HHHHHHHMM 33F;;Mww**+>+8+W+W+W+WPV+W+W+W+V+V+V+VPU+V+V+V@T +VV Vr%c|dg}t||dg}|d}|dpt|}|dg}fd|D}||t||||d} tdi| } | t_t |dkr| |d <|d o|d  } | r|g} n|d d  d } |dd} |j |}g}||zD]}t|trHd|D}| r9t||D](\}}| |d|d|)n:|d}| r#| |d|d||||dpt|}||d<t |t |dkrdS|d}|j2h|jd||ifd|Dn||i|| rGdd}|fd}| D]}t|t$rp| d\}}| ||rA||i|d}| |||t)dS)zOPerform callback dispatching, with enhanced arguments and recording of responserrrrchangedPropIdsc@g|]}||dS))prop_idrrF)rr0 input_valuess r&rz2WrappedDash.dispatch_with_args..s/```QL4D4DQ4G4GHH```r%)rrrrrrrrcallback_contextz..z...dash_appNc8g|]}|dS)rrc)rcis r&rz2WrappedDash.dispatch_with_args..s"111RVVG__111r%r(r9rr EDGECASEEXITrc$i|] \}}|v || Sr$r$)rrrparameters_to_injects r&rz2WrappedDash.dispatch_with_args..s*$b$b$bdaMaHaHaQHaHaHar%ceZdZdZdZdZdS)0WrappedDash.dispatch_with_args..LazyJsonzA class to allow delayed the evaluation of a dict (returned by `func`) till the first get(...) is called on the dict.c||_dSr)) _root_value)r,rs r&r.z9WrappedDash.dispatch_with_args..LazyJson.__init__s'+D$$$r%ct|jtr||_|j||Sr))rrqrrF)r,rNdefaults r&rFz4WrappedDash.dispatch_with_args..LazyJson.getsD!$"2H==>+/+;+;+=+=(+//g>>>r%N)r r!r"rWr.rFr$r%r&LazyJsonros>CC,,,?????r%rtcTtjdiS)Nr1)rrrF)ressr&rz0WrappedDash.dispatch_with_args..s$*S//*=*=j"*M*Mr%.zFUpdating state for dict keys (pattern matching) is not yet implementedr$)rFr rrdashrer startswithendswithrx callback_maprrCziprrQrrNrrNotImplementedError)r,bodyargMaprrrr changed_propstriggered_inputscallback_context_infore single_caserda callback_inforrJrrjvirrt root_value output_item output_idoutput_propertyrrdrmrvs @@@r&dispatch_with_argszWrappedDash.dispatch_with_argsxs(B''%f-- '2&&hxx **G.?.G.G !1266 ````R_```""!$V,,(#)!!+CC-BCC!1 v;;??)9F% & ++D11Kfood6K6KL  0hGGQrTl((//GZZ D ) ))&1 &  A!T"" G11q111N"%a))NNB//4"Z."MMMMEE'NNG++AdGQz]AFFF KKNNNNxx **G.?.G.G !-~ t99s=233 3 3!> ,   (#GX%6#G#G (Dc$b$b$b$bfllnn$b$b$bccCC(D+F++C  x ? ? ? ? ? ? ? ?""M"M"M"MNNJ& x x k3//x1<1B1B31G1G.I229oNNS *y < < @ @RV W W// ?ERRR..vwww r%c.|j}t|S)z)Return the app id in a slug-friendly form)rmr )r,pre_slugified_ids r& slugified_idzWrappedDash.slugified_ids9'(((r%ch|r|nd}|rd|znd}|r|nd}|}d||||dzS)z Return extra html properties to allow individual apps to be styled separately. The content returned from this function is injected unescaped into templates. zdjango-plotly-dashz-%siframezT%(prefix)s %(prefix)s-%(template_type)s %(prefix)s-app-%(slugified_id)s%(post_part)s)r post_part template_typeprefix)r)r,rpostfixrrrs r&extra_html_propertiesz!WrappedDash.extra_html_propertiessu";';'.6EGOOB )6D H ((** eyEu~zGrxijijj jr%c |}|}|}|}|}t |dd}|jr4ddl} d| d|j} nd} d} | |||||| | | } | S) Ntitlerrz/z assets.static)filenamerz[
Loading...
)metasrrqrrr app_entryfaviconrenderer) _generate_scripts_html_generate_css_dist_html_generate_config_html_generate_meta_html_generate_rendererrE_faviconflaskrkurl_forinterpolate_index) r,rr-rrrqrrrrrr _app_entryindexs r&rzWrappedDash.indexs--//**,,++--((****,,gv.. =  LLLGNN o FFHHGGGJ&&u#fz7'  r%c |jstjdi|}|S|j|d|j|d|j|d|dS)Nrqrrrrr$)rr radd_css add_config add_scripts)r,r-resprs r&rzWrappedDash.interpolate_indexs$ ,577,66v66DK %%fUm444 (()9::: ))&*;<<<k""r%c4|r|n t|_dS)zISet a handler for embedded references prior to evaluating a view functionN)rr)r,embedded_holders r& set_embeddedzWrappedDash.set_embedded"s3B XHXHXr%cd|_dS)z1Exit the embedded section after processing a viewFN)rr0s r& exit_embeddedzWrappedDash.exit_embedded&s %r%)NNNFr)r)r r!r"rWr.rrr$r*rr5r7r9r;r@rrnsetterrBrGrOrrrrrrrrr __classcell__)rs@r&rrs99RW&&&&&&:%%%55554<<<$@###555 >>> 9999 [---   !!! K K K K K V V V V VgggR))) jjjj(8 # # # # #YYYY&&&&&&&r%r).rWryrrritypingrrrrxrr dash._utilsrr django.urlsr django.utils.textr rr rr middlewarerutilrrsrrr dataclassesrrrlr<rGr?rArDrJrLrYrrrr$r%r&rs4 '''''''''' ########99999999%%%%%%////////&&&&&&888888++++++<<<<<<<<,+%%%%%%Yd+++++++++++@  !  , " " " " " " " "c+c+c+c+c+c+c+c+N     %   :F&F&F&F&F&$F&F&F&F&F&s &%B B