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

README.md

@@ -1 +1,92 @@
 # kotlin-racingcar-precourse
+
+[1. 입력 기능](#입력-기능)
+
+[2. 출력 기능](#출력-기능)
+
+[3. Model](#model)
+
+[4. View](#view)
+
+[5. Controller](#controller)
+
+## 기능 요구 사항
+
+초간단 자동차 경주 게임 구현
+
+### 입력 기능
+
+자동차 이름 입력 기능
+
+- [x] 쉼표를 기준으로 자동차 이름 파싱
+- [x] `trim()`을 통해 자동차 이름 앞, 뒤 공백 문자 처리
+    - 유효성 검증
+    - [x] 아무런 입력이 없거나 `\n` 개행 문자인 경우 예외 처리
+
+자동차 이동 횟수 입력 기능
+
+- [x] 자동차 이동 횟수 입력
+    - 유효성 검증
+    - [x] 양의 정수가 아닌 경우 예외 처리
+
+### 출력 기능
+
+- [x] 현재 자동차 위치 출력 기능
+    ```text
+    // 예시
+    pobi : --
+    woni : ----
+    jun : ---
+    ```
+
+- [x] 우승자 안내 출력 기능
+    ```text
+    // 단독 우승
+    최종 우승자 : pobi
+
+    // 공동 우승
+    최종 우승자 : pobi, jun
+    ```
+
+### Model
+
+- [x] `Car`: 자동차 정보를 저장하는 객체
+    - [x] `name`: Car의 이름
+        - [x] 이름이 5자 이하가 아니라면 예외 처리
+    - [x] `position`: 현재 Car의 위치
+        - 초기 위치는 0
+    - [x] `move()`: Car의 현재 위치를 변경시키는 메서드
+        - `camp.nextstep.edu.missionutils`의 `Randoms` API를 사용해서 4이상일 경우 전진
+- [ ] ~~`Cars`: 자동차 경주에 참여하고 있는 Car의 이름을 저장하는 HashMap~~
+- [x] `parseCarNameInput()`: 입력받은 자동차 이름들을 쉼표를 기준으로 분리하고 저장하는 함수
+    - [x] 중복된 자동차 이름이 있는 경우 예외 처리
+- [x] `getRacingPlayers()`: 자동차 경주 참여 리스트를 만드는 함수
+- [x] `playRace()`: 자동차 경주를 한번 실행하는 함수
+- [x] `getWinPlayers()`: 자동차 경주의 우승자를 구하는 함수
+
+### View
+
+- [x] `getCarNameInput()`: 자동차 이름을 입력 처리 메서드
+    - `경주할 자동차 이름을 입력하세요.(이름은 쉼표(,) 기준으로 구분)`
+    - [x] `camp.nextstep.edu.missionutils.Console`의 `readLine()`을 활용
+
+- [x] `getCarRaceCountInput()`: 자동차 경주를 반복할 횟수 입력 처리 메서드
+    - `시도할 횟수는 몇 회인가요?`
+    - [x] `camp.nextstep.edu.missionutils.Console`의 `readLine()`을 활용
+
+- [x] `printCarRaceResultTitle()`: `실행 결과` 출력 메서드
+
+- [x] `printCarRaceCurrentResult()`: 현재 자동차 경주 현황을 출력하는 메서드
+    ```text
+    pobi : -
+    woni : 
+    jun : -
+    ```
+
+- [x] `printCarRaceWinnerResult()`: 자동차 경주 우승자 출력하는 메서드
+    - [x] 위치가 같은 우승자가 여러 명이라면 `,`를 이용하여 구분
+    - `최종 우승자 : carName1, carName2, ...`
+
+### Controller
+
+- [x] `run()`: Service의 로직 처리, View에 결과 전달

src/main/kotlin/racingcar/Application.kt

@@ -1,5 +1,15 @@
 package racingcar
 
+import racingcar.controller.RacingCarController
+import racingcar.model.RacingCarService
+import racingcar.view.RacingCarView
+
 fun main() {
     // TODO: 프로그램 구현
+    val racingCarService = RacingCarService()
+    val racingCarView = RacingCarView()
+
+    val racingCarController = RacingCarController(racingCarService, racingCarView)
+
+    racingCarController.run()
 }

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

@@ -0,0 +1,24 @@
+package racingcar.controller
+
+import racingcar.model.RacingCarService
+import racingcar.view.RacingCarView
+
+class RacingCarController(
+    val racingCarService: RacingCarService,
+    val racingCarView: RacingCarView
+) {
+    fun run() {
+        val carNamesInput = racingCarView.getCarNameInput()
+        val carCountInput = racingCarView.getCarRaceCountInput()
+
+        val names = racingCarService.parseCarNameInput(carNamesInput)
+        val cars = racingCarService.getRacingPlayers(names)
+        racingCarView.printCarRaceResultTitle()
+        repeat(carCountInput) {
+            racingCarService.playRace(cars)
+            racingCarView.printCarRaceCurrentResult(cars)
+        }
+        val winner = racingCarService.getWinPlayers(cars)
+        racingCarView.printCarRaceWinnerResult(winner)
+    }
+}

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

@@ -0,0 +1,16 @@
+package racingcar.model
+
+import camp.nextstep.edu.missionutils.Randoms
+
+data class Car(
+    val name: String,
+    var position: Int = 0
+) {
+    init {
+        require(name.length <= 5) { throw IllegalArgumentException() }
+    }
+
+    fun move() {
+        if (Randoms.pickNumberInRange(0, 9) >= 4) position++
+    }
+}

src/main/kotlin/racingcar/model/RacingCarService.kt

@@ -0,0 +1,26 @@
+package racingcar.model
+
+class RacingCarService {
+    fun parseCarNameInput(input: String): List<String> {
+        return input.split(",").map { it.trim() }
+    }
+
+    fun getRacingPlayers(names: List<String>): List<Car> {
+        val carNames = mutableSetOf<String>()
+        return names.map {
+            if (it.isEmpty() || carNames.contains(it)) throw IllegalArgumentException()
+            carNames.add(it)
+            Car(it)
+        }
+    }
+
+    fun playRace(players: List<Car>) {
+        players.forEach { it.move() }
+    }
+
+    fun getWinPlayers(players: List<Car>): List<String> {
+        val maxPosition = players.maxOfOrNull { it.position }
+
+        return players.filter { it.position == maxPosition }.map { it.name }
+    }
+}

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

@@ -0,0 +1,31 @@
+package racingcar.view
+
+import camp.nextstep.edu.missionutils.Console.readLine
+import racingcar.model.Car
+
+class RacingCarView {
+    fun getCarNameInput(): String {
+        println("경주할 자동차 이름을 입력하세요.(이름은 쉼표(,) 기준으로 구분)")
+        return readLine()
+    }
+
+    fun getCarRaceCountInput(): Int {
+        println("시도할 횟수는 몇 회인가요?")
+        val count = readLine().toIntOrNull()
+        if (count == null || count <= 0) throw IllegalArgumentException()
+        return count
+    }
+
+    fun printCarRaceResultTitle() {
+        println("실행 결과")
+    }
+
+    fun printCarRaceCurrentResult(cars: List<Car>) {
+        cars.forEach { println("${it.name} : ${"-".repeat(it.position)}") }
+        println()
+    }
+
+    fun printCarRaceWinnerResult(winner: List<String>) {
+        print("최종 우승자 : ${winner.joinToString(", ")}")
+    }
+}

src/test/kotlin/racingcar/ApplicationTest.kt

@@ -26,6 +26,20 @@ class ApplicationTest : NsTest() {
         }
     }
 
+    @Test
+    fun `자동차_이동_횟수_예외_테스트`() {
+        assertSimpleTest {
+            assertThrows<IllegalArgumentException> { runException("pobi,java", "0") }
+        }
+    }
+
+    @Test
+    fun `자동차_이동_횟수_음수_예외_테스트`() {
+        assertSimpleTest {
+            assertThrows<IllegalArgumentException> { runException("pobi,java", "-10") }
+        }
+    }
+
     override fun runMain() {
         main()
     }

src/test/kotlin/racingcar/model/RacingCarServiceTest.kt

@@ -0,0 +1,79 @@
+package racingcar.model
+
+import camp.nextstep.edu.missionutils.test.Assertions.assertSimpleTest
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.assertThrows
+
+class RacingCarServiceTest {
+    val racingCarService = RacingCarService()
+
+    @Test
+    fun `자동차_이름_파싱_테스트`() {
+        assertSimpleTest {
+            val input = "name1, name2, name3, name4"
+            val res = listOf("name1", "name2", "name3", "name4")
+            assertThat(racingCarService.parseCarNameInput(input)).isEqualTo(res)
+        }
+    }
+
+    @Test
+    fun `자동차_경주_참여자_생성_테스트`() {
+        assertSimpleTest {
+            val input = listOf("name1", "name2", "name3")
+            val res = listOf(
+                Car("name1"),
+                Car("name2"),
+                Car("name3")
+            )
+            assertThat(racingCarService.getRacingPlayers(input)).isEqualTo(res)
+        }
+    }
+
+    @Test
+    fun `자동차_경주_참여자_생성_예외_테스트_5글자이상`() {
+        assertSimpleTest {
+            assertThrows<IllegalArgumentException> { racingCarService.getRacingPlayers(listOf("name10")) }
+        }
+    }
+
+    @Test
+    fun `자동차_경주_참여자_생성_예외_테스트_미입력`() {
+        assertSimpleTest {
+            assertThrows<IllegalArgumentException> { racingCarService.getRacingPlayers(listOf("")) }
+        }
+    }
+
+    @Test
+    fun `자동차_경주_참여자_생성_예외_테스트_중복이름`() {
+        assertSimpleTest {
+            assertThrows<IllegalArgumentException> { racingCarService.getRacingPlayers(listOf("name1", "name1")) }
+        }
+    }
+
+    @Test
+    fun `자동차_경주_우승자_생성_테스트`() {
+        assertSimpleTest {
+            val input = listOf(
+                Car("name1", 10),
+                Car("name2", 15),
+                Car("name3", 12)
+            )
+            val res = listOf("name2")
+            assertThat(racingCarService.getWinPlayers(input)).isEqualTo(res)
+        }
+    }
+
+    @Test
+    fun `자동차_경주_다중_우승자_생성_테스트`() {
+        assertSimpleTest {
+            val input = listOf(
+                Car("name1", 10),
+                Car("name2", 15),
+                Car("name3", 15)
+            )
+            val res = listOf("name2", "name3")
+            assertThat(racingCarService.getWinPlayers(input)).isEqualTo(res)
+        }
+    }
+}