reintroduce __init__ parameter docs in the class docstring

Author: radix

effect/_base.py

@@ -19,6 +19,8 @@ class Effect(object):
     allow binding callbacks to be called with the result of the effect.
 
     Effects can be performed with :func:`perform`.
+
+    :param intent: The intent to be performed.
     """
 
     intent = attr.ib()

effect/_dispatcher.py

@@ -11,8 +11,9 @@
 class TypeDispatcher(object):
     """
     An Effect dispatcher which looks up the performer to use by type.
-    """
 
+    :param mapping: mapping of intent type to performer
+    """
     mapping = attr.ib()
 
     def __call__(self, intent):
@@ -25,15 +26,11 @@ class ComposedDispatcher(object):
     A dispatcher which composes other dispatchers.
 
     The dispatchers given will be searched in order until a performer is found.
+
+    :param dispatchers: Dispatchers to search.
     """
 
     dispatchers = attr.ib()
 
-    def __init__(self, dispatchers):
-        """
-        :param collections.Iterable dispatchers: Dispatchers to search.
-        """
-        self.dispatchers = dispatchers
-
     def __call__(self, intent):
         return next(filter(None, (d(intent) for d in self.dispatchers)), None)

effect/_intents.py

@@ -41,6 +41,8 @@ class ParallelEffects(object):
 
     Performers of this intent must fail with a :obj:`FirstError` exception when
     any child effect fails, representing the first error.
+
+    :param effects: Effects to be performed in parallel.
     """
 
     effects = attr.ib()
@@ -102,13 +104,19 @@ class Delay(object):
 
     When performed, the specified delay will pass and then the effect will
     result in None.
+
+    :param float delay: The number of seconds to delay.
     """
     delay = attr.ib()
 
 
 @attr.s
 class Constant(object):
-    """An intent that returns a pre-specified result when performed."""
+    """
+    An intent that returns a pre-specified result when performed.
+
+    :param result: The object which the Effect will result in.
+    """
     result = attr.ib()
 
 
@@ -120,7 +128,11 @@ def perform_constant(dispatcher, intent):
 
 @attr.s
 class Error(object):
-    """An intent that raises a pre-specified exception when performed."""
+    """
+    An intent that raises a pre-specified exception when performed.
+
+    :param BaseException exception: Exception instance to raise.
+    """
     exception = attr.ib()
 
 
@@ -149,6 +161,8 @@ class Func(object):
     intents as inert objects with public attributes of simple data. However,
     this is useful for integrating wih "legacy" side-effecting code in a quick
     way.
+
+    :param func: The function to call when this intent is performed.
     """
     func = attr.ib()