[staging-intervention] Setup exercise

Author: woojiahao

staging_intervention/.gitmastery-exercise.json

@@ -0,0 +1,16 @@
+{
+  "exercise_name": "staging-intervention",
+  "tags": [
+    "git-restore"
+  ],
+  "requires_git": true,
+  "requires_github": false,
+  "base_files": {},
+  "exercise_repo": {
+    "repo_type": "local",
+    "repo_name": "intervention",
+    "repo_title": null,
+    "create_fork": null,
+    "init": true
+  }
+}

staging_intervention/README.md

@@ -0,0 +1,11 @@
+# staging-intervention
+
+You are checking the attendance of your employees (indicated by staging a file)
+but you realize some employees have checked in but did not appear in person.
+
+## Task
+
+Unstage the attendance files of the following employees: Josh, Adam, Mary.
+
+Keep everyone else's attendance file staged.
+

staging_intervention/__init__.py

@@ -0,0 +1,52 @@
+import os
+import pathlib
+import subprocess
+import textwrap
+from sys import exit
+from typing import List, Optional
+
+
+def run_command(command: List[str], verbose: bool) -> Optional[str]:
+    try:
+        result = subprocess.run(
+            command,
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+        if verbose:
+            print(result.stdout)
+        return result.stdout
+    except subprocess.CalledProcessError as e:
+        if verbose:
+            print(e.stderr)
+        exit(1)
+
+
+def create_or_update_file(
+    filepath: str | pathlib.Path, contents: Optional[str] = None
+) -> None:
+    if os.path.dirname(filepath) != "":
+        os.makedirs(os.path.dirname(filepath), exist_ok=True)
+    if contents is None:
+        open(filepath, "a").close()
+    else:
+        with open(filepath, "w") as file:
+            file.write(textwrap.dedent(contents).lstrip())
+
+
+def setup(verbose: bool = False):
+    crew = [
+        "josh.txt",
+        "adam.txt",
+        "mary.txt",
+        "jane.txt",
+        "charlie.txt",
+        "kristen.txt",
+        "alice.txt",
+        "john.txt",
+    ]
+    for member in crew:
+        create_or_update_file(member)
+
+    run_command(["git", "add", "."], verbose)

staging_intervention/download.py

@@ -0,0 +1,6 @@
+initialization:
+  steps:
+    - type: commit
+      empty: true
+      message: Empty commit
+      id: start

staging_intervention/tests/__init__.py

@@ -0,0 +1,12 @@
+from git_autograder import GitAutograderTestLoader
+
+from ..verify import verify
+
+REPOSITORY_NAME = "staging-intervention"
+
+loader = GitAutograderTestLoader(__file__, REPOSITORY_NAME, verify)
+
+
+def test():
+    with loader.load("specs/base.yml", "start"):
+        pass

staging_intervention/tests/specs/base.yml

@@ -0,0 +1,11 @@
+from git_autograder import (
+    GitAutograderOutput,
+    GitAutograderExercise,
+    GitAutograderStatus,
+)
+
+
+def verify(exercise: GitAutograderExercise) -> GitAutograderOutput:
+    # INSERT YOUR GRADING CODE HERE
+
+    return exercise.to_output([], GitAutograderStatus.SUCCESSFUL)