Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[자동차 경주] 양효원 미션 제출합니다. #226

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
179 changes: 28 additions & 151 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,161 +1,38 @@
# 미션 - 자동차 경주
# 자동차 경주 게임

## 🔍 진행 방식

- 미션은 **기능 요구 사항, 프로그래밍 요구 사항, 과제 진행 요구 사항** 세 가지로 구성되어 있다.
- 세 개의 요구 사항을 만족하기 위해 노력한다. 특히 기능을 구현하기 전에 기능 목록을 만들고, 기능 단위로 커밋 하는 방식으로 진행한다.
- 기능 요구 사항에 기재되지 않은 내용은 스스로 판단하여 구현한다.

## 📮 미션 제출 방법

- 미션 구현을 완료한 후 GitHub을 통해 제출해야 한다.
- GitHub을 활용한 제출 방법은 [프리코스 과제 제출](https://github.com/woowacourse/woowacourse-docs/tree/master/precourse) 문서를 참고해 제출한다.
- GitHub에 미션을 제출한 후 [우아한테크코스 지원](https://apply.techcourse.co.kr) 사이트에 접속하여 프리코스 과제를 제출한다.
- 자세한 방법은 [제출 가이드](https://github.com/woowacourse/woowacourse-docs/tree/master/precourse#제출-가이드) 참고
- **Pull Request만 보내고 지원 플랫폼에서 과제를 제출하지 않으면 최종 제출하지 않은 것으로 처리되니 주의한다.**

## 🚨 과제 제출 전 체크 리스트 - 0점 방지

- 기능 구현을 모두 정상적으로 했더라도 **요구 사항에 명시된 출력값 형식을 지키지 않을 경우 0점으로 처리**한다.
- 기능 구현을 완료한 뒤 아래 가이드에 따라 테스트를 실행했을 때 모든 테스트가 성공하는지 확인한다.
- **테스트가 실패할 경우 0점으로 처리**되므로, 반드시 확인 후 제출한다.

### 테스트 실행 가이드

- 터미널에서 Mac 또는 Linux 사용자의 경우 `./gradlew clean test` 명령을 실행하고,
Windows 사용자의 경우 `gradlew.bat clean test` 또는 `./gradlew.bat clean test` 명령을 실행할 때 모든 테스트가 아래와 같이 통과하는지 확인한다.

```
BUILD SUCCESSFUL in 0s
```

---

## 🚀 기능 요구 사항

초간단 자동차 경주 게임을 구현한다.

- 주어진 횟수 동안 n대의 자동차는 전진 또는 멈출 수 있다.
- 각 자동차에 이름을 부여할 수 있다. 전진하는 자동차를 출력할 때 자동차 이름을 같이 출력한다.
- 자동차 이름은 쉼표(,)를 기준으로 구분하며 이름은 5자 이하만 가능하다.
- 사용자는 몇 번의 이동을 할 것인지를 입력할 수 있어야 한다.
- 전진하는 조건은 0에서 9 사이에서 무작위 값을 구한 후 무작위 값이 4 이상일 경우이다.
- 자동차 경주 게임을 완료한 후 누가 우승했는지를 알려준다. 우승자는 한 명 이상일 수 있다.
- 우승자가 여러 명일 경우 쉼표(,)를 이용하여 구분한다.
- 사용자가 잘못된 값을 입력할 경우 `IllegalArgumentException`을 발생시킨 후 애플리케이션은 종료되어야 한다.

### 입출력 요구 사항

#### 입력

- 경주 할 자동차 이름(이름은 쉼표(,) 기준으로 구분)

```
pobi,woni,jun
```

- 시도할 횟수

```
5
```

#### 출력

- 각 차수별 실행 결과
### 입출력
- 입력: 경주할 자동차 이름, 시도할 횟수
- 출력: 각 차수별 실행 결과, 단독 우승자 안내 문구, 공동 우승자 안내 문구

```
pobi : --
woni : ----
jun : ---
- 경주할 자동차 이름 입력
- 시도할 횟수 입력
- 실행 결과 출력
- 각 시도마다 전진 또는 멈춤
- 우승자 출력
```

- 단독 우승자 안내 문구
사용자로부터 자동차 이름을 입력 받는 함수
- 사용자로부터 자동차 이름을 입력받음
- 콤마 기준으로 나눠서 리스트로 저장
- 리스트 요소들의 각각 길이가 5자 초과면 에러문구출력
- 아니면 이름을 반환

```
최종 우승자 : pobi
```

- 공동 우승자 안내 문구

```
최종 우승자 : pobi, jun
```

#### 실행 결과 예시

```
경주할 자동차 이름을 입력하세요.(이름은 쉼표(,) 기준으로 구분)
pobi,woni,jun
시도할 횟수는 몇 회인가요?
5

실행 결과
pobi : -
woni :
jun : -

pobi : --
woni : -
jun : --

pobi : ---
woni : --
jun : ---

pobi : ----
woni : ---
jun : ----
사용자로부터 시도 횟수를 입력받는 함수
- 사용자로부터 시도 횟수를 입력받음
- 숫자로 변환하여 반환

pobi : -----
woni : ----
jun : -----

최종 우승자 : pobi, jun
```

---

## 🎯 프로그래밍 요구 사항

- Kotlin 1.9.0에서 실행 가능해야 한다. **Kotlin 1.9.0에서 정상적으로 동작하지 않을 경우 0점 처리한다.**
- **Java 코드가 아닌 Kotlin 코드로만 구현해야 한다.**
- 프로그램 실행의 시작점은 `Application`의 `main()`이다.
- `build.gradle(.kts)`을 변경할 수 없고, 외부 라이브러리를 사용하지 않는다.
- [Kotlin 코드 컨벤션](https://github.com/woowacourse/woowacourse-docs/tree/main/styleguide/kotlin) 가이드를 준수하며 프로그래밍한다.
- 프로그램 종료 시 System.exit()를 호출하지 않는다.
- 프로그램 구현이 완료되면 ApplicationTest의 모든 테스트가 성공해야 한다. 테스트가 실패할 경우 0점 처리한다.
- 프로그래밍 요구 사항에서 달리 명시하지 않는 한 파일, 패키지 이름을 수정하거나 이동하지 않는다.

### 추가된 요구 사항

- indent(인덴트, 들여쓰기) depth를 3이 넘지 않도록 구현한다. 2까지만 허용한다.
예를 들어 while문 안에 if문이 있으면 들여쓰기는 2이다.
힌트: indent(인덴트, 들여쓰기) depth를 줄이는 좋은 방법은 함수(또는 메서드)를 분리하면 된다.
- 함수(또는 메서드)가 한 가지 일만 하도록 최대한 작게 만들어라.
- JUnit 5와 AssertJ를 이용하여 본인이 정리한 기능 목록이 정상 동작함을 테스트 코드로 확인한다.
- 테스트 도구 사용법이 익숙하지 않다면 test/kotlin/study를 참고하여 학습한 후 테스트를 구현한다.

### 라이브러리

- `camp.nextstep.edu.missionutils`에서 제공하는 `Randoms` 및 `Console` API를 사용하여 구현해야 한다.
- Random 값 추출은 `camp.nextstep.edu.missionutils.Randoms`의 `pickNumberInRange()`를 활용한다.
- 사용자가 입력하는 값은 `camp.nextstep.edu.missionutils.Console`의 `readLine()`을 활용한다.

#### 사용 예시

- 0에서 9까지의 정수 중 한 개의 정수 반환

```kotlin
Randoms.pickNumberInRange(0, 9)
```
자동차 생성
- 전진 함수 생성
- 입력받은 시도 횟수 동안
- 0~9 무작위 값 생성 후
- 조건문을 통해 4 이상이면 전진시킴

---
경주 시작 함수
- 각 시도의 결과를 저장
- 각 자동차의 이름 옆에 위치를 출력(-)

## ✏️ 과제 진행 요구 사항
결과 출력 함수
- 위치량이 가장 많은 최종 우승자 또는 공동 우승자를 문구 출력

- 미션은 [kotlin-racingcar-6](https://github.com/woowacourse-precourse/kotlin-racingcar-6) 저장소를 Fork & Clone해 시작한다.
- **기능을 구현하기 전 `docs/README.md`에 구현할 기능 목록을 정리**해 추가한다.
- **Git의 커밋 단위는 앞 단계에서 `docs/README.md`에 정리한 기능 목록 단위**로 추가한다.
- [커밋 메시지 컨벤션](https://gist.github.com/stephenparish/9941e89d80e2bc58a153) 가이드를 참고해 커밋 메시지를 작성한다.
- 과제 진행 및 제출 방법은 [프리코스 과제 제출](https://github.com/woowacourse/woowacourse-docs/tree/master/precourse) 문서를 참고한다.
- 사용자가 잘못된 값을 입력할 경우 IllegalArgumentException을 발생시킨 후 애플리케이션은 종료
76 changes: 75 additions & 1 deletion src/main/kotlin/racingcar/Application.kt
Original file line number Diff line number Diff line change
@@ -1,5 +1,79 @@
package racingcar

import camp.nextstep.edu.missionutils.Console
import camp.nextstep.edu.missionutils.Randoms

fun main() {
// TODO: 프로그램 구현
println("경주할 자동차 이름을 입력하세요.(이름은 쉼표(,) 기준으로 구분)")

val carNames = getCarNames()
println("시도할 횟수는 몇 회인가요?")

val tryCount = getTryCount()
val cars = carNames.map { Car(it.toString()) }

racestart(tryCount, cars)
printResult(cars)

}

fun getCarNames(): List<String>{
val inputCarName = Console.readLine()
val listNameInput = inputCarName?.split(",")

checkNameInput(listNameInput?: emptyList())
return listNameInput?: emptyList()
}

fun checkNameInput(listNameInput: List<String>): List<String> {
if ( listNameInput.any { it.length > 5} ) {
throw IllegalArgumentException("차 이름은 5자 이하여야 합니다.")
}
return listNameInput
}

fun getTryCount(): Int {
val inputTryCount = Console.readLine()
try{
return inputTryCount?.toInt()?: 0
} catch (e: NumberFormatException) {
throw IllegalArgumentException("시도 횟수는 숫자여야 합니다.")
}
}

class Car (val name: String) {
var position = 0;

fun advance() {
if (Randoms.pickNumberInRange(0, 9) > 5) {
position++
}
}

}

fun racestart(tryCount: Int, cars: List<Car>) {
println("\n실행 결과")

for (i in 0 until tryCount) {
for (car in cars) {
car.advance()
println("${car.name} : ${"-".repeat(car.position)}")
}
println("\n")
}

}


fun printResult(cars: List<Car>) {
val maxPosition = cars.map { it.position }.maxOrNull()
val winners = cars.filter { it.position == maxPosition }
val winnerNames = winners.joinToString(", ") { it.name }

if (winners.size == 1) {
println("\n최종 우승자: $winnerNames")
} else {
println("\n공동 우승자: $winnerNames")
}
}
3 changes: 2 additions & 1 deletion src/test/kotlin/racingcar/ApplicationTest.kt
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
package racingcar
package racingcars

import camp.nextstep.edu.missionutils.test.Assertions.assertRandomNumberInRangeTest
import camp.nextstep.edu.missionutils.test.Assertions.assertSimpleTest
import camp.nextstep.edu.missionutils.test.NsTest
import org.assertj.core.api.Assertions.assertThat
import org.junit.jupiter.api.Test
import org.junit.jupiter.api.assertThrows
import racingcar.main

class ApplicationTest : NsTest() {
@Test
Expand Down