Minor: comments / docstring edits

Author: Sylvain MARIE

valid8/base.py

@@ -484,7 +484,7 @@ def failure_raiser(validation_callable,   # type: ValidationCallableOrLambda
     # type: (...) -> ValidationCallable
     """
     Wraps the provided validation function so that in case of failure it raises the given `failure_type` or a
-    `WrappingFailure` with the given help message.
+    `ValidationFailure` with the given help message.
 
     >>> import sys, pytest
     >>> if sys.version_info < (3, 0):
@@ -517,8 +517,8 @@ def failure_raiser(validation_callable,   # type: ValidationCallableOrLambda
     valid8.base.InvalidValue: x should be smaller than 3. Function [x < 3] returned [False] for value 11.
 
     :param validation_callable:
-    :param failure_type: an optional subclass of `WrappingFailure` that should be raised in case of failure, instead of
-        `WrappingFailure`.
+    :param failure_type: an optional subclass of `ValidationFailure` that should be raised in case of failure, instead
+        of `ValidationFailure`.
     :param help_msg: an optional string help message for the raised failure.
     :param kw_context_args: optional context arguments for the custom failure message
     :return:

valid8/common_syntax.py

@@ -100,7 +100,7 @@ def make_validation_func_callable(vf_definition,                   # type: Valid
        in case of success. If it is a mini-lambda expression it will automatically be transformed into a function using
        `mini_lambda.as_function`. See `ValidationCallable` type hint.
      - `<err_msg>` should be a string
-     - `<failure_type>` should be a subclass of `WrappingFailure`
+     - `<failure_type>` should be a subclass of `ValidationFailure`
 
     :param vf_definition: the definition for a validation function. One of <validation_func>,
         (<validation_func>, <err_msg>), (<validation_func>, <err_type>), or (<validation_func>, <err_msg>, <err_type>)
@@ -248,7 +248,7 @@ def make_validation_func_callables(*vf_definition,                  # type: OneO
     if len(vf_definition) == 0:
         raise ValueError('mandatory vf_definition is None')
     elif len(vf_definition) == 1:
-        # a single item has been received. If it is not a tuple, unpack it
+        # a single item has been received. If it is not a tuple, use it: it might be a list or dict
         single_entry = vf_definition[0]
         if not isinstance(single_entry, tuple):
             vf_definition = single_entry