Skip to main content

Decorator for run-time type checks.

Project description

Takes

https://img.shields.io/pypi/v/takes.svg https://img.shields.io/travis/pymetrics/takes.svg Documentation Status

Decorator for run-time type checks.

Features

  • Convert undefined dictionaries accepted by functions to strong data types, without changing calling code.

  • Decorated functions can be called with dictionaries as before, or with instances of the desired type.

Example

This function takes an undocumented dictionary. Maintainers must read the function body to determine the expected shape of the data.

def my_function(data):
    x, y = data["x"], data["y"]
    return f"x={x}, y={y}"

>>> my_function({"x": 1, "y": 1})
"x=1, y=1"

Takes lets you redefine this function to accept a well-defined data type, without needing to immediately change all of the calling code:

from takes import takes

@dataclass
class Point:
    x: int
    y: int

@takes(Point)
def my_function(point):
    x, y = point.x, point.y
    return f"x={x}, y={y}"

# Can still call my_function with a dictionary,
# Takes will convert it to a point by instantiating
# a Point using the given data as kwargs:
>>> my_function({"x": 1, "y": 1})
"x=1, y=1"

# Of course, you can also call the function with the proper
# type:
>>> my_function(Point(x=1, y=1))
"x=1, y=1"

Further, takes performs type checks at run-time.

Credits

This package was created with Cookiecutter and the pymetrics/cookiecutter-python-library project template.

History

0.2.0 (2021-11-28)

  • First release on PyPI.

Project details


Download files

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

Source Distribution

takes-0.2.0.tar.gz (13.4 kB view details)

Uploaded Source

Built Distribution

takes-0.2.0-py2.py3-none-any.whl (4.2 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file takes-0.2.0.tar.gz.

File metadata

  • Download URL: takes-0.2.0.tar.gz
  • Upload date:
  • Size: 13.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.2 pkginfo/1.8.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.9

File hashes

Hashes for takes-0.2.0.tar.gz
Algorithm Hash digest
SHA256 2d4b7b49699ee6ad125c418c5032ef05487ada49582926ba58fa60b5a49914e5
MD5 d69cc4a9de4193e480197d7f2c56a34e
BLAKE2b-256 3d153898af4e1a3d54f17f249c9f16695a3e47488ab0813b7586cce06a6c123c

See more details on using hashes here.

File details

Details for the file takes-0.2.0-py2.py3-none-any.whl.

File metadata

  • Download URL: takes-0.2.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 4.2 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.2 pkginfo/1.8.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.9

File hashes

Hashes for takes-0.2.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 c028447c0c27e93580c71bc28fa34afd5722d0195b707877e9e9ee45304ede4b
MD5 33d38d87cad77e3896782ce1b7acefd5
BLAKE2b-256 d2c84eb3ce30d72d7f28b2b4a061d7b036f74b4034073ea33759ead76ed48ddf

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page