Set up continuous integration

.github/workflows/check.yml

@@ -0,0 +1,31 @@
+name: continuous integration
+on: [push, pull_request]
+env:
+  HCI_ROOT_DIR: "."
+permissions:
+  contents: read
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup Go 1.22
+        uses: actions/setup-go@v5
+        with:
+          go-version: "1.22.x"
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: install Pipenv
+        run: pip install pipenv --user
+      - name: install dependencies
+        run: pipenv sync --dev # Installs all deps, including dev deps, from Pipfile.lock.
+      - name: format
+        run: pipenv run invoke fmt
+      - name: lint
+        run: pipenv run invoke lint
+      - name: check types
+        run: pipenv run invoke build
+      - name: run tests
+        run: pipenv run invoke test

LICENSE.md

@@ -15,4 +15,4 @@ INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PA
 PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
 OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
-OTHER DEALINGS IN THE SOFTWARE.
+OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -1,4 +1,4 @@
 # Human Leukocyte Antigen (HLA) Curation Interface
 
 The HCI is under development. See our [roadmap](https://github.com/ClinGen/stanford-hci/issues/1)
-and our [docs](./doc).
+and our [docs](./doc).

doc/README.md

@@ -1,26 +1,26 @@
 # Documentation
 
 - [Tutorials](./tutorial.md) (learning-oriented)
-    - Tutorials are lessons that take the reader by the hand through a series of
-      steps to complete a project of some kind. Unlike how-to guides, tutorials
-      don't assume lots of prerequisite knowledge.
+  - Tutorials are lessons that take the reader by the hand through a series of
+    steps to complete a project of some kind. Unlike how-to guides, tutorials
+    don't assume lots of prerequisite knowledge.
 - [How-to guides](./howto.md) (problem-oriented)
-    - How-to guides take the reader through the steps required to solve a
-      real-world problem. They are recipes, directions to achieve a specific end.
-      Unlike tutorials, they typically assume a fair amount of prerequisite
-      knowledge.
+  - How-to guides take the reader through the steps required to solve a
+    real-world problem. They are recipes, directions to achieve a specific end.
+    Unlike tutorials, they typically assume a fair amount of prerequisite
+    knowledge.
 - [Explanations](./explanation.md) (understanding-oriented)
-    - Explanation, or discussions, clarify and illuminate a particular topic. They
-      broaden the documentation’s coverage of a topic. Explanations can equally
-      well be described as discussions; they are discursive in nature. They are a
-      chance for the documentation to relax and step back from the software,
-      taking a wider view, illuminating it from a higher level or even from
-      different perspectives. You might imagine a discussion document being read
-      at leisure, rather than over the code.
+  - Explanation, or discussions, clarify and illuminate a particular topic. They
+    broaden the documentation’s coverage of a topic. Explanations can equally
+    well be described as discussions; they are discursive in nature. They are a
+    chance for the documentation to relax and step back from the software,
+    taking a wider view, illuminating it from a higher level or even from
+    different perspectives. You might imagine a discussion document being read
+    at leisure, rather than over the code.
 - Reference guides (information-oriented)
-    - Reference guides are technical descriptions of the machinery and how to
-      operate it. Reference guides have one job only: to describe. They are
-      code-determined, because ultimately that’s what they describe: key classes,
-      functions, APIs, and so they should list things like functions, fields,
-      attributes and methods, and set out how to use them. For this project,
-      reference is code comments (Go doc comments).
+  - Reference guides are technical descriptions of the machinery and how to
+    operate it. Reference guides have one job only: to describe. They are
+    code-determined, because ultimately that’s what they describe: key classes,
+    functions, APIs, and so they should list things like functions, fields,
+    attributes and methods, and set out how to use them. For this project,
+    reference is code comments (Go doc comments).

doc/explanation.md

@@ -1 +1 @@
-# Explanations
+# Explanations

doc/howto.md

@@ -1 +1 @@
-# How-to guides
+# How-to guides

doc/tutorial.md

@@ -1 +1 @@
-# Tutorials
+# Tutorials

tasks.py

@@ -37,6 +37,8 @@ def fmt(c):
     """Format code."""
     c.run("go fmt ./...")
     c.run("black tasks.py")
+    c.run("yamlfmt ./.github/**/*")
+    c.run("mdformat .")
 
 
 @task