[ 자동차 경주 ] 이진 미션 제출합니다.

README.md

@@ -1 +1,72 @@
 # javascript-racingcar-precourse
+## 🚀 요구 사항 분석
+### 시작하기
+
+- [x]  요구사항 분석하기 `README`
+- [x]  constant 작성하기 `constant`
+
+### 입력받기 `input`
+
+- [x]  사용자에게 입력받는 함수 구현하기
+- [x]  사용자에게 자동차 이름 입력받기
+- [x]  입력받은 값 쉼표(,) 기준으로 구분하기
+- [x]  시도할 횟수 입력받기
+
+### 출력하기 `output`
+
+- [x]  출력하는 함수 구현하기
+- [x]  실행 결과 출력하기
+- [x]  최종 우승자 출력하기
+
+### 게임하기 `game`
+
+- [x]  0~9 무작위값 구하기
+- [x]  전진 가능한지 확인하기
+- [x]  실행 횟수만큼 실행하기
+- [x]  최종 우승자 구하기
+
+### 입력값 예외 처리하기 `error`
+
+- [x]  입력값이 없는 경우
+- [x]  이름이 5자 이하가 아닐 경우
+- [x]  자동차 이름이 중복될 경우
+- [x]  시도 횟수가 양수가 아닐 경우
+
+<br/>
+
+## 🚨 체크리스트
+- [x]  JavaScript Code Conventions 을 준수하였는가?
+- [x]  한 메서드에 오직 한 단계의 들여쓰기만 허용했는가?
+- [x]  else 예약어를 쓰지 않았는가?
+- [x]  모든 원시값과 문자열을 포장했는가?
+- [x]  3개 이상의 인스턴스 변수를 가진 클래스를 구현하지 않았는가?
+- [x]  getter/setter 없이 구현했는가?
+- [x]  메소드의 인자 수를 제한했는가?
+- [ ]  코드 한 줄에 점(.)을 하나만 허용했는가?
+- [x]  메소드가 한가지 일만 담당하도록 구현했는가?
+- [x]  클래스를 작게 유지하기 위해 노력했는가?
+- [x]  3항 연산자를 사용하지 않았는가?
+- [x]  AngularJS Commit Conventions 에 맞춰 Commit Message를 작성했는가?
+- [x]  이름을 축약하지 않고 의도를 잘 드러냈는가?
+- [x]  JavaScript API를 적극 활용했는가?
+- [x]  Jest를 활용해 테스트 코드로 작동을 확인했는가?
+- [x]  테스트 코드를 관심사별로 분리했는가?
+
+<br/>
+
+## 📄 폴더구조
+```
+📦 __tests__
+ ┗━ 📜ApplicationTest.js
+📦 src
+ ┣━ 📜App.js
+ ┣━ 📜index.js
+ ┣━ 📂util
+ ┃   ┣━ 📜io.js
+ ┃   ┣━ 📜pickRandomNumberInRange.js
+ ┃   ┣━ 📜printSimulate.js
+ ┃   ┗━ 📜splitByComma.js
+ ┣━ 📜Simulator.js
+ ┣━ 📜Validator.js
+ ┗━ 📜constant.js
+```

__tests__/ApplicationTest.js

