Fix lint

Author: thejohnfreeman

.pydocstyle

@@ -0,0 +1,12 @@
+[pydocstyle]
+# These are preferences:
+# D102 = Missing docstring in public method
+# D103 = Missing docstring in public function
+# D105 = Missing docstring in magic method
+# D107 = Missing docstring in __init__
+# These conflict with the Google style:
+# D202 = No blank lines allowed after function docstring
+# D203 = 1 blank line required before class docstring
+# D213 = Multi-line docstring summary should start at the second line
+# D413 = Missing blank line after last section
+ignore = D102,D103,D105,D107,D202,D203,D213,D413

README.rst

@@ -140,8 +140,9 @@ site, so that path to instance discovery is impossible; the type variable
 
 .. code-block:: python
 
-   @typeclass('T')
-   def to_json(value: 'T') -> str:
+   T = typing.TypeVar('T')
+   @typeclass(T)
+   def to_json(value: T) -> str:
        """Serialize a value to JSON."""
 
 We may optionally provide a default implementation. If we do not, the

tests/test_tutorial.py

@@ -1,13 +1,19 @@
+"""Test the tutorial from the documentation."""
+
+# pylint: disable=invalid-name
+
 from dataclasses import dataclass
 import typing
 
-import pytest
+import pytest  # type: ignore
 
 from typeclasses import typeclass
 
+T = typing.TypeVar('T')
+
 
-@typeclass('T')
-def to_json(value: 'T') -> str:
+@typeclass(T)
+def to_json(value: T) -> str:  # pylint: disable=unused-argument
     """Serialize a value to JSON."""
 
 

typeclasses/decorator.py

@@ -1,3 +1,5 @@
+"""The :func:`typeclass` decorator."""
+
 import functools
 import inspect
 
@@ -7,11 +9,7 @@ def _empty():
 
 
 def _docstring():
-    """A docstring."""
-
-
-def _return_type() -> None:
-    pass
+    """Just an empty function with a docstring."""
 
 
 def _code(f):
@@ -25,17 +23,21 @@ def _code(f):
 
 def _is_empty(f):
     """Return whether a function has an empty body."""
-    return _code(f) in (_code(_empty), _code(_docstring), _code(_return_type))
+    return _code(f) in (_code(_empty), _code(_docstring))
 
 
 class TypeClassMethod:
-    """A type class of a single method.
+    """A method of a type class.
 
-    This docstring will be overwritten by that of the default implementation.
+    This docstring will be overwritten by that of the method's default
+    implementation.
     """
 
+    __name__: str
+
     def __init__(self, get_type_argument, default_implementation):
-        """
+        """Construct a type class method.
+
         Parameters
         ----------
         get_type_argument :