Coverage for benefits/in_person/forms.py: 72%

40 statements  

« prev     ^ index     » next       coverage.py v7.16.2, created at 2026-10-08 19:50 +0000

1""" 

2The in-person eligibility application: Form definition for the 

3in-person eligibility verification flow, in which a 

4transit agency employee manually verifies a rider's eligibility. 

5""" 

6 

7from dataclasses import dataclass 

8 

9from django import forms 

10 

11from benefits.core import models 

12from benefits.enrollment.forms import CardTokenizeFailForm, CardTokenizeSuccessForm # noqa 

13from benefits.routes import routes 

14 

15 

16@dataclass 

17class EligibilityPolicy: 

18 details: str 

19 

20 

21class InPersonEligibilityForm(forms.Form): 

22 """Form to capture eligibility for in-person verification flow selection.""" 

23 

24 action_url = routes.IN_PERSON_ELIGIBILITY 

25 id = "form-flow-selection" 

26 method = "POST" 

27 

28 flow = forms.ChoiceField(label="Choose an eligibility type to qualify this rider.", widget=forms.widgets.RadioSelect) 

29 

30 cancel_url = routes.ADMIN_INDEX 

31 

32 flow_field_error_message = "Choose an eligibility type" 

33 verified_field_error_message = "Check the box to verify you have confirmed eligibility" 

34 

35 def __init__(self, agency: models.TransitAgency, *args, **kwargs): 

36 super().__init__(*args, **kwargs) 

37 flows = agency.enrollment_flows.filter(supported_enrollment_methods__contains=models.EnrollmentMethods.IN_PERSON) 

38 

39 self.classes = "in-person-eligibility-form" 

40 flow_field = self.fields["flow"] 

41 flow_field.choices = [(f.id, f.label) for f in flows] 

42 flow_field.widget.attrs.update({"data-custom-validity": self.flow_field_error_message}) 

43 

44 # dynamically add a BooleanField for each flow 

45 for flow in flows: 

46 field_id = f"verified_{flow.id}" 

47 self.fields[field_id] = forms.BooleanField( 

48 required=False, # `clean()` will handle requiring the specific field 

49 label=flow.in_person_policy, 

50 widget=forms.widgets.CheckboxInput(attrs={"class": "d-none"}), # start out hidden 

51 ) 

52 field = self.fields[field_id] 

53 field.hide = True 

54 field.widget.attrs.update({"data-custom-validity": self.verified_field_error_message}) 

55 

56 self.use_custom_validity = True 

57 

58 def clean(self): 

59 cleaned_data = super().clean() 

60 

61 flow_field_name = "flow" 

62 selected_flow = cleaned_data.get(flow_field_name) 

63 

64 if not selected_flow: 

65 self.add_error(flow_field_name, self.flow_field_error_message) 

66 else: 

67 verified_field_name = f"verified_{selected_flow}" 

68 verified = cleaned_data.get(verified_field_name) 

69 if not verified: 

70 self.add_error(verified_field_name, self.verified_field_error_message)