From 6298fa6170cd1cb11dd876fa91d7cceb9cdc9446 Mon Sep 17 00:00:00 2001
From: Amir MOHAMMADI <amir.mohammadi@idiap.ch>
Date: Mon, 12 Jun 2017 11:14:13 +0200
Subject: [PATCH] compromise for Sphinx

---
 bob/bio/base/utils/io.py | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/bob/bio/base/utils/io.py b/bob/bio/base/utils/io.py
index bafd215b..906be8af 100644
--- a/bob/bio/base/utils/io.py
+++ b/bob/bio/base/utils/io.py
@@ -1,10 +1,7 @@
 import os
 import tempfile
 import tarfile
-try:  # this is needed for the sphinx documentation
-  from collections.abc import Callable, Iterable
-except ImportError:
-  from collections import Callable, Iterable
+import collections  # this is needed for the sphinx documentation
 import functools  # this is needed for the sphinx documentation
 import numpy
 import logging
@@ -185,9 +182,9 @@ def _generate_features(reader, paths):
 
   Parameters
   ----------
-  reader : Callable
+  reader : ``collections.Callable``
       See the documentation of :py:func:`vstack_features`.
-  paths : Iterable
+  paths : ``collections.Iterable``
       See the documentation of :py:func:`vstack_features`.
 
   Yields
@@ -273,14 +270,14 @@ def vstack_features(reader, paths, same_size=False):
 
   Parameters
   ----------
-  reader : Callable
+  reader : ``collections.Callable``
       The function to load the features. The function should only take one
       argument being the path to the features. Use
       :any:`functools.partial` to accommodate your reader to this format.
       The features returned by ``reader`` are expected to have the same
       :py:class:`numpy.dtype` and the same shape except for their first
       dimension. First dimension is should correspond to the number of samples.
-  paths : Iterable
+  paths : ``collections.Iterable``
       An iterable of paths to iterate on. Whatever is inside path is given to
       ``reader``. If ``same_size`` is ``True``, ``len(paths)`` must be valid.
   same_size : :obj:`bool`, optional
-- 
GitLab