[doc] use autodoc to generate doc based on docstring

doc/conf.py

@@ -15,10 +15,10 @@
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
-#
-# import os
-# import sys
-# sys.path.insert(0, os.path.abspath('.'))
+
+import os
+import sys
+sys.path.insert(0, os.path.abspath('..'))
 
 
 # -- General configuration ------------------------------------------------

doc/index.rst

@@ -16,6 +16,12 @@ a reference.
    :maxdepth: 2
    :caption: Contents:
 
+   utils/filesystem
+   utils/network
+   utils/process
+   utils/stream
+   utils/text
+
 Indices and tables
 ==================
 

doc/utils/network.rst

@@ -0,0 +1,5 @@
+Network operation utils
+=======================
+
+.. autofunction:: moulinette.utils.network.download_text
+.. autofunction:: moulinette.utils.network.download_json

doc/utils/process.rst

@@ -0,0 +1,6 @@
+Process operation utils
+=======================
+
+.. autofunction:: moulinette.utils.process.check_output
+.. autofunction:: moulinette.utils.process.call_async_output
+.. autofunction:: moulinette.utils.process.run_commands

doc/utils/stream.rst

@@ -0,0 +1,5 @@
+Stream operation utils
+======================
+
+.. autofunction:: moulinette.utils.stream.consume_queue
+.. autofunction:: moulinette.utils.stream.async_file_reading