py.validator
A library of string validators and sanitizers
Insipired by validator.js
Strings only
This library validates and sanitizes strings only.
Passing anything other than a string will result in an error.
Instalation
You can install it by running: pip install py.validator
Validators
Here is a list of the validators currently available.
| Validator | Description |
|---|---|
| is_after(str [, date]) | check if the string is a date that's after the specified date (defaults to now). |
| is_alpha(str [, locale, options]) | check if the string contains only letters (a-zA-Z). Locale is one of ['ar', 'ar-AE', 'ar-BH', 'ar-DZ', 'ar-EG', 'ar-IQ', 'ar-JO', 'ar-KW', 'ar-LB', 'ar-LY', 'ar-MA', 'ar-QA', 'ar-QM', 'ar-SA', 'ar-SD', 'ar-SY', 'ar-TN', 'ar-YE', 'bg-BG', 'cs-CZ', 'da-DK', 'de-DE', 'el-GR', 'en-AU', 'en-GB', 'en-HK', 'en-IN', 'en-NZ', 'en-US', 'en-ZA', 'en-ZM', 'es-ES', 'fa-IR', 'fi-FI', 'fr-CA', 'fr-FR', 'he', 'hi-IN', 'hu-HU', 'it-IT', 'ku-IQ', 'nb-NO', 'nl-NL', 'nn-NO', 'pl-PL', 'pt-BR', 'pt-PT', 'ru-RU', 'sl-SI', 'sk-SK', 'sr-RS', '[email protected]', 'sv-SE', 'tr-TR', 'uk-UA']) and defaults to en-US. Locale list is validator.isAlphaLocales. options is an optional object that can be supplied with the following key(s): ignore which can either be a String or RegExp of characters to be ignored e.g. " -" will ignore spaces and -'s. |
| is_alphanumeric(str [, locale, options]) | check if the string contains only letters and numbers (a-zA-Z0-9). Locale is one of ['ar', 'ar-AE', 'ar-BH', 'ar-DZ', 'ar-EG', 'ar-IQ', 'ar-JO', 'ar-KW', 'ar-LB', 'ar-LY', 'ar-MA', 'ar-QA', 'ar-QM', 'ar-SA', 'ar-SD', 'ar-SY', 'ar-TN', 'ar-YE', 'bg-BG', 'cs-CZ', 'da-DK', 'de-DE', 'el-GR', 'en-AU', 'en-GB', 'en-HK', 'en-IN', 'en-NZ', 'en-US', 'en-ZA', 'en-ZM', 'es-ES', 'fa-IR', 'fi-FI', 'fr-CA', 'fr-FR', 'he', 'hi-IN', 'hu-HU', 'it-IT', 'ku-IQ', 'nb-NO', 'nl-NL', 'nn-NO', 'pl-PL', 'pt-BR', 'pt-PT', 'ru-RU', 'sl-SI', 'sk-SK', 'sr-RS', '[email protected]', 'sv-SE', 'tr-TR', 'uk-UA']) and defaults to en-US. Locale list is validator.isAlphanumericLocales. options is an optional object that can be supplied with the following key(s): ignore which can either be a String or RegExp of characters to be ignored e.g. " -" will ignore spaces and -'s. |
| is_ascii(str) | check if the string contains ASCII chars only. |
| is_base32(str) | check if a string is base32 encoded. |
| is_base58(str) | check if a string is base58 encoded. |
| is_base64(str [, options]) | check if a string is base64 encoded. options is optional and defaults to {urlSafe: false}when urlSafe is true it tests the given base64 encoded string is url safe |
| is_before(str [, date]) | check if the string is a date that's before the specified date. |
| is_bic(str) | check if a string is a BIC (Bank Identification Code) or SWIFT code. |
| is_boolean(str [, options]) | check if a string is a boolean.options is an object which defaults to { loose: false }. If loose is is set to false, the validator will strictly match ['true', 'false', '0', '1']. If loose is set to true, the validator will also match 'yes', 'no', and will match a valid boolean string of any case. (eg: ['true', 'True', 'TRUE']). |
| is_btc_address(str) | check if the string is a valid BTC address. |
| is_byte_length(str [, options]) | check if the string's length (in UTF-8 bytes) falls in a range.options is an object which defaults to {min:0, max: undefined}. |
| is_credit_card(str) | check if the string is a credit card. |
| is_currency(str [, options]) | check if the string is a valid currency amount.options is an object which defaults to {symbol: '$', require_symbol: false, allow_space_after_symbol: false, symbol_after_digits: false, allow_negatives: true, parens_for_negatives: false, negative_sign_before_digits: false, negative_sign_after_digits: false, allow_negative_sign_placeholder: false, thousands_separator: ',', decimal_separator: '.', allow_decimal: true, require_decimal: false, digits_after_decimal: [2], allow_space_after_digits: false}.Note: The array digits_after_decimal is filled with the exact number of digits allowed not a range, for example a range 1 to 3 will be given as [1, 2, 3]. |
| is_data_uri(str) | check if the string is a data uri format. |
| is_date(str [, options]) | Check if the input is a valid date. e.g. [2002-07-15, new Date()].options is an object which can contain the keys format, strictMode and/or delimitersformat is a string and defaults to YYYY/MM/DD.strictMode is a boolean and defaults to false. If strictMode is set to true, the validator will reject inputs different from format.delimiters is an array of allowed date delimiters and defaults to ['/', '-']. |
| is_decimal(str [, options]) | check if the string represents a decimal number, such as 0.1, .3, 1.1, 1.00003, 4.0, etc.options is an object which defaults to {force_decimal: false, decimal_digits: '1,', locale: 'en-US'}locale determine the decimal separator and is one of ['ar', 'ar-AE', 'ar-BH', 'ar-DZ', 'ar-EG', 'ar-IQ', 'ar-JO', 'ar-KW', 'ar-LB', 'ar-LY', 'ar-MA', 'ar-QA', 'ar-QM', 'ar-SA', 'ar-SD', 'ar-SY', 'ar-TN', 'ar-YE', 'bg-BG', 'cs-CZ', 'da-DK', 'de-DE', 'el-GR', 'en-AU', 'en-GB', 'en-HK', 'en-IN', 'en-NZ', 'en-US', 'en-ZA', 'en-ZM', 'es-ES', 'fa', 'fa-AF', 'fa-IR', 'fr-FR', 'fr-CA', 'hu-HU', 'id-ID', 'it-IT', 'ku-IQ', 'nb-NO', 'nl-NL', 'nn-NO', 'pl-PL', 'pl-Pl', 'pt-BR', 'pt-PT', 'ru-RU', 'sl-SI', 'sr-RS', '[email protected]', 'sv-SE', 'tr-TR', 'uk-UA', 'vi-VN'].Note: decimal_digits is given as a range like '1,3', a specific value like '3' or min like '1,'. |
| is_divisible_by(str, number) | check if the string is a number that's divisible by another. |
| is_ean(str) | check if the string is an EAN (European Article Number). |
| is_float(str [, options]) | check if the string is a float.options is an object which can contain the keys min, max, gt, and/or lt to validate the float is within boundaries (e.g. { min: 7.22, max: 9.55 }) it also has locale as an option.min and max are equivalent to 'greater or equal' and 'less or equal', respectively while gt and lt are their strict counterparts.locale determine the decimal separator and is one of ['ar', 'ar-AE', 'ar-BH', 'ar-DZ', 'ar-EG', 'ar-IQ', 'ar-JO', 'ar-KW', 'ar-LB', 'ar-LY', 'ar-MA', 'ar-QA', 'ar-QM', 'ar-SA', 'ar-SD', 'ar-SY', 'ar-TN', 'ar-YE', 'bg-BG', 'cs-CZ', 'da-DK', 'de-DE', 'en-AU', 'en-GB', 'en-HK', 'en-IN', 'en-NZ', 'en-US', 'en-ZA', 'en-ZM', 'es-ES', 'fr-CA', 'fr-FR', 'hu-HU', 'it-IT', 'nb-NO', 'nl-NL', 'nn-NO', 'pl-PL', 'pt-BR', 'pt-PT', 'ru-RU', 'sl-SI', 'sr-RS', '[email protected]', 'sv-SE', 'tr-TR', 'uk-UA']. Locale list is validator.isFloatLocales. |
| is_hexadecimal(str) | check if the string is a hexadecimal number. |
| is_int(str [, options]) | check if the string is an integer.options is an object which can contain the keys min and/or max to check the integer is within boundaries (e.g. { min: 10, max: 99 }). options can also contain the key allow_leading_zeroes, which when set to false will disallow integer values with leading zeroes (e.g. { allow_leading_zeroes: false }). Finally, options can contain the keys gt and/or lt which will enforce integers being greater than or less than, respectively, the value provided (e.g. {gt: 1, lt: 4} for a number between 1 and 4). |
| is_ip(str [, version]) | check if the string is an IP (version [string |
| is_ISO31661_alpha2(str) | check if the string is a valid ISO 3166-1 alpha-2 officially assigned country code. |
| is_isrc(str) | check if the string is a ISRC. |
| is_jwt(str) | check if the string is valid JWT token. |
| isLowercase(str) | check if the string is lowercase. |
| is_md5(str) | check if the string is a MD5 hash. Please note that you can also use the isHash(str, 'md5') function. Keep in mind that MD5 has some collision weaknesses compared to other algorithms (e.g., SHA). |
| is_mongo_id(str) | check if the string is a valid hex-encoded representation of a [MongoDB ObjectId][mongoid]. |
| is_number(str [, options]) | check if the string is a number (int or float) |
| is_octal(str) | check if the string is a valid octal number. |
| is_passport_number(str, country_code) | check if the string is a valid passport number. (country_code is one of [ 'AM', 'AR', 'AT', 'AU', 'BA', 'BE', 'BG', 'BY', 'BR', 'CA', 'CH', 'CN', 'CY', 'CZ', 'DE', 'DK', 'DZ', 'EE', 'ES', 'FI', 'FR', 'GB', 'GR', 'HR', 'HU', 'IE' 'IN', 'IR', 'ID', 'IS', 'IT', 'JP', 'KR', 'LT', 'LU', 'LV', 'LY', 'MT', 'MY', 'MZ', 'NL', 'PL', 'PT', 'RO', 'RS', 'RU', 'SE', 'SL', 'SK', 'TR', 'UA', 'US' ]. |
| is_port(str) | check if the string is a valid port number. |
| is_rgb_color(str [, include_percent_values]) | check if the string is a rgb or rgba color.includePercentValues defaults to true. If you don't want to allow to set rgb or rgba values with percents, like rgb(5%,5%,5%), or rgba(90%,90%,90%,.3), then set it to false. |
| is_semantic_version(str) | check if the string is a Semantic Versioning Specification (SemVer). |
| is_uppercase(str) | check if the string is uppercase. |
| is_slug(str) | Check if the string is of type slug. Options allow a single hyphen between string. e.g. [cn-cn, cn-c-c] |
| is_uuid(str [, version]) | check if the string is a UUID (version [string |
7 Dec 13, 2021
13 Mar 17, 2022
23 Nov 04, 2022
2 Jan 10, 2022
31 Jan 01, 2023
46 Dec 25, 2022
0 Mar 24, 2022
6 Sep 13, 2022
4 Oct 30, 2022
1 Oct 30, 2021
53 Sep 07, 2022
2 Sep 04, 2022
0 Aug 31, 2022
4 Sep 24, 2021
1 Mar 31, 2022
6 Dec 01, 2021
9 Jan 26, 2022
12 Dec 26, 2022
26 Dec 30, 2022
12 Jan 02, 2023