Bhq:ddlZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZd d lmZd d lmZd dlmZdZGddZGddeZGddeZGddeZGddeZGddeZGddeZ y)N) OrderedDict)forms)SuspiciousOperation)formsets)redirect)reverse)classonlymethod)gettext) TemplateView)ManagementForm) get_storage)NoFileStorageConfiguredcntjdd|}|jjdS)z Converts camel-case style names into underscore separated words. Example:: >>> normalize_name('oneTwoThree') 'one_two_three' >>> normalize_name('FourFiveSix') 'four_five_six' z&(((?<=[a-z])[A-Z])|([A-Z](?![A-Z]|$)))z_\1_)resublowerstrip)namenews F/home/dcms/DCMS/lib/python3.12/site-packages/formtools/wizard/views.pynormalize_namers. &&964 HC 99;  S !!ceZdZdZdZdZdZedZedZ edZ edZ ed Z ed Z ed Zed Zed ZedZy) StepsHelperc||_yN)_wizard)selfwizards r__init__zStepsHelper.__init__"s  rc|jSrallr s r__dir__zStepsHelper.__dir__%s xxrc|jSr)countr&s r__len__zStepsHelper.__len__(s zzrc<d|jd|jdS)Nz)rr%r&s r__repr__zStepsHelper.__repr__+s"4<<. $((2FFrcHt|jjS)z%Returns the names of all steps/forms.)listr get_form_listr&s rr%zStepsHelper.all.sDLL..011rc,t|jS)z;Returns the total number of steps/forms in this the wizard.)lenr%r&s rr)zStepsHelper.count3s488}rc^|jjjxs |jS)z Returns the current step. If no current step is stored in the storage backend, the first step will be returned. )rstorage current_stepfirstr&s rcurrentzStepsHelper.current8s# ||##00>DJJ>rc |jdS)z#Returns the name of the first step.rr$r&s rr5zStepsHelper.first@sxx{rc |jdS)z"Returns the name of the last step.r$r&s rlastzStepsHelper.lastEsxx|rc6|jjS)zReturns the next step.)r get_next_stepr&s rnextzStepsHelper.nextJ||))++rc6|jjS)zReturns the previous step.)r get_prev_stepr&s rprevzStepsHelper.prevOr>rc6|jjS)z'Returns the index for the current step.)rget_step_indexr&s rindexzStepsHelper.indexTs||**,,rc,t|jSrintrDr&s rstep0zStepsHelper.step0Ys4::rc2t|jdzS)Nr rFr&s rstep1zStepsHelper.step1]s4::""rN)__name__ __module__ __qualname__r"r'r*r,propertyr%r)r6r5r:r=rArDrHrJrrrr sG22??,,,,--##rrceZdZdZdZdZdZdZdZdZ dZ e fdZ e d!dZdZdZfd Zd Zd Zd Zd ZdZd"dZdZdZd#dZd$dZdZdZdZdZdZ dZ!dZ"d#dZ#d#dZ$d#dZ%fdZ&d#dZ'd Z(xZ)S)% WizardViewz The WizardView is used to create multi-page forms and handles all the storage and validation stuff. The wizard is based on Django's generic class based views. Nz!formtools/wizard/wizard_form.htmlcPd|jjd|jdS)N) __class__rK form_listr&s rr,zWizardView.__repr__os'4>>**+9T^^4DAFFrcF|j|i|}t|di|S)z This method is used within urls.py to create unique wizardview instances for every request. We need to override this method because we add some kwargs which are needed to make the wizardview usable. rO)get_initkwargssuperas_view)clsargskwargs initkwargsrUs rrZzWizardView.as_viewrs.(S''88 w,,,rc D|j|xs!|jdt|ddxsi|xs!|jdt|ddxsi|xs!|jdt|ddxsid|xs!|jdt|ddxsg}t}t |dkDsJdt |D]>\}} t | ttfr| d |t| d<1| |t|<@|jD]y} t| tjr | j} | jjD]4} t | t j"st%|d r+t'd {||d<|S) a Creates a dict with all needed parameters for the form wizard instances * `form_list` - is a list of forms. The list entries can be single form classes or tuples of (`step_name`, `form_class`). If you pass a list of forms, the wizardview will convert the class list to (`zero_based_counter`, `form_class`). This is needed to access the form for a specific step. * `initial_dict` - contains a dictionary of initial data dictionaries. The key should be equal to the `step_name` in the `form_list` (or the str of the zero based counter - if no step_names added in the `form_list`) * `instance_dict` - contains a dictionary whose values are model instances if the step is based on a ``ModelForm`` and querysets if the step is based on a ``ModelFormSet``. The key should be equal to the `step_name` in the `form_list`. Same rules as for `initial_dict` apply. * `condition_dict` - contains a dictionary of boolean values or callables. If the value of for a specific `step_name` is callable it will be called with the wizardview instance as the only argument. If the return value is true, the step's form will be used. initial_dictN instance_dictcondition_dict)r`rarbrVrzat least one form is neededr file_storagezVYou need to define 'file_storage' in your wizard view in order to handle file uploads.)updatepopgetattrrr1 enumerate isinstancer.tuplestrvalues issubclassr BaseFormSetform base_fieldsr FileFieldhasattrr) r[rVr`rarbr\r]computed_form_listirnfields rrXzWizardView.get_initkwargs|s2  U >73+MNURTW ?GC$,OPWTVY +WS:JD-QRYVX  _KkSW9X!Y_]_ (]9~!@#@@!!+ 2GAt$u .487"3tAw<0.2"3q6* 2'--/ D$ 4 45yy))002 ueoo6#C81G   1{ rc@t|jjSr)rrUrKr requestr\r]s r get_prefixzWizardView.get_prefixsdnn5566rct}t|ddr |jSd|_|jj D]<\}}|j j |d}t|r||}|s8|||<>|`|S)a This method returns a form_list based on the initial form list but checks if there is a condition method/value in the condition_list. If an entry exists in the condition list, it will call/read the value and respect the result. (True means add the form, False means ignore the form) The form_list is always generated on the fly because condition methods could use data from other (maybe previous forms). _check_cond_startedFT)rrfrVrzitemsrbgetcallable)r rVform_key form_class conditions rr/zWizardView.get_form_lists M 4. 6>> !#' $(NN$8$8$: 1 Hj++//$?I "%dO &0 (# 1  $rc |j|g|i||_t|j|j|t |dd|_t ||_t|$|g|i|}|j j||S)a This method gets called by the routing engine. The first argument is `request` which contains a `HttpRequest` instance. The request is stored in `self.request` for later use. The storage instance is stored in `self.storage`. After processing the request using the `dispatch` method, the response gets updated by the storage engine (for example add cookies). rcN) rxprefixr storage_namerfr3rstepsrYdispatchupdate_response)r rwr\r]responserUs rrzWizardView.dispatchs&doog??? "   t{{G D.$ /  !& 7#G=d=f= $$X.rc|jj|jj|j_|j |j S)a This method handles GET requests. If a GET request reaches this point, the wizard assumes that the user just starts at the first step or wants to restart the process. The data of the wizard will be reset before rendering the first step )r3resetrr5r4renderget_formrvs rr|zWizardView.getsA %)JJ$4$4 !{{4==?++rc*|jjjdd}|r#||jvr|j |St |jj|j }|jsttd|jd}||jjk7r'|jj||j_|j|jj|jj }|jr|jj#|jj|j%||jj'|jj|j)||jj|jj*k(r|j,|fi|S|j/|S|j1|S)a This method handles POST requests. The wizard will render either the current step (if form validation wasn't successful), the next step (if the current step was stored successful) or the done view (if no more steps are available) wizard_goto_stepN)rz4ManagementForm data is missing or has been tampered.r4datafiles)rwPOSTr|r/render_goto_stepr ris_validrr cleaned_datarr6r3r4rFILES set_step_data process_stepset_step_filesprocess_step_filesr: render_donerender_next_stepr)r r\r]rmanagement_formform_current_steprns rpostzWizardView.posts <<,,001CTJ  0D4F4F4H H(()9: :)):):4;;O'')%a(^&_` `+88H !3!3 3 ))5(9DLL %}}$,,"3"34<<;M;M}N ==? LL & &tzz'9'94;L;LT;R S LL ' ' (:(:D,>?,,--djj.@.@ACt{{4*6**rc t}|jD]s}|j||jj ||jj |}|j s|j||fi|cS|||<u|jt|jfd|i|}|jj|S)a This method gets called when all forms passed. The method should also re-validate all steps to prevent manipulation. If any form fails to validate, `render_revalidation_failure` should get called. If everything is fine call `done`. steprr form_dict) rr/rr3rrrrender_revalidation_failuredoner.rkr)r rnr] final_formsr~form_obj done_responses rrzWizardView.render_doneVs"m **, -H}}\\//9ll11(;%H $$&7t77(UfUU$,K ! -" ${'9'9';"<^ ^W]^  rcH||jj}t|S)a; Returns the prefix which will be used when calling the actual form for the given step. `step` contains the step-name, `form` the form which will be called with the returned prefix. If no step is given, the form_prefix will determine the current step automatically. )rr6rj)r rrns rget_form_prefixzWizardView.get_form_prefixps" <::%%D4yrc:|jj|iS)z Returns a dictionary which will be passed to the form for `step` as `initial`. If no initial data was provided while initializing the form wizard, an empty dictionary will be returned. )r`r|r rs rget_form_initialzWizardView.get_form_initial}s   $$T2..rc:|jj|dS)z Returns an object which will be passed to the form for `step` as `instance`. If no instance object was provided while initializing the form wizard, None will be returned. N)rar|rs rget_form_instancezWizardView.get_form_instances !!%%dD11rciS)zr Returns the keyword arguments for instantiating the form (or formset) on the given step. rOrs rget_form_kwargszWizardView.get_form_kwargss  rc*||jj}|j|}|j|}|j |||j |||j |dt|tjtjjfr"|jd|j|nEt|tjjr!|jd|j||di|S)aM Constructs the form for a given `step`. If no `step` is defined, the current step will be determined automatically. The form will be initialized using the `data` argument to prefill the new form. If needed, instance or queryset (for `ModelForm` or `ModelFormSet`) will be added too. )rrrinitialinstancequerysetrO)rr6r/rrdrrrlr ModelFormmodelsBaseInlineFormSet setdefaultrBaseModelFormSet)r rrrrr]s rrzWizardView.get_forms <::%%D'')$/ %%d+ **4<,,T2   j5??ELL4R4R"S T   j$*@*@*F G  ELL$A$A B   j$*@*@*F G#F##rc$|j|S)z This method is used to postprocess the form data. By default, it returns the raw `form.data` dictionary. )get_form_step_datar rns rrzWizardView.process_steps &&t,,rc$|j|S)z This method is used to postprocess the form files. By default, it returns the raw `form.files` dictionary. )get_form_step_filesrs rrzWizardView.process_step_filess ''--rc J||j_|j|fi|S)z Gets called when a form doesn't validate when rendering the done view. By default, it changes the current step to failing forms step and renders the form. )r3r4r)r rrnr]s rrz&WizardView.render_revalidation_failures& %) !t{{4*6**rc|jS)zn Is used to return the raw form data. You may use this method to manipulate the data. )rrs rrzWizardView.get_form_step_datas yyrc|jS)zo Is used to return the raw form files. You may use this method to manipulate the data. )rrs rrzWizardView.get_form_step_filess zzrci}|jD]}|j||jj||jj |}|j sZt |jttfr!|jd|z|ji|j|j|S)z Returns a merged dictionary of all step cleaned_data dictionaries. If a step contains a `FormSet`, the key will be prefixed with 'formset-' and contain a list of the formset cleaned_data dictionaries. rz formset-%s) r/rr3rrrrhrrir.rd)r rr~rs rget_all_cleaned_datazWizardView.get_all_cleaned_datas  **, ?H}}\\//9ll11(;%H   "h33eT]C ''$x/1F1F)!''(=(=> ?rc||jvrb|j||jj||jj |}|j r |j Sy)z Returns the cleaned data for a given `step`. Before returning the cleaned data, the stored values are revalidated through the form. If the data doesn't validate, None will be returned. rN)rVrr3rrrr)r rrs rget_cleaned_data_for_stepz$WizardView.get_cleaned_data_for_stepsg 4>> !}}\\//5ll11$7%H   ",,,rc||jj}|j}t|j }||vr|jj S|j |dz}t||kDr||Sy)a= Returns the next step after the given `step`. If no more steps are available, None will be returned. If the `step` argument is None, the current step will be determined automatically. If the `step` is not in the current list of steps, the first step will be returned. Nr )rr6r/r.keysr5rDr1r rrVrkeys rr<zWizardView.get_next_stepsz <::%%D&&( INN$% t ::## #jj" t9s?9 rc||jj}|j}t|j }||vry|j |dz }|dk\r||Sy)a9 Returns the previous step before the given `step`. If there are no steps available, None will be returned. If the `step` argument is None, the current step will be determined automatically. If the `step` is not in the current list of steps, None will be returned. Nr r)rr6r/r.rrDrs rr@zWizardView.get_prev_stepsi <::%%D&&( INN$% t jj" !89 rc||jj}t|jj }||vr|j |Sy)z Returns the index for the given `step` name. If no step is given, the current step will be used to get the index. If the current step is not in the current list of steps, None will be returned. N)rr6r.r/rrD)r rrs rrCzWizardView.get_step_index#sM <::%%DD&&(--/0 4<::d# #rc t|dd|i|}|j|jj||j t |jd|j jid|d<|S)a Returns the template context for a step. You can overwrite this method to add more data for all or some steps. This method returns a dictionary containing the rendered form step. Available template context variables are: * all extra data stored in the storage backend * `wizard` - a dictionary representation of the wizard instance Example:: class MyWizard(WizardView): def get_context_data(self, form, **kwargs): context = super().get_context_data(form=form, **kwargs) if self.steps.current == 'my_step_name': context.update({'another_var': True}) return context rnr4)rr)rnrrr!rO) rYget_context_datardr3 extra_datarr rr6r rnr]contextrUs rrzWizardView.get_context_data1sr&'*???t||../ZZ-T[[ 2 2K  rc t|xs|j}|jdd|i|}|j|S)zP Returns a ``HttpResponse`` containing all needed context data. rnrO)rrrender_to_response)r rnr]rs rrzWizardView.renderOs?&t}}'$''.>?@ @rc|jjjdd}|r#||jvr|j |St ||i|S)z{ Do a redirect if user presses the prev. step button. The rest of this is super'd from WizardView. rN)rwrr|r/rrYr)r r\r]rrUs rrzNamedUrlWizardView.posts]  <<,,001CTJ  0D4F4F4H H(()9: :w|T,V,,rc Nt|dd|i|}|j|dd<|S)zo NamedUrlWizardView provides the url_name of this wizard in the context dict `wizard`. rnr!rrO)rYrrrs rrz#NamedUrlWizardView.get_context_datas4 '*???(, *%rc x|j}||j_t|j |S)z When using the NamedUrlWizardView, we have to redirect to update the browser's URL to match the shown step. )r<r3r4rr)r rnr]rs rrz#NamedUrlWizardView.render_next_steps4 &&( $- !)))455rc X||j_t|j|S)rr3r4rr)r rr]s rrz#NamedUrlWizardView.render_goto_steps& %. !)))455rc X||j_t|j|S)zd When a step fails, we have to redirect the user to the first failing step. r)r failed_steprnr]s rrz.NamedUrlWizardView.render_revalidation_failures& %0 !))+677rc |jdd|jk7r$t|j|jSt ||fi|S)zp When rendering the done view, we have to redirect first (if the URL name doesn't fit). rN)r|rrrrYr)r rnr]rUs rrzNamedUrlWizardView.render_donesO ::fd #t':': :D--d.A.ABC Cw"42622r)rKrLrMrrrrrXrr|rrrrrrrrs@rrrpsUHN"=-A^-66833rrceZdZdZdZy)NamedUrlSessionWizardViewzJ A NamedUrlWizardView with pre-configured SessionStorage backend. rNrrOrrrrrrrceZdZdZdZy)NamedUrlCookieWizardViewzH A NamedUrlFormWizard with pre-configured CookieStorageBackend. rNrrOrrrrrrr)!r collectionsrdjangordjango.core.exceptionsr django.formsrdjango.shortcutsr django.urlsrdjango.utils.decoratorsr django.utils.translationr rdjango.views.genericr r r3rstorage.exceptionsrrrrQrrrrrrOrrrs #6!%31-! 7 "?#?#D} } @E ECzC~3~3BE 2EC1Cr