Programming exercises: Add Bash programming exercise template (#10089)

docs/user/exercises/programming-exercise-features.inc

@@ -47,6 +47,8 @@ Instructors can still use those templates to generate programming exercises and
   +----------------------+----------+---------+
   | Go                   | yes      | yes     |
   +----------------------+----------+---------+
+  | Bash                 | yes      | yes     |
+  +----------------------+----------+---------+
 
 - Not all ``templates`` support the same feature set and supported features can also change depending on the continuous integration system setup.
   Depending on the feature set, some options might not be available during the creation of the programming exercise.
@@ -91,6 +93,8 @@ Instructors can still use those templates to generate programming exercises and
   +----------------------+----------------------+----------------------+---------------------+--------------+------------------------------------------+------------------------------+------------------------+
   | Go                   | no                   | no                   | yes                 | yes          | n/a                                      | no                           | L: yes, J: no          |
   +----------------------+----------------------+----------------------+---------------------+--------------+------------------------------------------+------------------------------+------------------------+
+  | Bash                 | no                   | no                   | no                  | no           | n/a                                      | no                           | L: yes, J: no          |
+  +----------------------+----------------------+----------------------+---------------------+--------------+------------------------------------------+------------------------------+------------------------+
 
   - *Sequential Test Runs*: ``Artemis`` can generate a build plan which first executes structural and then behavioral tests. This feature can help students to better concentrate on the immediate challenge at hand.
   - *Static Code Analysis*: ``Artemis`` can generate a build plan which additionally executes static code analysis tools.

src/main/java/de/tum/cit/aet/artemis/programming/domain/ProgrammingLanguage.java

@@ -39,6 +39,7 @@ public enum ProgrammingLanguage {
 
     private static final Set<ProgrammingLanguage> ENABLED_LANGUAGES = Set.of(
         ASSEMBLER,
+        BASH,
         C,
         C_PLUS_PLUS,
         C_SHARP,

src/main/java/de/tum/cit/aet/artemis/programming/service/TemplateUpgradePolicyService.java

@@ -32,8 +32,9 @@ public TemplateUpgradePolicyService(JavaTemplateUpgradeService javaRepositoryUpg
     public TemplateUpgradeService getUpgradeService(ProgrammingLanguage programmingLanguage) {
         return switch (programmingLanguage) {
             case JAVA -> javaRepositoryUpgradeService;
-            case KOTLIN, PYTHON, C, HASKELL, VHDL, ASSEMBLER, SWIFT, OCAML, EMPTY, RUST, JAVASCRIPT, R, C_PLUS_PLUS, TYPESCRIPT, C_SHARP, GO -> defaultRepositoryUpgradeService;
-            case SQL, MATLAB, BASH, RUBY, POWERSHELL, ADA, DART, PHP -> throw new UnsupportedOperationException("Unsupported programming language: " + programmingLanguage);
+            case KOTLIN, PYTHON, C, HASKELL, VHDL, ASSEMBLER, SWIFT, OCAML, EMPTY, RUST, JAVASCRIPT, R, C_PLUS_PLUS, TYPESCRIPT, C_SHARP, GO, BASH ->
+                defaultRepositoryUpgradeService;
+            case SQL, MATLAB, RUBY, POWERSHELL, ADA, DART, PHP -> throw new UnsupportedOperationException("Unsupported programming language: " + programmingLanguage);
         };
     }
 }

src/main/java/de/tum/cit/aet/artemis/programming/service/ci/ContinuousIntegrationService.java

@@ -219,8 +219,8 @@ enum RepositoryCheckoutPath implements CustomizableCheckoutPath {
             @Override
             public String forProgrammingLanguage(ProgrammingLanguage language) {
                 return switch (language) {
-                    case JAVA, PYTHON, C, HASKELL, KOTLIN, VHDL, ASSEMBLER, SWIFT, OCAML, EMPTY, RUST, JAVASCRIPT, R, C_PLUS_PLUS, TYPESCRIPT, C_SHARP, GO -> "assignment";
-                    case SQL, MATLAB, BASH, RUBY, POWERSHELL, ADA, DART, PHP -> throw new UnsupportedOperationException("Unsupported programming language: " + language);
+                    case JAVA, PYTHON, C, HASKELL, KOTLIN, VHDL, ASSEMBLER, SWIFT, OCAML, EMPTY, RUST, JAVASCRIPT, R, C_PLUS_PLUS, TYPESCRIPT, C_SHARP, GO, BASH -> "assignment";
+                    case SQL, MATLAB, RUBY, POWERSHELL, ADA, DART, PHP -> throw new UnsupportedOperationException("Unsupported programming language: " + language);
                 };
             }
         },
@@ -230,8 +230,8 @@ public String forProgrammingLanguage(ProgrammingLanguage language) {
             public String forProgrammingLanguage(ProgrammingLanguage language) {
                 return switch (language) {
                     case JAVA, PYTHON, HASKELL, KOTLIN, SWIFT, EMPTY, RUST, JAVASCRIPT, R, C_PLUS_PLUS, TYPESCRIPT -> "";
-                    case C, VHDL, ASSEMBLER, OCAML, C_SHARP, GO -> "tests";
-                    case SQL, MATLAB, BASH, RUBY, POWERSHELL, ADA, DART, PHP -> throw new UnsupportedOperationException("Unsupported programming language: " + language);
+                    case C, VHDL, ASSEMBLER, OCAML, C_SHARP, GO, BASH -> "tests";
+                    case SQL, MATLAB, RUBY, POWERSHELL, ADA, DART, PHP -> throw new UnsupportedOperationException("Unsupported programming language: " + language);
                 };
             }
         },

src/main/java/de/tum/cit/aet/artemis/programming/service/jenkins/JenkinsProgrammingLanguageFeatureService.java

@@ -1,5 +1,6 @@
 package de.tum.cit.aet.artemis.programming.service.jenkins;
 
+import static de.tum.cit.aet.artemis.programming.domain.ProgrammingLanguage.BASH;
 import static de.tum.cit.aet.artemis.programming.domain.ProgrammingLanguage.C;
 import static de.tum.cit.aet.artemis.programming.domain.ProgrammingLanguage.C_PLUS_PLUS;
 import static de.tum.cit.aet.artemis.programming.domain.ProgrammingLanguage.C_SHARP;
@@ -38,6 +39,7 @@ public class JenkinsProgrammingLanguageFeatureService extends ProgrammingLanguag
     public JenkinsProgrammingLanguageFeatureService() {
         // Must be extended once a new programming language is added
         programmingLanguageFeatures.put(EMPTY, new ProgrammingLanguageFeature(EMPTY, false, false, false, false, false, List.of(), false));
+        programmingLanguageFeatures.put(BASH, new ProgrammingLanguageFeature(BASH, false, false, false, false, false, List.of(), false));
         programmingLanguageFeatures.put(C, new ProgrammingLanguageFeature(C, false, false, true, false, false, List.of(FACT, GCC), false));
         programmingLanguageFeatures.put(C_PLUS_PLUS, new ProgrammingLanguageFeature(C_PLUS_PLUS, false, false, true, false, false, List.of(), false));
         programmingLanguageFeatures.put(C_SHARP, new ProgrammingLanguageFeature(C_SHARP, false, false, true, false, false, List.of(), false));

src/main/java/de/tum/cit/aet/artemis/programming/service/jenkins/build_plan/JenkinsBuildPlanService.java

@@ -185,8 +185,8 @@ private JenkinsXmlConfigBuilder builderFor(ProgrammingLanguage programmingLangua
             throw new UnsupportedOperationException("Xcode templates are not available for Jenkins.");
         }
         return switch (programmingLanguage) {
-            case JAVA, KOTLIN, PYTHON, C, HASKELL, SWIFT, EMPTY, RUST, JAVASCRIPT, R, C_PLUS_PLUS, TYPESCRIPT, C_SHARP, GO -> jenkinsBuildPlanCreator;
-            case VHDL, ASSEMBLER, OCAML, SQL, MATLAB, BASH, RUBY, POWERSHELL, ADA, DART, PHP ->
+            case JAVA, KOTLIN, PYTHON, C, HASKELL, SWIFT, EMPTY, RUST, JAVASCRIPT, R, C_PLUS_PLUS, TYPESCRIPT, C_SHARP, GO, BASH -> jenkinsBuildPlanCreator;
+            case VHDL, ASSEMBLER, OCAML, SQL, MATLAB, RUBY, POWERSHELL, ADA, DART, PHP ->
                 throw new UnsupportedOperationException(programmingLanguage + " templates are not available for Jenkins.");
         };
     }

src/main/java/de/tum/cit/aet/artemis/programming/service/localci/LocalCIProgrammingLanguageFeatureService.java

@@ -2,6 +2,7 @@
 
 import static de.tum.cit.aet.artemis.core.config.Constants.PROFILE_LOCALCI;
 import static de.tum.cit.aet.artemis.programming.domain.ProgrammingLanguage.ASSEMBLER;
+import static de.tum.cit.aet.artemis.programming.domain.ProgrammingLanguage.BASH;
 import static de.tum.cit.aet.artemis.programming.domain.ProgrammingLanguage.C;
 import static de.tum.cit.aet.artemis.programming.domain.ProgrammingLanguage.C_PLUS_PLUS;
 import static de.tum.cit.aet.artemis.programming.domain.ProgrammingLanguage.C_SHARP;
@@ -45,6 +46,7 @@ public LocalCIProgrammingLanguageFeatureService() {
         // Must be extended once a new programming language is added
         programmingLanguageFeatures.put(EMPTY, new ProgrammingLanguageFeature(EMPTY, false, false, false, false, false, List.of(), true));
         programmingLanguageFeatures.put(ASSEMBLER, new ProgrammingLanguageFeature(ASSEMBLER, false, false, false, false, false, List.of(), true));
+        programmingLanguageFeatures.put(BASH, new ProgrammingLanguageFeature(BASH, false, false, false, false, false, List.of(), true));
         programmingLanguageFeatures.put(C, new ProgrammingLanguageFeature(C, false, true, true, false, false, List.of(FACT, GCC), true));
         programmingLanguageFeatures.put(C_PLUS_PLUS, new ProgrammingLanguageFeature(C_PLUS_PLUS, false, false, true, false, false, List.of(), true));
         programmingLanguageFeatures.put(C_SHARP, new ProgrammingLanguageFeature(C_SHARP, false, false, true, false, false, List.of(), true));

src/main/resources/config/application.yml

@@ -95,6 +95,8 @@ artemis:
                     default: "ghcr.io/ls1intum/artemis-javascript-docker:v1.0.0"
                 r:
                     default: "ghcr.io/ls1intum/artemis-r-docker:v1.0.0"
+                bash:
+                    default: "ghcr.io/ls1intum/artemis-bash-docker:v1.0.0"
                 c_plus_plus:
                     default: "ghcr.io/ls1intum/artemis-cpp-docker:v1.0.0"
                 c_sharp:

src/main/resources/templates/aeolus/bash/default.sh

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+set -e
+export AEOLUS_INITIAL_DIRECTORY=${PWD}
+set_permissions () {
+  echo '⚙️ executing set_permissions'
+  find "${studentParentWorkingDirectoryName}" -type f -exec chmod +x "{}" +
+}
+
+create_results_directory () {
+  echo '⚙️ executing create_results_directory'
+  mkdir results
+}
+
+test () {
+  echo '⚙️ executing test'
+  bats --report-formatter junit --output results "${testWorkingDirectory}" || true
+}
+
+main () {
+  if [[ "${1}" == "aeolus_sourcing" ]]; then
+    return 0 # just source to use the methods in the subshell, no execution
+  fi
+  local _script_name
+  _script_name=${BASH_SOURCE[0]:-$0}
+  cd "${AEOLUS_INITIAL_DIRECTORY}"
+  bash -c "source ${_script_name} aeolus_sourcing; set_permissions"
+  cd "${AEOLUS_INITIAL_DIRECTORY}"
+  bash -c "source ${_script_name} aeolus_sourcing; create_results_directory"
+  cd "${AEOLUS_INITIAL_DIRECTORY}"
+  bash -c "source ${_script_name} aeolus_sourcing; test"
+}
+
+main "${@}"

src/main/resources/templates/aeolus/bash/default.yaml

@@ -0,0 +1,15 @@
+api: v0.0.1
+metadata:
+  name: "Bash"
+  id: bash
+actions:
+  - name: set_permissions
+    script: 'find "${studentParentWorkingDirectoryName}" -type f -exec chmod +x "{}" +'
+  - name: create_results_directory
+    script: 'mkdir results'
+  - name: test
+    script: 'bats --report-formatter junit --output results "${testWorkingDirectory}" || true'
+    results:
+      - name: Bats Test Results
+        path: "results/*.xml"
+        type: junit

src/main/resources/templates/bash/exercise/script.bash

@@ -0,0 +1,14 @@
+# TODO: add shebang
+
+# TODO: list directory entries
+
+# TODO: create create_me.txt
+
+# TODO: delete delete_me.txt
+
+# TODO: rename rename_me.txt to renamed.txt
+
+# TODO: replace 2.718 with 3.1415 in numbers.txt
+
+# TODO: exit with an successful status code
+exit 1

src/main/resources/templates/bash/readme

@@ -0,0 +1,26 @@
+# Bash Scripting Exercise
+
+This exercise is designed to help you practice basic Bash scripting skills.
+Complete the following tasks by writing a Bash script that performs each action.
+
+1. [task][Add a Shebang](shebang,shebang_custom_message)
+Insert a "shebang" at the top of your script to specify that it should be executed with Bash.
+Assume Bash is installed at a standard path.
+
+2. [task][List Directory Entries](list_dir)
+Write a command to list all entries in the current directory, including hidden files, and print the output to the terminal.
+
+3. [task][Create File](file_creation)
+Create a file named `create_me.txt` in the current directory.
+
+4. [task][Delete a File](file_deletion)
+Delete the file named `delete_me.txt` from the current directory.
+
+5. [task][Rename a File](rename)
+Rename the file `rename_me.txt` to `renamed.txt`.
+
+6. [task][Find and Replace Text](replace)
+Replace all occurrences of the number `2.718` with `3.1415` in the file `numbers.txt`. Ensure the changes are saved.
+
+7. [task][Exit with Success](status_code)
+Exit the script with a successful status code.

src/main/resources/templates/bash/solution/script.bash

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+
+ls -a
+
+touch create_me.txt
+
+rm delete_me.txt
+
+mv rename_me.txt renamed.txt
+
+sed -i 's/2\.718/3.1415/g' numbers.txt
+
+exit 0

src/main/resources/templates/bash/test/test.bats

@@ -0,0 +1,72 @@
+setup_file() {
+    BATS_TEST_TIMEOUT=10
+}
+
+setup() {
+    load "test_helper/common-setup"
+    _common_setup
+
+    TEST_DATA="$BATS_TEST_DIRNAME/test_data"
+
+    cp "$TEST_DATA"/{numbers.txt,rename_me.txt} "$BATS_TEST_TMPDIR"
+
+    cd "$BATS_TEST_TMPDIR"
+    touch delete_me.txt
+    touch .hidden
+}
+
+@test "shebang" {
+    first_line=$(head -n 1 "$ASSIGNMENT_ROOT/script.bash")
+    assert_regex "$first_line" '^#!(/usr)?/bin/(env )?bash$'
+}
+
+@test "shebang_custom_message" {
+    first_line=$(head -n 1 "$ASSIGNMENT_ROOT/script.bash")
+
+    if ! assert_regex "$first_line" '^#!(/usr)?/bin/(env )?bash$' 2>/dev/null; then
+        echo "$first_line" \
+        | batslib_decorate "first line is not a valid shebang" \
+        | fail
+    fi
+}
+
+@test "list_dir" {
+    run script.bash
+
+    assert_output --partial delete_me.txt
+    assert_output --partial numbers.txt
+    assert_output --partial rename_me.txt
+    assert_output --partial .hidden
+}
+
+@test "file_creation" {
+    run script.bash
+
+    assert_file_exists create_me.txt
+}
+
+@test "file_deletion" {
+    run script.bash
+
+    assert_file_not_exists delete_me.txt
+}
+
+@test "rename" {
+    run script.bash
+
+    assert_file_not_exists rename_me.txt
+    assert_file_exists renamed.txt
+    _assert_file_contents renamed.txt "$TEST_DATA/rename_me.txt"
+}
+
+@test "replace" {
+    run script.bash
+
+    _assert_file_contents numbers.txt "$TEST_DATA/numbers_expected.txt"
+}
+
+@test "status_code" {
+    run script.bash
+
+    assert_success
+}

src/main/resources/templates/bash/test/test_data/numbers.txt

@@ -0,0 +1,3 @@
+2.718
+2.718 2.718 2.718
+21718

src/main/resources/templates/bash/test/test_data/numbers_expected.txt

@@ -0,0 +1,3 @@
+3.1415
+3.1415 3.1415 3.1415
+21718

src/main/resources/templates/bash/test/test_data/rename_me.txt

@@ -0,0 +1 @@
+example content

src/main/resources/templates/bash/test/test_helper/common-setup.bash

@@ -0,0 +1,34 @@
+_common_setup() {
+    bats_load_library "bats-support"
+    bats_load_library "bats-assert"
+    bats_load_library "bats-file"
+
+    PROJECT_ROOT="$( cd "$BATS_TEST_DIRNAME/.." >/dev/null 2>&1 && pwd )"
+    ASSIGNMENT_ROOT="$PROJECT_ROOT/${studentParentWorkingDirectoryName}"
+
+    PATH="$ASSIGNMENT_ROOT:$PATH"
+}
+
+# _assert_file_contents
+# ============
+#
+# Fail if the actual and expected file contents differ.
+#
+# Usage: _assert_file_contents <actual_path> <expected_path>
+#
+# IO:
+#   STDERR - unified diff, on failure
+# Options:
+#   <actual_path>      The file being compared.
+#   <expected_path>    The file to compare against.
+_assert_file_contents() {
+    if ! diff_output=$(diff -u --label="actual" --label="expected" "$1" "$2" 2>&1); then
+        echo "$diff_output" \
+        | batslib_decorate "$1: file contents differ" \
+        | fail
+    fi
+}
+
+# reduce output
+bats_print_stack_trace() { :; }
+bats_print_failed_command() { :; }

src/main/resources/templates/jenkins/bash/regularRuns/pipeline.groovy

@@ -0,0 +1,55 @@
+/*
+ * This file configures the actual build steps for the automatic grading.
+ *
+ * !!!
+ * For regular exercises, there is no need to make changes to this file.
+ * Only this base configuration is actively supported by the Artemis maintainers
+ * and/or your Artemis instance administrators.
+ * !!!
+ */
+
+dockerImage = '#dockerImage'
+dockerFlags = '#dockerArgs'
+
+/**
+ * Main function called by Jenkins.
+ */
+void testRunner() {
+    docker.image(dockerImage).inside(dockerFlags) { c ->
+        runTestSteps()
+    }
+}
+
+private void runTestSteps() {
+    test()
+}
+
+/**
+ * Run unit tests
+ */
+private void test() {
+    stage('Set Permissions') {
+        sh 'find ./assignment -type f -exec chmod +x "{}" +'
+    }
+    stage('Create Results Directory') {
+        sh 'mkdir results'
+    }
+    stage('Test') {
+        sh 'bats --report-formatter junit --output results ./tests || true'
+    }
+}
+
+/**
+ * Script of the post build tasks aggregating all JUnit files in $WORKSPACE/results.
+ *
+ * Called by Jenkins.
+ */
+void postBuildTasks() {
+    sh '''
+    sed -i 's/[^[:print:]\t]/�/g' $WORKSPACE/results/*.xml || true
+    '''
+}
+
+// very important, do not remove
+// required so that Jenkins finds the methods defined in this script
+return this

src/main/webapp/app/entities/programming/programming-exercise.model.ts

@@ -14,6 +14,7 @@ import dayjs from 'dayjs/esm';
 export enum ProgrammingLanguage {
     EMPTY = 'EMPTY',
     ASSEMBLER = 'ASSEMBLER',
+    BASH = 'BASH',
     C = 'C',
     C_PLUS_PLUS = 'C_PLUS_PLUS',
     C_SHARP = 'C_SHARP',