Dataclass Type Validator Library
Project description
dataclass-type-validator
The dataclass-type-validator
is a type validation library for the properties of dataclasses.dataclass
using Python type hint information.
Installation
pip install dataclass-type-validator
or add dataclass-type-validator
line to requirements.txt
A Simple Example
Explicitly calling dataclass_type_validator from within your dataclass
from dataclasses import dataclass
from typing import List
from dataclass_type_validator import dataclass_type_validator
from dataclass_type_validator import TypeValidationError
@dataclass()
class User:
id: int
name: str
friend_ids: List[int]
def __post_init__(self):
dataclass_type_validator(self)
# Valid User
User(id=10, name='John Smith', friend_ids=[1, 2])
# => User(id=10, name='John Smith', friend_ids=[1, 2])
# Invalid User
try:
User(id='a', name=['John', 'Smith'], friend_ids=['a'])
except TypeValidationError as e:
print(e)
# => TypeValidationError: Dataclass Type Validation (errors = {
# 'id': "must be an instance of <class 'int'>, but received <class 'str'>",
# 'name': "must be an instance of <class 'str'>, but received <class 'list'>",
# 'friend_ids': 'must be an instance of typing.List[int], but there are some errors:
# ["must be an instance of <class \'int\'>, but received <class \'str\'>"]'})
The same, but using the class decorator instead
from dataclasses import dataclass
from typing import List
from dataclass_type_validator import dataclass_validate
from dataclass_type_validator import TypeValidationError
@dataclass_validate
@dataclass()
class User:
id: int
name: str
friend_ids: List[int]
# Valid User
User(id=10, name='John Smith', friend_ids=[1, 2])
# => User(id=10, name='John Smith', friend_ids=[1, 2])
# Invalid User
try:
User(id='a', name=['John', 'Smith'], friend_ids=['a'])
except TypeValidationError as e:
print(e)
# => TypeValidationError: Dataclass Type Validation (errors = {
# 'id': "must be an instance of <class 'int'>, but received <class 'str'>",
# 'name': "must be an instance of <class 'str'>, but received <class 'list'>",
# 'friend_ids': 'must be an instance of typing.List[int], but there are some errors:
# ["must be an instance of <class \'int\'>, but received <class \'str\'>"]'})
You can also pass the strict
param (which defaults to False) to the decorator:
@dataclass_validate(strict=True)
@dataclass(frozen=True)
class SomeList:
values: List[str]
# Invalid item contained in typed List
try:
SomeList(values=["one", "two", 3])
except TypeValidationError as e:
print(e)
# => TypeValidationError: Dataclass Type Validation Error (errors = {
# 'x': 'must be an instance of typing.List[str], but there are some errors:
# ["must be an instance of <class \'str\'>, but received <class \'int\'>"]'})
You can also pass the before_post_init
param (which defaults to False) to the decorator,
to force the type validation to occur before __post_init__()
is called. This can be used
to ensure the types of the field values have been validated before your higher-level semantic
validation is performed in __post_init__()
.
@dataclass_validate(before_post_init=True)
@dataclass
class User:
id: int
name: str
def __post_init__(self):
# types of id and name have already been checked before this is called.
# Otherwise, the following check will throw a TypeError if user passed
# `id` as a string or other type that cannot be compared to int.
if id < 1:
raise ValueError("superuser not allowed")
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for dataclass-type-validator-0.0.7.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0074266ca276ce2a1338d51b09e314f42514282afb41fa60250b9c50bca3af2e |
|
MD5 | d86a7b5d49ad9a55e5a0338bf6266bee |
|
BLAKE2b-256 | d59489e9a4baab008c28b81d215c863d576cc35ac405321dc08d2c8b39777205 |
Hashes for dataclass_type_validator-0.0.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a8194b5ed56f66f373d63d590db045af217e52a3001909c13f57234e666d8a59 |
|
MD5 | 205e2069f2ac8bbab723eb7a011ac6f1 |
|
BLAKE2b-256 | 2eb8f970a66d2235db017b5da85915f20882c5c045e6798f1dea7efb57806597 |