ó ø¢TQc@s°dZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddlmZdd lmZdd lmZd efd „ƒYZd S(s² FormWizard class -- implements a multi-page form, validating between each step and storing the form's state as HTML hidden fields so that no state is stored on the server side. iÿÿÿÿ(t HiddenInput(tHttp404(trender_to_response(tRequestContext(tconstant_time_compare(t ugettext_lazy(tmethod_decorator(t csrf_protect(t form_hmact FormWizardcBs¿eZdZdd„Zd„Zdd„Zd„Zd„Ze e ƒd„ƒZ dd„Z d„Z d „Zd „Zd „Zd „Zd „Zd„Zdd„Zd„Zd„ZRS(t wizard_stepcCsK||_|pi|_i|_d|_ddl}|jdtƒdS(s Start a new wizard with a list of forms. form_list should be a list of Form classes (not instances). iiÿÿÿÿNsxOld-style form wizards have been deprecated; use the class-based views in django.contrib.formtools.wizard.views instead.(t form_listtinitialt extra_contexttsteptwarningstwarntDeprecationWarning(tselfR R R((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyt__init__s    cCsd|j|j|jfS(Ns'step: %d form_list: %s initial_data: %s(RR R (R((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyt__repr__,scCsZ||jƒkr%td|ƒ‚n|j||d|j|ƒd|jj|dƒƒS(s@Helper method that returns the Form instance for the given step.sStep %s does not existtprefixR N(t num_stepsRR tprefix_for_stepR tgettNone(RRtdata((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pytget_form/scCs t|jƒS(s/Helper method that returns the number of steps.(tlenR (R((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyR6scCs|j||ƒ}t||ƒS(N(t security_hashR(Rttokentrequesttformtexpected((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyt_check_security_hash=sc Os®d|kr#|jj|dƒn|j|||Ž}|j|||Žg}x t|ƒD]’}|j||jƒ}|j|jjd|dƒ||ƒs±|j ||ƒS|j ƒsÐ|j |||ƒS|j |||ƒ|j |ƒq^W|jdkr|j||jƒ}n|j|ƒ}|j ƒr›|j |||ƒ|d} | |jƒkr||j|||gƒS|j| ƒ}| |_}n|j|||ƒS(sk Main method that does all the hard work, conforming to the Django view interface. R shash_%dttPOSTi(R tupdatetget_current_or_first_stept parse_paramstrangeRR$R"Rtrender_hash_failuretis_validtrender_revalidation_failuret process_steptappendtmethodRtdoneRtrender( RRtargstkwargst current_steptprevious_form_listtitfR t next_step((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyt__call__As2     c CsÍ|j}g}|r«tƒ}xŠt|ƒD]y}|j||ƒ} d|} |jg| D]} | jƒ^qZƒ|j|j| |j| |j || ƒƒƒƒq+Wn|j ||dj |ƒ||ƒS(s9Renders the given Form object, returning an HttpResponse.shash_%sR#( R$RR(Rtextendt as_hiddenR-R0RRtrender_templatetjoin( RR RRtcontexttold_datat prev_fieldsthiddenR5told_formt hash_nametbf((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyR0s   &8cCs t|ƒS(s-Given the step, returns a Form prefix to use.(tstr(RR((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyR‘scCs/|j|j|ƒ||ditdƒd6ƒS(s6 Hook for rendering a template if a hash check failed. step is the step that failed. Any previous step is guaranteed to be valid. This default implementation simply renders the form for the given step, but subclasses may want to display an error message, etc. R=s]We apologize, but your form has expired. Please continue filling out the form from this page.t wizard_error(R0Rt_(RRR((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyR)•s cCs|j|||ƒS(sÑ Hook for rendering a template if final revalidation failed. It is highly unlikely that this point would ever be reached, but See the comment in __call__() for an explanation. (R0(RRRR ((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyR+¡scCs t|ƒS(sÌ Calculates the security hash for the given HttpRequest and Form instances. Subclasses may want to take into account request-specific information, such as the IP address. (R(RRR ((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyRªscOsH|js dSy"t|jj|jdƒƒ}Wntk rCdSX|S(s6 Given the request object and whatever *args and **kwargs were passed to __call__(), returns the current step (which is zero-based). Note that the result should not be trusted. It may even be a completely invalid number. It's not the job of this method to validate it. i(R$tintRtstep_field_namet ValueError(RRR1R2R((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyR&³s " cOsdS(sÓ Hook for setting some state, given the request object and whatever *args and **kwargs were passed to __call__(), sets some state. This is called at the beginning of __call__(). N((RRR1R2((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyR'ÃscCsdS(sß Hook for specifying the name of the template to use for a given step. Note that this can return a tuple of template names if you'd like to use the template system's select_template() hook. sforms/wizard.html((RR((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyt get_templateÌscCsu|p i}|j|jƒt|j|ƒt|d|jd|d|dd|jƒd|d|ƒdt|ƒƒS( s? Renders the template for the given step, returning an HttpResponse object. Override this method if you want to add a custom context, return a different MIME type, etc. If you only need to override the template name, use get_template() instead. The template will be rendered with the following context: step_field -- The name of the hidden field containing the step. step0 -- The current step (zero-based). step -- The current step (one-based). step_count -- The total number of steps. form -- The Form instance for the current step (either empty or with errors). previous_fields -- A string representing every previous data field, plus hashes for completed forms, all in the form of hidden fields. Note that you'll need to run this through the "safe" template filter, to prevent auto-escaping, because it's raw HTML. t step_fieldtstep0Rit step_countR tprevious_fieldstcontext_instance(R%R RRJtdictRHRR(RRR RNRR=((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyR;Õs     cCsdS(sÛ Hook for modifying the FormWizard's internal state, given a fully validated Form object. The Form is guaranteed to have clean, valid data. This method should *not* modify any of that data. Rather, it might want to set self.extra_context or dynamically alter self.form_list, based on previously submitted forms. Note that this method is called every time a page is rendered for *all* submitted steps. N((RRR R((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyR,õs cCstd|jjƒ‚dS(sÔ Hook for doing something with the validated data. This is responsible for the final processing. form_list is a list of Form instances, each containing clean, valid data. sAYour %s class has not defined a done() method, which is required.N(tNotImplementedErrort __class__t__name__(RRR ((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyR/sN(RSt __module__RHRRRRRR"RRR8R0RR)R+RR&R'RJR;R,R/(((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyR s$     @    N(t__doc__t django.formsRt django.httpRtdjango.shortcutsRtdjango.template.contextRtdjango.utils.cryptoRtdjango.utils.translationRRFtdjango.utils.decoratorsRtdjango.views.decorators.csrfRtdjango.contrib.formtools.utilsRtobjectR (((s?../Django//lib/python/django/contrib/formtools/wizard/legacy.pyts