chore: ✅ placeholder code and tests so workflows run (#72)

# Description

This allows the workflows and `just run-all` to run, plus gets the
quartodocs to work properly and not mess up the `_quarto.yml`.

Needs a quick review.

## Checklist

- [x] Ran `just run-all`

Author: lwjohnst86

_quarto.yml

@@ -66,6 +66,12 @@ quartodoc:
     style: _renderer.py
     table_style: description-list
     show_signature_annotations: true
+  sections:
+    - title: CLI functions
+      desc: "Functions available via the command line interface."
+      contents:
+        - build
+        - view
 
 metadata-files:
   - docs/reference/_sidebar.yml

src/seedcase_flower/__init__.py

@@ -1 +1,5 @@
 """Module containing all source code."""
+
+from .cli import build, view
+
+__all__ = ["build", "view"]

src/seedcase_flower/cli.py

@@ -0,0 +1,14 @@
+"""Module containing only the functions for the exposed CLI."""
+
+from pathlib import Path
+
+
+def build() -> Path:
+    """Build human-friendly documentation from a `datapackage.json` file."""
+    # mypy doesn't like returning None (design is to return None)
+    return Path(".")
+
+
+def view() -> str:
+    """Display the contents of a `datapackage.json` to the Terminal in a human-friendly way."""
+    return ""

tests/test_cli.py

@@ -0,0 +1,17 @@
+"""These are integration tests for the CLI commands."""
+
+from pathlib import Path
+
+from seedcase_flower.cli import build, view
+
+
+def test_build() -> None:
+    """Test the build CLI function."""
+    result = build()
+    assert result == Path(".")
+
+
+def test_view() -> None:
+    """Test the view CLI function."""
+    result = view()
+    assert result == ""