{"id":17914213,"url":"https://github.com/knadh/stringvalidator.py","last_synced_at":"2025-03-23T23:30:46.472Z","repository":{"id":66339866,"uuid":"8534428","full_name":"knadh/stringvalidator.py","owner":"knadh","description":"Aa simple string validator class in Python for basic data validation such as checking if a string is alpha, alphanumeric, e-mail etc.","archived":false,"fork":false,"pushed_at":"2013-03-05T06:41:45.000Z","size":104,"stargazers_count":9,"open_issues_count":0,"forks_count":7,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-19T00:17:58.373Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/knadh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-03-03T09:41:05.000Z","updated_at":"2024-10-10T21:05:39.000Z","dependencies_parsed_at":"2023-02-20T02:30:54.914Z","dependency_job_id":null,"html_url":"https://github.com/knadh/stringvalidator.py","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knadh%2Fstringvalidator.py","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knadh%2Fstringvalidator.py/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knadh%2Fstringvalidator.py/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knadh%2Fstringvalidator.py/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/knadh","download_url":"https://codeload.github.com/knadh/stringvalidator.py/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245186440,"owners_count":20574551,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-28T19:56:52.066Z","updated_at":"2025-03-23T23:30:46.221Z","avatar_url":"https://github.com/knadh.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# stringvalidator.py\nAa simple string validator class in Python for basic data validation such as checking\nif a string is alpha, alphanumeric, e-mail etc.\n\nKailash Nadh, March 2013\n\nLicense:\tMIT License\n\nDocumentation: http://nadh.in/code/stringvalidator.py\n\n## Validation checks\n\u003ctable border=\"1\"\u003e\n\t\u003cthead\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003eCheck\u003c/td\u003e\n\t\t\t\u003ctd\u003eDescription\u003c/td\u003e\n\t\t\t\u003ctd\u003eArguments\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\u003c/thead\u003e\n\t\u003ctbody\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003eis_numeric\u003c/td\u003e\n\t\t\t\u003ctd\u003eCheck if a string is numeric (123, 12.3, -12.3 etc.)\u003c/td\u003e\n\t\t\t\u003ctd\u003e\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003eis_alpha\u003c/td\u003e\n\t\t\t\u003ctd\u003eCheck if a string is alphabetical (a-z only)\u003c/td\u003e\n\t\t\t\u003ctd\u003e\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003eis_alphanumeric\u003c/td\u003e\n\t\t\t\u003ctd\u003eCheck if a string is alphanumeric (a-z and 0-9)\u003c/td\u003e\n\t\t\t\u003ctd\u003e\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003eis_integer\u003c/td\u003e\n\t\t\t\u003ctd\u003eCheck if a string is an integer (1, -1, 0, but not 1.1)\u003c/td\u003e\n\t\t\t\u003ctd\u003e\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003eis_float\u003c/td\u003e\n\t\t\t\u003ctd\u003eCheck if a string is a float (1.0, -2.0, but not 1)\u003c/td\u003e\n\t\t\t\u003ctd\u003e\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003elonger_than\u003c/td\u003e\n\t\t\t\u003ctd\u003eCheck if a string is longer than a given length\u003c/td\u003e\n\t\t\t\u003ctd\u003e(length)\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003eshorter_than\u003c/td\u003e\n\t\t\t\u003ctd\u003eCheck if a string is shorter than a given length\u003c/td\u003e\n\t\t\t\u003ctd\u003e(length)\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003eis_email\u003c/td\u003e\n\t\t\t\u003ctd\u003eCheck if a given string is a valid e-mail\u003c/td\u003e\n\t\t\t\u003ctd\u003e\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003eis_tld\u003c/td\u003e\n\t\t\t\u003ctd\u003eCheck if a given string is a top level domain (www.site.com, site.com, but not a.b.site.com)\u003c/td\u003e\n\t\t\t\u003ctd\u003e\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003eis_handle\u003c/td\u003e\n\t\t\t\u003ctd\u003eCheck if a given string is a valid username handle containing only alphanumeric and _ (username, username9, user_name, 1user ...)\u003c/td\u003e\n\t\t\t\u003ctd\u003e\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\u003c/tbody\u003e\n\u003c/table\u003e\n\n## Usage\nAny number of conditions can be chained and passed to the ```StringValidator.validate()``` method.\n\n```StringValidator.validate(input, [checks], log)```\n\n- ```input``` is the input string to be validated. It is always stripped of preceding and trailing spaces\n\n- ```checks``` is the chained list of checks. Checks with arguments are passed as tuples\n\n- ```log``` is an optional boolean flag. If set to ```False```(default), ```StringValidator.validate()``` simply\nreturns ```True, False``` if all checks pass, or one of the checks fail, respectively.\nIf set to ```False```, ```True``` is returned if all checks pass, or a ```dict``` containing\nwhat failed and passed is returned. Example:\n\n```\n{\n\t'not_empty': True,\n\t'is_email': False\n}\n```\n\n### Examples\n```\nfrom StringValidator import StringValidator\n\nvalidator = StringValidator()\n\ninput = \"user@email.com\"\nvalidator.validate(input, ['is_email'])\n# =\u003e True\n\ninput = \"user@email.com\"\nvalidator.validate(input, ['is_email', ('longer_than', 20)])\n# =\u003e False\n\ninput = \"123.4\"\nvalidator.validate(input, ['not_empty', ('shorter_than', 5), 'is_float'])\n# =\u003e True\n\ninput = \"123.4\"\nvalidator.validate(input, ['is_float', ('longer_than', 5), ('shorter_than', 10)])\n# =\u003e True\n\n\ninput = \"123\"\nvalidator.validate(input, ['not_empty', 'is_alpha'], True)\n# =\u003e {\n\t'not_empty': True,\n\t'is_alpha': False\n}\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fknadh%2Fstringvalidator.py","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fknadh%2Fstringvalidator.py","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fknadh%2Fstringvalidator.py/lists"}