feat: Add type hinting

.coveragerc

@@ -4,3 +4,10 @@ include =
 omit =
     kazoo/tests/*
     kazoo/testing/*
+
+# Note - this is a copy of the default exclusions from coverage 7.10.1
+[report]
+exclude_lines =
+    #\s*(pragma|PRAGMA)[:\s]?\s*(no|NO)\s*(cover|COVER)
+    ^\s*(((async )?def .*?)?\)(\s*->.*?)?:\s*)?\.\.\.\s*(#|$)
+    if (typing\.)?TYPE_CHECKING:

.flake8

@@ -1,14 +1,28 @@
 [flake8]
 builtins = _
 exclude =
+    docs/conf.py,
     .git,
     __pycache__,
-    .venv/,venv/,
-    .tox/,
-    build/,dist/,*egg,
-    docs/conf.py,
-    zookeeper/
-# See black's documentation for E203
+    .venv/,
+    venv*/,
+    .tox*/,
+    build/,
+    dist/,
+    *egg,
+    zookeeper/,
+
 max-line-length = 79
-extend-ignore = BLK100,E203
+
+# See black's documentation for E203
+#
+# I am not sure what version of flake8 hound is using but it gives a lot of
+# undefined names for comments (F821) and redefinition of unused variables 
+# (F811).
+#
+# I've also had to supress F401 because you generally also need to specify
+# type: ignore and something gets very upset when you have both in the same
+# comment.
+# 
+extend-ignore = BLK100,E203,F401,F811,F821
 

.gitignore

@@ -29,14 +29,15 @@ zookeeper/
 .idea
 .project
 .pydevproject
-.tox
+.tox*/
 venv*/
 /.settings
 /.metadata
+__pycache__/
 
 !.gitignore
 !.git-blame-ignore-revs
 
-.vscode/settings.json
+.vscode/
 .*_cache/
 coverage.xml

constraints.txt

@@ -1,8 +1,14 @@
 # Consistent testing environment.
+# requirements.txt
+eventlet>=0.17.1 ; implementation_name!='pypy'
+gevent>=1.2 ; implementation_name!='pypy'
+
+# requirements-dev.txt
 black==22.10.0
 coverage==6.3.2; python_version=="3.8"
 coverage==7.10.7; python_version > "3.8"
 flake8==5.0.2
+mypy==1.14.1
 objgraph==3.5.0
 pytest==6.2.5; python_version=="3.8"
 pytest==8.4.2; python_version > "3.8"

docs/testing.rst

@@ -37,10 +37,10 @@ Example:
     from kazoo.testing import KazooTestHarness
 
     class MyTest(KazooTestHarness):
-        def setUp(self):
+        def setUp(self) -> None:
             self.setup_zookeeper()
 
-        def tearDown(self):
+        def tearDown(self)-> None:
             self.teardown_zookeeper()
 
         def testmycode(self):