Exercise(tags-add): add download and verify (tag v1.0.0)

Author: MousseDm

tags_add/.gitmastery-exercise.json

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

tags_add/README.md

@@ -0,0 +1,18 @@
+# tags-add
+
+<!--- Insert exercise description -->
+
+## Task
+
+<!--- Insert exercise task, simplify what needs to be done -->
+
+## Hints
+
+<!--- Insert hints here -->
+<!---
+    Use Github Markdown's collapsible content:
+    <details>
+    <summary>...</summary>
+    ...
+    </details>
+-->

tags_add/__init__.py

@@ -0,0 +1,16 @@
+from exercise_utils.file import create_or_update_file
+from exercise_utils.git import add, commit
+from exercise_utils.gitmastery import create_start_tag
+
+__resources__ = []
+
+def setup(verbose: bool = False):
+    create_or_update_file("README.md", "# T4L2: Add a tag\n")
+    add(["README.md"], verbose)
+    commit("chore: init README", verbose)
+
+    create_or_update_file("main.txt", "v1 content\n")
+    add(["main.txt"], verbose)
+    commit("feat: initial content", verbose)
+
+    create_start_tag(verbose)

tags_add/download.py

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

tags_add/tests/__init__.py

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

tags_add/tests/specs/base.yml

@@ -0,0 +1,26 @@
+from typing import List
+from git_autograder.core import GitAutograderExercise, GitAutograderStatus
+
+MSG_NO_TAG = "Tag 'v1.0.0' was not found."
+MSG_NOT_AT_HEAD = "Tag 'v1.0.0' does not point to HEAD."
+
+def verify(exercise: GitAutograderExercise):
+    """
+    Pass condition：
+    1) exist 1.0.0 tag
+    2) the tag is pointing to current head
+    """
+    repo = exercise.repo.repo
+    target = next((t for t in repo.tags if t.name == "v1.0.0"), None)
+
+    messages: List[str] = []
+    status = GitAutograderStatus.SUCCESSFUL
+
+    if target is None:
+        messages.append(MSG_NO_TAG)
+        status = GitAutograderStatus.FAILED
+    elif target.commit.hexsha != repo.head.commit.hexsha:
+        messages.append(MSG_NOT_AT_HEAD)
+        status = GitAutograderStatus.FAILED
+
+    return exercise.to_output(messages, status)