typical: Python's Typing Toolkit

How Typical

Introduction

typical is a library devoted to runtime analysis, inference, validation, and enforcement of Python types, PEP 484 Type Hints, and custom user-defined data-types.

It provides a high-level Functional API and Object API to suite most any occasion.

Getting Started

Installation is as simple as pip install -U typical. For more installation options to make typical even faster, see the Install section in the documentation.

Help

The latest documentation is hosted at python-typical.org.

Starting with version 2.0, All documentation is hand-crafted markdown & versioned documentation can be found at typical's Git Repo. (Versioned documentation is still in-the-works directly on our domain.)

A Typical Use-Case

The decorator that started it all:

`typic.al(...)`

import typic


@typic.al
def hard_math(a: int, b: int, *c: int) -> int:
    return a + b + sum(c)

hard_math(1, "3")
#> 4


@typic.al(strict=True)
def strict_math(a: int, b: int, *c: int) -> int:
    return a + b + sum(c)

strict_math(1, 2, 3, "4")
#> Traceback (most recent call last):
#>  ...
#> typic.constraints.error.ConstraintValueError: Given value <'4'> fails constraints: (type=int, nullable=False, coerce=False)

typical has both a high-level Object API and high-level Functional API. In general, any method registered to one API is also available to the other.

The Object API

from typing import Iterable

import typic


@typic.constrained(ge=1)
class ID(int):
    ...


@typic.constrained(max_length=280)
class Tweet(str):
    ...


@typic.klass
class Tweeter:
    id: ID
    tweets: Iterable[Tweet]
    

json = '{"id":1,"tweets":["I don\'t understand Twitter"]}'
t = Tweeter.transmute(json)

print(t)
#> Tweeter(id=1, tweets=["I don't understand Twitter"])

print(t.tojson())
#> '{"id":1,"tweets":["I don\'t understand Twitter"]}'

Tweeter.validate({"id": 0, "tweets": []})
#> Traceback (most recent call last):
#>  ...
#> typic.constraints.error.ConstraintValueError: Given value <0> fails constraints: (type=int, nullable=False, coerce=False, ge=1)

The Functional API

import dataclasses
from typing import Iterable

import typic


@typic.constrained(ge=1)
class ID(int):
    ...


@typic.constrained(max_length=280)
class Tweet(str):
    ...


@dataclasses.dataclass # or typing.TypedDict or typing.NamedTuple or annotated class...
class Tweeter:
    id: ID
    tweets: Iterable[Tweet]


json = '{"id":1,"tweets":["I don\'t understand Twitter"]}'
protocol = typic.protocol(Tweeter)

t = protocol.transmute(json)  # or typic.transmute()
print(t)
#> Tweeter(id=1, tweets=["I don't understand Twitter"])

print(protocol.tojson(t))
#> '{"id":1,"tweets":["I don\'t understand Twitter"]}'

protocol.validate({"id": 0, "tweets": []})  # or typic.validate()
#> Traceback (most recent call last):
#>  ...
#> typic.constraints.error.ConstraintValueError: Tweeter.id: value <0> fails constraints: (type=int, nullable=False, coerce=False, ge=1)

Changelog

See our Change Log and our Releases.

Metadata

Release files for typical 2.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for typical 2.0.2
File	Size	Uploaded
typical-2.0.2.tar.gz	69.0 kB	Apr 17, 2020	Details

Built distribution (wheel)

Table of built distributions (wheels) for typical 2.0.2
File	Interpreter	ABI	Platform	Reset
typical-2.0.2-py3-none-any.whl 86.7 kB Apr 17, 2020	Python 3	none	any	Details

Total release size: 155.8 kB

Release files / typical-2.0.2.tar.gz

Download URL	typical-2.0.2.tar.gz
Size	69.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`d83f6a88af7861f30c9a8a80de8f1cccd067a6b759cfff84f1d591b4cfeed802`
BLAKE2b-256 checksum How to use checksums	`8cac118d4268278758b8fe1ede1d7dd4c5732e8e6fab1880612b3289c5bdcb54`
Upload date	Apr 17, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.0.5 CPython/3.7.6 Linux/5.0.0-1035-azure`

Release files / typical-2.0.2-py3-none-any.whl

Download URL	typical-2.0.2-py3-none-any.whl
Size	86.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ff06d1b6056e12d119727138c97f9769d8f7d9162fea699f1f2ee3303a0741e1`
BLAKE2b-256 checksum How to use checksums	`0ddcd197e9afd23a2e4a03851c095d2e79eb353668a8c6a3bfc8c9da0cafeefb`
Upload date	Apr 17, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.0.5 CPython/3.7.6 Linux/5.0.0-1035-azure`