#31960: Document that Django email validator does not enforce valid emails
-------------------------------+--------------------------------------
Reporter: James Pic | Owner: nobody
Type: Uncategorized | Status: new
Component: Uncategorized | Version: 3.1
Severity: Normal | Resolution:
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------+--------------------------------------
Description changed by James Pic:
Old description:
> Currently, Django makes it seem that using an EmailField / EmailValidator
> will protect projects from getting invalid emails in their database, for
> example: emails starting with a dot like "[email protected]" will be invalid
> as expected.
>
> But in reality, users must not count on Django for that:
>
> - https://code.djangoproject.com/ticket/31959
> - https://code.djangoproject.com/ticket/25452
>
> This makes the following documentation statement inaccurate:
>
> > "EmailField: A CharField that checks that the value is a valid email
> address using EmailValidator."
>
> Source :
> https://docs.djangoproject.com/en/3.1/ref/models/fields/#emailfield
>
> It would be only fair to users to document that the EmailValidator will
> let invalid emails through, which will be the cause of SMTPError, and
> that people who don't want invalid emails in their EmailField must
> override and fix Django's default behaviour.
New description:
Currently, Django makes it seem that using an EmailField / EmailValidator
will protect projects from getting invalid emails in their database.
But in reality, users must not count on Django for that:
- https://code.djangoproject.com/ticket/31959
- https://code.djangoproject.com/ticket/25452
This makes the following documentation statement inaccurate:
> "EmailField: A CharField that checks that the value is a valid email
address using EmailValidator."
Source :
https://docs.djangoproject.com/en/3.1/ref/models/fields/#emailfield
It would be only fair to users to document that the EmailValidator will
let invalid emails through, which will be the cause of SMTPError, and that
people who don't want invalid emails in their EmailField must override and
fix Django's default behaviour.
As to why EmailValidator would reject emails starting with a dot like
"[email protected]" but not emails starting with a hyphen "[email protected]": this
will remain a mystery.
--
--
Ticket URL: <https://code.djangoproject.com/ticket/31960#comment:3>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/062.8361839330dd11e91f1f0cace8790d49%40djangoproject.com.
