feat(tests): add GitHub Actions workflow for automated testing and coverage reporting

Author: s3ich4n

.github/workflows/pr-test.yml

@@ -0,0 +1,70 @@
+name: PR Test & Coverage Report
+
+on:
+  pull_request:
+    branches:
+      - main  # 필요시 변경
+
+jobs:
+  test:
+    name: Run Tests & Coverage
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12.6'
+
+      - name: Install Dependencies
+        run: |
+          python -m pip install -r requirements.txt
+          python -m pip install coverage junitparser
+
+      - name: Run Tests (by Makefile)
+        run: |
+          make test
+
+      - name: Combine Coverage Report (XML)
+        run: |
+          coverage xml -o coverage.xml
+
+      - name: Parse Coverage and Write Summary
+        run: |
+          TOTAL=$(xmllint --xpath 'string(/coverage/@line-rate)' coverage.xml)
+          PERCENTAGE=$(echo "$TOTAL * 100" | bc)
+          echo "| Metric  | Value |" >> $GITHUB_STEP_SUMMARY
+          echo "|--------|-----|" >> $GITHUB_STEP_SUMMARY
+          echo "| 📊 Line Coverage | ${PERCENTAGE}% |" >> $GITHUB_STEP_SUMMARY
+
+      - name: Publish Test Results Summary
+        uses: test-summary/action@v2
+        with:
+          paths: "test-results/*.xml"
+        if: always()
+
+      - name: Upload Coverage HTML Report
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-html
+          path: htmlcov/
+
+      - name: Upload JUnit XML (for archive)
+        uses: actions/upload-artifact@v4
+        with:
+          name: junit-xml-reports
+          path: test-results/
+
+      - name: Add Coverage Comment to PR
+        uses: peter-evans/create-or-update-comment@v4
+        with:
+          issue-number: ${{ github.event.pull_request.number }}
+          body: |
+            ## 📝 Coverage Report
+            | Metric  | Value |
+            |--------|-----|
+            | 📊 Line Coverage | ${PERCENTAGE}% |
+        if: github.event_name == 'pull_request'

.gitignore

@@ -358,3 +358,5 @@ $RECYCLE.BIN/
 
 ## env-related files
 .env*
+
+test-results/

Makefile

@@ -1,24 +1,57 @@
-.PHONY: test test-ch01 test-ch04 test-ch06 test-ch07 clean
+.PHONY: test test-all test-ch01 test-ch04 test-ch06 test-ch07 clean clean-coverage clean-results combine-coverage merge-junit
 
-test-all: test-ch01 test-ch04 test-ch06 test-ch07
+CHAPTERS = ch01 ch04 ch06 ch07
+TEST_RESULTS_DIR = test-results
+
+test: test-all
+
+clean: clean-results clean-coverage
+	find . -type d -name "__pycache__" -exec rm -r {} +
+	find . -type d -name ".pytest_cache" -exec rm -r {} +
+	find . -type f -name "*.pyc" -delete
+
+clean-results:
+	rm -rf $(TEST_RESULTS_DIR)
+
+clean-coverage:
+	coverage erase
+	rm -f $(TEST_RESULTS_DIR)/.coverage*
+
+test-all: clean-results clean-coverage $(TEST_RESULTS_DIR) test-ch01 test-ch04 test-ch06 test-ch07 combine-coverage merge-junit
 
 test-ch01:
-	cd chapter01 && pytest && cd ..
+	cd chapter01 && \
+	COVERAGE_FILE=../$(TEST_RESULTS_DIR)/.coverage.ch01 coverage run -m pytest -v \
+	    --junitxml=../$(TEST_RESULTS_DIR)/ch01-results.xml
 
 test-ch04:
-	cd chapter04 && pytest && cd ..
+	cd chapter04 && \
+	COVERAGE_FILE=../$(TEST_RESULTS_DIR)/.coverage.ch04 coverage run -m pytest -v \
+	    --junitxml=../$(TEST_RESULTS_DIR)/ch04-results.xml
 
 test-ch06:
-	cd chapter06 && pytest && cd ..
+	cd chapter06 && \
+	COVERAGE_FILE=../$(TEST_RESULTS_DIR)/.coverage.ch06 coverage run -m pytest -v \
+	    --junitxml=../$(TEST_RESULTS_DIR)/ch06-results.xml
 
 test-ch07:
-	cd chapter07 && pytest && cd ..
+	cd chapter07 && \
+	COVERAGE_FILE=../$(TEST_RESULTS_DIR)/.coverage.ch07 coverage run -m pytest -v \
+	    --junitxml=../$(TEST_RESULTS_DIR)/ch07-results.xml
 
-# 모든 테스트의 alias
-test: test-all
+combine-coverage:
+	coverage combine $(TEST_RESULTS_DIR)
+	coverage report
+	coverage html
 
-# 캐시 파일 정리
-clean:
-	find . -type d -name "__pycache__" -exec rm -r {} +
-	find . -type d -name ".pytest_cache" -exec rm -r {} +
-	find . -type f -name "*.pyc" -delete
+merge-junit:
+	command -v python3 > /dev/null && python3 -m pip show junitparser > /dev/null || python3 -m pip install junitparser
+	python3 -m junitparser merge \
+	    $(TEST_RESULTS_DIR)/ch01-results.xml \
+	    $(TEST_RESULTS_DIR)/ch04-results.xml \
+	    $(TEST_RESULTS_DIR)/ch06-results.xml \
+	    $(TEST_RESULTS_DIR)/ch07-results.xml \
+	    $(TEST_RESULTS_DIR)/merged-results.xml
+
+$(TEST_RESULTS_DIR):
+	mkdir -p $(TEST_RESULTS_DIR)

poetry.lock

@@ -15,6 +15,7 @@ arrow = "^1.3.0"
 pytest = "^8.3.4"
 beautifulsoup4 = "^4.12.3"
 pytest-cov = "^6.0.0"
+junitparser = "^3.2.0"
 
 
 [tool.poetry.group.linter.dependencies]