Add Sphinx docs

doc/CLI.rst

@@ -0,0 +1,7 @@
+Command Line Interface
+======================
+
+.. argparse::
+   :module: cgnsutilities.cgns_utils
+   :func: get_parser
+   :prog: cgns_utils

doc/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

doc/conf.py

@@ -0,0 +1,25 @@
+from sphinx_mdolab_theme.config import *
+
+# -- Path setup --------------------------------------------------------------
+# 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
+from unittest.mock import MagicMock
+
+sys.path.insert(0, os.path.abspath("../"))
+
+extensions.extend(["sphinxarg.ext"])
+
+# -- Project information -----------------------------------------------------
+
+project = "CGNS Utilities"
+
+
+# We have to mock some stuff
+# and sphinxarg.ext does NOT use the autodoc mock feature
+
+for mod in ["cgnsutilities.libcgns_utils", "numpy"]:
+    sys.modules[mod] = MagicMock()

doc/index.rst

@@ -0,0 +1,13 @@
+.. CGNS Utilities documentation master file, created by
+   sphinx-quickstart on Mon Mar 29 10:19:14 2021.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+Welcome to CGNS Utilities's documentation!
+==========================================
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+   CLI

doc/requirements.txt

@@ -0,0 +1,3 @@
+sphinx_mdolab_theme
+sphinx-argparse
+