typepy 0.0.2

A python library for variable type checker/validator/converter at run time.

typepy

Summary

A python library for variable type checker/validator/converter at run time.

Usage

Type Check Method

>>> from typepy.type import Integer
>>> Integer(1).is_type()
True
>>> Integer(1.1).is_type()
False

Type Validation Method

>>> from typepy.type import Integer
>>> Integer(1).validate()
>>> try:
...     Integer(1.1).validate()
... except TypeError as e:
...     print(e)
...
invalid value type: expected=INTEGER, actual=<type 'float'>

Type Conversion Methods

convert

>>> from typepy.type import Integer
>>> from typepy import TypeConversionError
>>> Integer("1").convert()
1
>>> try:
...     Integer(1.1).convert()
... except TypeConversionError as e:
...     print(e)  # convert method will raise TypeConversionError when conversion failed
...
failed to convert from float to INTEGER

try_convert

>>> from typepy.type import Integer
>>> Integer("1").try_convert()
1
>>> print(Integer(1.1).try_convert())  # try_convert method will return None when conversion failed
None

force_convert

>>> from typepy.type import Integer
>>> Integer("1").force_convert()  # force_convert will forcibly convert the value
1
>>> Integer(1.1).force_convert()
1

For more information

Type check/validate/convert results will be changed according to strict_level value which can be passed to constructors as an argument. More information can be found in the API reference.

Features

The association between Python types and typepy classes is as follows:

Python Type	typepy Class
bool	Bool
datetime	DateTime
dict	Dictionary
inf	Infinity
int	Integer
float	RealNumber
NaN	Nan
None	None
str (not null)	String
str (null)	NullString

Installation

pip install typepy

Dependencies

Python 2.7+ or 3.3+

• mbstrdecoder

• python-dateutil

• pytz

• six

Test dependencies

• pytest

• pytest-runner

• tox

Documentation

http://typepy.rtfd.io/