throws 1.0.2

Python implementation of Javas @throws(...) function decorator!

Python: throws

Small but simple library providing a function decorator similar to Javas @throws(...) decorator. Should maily used for annotation, documentation and debugging purposes.

Installation

Installation is possible using the Python 3 pip tool. For you the installation command possibaly looks similar to this:

pip3 install throws

Usage

To use the @throw decorator simply put it before the function declaration providing every possible exception raised by the function. For a quick example see below:

from throws import throws

@throws([IOError, ValueError])
def check_version(version_file: str) -> bool:
    with open(version_file, "r", encoding = "utf-8") as vf:
        if (float(vf.read() > 1.0):
            return true
        return false

The library provides two Exceptions by itself, the ListEmptyException and the InvalidRaisedException. The first one is raised when the list used by @throw is left blank and the function decorated is run. The second one occours when the function raises an exception which is not provided to the decorator, providing the developer with feedback that he might have forgotten about handling this specific exception!

Links

Library at the Python Package Index (PyPI): https://pypi.org/project/throws/