Merge pull request #61 from ecmwf/develop

Bugfix in docs, added GitHub Actions to check docs creation
ecmwf · Oct 14, 2024 · c5259ef · c5259ef
2 parents 7198098 + 824fdbb
commit c5259ef
Show file tree

Hide file tree

Showing 4 changed files with 43 additions and 0 deletions.
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -19,6 +19,29 @@ jobs:
       - run: black --check .
       - run: flake8 .
 
+  docs:
+    name: docs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: conda-incubator/setup-miniconda@v2
+        with:
+          activate-environment: test
+          environment-file: docs/environment.yml
+          python-version: 3.8
+          auto-activate-base: false
+      - name: Conda check
+        shell: bash -l {0}
+        run: |
+          conda info
+          conda list
+      - name: Install pyflow and docs
+        shell: bash -l {0}  # required to load conda I think
+        run: |
+          python -m pip install .
+          cd docs
+          make html
+
   setup:
     name: setup
     runs-on: ubuntu-latest

diff --git a/docs/content/api-reference.rst b/docs/content/api-reference.rst
@@ -49,6 +49,14 @@ Variable
 .. autoclass:: pyflow.Edit
 
 
+GeneratedVariable
+~~~~~~~~~~~~~~~~~
+
+.. _GeneratedVariable:
+
+.. autoclass:: pyflow.GeneratedVariable
+
+
 .. _Trigger:
 
 Trigger
@@ -104,6 +112,16 @@ Defstatus
 
 .. autoclass:: pyflow.Defstatus
 
+Aviso
+~~~~~~~~~
+
+.. autoclass:: pyflow.Aviso
+
+Mirror
+~~~~~~~~~
+
+.. autoclass:: pyflow.Mirror
+
 
 Time Dependencies
 ~~~~~~~~~~~~~~~~~

diff --git a/docs/environment.yml b/docs/environment.yml
@@ -11,6 +11,7 @@ dependencies:
   - requests
   - pytest
   - pygraphviz
+  - pandoc
   - pip:
     - ipykernel
     - nbsphinx

diff --git a/pyflow/__init__.py b/pyflow/__init__.py
@@ -11,6 +11,7 @@
     Defstatus,
     Edit,
     Event,
+    GeneratedVariable,
     InLimit,
     Inlimit,
     Label,