@@ -1,5 +1,7 @@
-import App from "../src/App.js";
-import { MissionUtils } from "@woowacourse/mission-utils";
+import App from '../src/App.js';
+import { MissionUtils } from '@woowacourse/mission-utils';
+import { ERROR_MESSAGE } from '../src/constant.js';
+import Validator from '../src/Validator.js';
 
 const mockQuestions = (inputs) => {
   MissionUtils.Console.readLineAsync = jest.fn();
@@ -19,18 +21,18 @@ const mockRandoms = (numbers) => {
 };
 
 const getLogSpy = () => {
-  const logSpy = jest.spyOn(MissionUtils.Console, "print");
+  const logSpy = jest.spyOn(MissionUtils.Console, 'print');
   logSpy.mockClear();
   return logSpy;
 };
 
-describe("자동차 경주", () => {
-  test("기능 테스트", async () => {
+describe('자동차 경주', () => {
+  test('기능 테스트', async () => {
     // given
     const MOVING_FORWARD = 4;
     const STOP = 3;
-    const inputs = ["pobi,woni", "1"];
-    const logs = ["pobi : -", "woni : ", "최종 우승자 : pobi"];
+    const inputs = ['pobi,woni', '1'];
+    const logs = ['pobi : -', 'woni : ', '최종 우승자 : pobi'];
     const logSpy = getLogSpy();
 
     mockQuestions(inputs);
@@ -46,15 +48,22 @@ describe("자동차 경주", () => {
     });
   });
 
-  test("예외 테스트", async () => {
-    // given
-    const inputs = ["pobi,javaji"];
+  test.each([
+    { inputs: [], expectedError: ERROR_MESSAGE.EMPTY_INPUT },
+    { inputs: ['pobi,javaji'], expectedError: ERROR_MESSAGE.NAME_TOO_LONG },
+    { inputs: ['pobi,pobi'], expectedError: ERROR_MESSAGE.DUPLICATE_NAME },
+    { inputs: ['pobi,java'], expectedError: ERROR_MESSAGE.EMPTY_INPUT },
+    {
+      inputs: ['pobi,java', '-1'],
+      expectedError: ERROR_MESSAGE.INVALID_TRY_COUNT,
+    },
+    {
+      inputs: ['pobi,java', '0'],
+      expectedError: ERROR_MESSAGE.INVALID_TRY_COUNT,
+    },
+  ])('예외 테스트: %o', async ({ inputs, expectedError }) => {
     mockQuestions(inputs);
-
-    // when
     const app = new App();
-
-    // then
-    await expect(app.run()).rejects.toThrow("[ERROR]");
+    await expect(app.run()).rejects.toThrow(expectedError);
   });
 });

__tests__/RandomTest.js

@@ -0,0 +1,32 @@
+import { Random } from '@woowacourse/mission-utils';
+import pickRandomNumberInRange from '../src/util/pickRandomNumberInRange';
+
+describe('random function', () => {
+  beforeEach(() => {
+    jest
+      .spyOn(Random, 'pickNumberInRange')
+      .mockImplementation((startRange, endRange) => {
+        // 항상 중간값을 반환하도록 모의 처리
+        return Math.floor((startRange + endRange) / 2);
+      });
+  });
+
+  afterEach(() => {
+    jest.restoreAllMocks();
+  });
+
+  test('0-9 사이의 랜덤한 숫자 추출하기', () => {
+    const startRange = 0;
+    const endRange = 9;
+    const result = pickRandomNumberInRange(startRange, endRange);
+    expect(result).toBeGreaterThanOrEqual(startRange);
+    expect(result).toBeLessThanOrEqual(endRange);
+  });
+
+  test('mock에서 설정한 중간값 반환되는지 확인하기', () => {
+    const startRange = 2;
+    const endRange = 8;
+    const result = pickRandomNumberInRange(startRange, endRange);
+    expect(result).toBe(5);
+  });
+});

__tests__/SimulateTest.js

@@ -0,0 +1,98 @@
+import Simulator from '../src/Simulator'; // Simulator 클래스가 정의된 경로로 수정하세요.
+import { MESSAGE } from '../src/constant';
+import { printOutput } from '../src/util/io';
+import pickRandomNumberInRange from '../src/util/pickRandomNumberInRange';
+
+jest.mock('../src/util/io');
+jest.mock('../src/util/pickRandomNumberInRange');
+
+describe('Simulator simulate test', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  test('#canMoveForward가 true일 때 상태 업데이트 확인하기', () => {
+    const names = ['Car1'];
+    const simulator = new Simulator(names);
+    pickRandomNumberInRange.mockReturnValue(5);
+
+    simulator.simulate(1);
+    expect(printOutput).toHaveBeenCalledWith(MESSAGE.EXECUTE_OUTPUT);
+    expect(printOutput).toHaveBeenCalledWith('Car1 : -');
+    expect(printOutput).toHaveBeenCalledWith('');
+  });
+
+  test('#canMoveForward가 false일 때 상태 업데이트 확인하기', () => {
+    const names = ['Car1'];
+    const simulator = new Simulator(names);
+    pickRandomNumberInRange.mockReturnValue(3);
+
+    simulator.simulate(1);
+
+    expect(printOutput).toHaveBeenCalledWith(MESSAGE.EXECUTE_OUTPUT);
+    expect(printOutput).toHaveBeenCalledWith('Car1 : ');
+    expect(printOutput).toHaveBeenCalledWith('');
+  });
+
+  test('자동차가 여러 개일 때 상태 업데이트 확인하기', () => {
+    const names = ['Car1', 'Car2'];
+    const simulator = new Simulator(names);
+    pickRandomNumberInRange.mockReturnValueOnce(5).mockReturnValueOnce(3);
+
+    simulator.simulate(1);
+
+    expect(printOutput).toHaveBeenCalledWith(MESSAGE.EXECUTE_OUTPUT);
+    expect(printOutput).toHaveBeenCalledWith('Car1 : -');
+    expect(printOutput).toHaveBeenCalledWith('Car2 : ');
+    expect(printOutput).toHaveBeenCalledWith('');
+  });
+});
+
+describe('Simulator printWinner test', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  test('우승자가 한 명일 경우', () => {
+    const names = ['Car1', 'Car2', 'Car3'];
+    const simulator = new Simulator(names);
+
+    pickRandomNumberInRange.mockReturnValueOnce(5);
+    pickRandomNumberInRange.mockReturnValue(3);
+
+    simulator.simulate(1);
+    simulator.printWinner();
+
+    expect(printOutput).toHaveBeenCalledWith(`${MESSAGE.FINAL_OUTPUT} : Car1`);
+  });
+
+  test('우승자가 여러 명일 경우', () => {
+    const names = ['Car1', 'Car2', 'Car3'];
+    const simulator = new Simulator(names);
+
+    pickRandomNumberInRange.mockReturnValueOnce(5);
+    pickRandomNumberInRange.mockReturnValueOnce(5);
+    pickRandomNumberInRange.mockReturnValue(3);
+
+    simulator.simulate(1);
+    simulator.printWinner();
+
+    expect(printOutput).toHaveBeenCalledWith(
+      `${MESSAGE.FINAL_OUTPUT} : Car1, Car2`,
+    );
+  });
+
+  test('아무도 전진하지 않았을 경우', () => {
+    const names = ['Car1', 'Car2', 'Car3'];
+    const simulator = new Simulator(names);
+
+    pickRandomNumberInRange.mockReturnValue(1);
+
+    simulator.simulate();
+    simulator.printWinner();
+
+    expect(printOutput).toHaveBeenCalledWith(
+      `${MESSAGE.FINAL_OUTPUT} : Car1, Car2, Car3`,
+    );
+  });
+});

src/App.js

@@ -1,5 +1,23 @@
+import { MESSAGE } from './constant';
+import Simulator from './Simulator.js';
+import { readUserInput } from './util/io.js';
+import splitByComma from './util/splitByComma';
+import Validator from './Validator';
+
 class App {
-  async run() {}
+  async run() {
+    const input = await readUserInput(MESSAGE.PROMPT_NAME_USER_INPUT);
+    Validator.validate(input);
+    const cars = splitByComma(input);
+    Validator.validate(cars);
+
+    const attemptCount = await readUserInput(MESSAGE.PROMPT_COUNT_USER_INPUT);
+    Validator.validate(+attemptCount);
+
+    const simulator = new Simulator(cars);
+    simulator.simulate(attemptCount);
+    simulator.printWinner();
+  }
 }
 
 export default App;

src/Simulator.js

@@ -0,0 +1,38 @@
+import { MESSAGE, RANGE } from './constant';
+import { printOutput } from './util/io';
+import pickRandomNumberInRange from './util/pickRandomNumberInRange';
+import printSimulate from './util/printSimulate';
+
+class Simulator {
+  #state;
+
+  constructor(names) {
+    printOutput(MESSAGE.EXECUTE_OUTPUT);
+    this.#state = names.map((name) => ({ name, count: 0 }));
+  }
+
+  #canMoveForward() {
+    return pickRandomNumberInRange(RANGE.START, RANGE.END) >= RANGE.VALID;
+  }
+
+  simulate(attemptCount) {
+    for (let i = 0; i < attemptCount; i++) {
+      this.#state = this.#state.map(({ name, count }) => {
+        if (this.#canMoveForward()) count++;
+        printSimulate(name, count);
+        return { name, count };
+      });
+      printOutput('');
+    }
+  }
+
+  printWinner() {
+    const maxCount = Math.max(...this.#state.map((car) => car.count));
+    const winner = this.#state
+      .filter((car) => car.count === maxCount)
+      .map((car) => car.name);
+    printOutput(`${MESSAGE.FINAL_OUTPUT} : ${winner.join(', ')}`);
+  }
+}
+
+export default Simulator;

src/Validator.js

@@ -0,0 +1,46 @@
+import { ERROR_MESSAGE, MAX_INPUT_LENGTH } from './constant';
+
+class Validator {
+  #value;
+  constructor(value) {
+    this.#value = value;
+  }
+
+  #validateNotEmpty() {
+    if (this.#value !== 0 && !this.#value) {
+      throw new Error(ERROR_MESSAGE.EMPTY_INPUT);
+    }
+  }
+
+  #validatePositiveNumber() {
+    if (this.#value <= 0) {
+      throw new Error(ERROR_MESSAGE.INVALID_TRY_COUNT);
+    }
+  }
+
+  #validateMaxLength() {
+    if (this.#value.some((value) => value.length > MAX_INPUT_LENGTH)) {
+      throw new Error(ERROR_MESSAGE.NAME_TOO_LONG);
+    }
+  }
+
+  #validateNoDuplicates() {
+    const hasDuplicates = new Set(this.#value).size !== this.#value.length;
+    if (hasDuplicates) {
+      throw new Error(ERROR_MESSAGE.DUPLICATE_NAME);
+    }
+  }
+
+  static validate(value) {
+    const validator = new Validator(value);
+    validator.#validateNotEmpty();
+    if (typeof validator.#value === 'number') {
+      validator.#validatePositiveNumber();
+    } else if (typeof validator.#value === 'object') {
+      validator.#validateMaxLength();
+      validator.#validateNoDuplicates();
+    }
+  }
+}
+
+export default Validator;