Type hinting

I have started to use mypy. Aaaand it is not so good right now.

Libraries lack typing support. And I know that mimesis support only python3. Do you consider adding type hints?

There are some advantages:

• stricter API
• static analysis support to improve quality

There are some disadvantages:

• type hinting was introduced in python3.5, so any version prior to that will have to use special comments or other hacks
• a lot of manual work
• possible API changes

[lk-geimfari]

Sooo, it’s done!

[bjd2385]

@lk-geimfari I’ve already mentioned this in #267, but if one is defaulting the argument to None, which is automatically pushed to type(None) or NoneType, then we should use typing.Optional[the_type]. In the example above, we’d have

def randints(self, amount: Optional[int] = None, a: int = 1, b: int = 100) -> list:
        """Generate list of random integers.

        :param amount: Amount of elements.
        :param a: Minimum value of range.
        :param b: Maximum value of range.
        :return: List of random integers.
        """

        if amount is None:
            amount = 3

        return [self.randint(a, b) for _ in range(amount)]

By the way, I believe I mistakenly reversed the logic of that predicate in my PR earlier 😛