Skip to main content

Username validation

Project description

Username Validation

Username validation methods extracted from django-registration for use outside of django apps (no dependency on django).

James Bennett's post Let’s talk about usernames is a great write-up of both why and how to perform username validation.

This library performs both reserved name checking as well as confusable homohomoglyph checking.


An Exception will be thrown if the name is confusable or reserved.

All checks

from username_validator import UsernameValidator

# checks both reserved names and confusable

Confusable checks only

from username_validator import UsernameValidator

UsernameValidator().validate_confusables('j\u0430ne_doe') # will throw exception

Reserved name checks only

from username_validator import UsernameValidator


Custom reserved list

You can add to the reserved list with domain specific names or replace it completely. The default list is broken into categories and exposed, so you can pick and choose if you like.

Extend reserved list with our custom names

UsernameValidator(additional_names=["myspecialname", "myothername"]).validate_reserved("myname")

Replace default list with subset

from username_validator import UsernameValidator, PROTOCOL_HOSTNAMES, SENSITIVE_FILENAMES

UsernameValidator(reserved_names=(PROTOCOL_HOSTNAMES + SENSITIVE_FILENAMES)).validate_all("my_name")


This code is pretty much a straight copy-paste of django-registration, removing django utility methods. Thank to James Bennett for the excellent work.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

username_validator-0.0.1.tar.gz (5.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page