# HG changeset patch
# User Goffi <goffi@goffi.org>
# Date 1627591861 -7200
# Node ID 62e81b1058f874bf6c96b27b17699cb7d4c7d4ef
# Parent  80815f2f12cf4a996ffc164a78137c7d6dcd2da1
doc: activate `autodoc` extension + extension to adapt Libervia docstring style to autodoc

diff -r 80815f2f12cf -r 62e81b1058f8 doc/_ext/__init__.py
diff -r 80815f2f12cf -r 62e81b1058f8 doc/_ext/docstring.py
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/_ext/docstring.py	Thu Jul 29 22:51:01 2021 +0200
@@ -0,0 +1,19 @@
+#!/usr/bin/env python3
+
+"""Adapt Libervia docstring style to autodoc"""
+
+
+def process_docstring(app, what, name, obj, options, lines):
+    lines[:] = [
+        l.replace("@param", ":param").replace("@raise", ":raises")
+        for l in lines
+    ]
+
+
+def setup(app):
+    app.connect("autodoc-process-docstring", process_docstring)
+    return {
+        'version': '0.1',
+        'parallel_read_safe': True,
+        'parallel_write_safe': True,
+    }
diff -r 80815f2f12cf -r 62e81b1058f8 doc/conf.py
--- a/doc/conf.py	Thu Jul 29 22:51:01 2021 +0200
+++ b/doc/conf.py	Thu Jul 29 22:51:01 2021 +0200
@@ -12,13 +12,15 @@
 # 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
 import os.path
 import re
 
 
+sys.path.insert(0, os.path.abspath("./_ext"))
+
+
 # -- Project information -----------------------------------------------------
 
 project = 'Libervia'
@@ -47,6 +49,8 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
+    "sphinx.ext.autodoc",
+    "docstring"
 ]
 
 # Add any paths that contain templates here, relative to this directory.