[자동차 경주 게임] 윤성준 미션 제출합니다.

docs/README.md

@@ -0,0 +1,144 @@
+# 미션 - 자동차 경주
+
+## 🚀 기능 요구 사항
+
+초간단 자동차 경주 게임을 구현한다.
+
+**최초 요구사항**
+
+- 주어진 횟수 동안 n대의 자동차는 전진 또는 멈출 수 있다.
+- 각 자동차에 이름을 부여할 수 있다. 전진하는 자동차를 출력할 때 자동차 이름을 같이 출력한다.
+- 자동차 이름은 쉼표(,)를 기준으로 구분하며 이름은 5자 이하만 가능하다.
+- 사용자는 몇 번의 이동을 할 것인지를 입력할 수 있어야 한다.
+- 전진하는 조건은 0에서 9 사이에서 무작위 값을 구한 후 무작위 값이 4 이상일 경우이다.
+- 자동차 경주 게임을 완료한 후 누가 우승했는지를 알려준다. 우승자는 한 명 이상일 수 있다.
+- 우승자가 여러 명일 경우 쉼표(,)를 이용하여 구분한다.
+- 사용자가 잘못된 값을 입력한 경우 throw문을 사용해 "[ERROR]"로 시작하는 메시지를 가지는 예외를 발생시킨 후, 애플리케이션은 종료되어야 한다.
+  ```
+  예시) [ERROR] 숫자가 잘못된 형식입니다.
+  ```
+
+**구현 함수**
+
+```
+#1. 입력(1) 자동차 이름.(쉼표 구분, 여러대 입력 가능)
+  -> getCarNames
+#2. 입력(2) 실행 횟수
+  -> getTryNumbers
+#3. 입력(1), (2)에 대한 유효성 검사
+  -> checkValidation
+#4. 에러 메세지
+  ->
+#5. 전진 조건 만들기(0~9 랜덤값 추출, 4이상 전진)
+
+#6. 각 자동차별 총 전진 수 count
+
+#7. 각 자동차별 전진 수 output 저장
+
+#8. 각 차수별 실행 결과 출력
+
+#9. 우승자 출력(count)
+```
+
+### 입출력 요구 사항
+
+#### 입력
+
+- 경주 할 자동차 이름(이름은 쉼표(,) 기준으로 구분)
+
+```
+pobi,woni,jun
+```
+
+- 시도할 횟수
+
+```
+5
+```
+
+#### 출력
+
+- 각 차수별 실행 결과
+
+```
+pobi : --
+woni : ----
+jun : ---
+```
+
+- 단독 우승자 안내 문구
+
+```
+최종 우승자 : pobi
+```
+
+- 공동 우승자 안내 문구
+
+```
+최종 우승자 : pobi, jun
+```
+
+#### 실행 결과 예시
+
+```
+경주할 자동차 이름을 입력하세요.(이름은 쉼표(,) 기준으로 구분)
+pobi,woni,jun
+시도할 횟수는 몇 회인가요?
+5
+
+실행 결과
+pobi : -
+woni :
+jun : -
+
+pobi : --
+woni : -
+jun : --
+
+pobi : ---
+woni : --
+jun : ---
+
+pobi : ----
+woni : ---
+jun : ----
+
+pobi : -----
+woni : ----
+jun : -----
+
+최종 우승자 : pobi, jun
+```
+
+---
+
+## 🎯 프로그래밍 요구 사항
+
+- 프로그램 실행의 시작점은 `App.js`의 `play` 메서드이다.
+- `package.json`을 변경할 수 없고 외부 라이브러리(jQuery, Lodash 등)를 사용하지 않는다. 순수 Vanilla JS로만 구현한다.
+- [JavaScript 코드 컨벤션](https://github.com/woowacourse/woowacourse-docs/tree/main/styleguide/javascript)을 지키면서 프로그래밍 한다
+- 프로그램 종료 시 `process.exit()`를 호출하지 않는다.
+- 프로그램 구현이 완료되면 `ApplicationTest`의 모든 테스트가 성공해야 한다. **테스트가 실패할 경우 0점 처리한다.**
+- 프로그래밍 요구 사항에서 달리 명시하지 않는 한 파일, 패키지 이름을 수정하거나 이동하지 않는다.
+
+### 추가된 요구 사항
+
+- indent(인덴트, 들여쓰기) depth를 3이 넘지 않도록 구현한다. 2까지만 허용한다.
+  - 예를 들어 while문 안에 if문이 있으면 들여쓰기는 2이다.
+  - 힌트: indent(인덴트, 들여쓰기) depth를 줄이는 좋은 방법은 함수(또는 메소드)를 분리하면 된다.
+- Jest를 이용하여 본인이 정리한 기능 목록이 정상 동작함을 테스트 코드로 확인한다.
+  - 테스트 도구 사용법이 익숙하지 않다면 `__tests__/StringTest.js`를 참고하여 학습한 후 테스트를 구현한다.
+
+### 라이브러리
+
+- `@woowacourse/mission-utils`에서 제공하는 `Random` 및 `Console` API를 사용하여 구현해야 한다.
+  - Random 값 추출은 `Random.pickNumberInRange()`를 활용한다.
+  - 사용자의 값을 입력 받고 출력하기 위해서는 `Console.readLineAsync`, `Console.print`를 활용한다.
+
+#### 사용 예시
+
+- 0에서 9까지의 정수 중 한 개의 정수 반환
+
+```javascript
+MissionUtils.Random.pickNumberInRange(0, 9);
+```

src/App.js

@@ -1,5 +1,73 @@
+import { MissionUtils } from "@woowacourse/mission-utils";
+import { printMessages } from "./constants";
+import {
+  generateForwardCount,
+  validateCarName,
+  validateGetNumber,
+} from "./utils";
+
 class App {
-  async play() {}
+  // #1 자동차 이름을 입력받음
+  async getCarName() {
+    const carList = await MissionUtils.Console.readLineAsync(
+      printMessages.GET_CAR_NAMES_MESSAGE
+    );
+    validateCarName(carList);
+    return carList;
+  }
+
+  // #2 실행 횟수를 입력받음
+  async getTryNumbers() {
+    const tryNumber = await MissionUtils.Console.readLineAsync(
+      printMessages.TRY_NUMBER_ERROR
+    );
+    validateGetNumber(tryNumber);
+    return tryNumber;
+  }
+
+  // #3 getTryNumbers만큼 실행 -> generateForwardCount을 사용
+  async forwardCars(carNumArray) {
+    const isForward = generateForwardCount();
+    if (isForward) {
+      carNumArray.map((num) => {
+        num++;
+      });
+    }
+    return carNumArray;
+  }
+  // 출력 함수 따로 빼기
+  async raceCar(tryNumber, carListArray, carNumArray) {
+    for (let i = 0; i < tryNumber; i++) {
+      await MissionUtils.Console.print(
+        `${printCar(i, carListArray, carNumArray)} `
+      );
+    }
+    return;
+  }
+  // #4 각 실행 결과를 출력함
+  async printCar(index, carListArray, carNumArray) {
+    return `${carListArray[index]} : ${changeNumToDash(carNumArray[index])}`;
+  }
+  // #5 우승 차량 몇대인지 확인 -> 1대, 2대 이상일 때
+  async checkWinners(carNumArray) {}
+
+  async winCar(carCountArray) {
+    Math.max(carCountArray);
+  }
+  // #6 우승 차량 출력
+  async printWinCar(carCountArray) {
+    await MissionUtils.Console.print(winCar(carCountArray));
+  }
+
+  async play() {
+    const carListArray = await getCarName();
+    const tryNumber = await getTryNumbers();
+    // tryNumber만큼의 0요소를 가진 배열을 생성
+    const carCountArray = new Array(tryNumber, 0);
+    await raceCar(tryNumber, carListArray, carCountArray);
+    await checkWinners(carNumArray);
+    await printWinCar(winCar());
+  }
 }
 
 export default App;

src/constants.js

@@ -0,0 +1,12 @@
+export const printMessages = {
+  GET_CAR_NAMES_MESSAGE:
+    "경주할 자동차 이름을 입력하세요.(이름은 쉼표(,) 기준으로 구분)",
+  GET_TRY_NUMBERS_MESSAGE: "시도할 횟수는 몇 회인가요?",
+  PRINT_RESULT: "실행 결과",
+  PRINT_WINNER: "최종 우승자 : ",
+};
+
+export const printErrorMessages = {
+  CAR_NAME_LENGTH_ERROR: "[ERROR] 자동차 이름은 5자 이하만 가능합니다.",
+  TRY_NUMBER_ERROR: "[ERROR] 숫자가 잘못된 형식입니다.",
+};

src/utils.js

@@ -0,0 +1,27 @@
+import { MissionUtils } from "@woowacourse/mission-utils";
+import { printErrorMessages } from "./constants";
+
+// generateForwardCount
+export function generateForwardCount() {
+  const randomNumber = MissionUtils.Random.pickNumberInRange(0, 9);
+  return randomNumber >= 4 ? true : false;
+}
+
+// validateCarName
+export function validateCarName(carList) {
+  carList.forEach((car) => {
+    if (car.length > 5)
+      throw new Error(printErrorMessages.CAR_NAME_LENGTH_ERROR);
+  });
+}
+// validateGetNumber
+export function validateGetNumber(number) {
+  if (number.match(/\D/g)) {
+    throw new Error(printErrorMessages.TRY_NUMBER_ERROR);
+  }
+}
+
+// changeNumToDash
+export function changeNumToDash(num) {
+  return "-".repeat(num);
+}