feature: add type hints for recipes (pytoolz#496)

Author: Jiehong

.gitignore

@@ -4,5 +4,6 @@ dist/
 *.egg-info/
 bench/shakespeare.txt
 .coverage
+.idea
 
 \.tox/

.travis.yml

@@ -17,7 +17,7 @@ env:
 
 # command to install dependencies
 install:
-    - pip install coverage pep8 pytest
+    - pip install coverage pep8 pytest 'mypy==0.782'
 
 # command to run tests
 # require 100% coverage (not including test files) to pass Travis CI test
@@ -32,6 +32,7 @@ script:
     - python setup.py develop
     - py.test
     - nosetests
+    - mypy toolz/recipes.py
 
 # load coverage status to https://coveralls.io
 after_success:

toolz/__init__.py

@@ -19,7 +19,7 @@
 
 from . import curried, sandbox
 
-functoolz._sigs.create_signature_registry()
+functoolz._sigs.create_signature_registry()  # type: ignore
 
 from ._version import get_versions
 __version__ = get_versions()['version']

toolz/_signatures.py

@@ -17,6 +17,7 @@
 import itertools
 import operator
 from importlib import import_module
+from typing import Dict
 
 from .functoolz import (is_partial_args, is_arity, has_varargs,
                         has_keywords, num_required_args)
@@ -571,7 +572,7 @@
         lambda a, b: None],
 )
 
-module_info['toolz'] = dict(
+module_info['toolz'] = dict(  # type: ignore
     curry=[
         (0, lambda *args, **kwargs: None)],
     excepts=[
@@ -584,7 +585,7 @@
         (0, lambda func=None, cache=None, key=None: None)],
 )
 
-module_info['toolz.functoolz'] = dict(
+module_info['toolz.functoolz'] = dict(  # type: ignore
     Compose=[
         (0, lambda funcs: None)],
     InstanceProperty=[
@@ -653,7 +654,7 @@ def expand_sig(sig):
     return num_pos_only, func, keyword_only + keyword_exclude, sigspec
 
 
-signatures = {}
+signatures: Dict = {}
 
 
 def create_signature_registry(module_info=module_info, signatures=signatures):

toolz/_version.py

@@ -15,6 +15,7 @@
 import re
 import subprocess
 import sys
+from typing import Dict
 
 
 def get_keywords():
@@ -52,7 +53,7 @@ class NotThisMethod(Exception):
     """Exception raised if a method is not valid for the current scenario."""
 
 
-LONG_VERSION_PY = {}
+LONG_VERSION_PY: Dict = {}
 HANDLERS = {}
 
 

toolz/curried/__init__.py

@@ -99,5 +99,5 @@
 valfilter = toolz.curry(toolz.valfilter)
 valmap = toolz.curry(toolz.valmap)
 
-del exceptions
+del exceptions  # type: ignore
 del toolz

toolz/recipes.py

@@ -1,11 +1,16 @@
 import itertools
-from .itertoolz import frequencies, pluck, getter
+from typing import TypeVar, Dict, Tuple, Callable, Any, Iterable, Sequence
 
+from .itertoolz import frequencies, pluck, getter
 
 __all__ = ('countby', 'partitionby')
 
+A = TypeVar('A')
+B = TypeVar('B')
+KeyLike = TypeVar('KeyLike', int, Iterable, Callable, Tuple)
+
 
-def countby(key, seq):
+def countby(key: KeyLike, seq: Iterable[Any]) -> Dict[Any, int]:
     """ Count elements of a collection by a key function
 
     >>> countby(len, ['cat', 'mouse', 'dog'])
@@ -20,10 +25,11 @@ def countby(key, seq):
     """
     if not callable(key):
         key = getter(key)
-    return frequencies(map(key, seq))
+    return frequencies(map(key, seq))  # type: ignore
 
 
-def partitionby(func, seq):
+def partitionby(func: Callable[[A], bool],
+                seq: Sequence[A]) -> Iterable[Tuple[A, ...]]:
     """ Partition a sequence according to a function
 
     Partition `s` into a sequence of lists such that, when traversing