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

README.md

@@ -1 +1,66 @@
 # kotlin-racingcar-precourse
+## 2주차 - 자동차 경주
+초간단 자동차 경주 게임을 구현한다.
+
+## 📝 기능 목록
+
+### 경주 생성
+- 자동차 이름 입력 받기<br>
+  예외 처리
+  - 쉼표가 아닌 문자 중 알파벳이 아닌 문자가 존재하는 경우 예외 발생
+  - 자동차 이름이 5자를 초과하는 경우 예외 발생
+  - 자동차 이름이 비어 있는 경우 예외 발생
+- 시도할 횟수 입력 받기<br>
+  예외 처리
+  - 시도 횟수가 비어 있는 경우 0으로 처리. 예외 발생시키지 않음
+  - 숫자가 아닌 경우 예외 발생
+- 경주에 참여하는 자동차와 경주 생성
+
+### 경주 진행
+- 현재 차수가 입력 받은 시도 횟수보다 작은지 확인
+    - 시도 횟수를 초과하는 경우 우승자 선정
+- 자동차마다 0~9 사이의 무작위 값 추출
+    - 추출된 값이 4 이상인 경우 움직임 데이터 1 증가
+- 자동차마다 해당 차수의 실행 결과 출력
+- 우승자를 List<Car>로 반환
+
+### 경주 결과 출력
+- 최종 우승자 출력
+
+## 🔃플로우 차트
+```mermaid
+---
+title: 자동차 경주
+---
+flowchart TD
+subgraph INIT[경주 생성]
+inputCarName[자동차 이름 입력] -->|입력 조건 예외 처리| inputRound[시도할 횟수 입력]
+inputRound --> createCar[경주와 경주의 자동차 생성]
+end INIT --> Game
+
+    subgraph Game[경주 진행]
+        initCurrentRound[현재 차수 = 1]
+        initCurrentRound --> isRoundNotFinished
+        isRoundNotFinished{현재 차수 <= 입력된 시도 횟수}
+        isRoundNotFinished -- YES --> extractRandomInt
+        isRoundNotFinished -- NO -----> winnerSelection["움직임 데이터가 가장 큰 우승자(들) 선정"]
+        winnerSelection --> END
+
+        extractRandomInt["자동차마다 0~9 사이의 값 추출"]
+        extractRandomInt --> isCanMove
+
+        isCanMove{추출된 값 >= 4}
+        isCanMove -- YES --> move
+        isCanMove -- NO --> printRound
+
+        move[움직임 데이터 1 증가]
+        move --> printRound
+
+        printRound[자동차마다 차수별 실행 결과 출력]
+        printRound --> isRoundNotFinished
+    end Game --> printResult
+
+    subgraph printResult[결과 출력하기]
+        printWinner[최종 우승자 출력]
+    end
+```

src/main/kotlin/racingcar/Application.kt

@@ -1,5 +1,107 @@
 package racingcar
 
+import camp.nextstep.edu.missionutils.Randoms
+import racingcar.view.InputView
+
 fun main() {
     // TODO: 프로그램 구현
+    val inputView = InputView()
+    val carNamesInput = inputView.getInputCarNames()
+    validateCarNamesInput(carNamesInput)
+
+    val splitCarNames = splitCarName(carNamesInput)
+    val roundInput = inputView.getInputRound()
+    val round = stringToInt(roundInput)
+
+    val carInstances = createCars(splitCarNames)
+    val racingGame = RacingGame(round, carInstances)
+    racingGame.play()
+    val winners = racingGame.getWinners()
+
+    printOutput(winners)
+}
+
+fun createCars(splitCarNames: List<String>): List<Car> = splitCarNames.map { Car(it) }
+
+fun validateCarNamesInput(carNamesInput: String) {
+    require(carNamesInput.isNotBlank()) { "이름이 입력되지 않았습니다." }
+    val hasInvalidChar = carNamesInput.any { it != ',' && !it.isLetter() }
+    require(!hasInvalidChar) { "이름을 올바르게 입력해주세요." }
+}
+
+fun splitCarName(carNamesInput: String): List<String> {
+    val splitCarNames = carNamesInput.split(",")
+    val hasLengthFiveOrLess = splitCarNames.all { it.length <= 5 && it.isNotBlank() }
+    require(hasLengthFiveOrLess) { "이름은 5글자를 초과하거나 비어있을 수 없습니다." }
+
+    return splitCarNames
+}
+
+fun stringToInt(roundInput: String): Int = if (roundInput.isNotBlank()) {
+    roundInput.toIntOrNull() ?: throw IllegalArgumentException("숫자를 입력해주세요.")
+} else {
+    0
+}
+
+fun printOutput(winners: List<Car>?) {
+    val winnerNames = winners?.joinToString(separator = ", ") { it.name }
+    println("최종 우승자 : $winnerNames")
 }
