Update apidocs generation to work with readthedocs

.gitlab-ci.yml

@@ -110,7 +110,14 @@ apidocs:
     - ga
   script:
     - cd $CI_PROJECT_DIR
-    - ./tools/build_apidocs.sh
+    - ./tools/cleanup.sh
+    - virtualenv -p python2 .venv
+    - source .venv/bin/activate
+    - pip install sphinx sphinx_rtd_theme
+    - sphinx-build -b html -a -c docs/source docs/source docs/build/html
+    - cd docs/build && tar czf ../../apidocs.tar.gz html/ && cd ../..
+    - deactivate
+    - ./tools/cleanup.sh
 
 package_release:
   tags:

docs/source/conf.py

@@ -1,6 +1,62 @@
 # -*- coding: utf-8 -*-
 #
 # libwally-core documentation build configuration file
+SCANNING, DOCS, FUNC = 1, 2, 3
+
+def get_doc_lines(l):
+    if l.startswith('.. '):
+        return ['   ' + l, '']
+    return ['   ' + l]
+
+def output_func(docs, func):
+    is_normal_ret = 'WALLY_CORE_API int' in func
+    func = func[:-1].replace('WALLY_CORE_API','').strip()
+    func = func.replace(',',', ').replace('  ', ' ')
+    ret = ['.. c:function:: ' + func, '']
+    seen_param = False
+    for l in docs:
+        ret.extend(get_doc_lines(l))
+    if is_normal_ret:
+        ret.append('   :return: WALLY_OK or an error code.') # FIXME: Link
+        ret.append('   :rtype: int')
+    ret.append('')
+    ret.append('')
+    return ret
+
+def extract_docs(infile, outfile):
+
+    lines = [l.strip() for l in open(infile).readlines()]
+    title = infile.split('_')[1][:-2].capitalize() + ' Functions'
+    title_markup = '=' * len(title)
+    output, current, func, state = [title, title_markup, ''], [], '', SCANNING
+
+    for l in lines:
+        if state == SCANNING:
+            if l.startswith('/**') and '*/' not in l:
+                current, func, state = [l[3:]], '', DOCS
+        elif state == DOCS:
+            if l == '*/':
+                state = FUNC
+            else:
+                assert l.startswith('*'), l
+                if l.startswith('*|'):
+                    current[-1] += ' ' + l[2:].strip()
+                else:
+                    current.append(l[1:].strip())
+        else: # FUNC
+            func += l
+            if ');' in func:
+                output.extend(output_func(current, func))
+                state = SCANNING
+    with open(outfile, 'w') as f:
+        f.write('\n'.join(output))
+
+# Generate the documentation source files
+# FIXME: elements
+for m in [
+    'core', 'crypto', 'address', 'bip32', 'bip38', 'bip39', 'script', 'transaction'
+    ]:
+    extract_docs('../../include/wally_%s.h' % m, '%s.rst' % m)
 
 # -- General configuration ------------------------------------------------