Add doctest in documentation

Author: seignovert

.travis.yml

@@ -22,4 +22,4 @@ deploy:
   local-dir: .tox/docs/_build
   on:
     tags: true
-    condition: $TOX = docs
+    condition: $TOX = "docs"

docs/index.rst

@@ -1,12 +1,20 @@
 .. include:: ../README.rst
 
-Content
--------
-
 .. testsetup::
 
     from foo import foo
 
+Doctest in the documentation
+----------------------------
+
+>>> foo('dummy')
+'foo'
+
+
+Content
+-------
+
+
 .. automodule:: foo
     :members:
     :show-inheritance:

foo/__init__.py

@@ -11,8 +11,8 @@ def foo(dummy):
         Examples should be written in doctest format, and should illustrate how
         to use the function.
 
-        >>> print(foo('dummy'))
-        foo
+        >>> foo('dummy')
+        'foo'
 
     Note:
         Test note in docstring

tox.ini

@@ -15,17 +15,19 @@ deps =
   -rrequirements.txt
   -rtests/requirements.txt
 
-commands=
-  py.test --verbose \
-    --cov {envsitepackagesdir}/foo --cov-report term-missing --cov-report html \
+commands =
+  py.test \
+    --cov {envsitepackagesdir}/foo \
+    --cov-report term-missing \
+    --verbose \
     {posargs}
 
 [testenv:py36-docs]
 deps =
   -rdocs/requirements.txt
 
-commands = 
+commands =
+    sphinx-build docs "{toxworkdir}/docs/_build" --color -W -bhtml {posargs}
     sphinx-build docs "{toxworkdir}/docs/_build" --color -W -bdoctest {posargs}
     sphinx-build docs "{toxworkdir}/docs/_build" --color -W -bcoverage {posargs}
-    /bin/cat {toxworkdir}/docs/_build/python.txt
-    sphinx-build docs "{toxworkdir}/docs/_build" --color -W -bhtml {posargs}
+    /bin/cat {toxworkdir}/docs/_build/python.txt