[자동차 경주] 김선아 미션 제출합니다.

README.md

@@ -1 +1,75 @@
-# kotlin-racingcar-precourse
+# [2주차] 자동차 경주 🚗
+초간단 자동차 경주 게임을 구현한다.
+
+## 기능 목록 📝
+#### 1. 애플리케이션을 실행하면 안내 문구를 출력하고, 자동차 이름과 시도할 횟수를 입력받는다.
+```
+경주할 자동차 이름을 입력하세요.(이름은 쉼표(,)기준으로 구분)
+pobi,woni,jun
+시도할 횟수는 몇 회인가요?
+5
+```
+#### 2. 쉼표(,)를 기준으로, 자동차 이름을 분리한다.
+#### 3. 0에서 9 사이에서 무작위 값을 구한 후 무작위 값이 4 이상일 경우 전진하고 4 미만일 경우 멈춘다.
+#### 4. 실행 결과 첫 출력시 '실행 결과' 문구를 출력하고, 한 횟수가 끝날 때마다 결과를 출력한다.
+```
+실행 결과
+pobi : -
+woni :
+jun : -
+
+```
+#### 5. 게임을 완료한 후 누가 우승했는지 출력하고, 우승자가 여러 명일 경우 쉼표(,)를 이용하여 구분한다.
+```
+최종 우승자 : pobi, jun
+```
+#### 6. 사용자가 잘못된 값을 입력할 경우 IllegalArgumentException 을 발생시킨 후 애플리케이션은 종료된다.
+- 자동차 이름이 5자를 초과인 경우
+- 쉼표로 구분한 각 이름이 비어있거나 공백일 경우 (예: pobi,,jun)
+- 시도할 횟수가 1 미만의 숫자인 경우 (또는 숫자가 아닌 경우)
+
+#### 7. 기능 목록이 정상 작동하는지 테스트 코드로 확인한다.
+
+
+## 설계 🧩
+#### main
+```
+racingcar
+├── controller
+│   └── RaceController.kt
+│
+├── domain
+│   ├── Car.kt
+│   └── Race.kt
+│
+├── port
+│   ├── InputPort.kt
+│   └── OutputPort.kt
+│
+├── util
+│   ├── InputParser.kt
+│   ├── InputValidator.kt
+│   └── RandomUtils.kt
+│
+├── view
+│   ├── InputView.kt
+│   └── OutputView.kt
+│
+└── Application.kt (main 함수)
+```
+#### test
+```
+racingcar
+├── controller
+│   └── RaceControllerTest.kt
+│
+├── domain
+│   ├── CarTest.kt
+│   └── RaceTest.kt
+│
+└── util
+│   ├── InputParserTest.kt
+│   └── InputValidatorTest.kt
+│
+└── ApplicationTest.kt
+```

src/main/kotlin/racingcar/Application.kt

@@ -1,5 +1,18 @@
 package racingcar
 
+import racingcar.controller.RaceController
+import racingcar.util.InputParser
+import racingcar.util.InputValidator
+import racingcar.view.InputView
+import racingcar.view.OutputView
+
 fun main() {
-    // TODO: 프로그램 구현
+    val inputPort = InputView
+    val outputPort = OutputView
+    val inputParser = InputParser
+    val inputValidator = InputValidator
+
+    val raceController = RaceController(inputPort, outputPort, inputParser, inputValidator)
+
+    raceController.run()
 }

src/main/kotlin/racingcar/controller/RaceController.kt

@@ -0,0 +1,41 @@
+package racingcar.controller
+
+import racingcar.domain.Car
+import racingcar.domain.Race
+import racingcar.port.InputPort
+import racingcar.port.OutputPort
+import racingcar.util.InputParser
+import racingcar.util.InputValidator
+
+class RaceController(
+    private val inputPort: InputPort,
+    private val outputPort: OutputPort,
+    private val inputParser: InputParser,
+    private val inputValidator: InputValidator
+) {
+    fun run() {
+        val readCarNames: String? = inputPort.readCarNames()
+        val readTryCount: String? = inputPort.readTryCount()
+
+        val carNames = inputParser.parseCarNames(readCarNames ?: "")
+        inputValidator.validateCarNames(carNames)
+        val cars: List<Car> = carNames.map { Car(it) }
+        val tryCount = inputValidator.validateTryCount(readTryCount)
+
+        val race = Race(cars)
+
+        outputPort.printFirstResult()
+        repeat(tryCount) {
+            race.runOneRound()
+
+            cars.forEach { car ->
+                outputPort.printRoundResult(car)
+            }
+
+            outputPort.printBlankLine()
+        }
+
+        val winners = race.findWinners()
+        outputPort.printFinalWinner(winners)
+    }
+}

