Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

A library to check user input.

Project description

userprovided

The package "userprovided" checks input for plausibility. For example it can check whether a string is a valid email address or an URL.

There are plenty of validators out there. The reasons to write another one:

  • Its sister-project exoskeleton needs some special features.
  • Extensive testing (100% test coverage / unit tests / automatic test generation with the hypothesis package)
  • Modularity

Installation and Use

Please take note that the development status of "userprovided" is "beta". This means it may still contain some bugs and some commands could change with one of the next releases.

Install exoskeleton using pip or pip3. For example:

pip install userprovided

You may consider using a virtualenv.

Examples

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

import userprovided

### Mailadresses ###

userprovided.mail.is_email(None)
# => False

userprovided.mail.is_email('example@example.com')
# => True

### Cloud ###

userprovided.cloud.is_aws_s3_bucket_name('foobar')
# => True


### URLs ###

print(userprovided.url.is_url('https://www.example.com'))
# => True

print(userprovided.url.is_url('https://www.example.com', ('ftp')))
# => False (Schema does not match permitted)


### Hashes ###

print(userprovided.hash.hash_available('md5'))
# => ValueError because md5 is deprecated

print(userprovided.hash.hash_available('sha256'))
# => True on almost any system

Update and Deprecation Policy

It makes no sense to duplicate functionality already available in the Python Standard Library.

For example: userprovided does not contain methods to check IP addresses as the library ipaddress is (since Python 3.3.) part of the standard.

If this package contains functionality that becomes superseded by the Standard Library, it will start to log a depreciation warning. The functionality itself is planned to stay available for at least a major version of userprovided.

Project details


Download files

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

Files for userprovided, version 0.5.4
Filename, size File type Python version Upload date Hashes
Filename, size userprovided-0.5.4-py3-none-any.whl (10.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size userprovided-0.5.4.tar.gz (5.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page