+
+data class Car(val name: String) {
+    var position: Int = 0
+}
+
+class RacingGame(val round: Int, val cars: List<Car>) {
+    private var currentRound: Int = 1
+
+    fun play() {
+        println()
+        println("실행 결과")
+        while (!this.isFinished()) {
+            this.makeMove()
+            this.printRoundResult(cars)
+            this.increaseCurrentRound()
+        }
+    }
+
+    fun getWinners(): List<Car> {
+        check(this.isFinished()) { "게임이 아직 시작되지 않았습니다." }
+        val winner = cars.maxBy { it.position }
+        val winners = cars.filter { it.position == winner.position }
+
+        return winners
+    }
+
+    private fun isFinished(): Boolean = this.currentRound > this.round
+
+    private fun makeMove() {
+        cars.map { car ->
+            val randomNumber = this.getRandomNumber()
+            if (canMove(randomNumber)) {
+                increaseCarPosition(car)
+            }
+        }
+    }
+
+    private fun getRandomNumber(): Int {
+        return Randoms.pickNumberInRange(0, 9)
+    }
+
+    private fun canMove(randomNumber: Int): Boolean = randomNumber >= 4
+
+    private fun increaseCarPosition(car: Car) {
+        car.position++
+    }
+
+    private fun increaseCurrentRound() {
+        this.currentRound++
+    }
+
+    private fun printRoundResult(cars: List<Car>) {
+        cars.forEach { car ->
+            println("${car.name} : ${"-".repeat(car.position)} ")
+        }
+        println()
+    }
+}

src/main/kotlin/racingcar/view/InputView.kt

@@ -0,0 +1,19 @@
+package racingcar.view
+
+import camp.nextstep.edu.missionutils.Console
+
+class InputView {
+    fun getInputCarNames(): String {
+        println("경주할 자동차 이름을 입력하세요.(이름은 쉼표(,) 기준으로 구분)")
+        val carNamesInput = Console.readLine()
+
+        return carNamesInput
+    }
+
+    fun getInputRound(): String {
+        println("시도할 횟수는 몇 회인가요?")
+        val roundInput = Console.readLine()
+
+        return roundInput
+    }
+}

src/test/kotlin/racingcar/CarAndRacingGameCreationTest.kt

@@ -0,0 +1,22 @@
+package racingcar
+
+import org.junit.jupiter.api.Test
+import org.assertj.core.api.Assertions.assertThat
+
+class CarAndRacingGameCreationTest {
+    @Test
+    fun `Car 및 Game 생성 기능 테스트`() {
+        // given
+        val testNames = listOf("pobi", "woni", "jun")
+        val testRound = 5
+
+        // when
+        val carInstances = createCars(testNames)
+        val racingGame = RacingGame(testRound, carInstances)
+
+        // then
+        assertThat(carInstances).extracting("name").containsOnly("pobi", "woni", "jun")
+        assertThat(racingGame.round).isEqualTo(testRound)
+        assertThat(racingGame.cars).isEqualTo(carInstances)
+    }
+}

src/test/kotlin/racingcar/InputProcessingTest.kt

@@ -0,0 +1,92 @@
+package racingcar
+
+import org.junit.jupiter.api.Test
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.assertThrows
+
+class InputProcessingTest {
+    @Test
+    fun `자동차 이름 입력 분할 기능 테스트`() {
+        // given
+        val testInput = "miso,seroi,hasta"
+
+        // when
+        val splitInput = splitCarName(testInput)
+
+        // then
+        assertThat(splitInput).containsOnly("miso", "seroi", "hasta")
+    }
+
+    @Test
+    fun `차수 입력 정수 변환 기능 테스트`() {
+        // given
+        val testInput = "5"
+
+        // when
+        val intInput = stringToInt(testInput)
+
+        // then
+        assertThat(intInput).isEqualTo(5)
+    }
+
+    @Test
+    fun `차수 입력 빈 문자열 테스트`() {
+        // given
+        val testInput = ""
+
+        // when
+        val intInput = stringToInt(testInput)
+
+        // then
+        assertThat(intInput).isEqualTo(0)
+    }
+
+    @Test
+    fun `차수 입력 whitespace 테스트`() {
+        // given
+        val testInput = " "
+
+        // when
+        val intInput = stringToInt(testInput)
+
+        // then
+        assertThat(intInput).isEqualTo(0)
+    }
+
+    @Test
+    fun `입력 분할 5글자 초과 예외 테스트`() {
+        // given
+        val testInput = "miso,saeroi,hasta"
+
+        // when
+        val exception = assertThrows<IllegalArgumentException> { splitCarName(testInput) }
+
+        // then
+        assertThat(exception.message).isEqualTo("이름은 5글자를 초과하거나 비어있을 수 없습니다.")
+    }
+
+    @Test
+    fun `입력 분할 빈 문자열 예외 테스트`() {
+        // given
+        val testInput = "miso,seroi,hasta,"
+
+        // when
+        val exception = assertThrows<IllegalArgumentException> { splitCarName(testInput) }
+
+        // then
+        assertThat(exception.message).isEqualTo("이름은 5글자를 초과하거나 비어있을 수 없습니다.")
+    }
+
+    @Test
+    fun `차수 입력 숫자가 아닌 문자 테스트`() {
+        // given
+        val testInput = "YourAreEverglowing"
+
+        // when
+        val exception = assertThrows<IllegalArgumentException> { stringToInt(testInput) }
+
+        // then
+        assertThat(exception.message).isEqualTo("숫자를 입력해주세요.")
+    }
+
+}