Canada (ca
)¶
Forms¶
Canada-specific Form helpers
-
class
localflavor.ca.forms.
CAPhoneNumberField
(required=True, widget=None, label=None, initial=None, help_text='', error_messages=None, show_hidden_initial=False, validators=[], localize=False, disabled=False, label_suffix=None)[source]¶ Canadian phone number form field.
-
class
localflavor.ca.forms.
CAPostalCodeField
(max_length=None, min_length=None, strip=True, *args, **kwargs)[source]¶ Canadian postal code form field.
Validates against known invalid characters: D, F, I, O, Q, U Additionally the first character cannot be Z or W. For more info see: http://www.canadapost.ca/tools/pg/manual/PGaddress-e.asp#1402170
-
class
localflavor.ca.forms.
CAProvinceField
(required=True, widget=None, label=None, initial=None, help_text='', error_messages=None, show_hidden_initial=False, validators=[], localize=False, disabled=False, label_suffix=None)[source]¶ A form field that validates its input is a Canadian province name or abbreviation. It normalizes the input to the standard two-leter postal service abbreviation for the given province.
-
class
localflavor.ca.forms.
CAProvinceSelect
(attrs=None)[source]¶ A Select widget that uses a list of Canadian provinces and territories as its choices.
-
class
localflavor.ca.forms.
CASocialInsuranceNumberField
(required=True, widget=None, label=None, initial=None, help_text='', error_messages=None, show_hidden_initial=False, validators=[], localize=False, disabled=False, label_suffix=None)[source]¶ A Canadian Social Insurance Number (SIN).
Checks the following rules to determine whether the number is valid:
Conforms to the XXX-XXX-XXX format.
- Passes the check digit process “Luhn Algorithm”
Data¶
-
localflavor.ca.ca_provinces.
PROVINCE_CHOICES
= (('AB', 'Alberta'), ('BC', 'British Columbia'), ('MB', 'Manitoba'), ('NB', 'New Brunswick'), ('NL', 'Newfoundland and Labrador'), ('NT', 'Northwest Territories'), ('NS', 'Nova Scotia'), ('NU', 'Nunavut'), ('ON', 'Ontario'), ('PE', 'Prince Edward Island'), ('QC', 'Quebec'), ('SK', 'Saskatchewan'), ('YT', 'Yukon'))¶ An alphabetical list of provinces and territories for use as choices in a formfield. Source: http://www.canada.gc.ca/othergov/prov_e.html
-
localflavor.ca.ca_provinces.
PROVINCES_NORMALIZED
= {'nt': 'NT', 'nb': 'NB', 'nova scotia': 'NS', 'pq': 'QC', 'quebec': 'QC', 'newfoundland': 'NL', 'bc': 'BC', 'manitoba': 'MB', 'ab': 'AB', 'nunavut': 'NU', 'yukon': 'YT', 'newfoundland and labrador': 'NL', 'mb': 'MB', 'p.e.i.': 'PE', 'yt': 'YT', 'saskatchewan': 'SK', 'ontario': 'ON', 'on': 'ON', 'yk': 'YT', 'yukon territory': 'YT', 'prince edward island': 'PE', 'new brunswick': 'NB', 'ns': 'NS', 'b.c.': 'BC', 'nu': 'NU', 'alberta': 'AB', 'nl': 'NL', 'sk': 'SK', 'pe': 'PE', 'nf': 'NL', 'british columbia': 'BC', 'northwest territories': 'NT', 'pei': 'PE', 'qc': 'QC'}¶ a mapping of province misspellings/abbreviations to normalized abbreviations