src/main/kotlin/racingcar/domain/Car.kt

@@ -0,0 +1,12 @@
+package racingcar.domain
+
+data class Car(val name: String) {
+    var position = 0
+        internal set
+
+    fun move(randomInt: Int) {
+        if (randomInt >= 4) {
+            position++
+        }
+    }
+}

src/main/kotlin/racingcar/domain/Race.kt

@@ -0,0 +1,28 @@
+package racingcar.domain
+
+import racingcar.util.RandomUtils
+
+class Race(val cars: List<Car>) {
+    fun runOneRound() {
+        for (car in cars) {
+            car.move(RandomUtils.getRandomInt())
+        }
+    }
+
+    private fun findFinalMaxPosition(cars: List<Car>): Int {
+        return cars.maxOf { it.position }
+    }
+
+    fun findWinners(): List<Car> {
+        val maxPosition = findFinalMaxPosition(cars)
+        val winners: MutableList<Car> = mutableListOf()
+
+        for (car in cars) {
+            if (car.position == maxPosition) {
+                winners += car
+            }
+        }
+
+        return winners
+    }
+}

src/main/kotlin/racingcar/port/InputPort.kt

@@ -0,0 +1,6 @@
+package racingcar.port
+
+interface InputPort {
+    fun readCarNames(): String?
+    fun readTryCount(): String?
+}

src/main/kotlin/racingcar/port/OutputPort.kt

@@ -0,0 +1,10 @@
+package racingcar.port
+
+import racingcar.domain.Car
+
+interface OutputPort {
+    fun printFirstResult()
+    fun printRoundResult(car: Car)
+    fun printBlankLine()
+    fun printFinalWinner(winners: List<Car>)
+}

src/main/kotlin/racingcar/util/InputParser.kt

@@ -0,0 +1,9 @@
+package racingcar.util
+
+object InputParser {
+    const val COMMA = ','
+
+    fun parseCarNames(input: String): List<String> {
+        return input.split(COMMA)
+    }
+}

src/main/kotlin/racingcar/util/InputValidator.kt

@@ -0,0 +1,24 @@
+package racingcar.util
+
+object InputValidator {
+    fun validateCarNames(readCarNames: List<String>) {
+        for (carName in readCarNames) {
+            if (carName.length > 5) {
+                throw IllegalArgumentException("${carName}이 5자를 초과합니다.")
+            }
+            if (carName.isBlank()) {
+                throw IllegalArgumentException("입력받은 자동차 이름이 공백입니다.")
+            }
+        }
+    }
+
+    fun validateTryCount(readTryCount: String?): Int {
+        val tryCount = readTryCount?.toIntOrNull() ?: throw IllegalArgumentException("입력받은 수가 유효하지 않은 값입니다.")
+
+        if (tryCount < 0) {
+            throw IllegalArgumentException("입력받은 수가 음수입니다.")
+        }
+
+        return tryCount
+    }
+}

src/main/kotlin/racingcar/util/RandomUtils.kt

@@ -0,0 +1,9 @@
+package racingcar.util
+
+import camp.nextstep.edu.missionutils.Randoms
+
+object RandomUtils {
+    fun getRandomInt(): Int {
+        return Randoms.pickNumberInRange(0, 9)
+    }
+}

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

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

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

@@ -0,0 +1,29 @@
+package racingcar.view
+
+import racingcar.domain.Car
+import racingcar.port.OutputPort
+
+object OutputView : OutputPort {
+    const val BAR = "-"
+
+    override fun printFirstResult() {
+        printBlankLine()
+        println("실행 결과")
+    }
+
+    override fun printRoundResult(car: Car) {
+        val positionBar = BAR.repeat(car.position)
+
+        println("${car.name} : $positionBar")
+    }
+
+    override fun printBlankLine() {
+        println()
+    }
+
+    override fun printFinalWinner(winners: List<Car>) {
+        val winnersName = winners.joinToString(", ") { it.name }
+
+        println("최종 우승자 : $winnersName")
+    }
+}