#11: after complete crash of VM: try to save as much as is still possible related to this issue

.gitlab-ci.yml

@@ -42,10 +42,7 @@ docs:
     - zypper --non-interactive install python3-pip
     - pip install --upgrade pip
     - pip install --no-cache-dir -r requirements.txt
-    - pip install sphinx
-    - pip install sphinxcontrib.napoleon
-    - pip install sphinxcontrib.restbuilder
-    - pip install sphinxcontrib.websupport
+    - pip install --no-cache-dir -r requirements_for_documentation.txt
     - chmod +x ./CI/create_documentation.sh
     - ./CI/create_documentation.sh
   artifacts:

docs/conf.py

@@ -14,6 +14,7 @@
 #
 import os
 import sys
+from recommonmark.parser import CommonMarkParser
 
 sys.path.insert(0, os.path.abspath('../'))
 #settings.configure()
@@ -50,11 +51,18 @@ extensions = [
     'sphinx.ext.viewcode',
     'sphinxcontrib.napoleon',
     'sphinxcontrib.restbuilder',
+    'sphinxcontrib.sqlalchemyviz',
+    'recommonmark',
+    'sphinx_markdown_tables',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
+source_parsers = {
+    '.md': CommonMarkParser,
+}
+
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
 #

docs/index.rst

@@ -10,10 +10,12 @@ Welcome to toar_db's documentation!
    :maxdepth: 5
 
    oldDB
+   toardb_fastapi
    newDB
    global_data_sources
 
 
+
 Indices and tables
 ==================
 

docs/toardb_fastapi.md

+../toardb_fastapi.md
\ No newline at end of file

requirements_for_documentation.txt

+< alabaster==0.7.12
+< commonmark==0.9.1
+< docutils==0.16
+< Jinja2==2.11.2
+< Markdown==3.2.2
+< MarkupSafe==1.1.1
+< pockets==0.9.1
+< recommonmark==0.6.0
+< sphinx-markdown-tables==0.0.15
+< sphinxcontrib-applehelp==1.0.2
+< sphinxcontrib-devhelp==1.0.2
+< sphinxcontrib-htmlhelp==1.0.3
+< sphinxcontrib-jsmath==1.0.1
+< sphinxcontrib-napoleon==0.7
+< sphinxcontrib-qthelp==1.0.3
+< sphinxcontrib-restbuilder==0.2
+< sphinxcontrib-serializinghtml==1.1.4
+< sphinxcontrib-sqlalchemyviz==0.5
+< sphinxcontrib-websupport==1.2.2

toardb/contacts/models_person.py

@@ -3,7 +3,7 @@
 class Person (Base)
 ===================
 """
-from sqlalchemy import Boolean, Column, Integer, String, Sequence
+from sqlalchemy import Boolean, Column, Integer, String, Sequence, UniqueConstraint
 from toardb.base import Base
 
 PERSONS_ID_SEQ = Sequence('persons_id_seq')  # define sequence explicitly

toardb/timeseries/models_programme.py

@@ -24,6 +24,7 @@ class TimeseriesProgramme(Base):
     +-------------+------------------------+-----------+----------+---------------------------------------------------+
     | description | text                   |           | not null |                                                   |
     +-------------+------------------------+-----------+----------+---------------------------------------------------+
+
     Indexes:
      "timeseries_programmes_pkey" PRIMARY KEY, btree (id)
     """