1주 차 프리코스 손행원 미션 제

README.md

@@ -1 +1,102 @@
-# java-calculator-precourse
+# java-calculator-precourse
+입력한 문자열에서 숫자를 추출하여 더하는 계산기를 구현한다.
+
+## 🚀 기능 요구 사항
+
+### 1️⃣ 기본 기능
+1. 문자열 입력 받기
+  - "덧셈할 문자열을 입력해 주세요." 메시지 출력
+  - `Console.readLine()`을 사용하여 문자열 입력 받기
+2. 구분자 설정
+  - 기본 구분자: "," 또는 ":"
+  - 커스텀 구분자 : 문자열 앞부분의 "//"와 "\n" 사이에 위치하는 문자
+3. 문자열 분리 및 숫자 추출
+  - 설정된 구분자로 문자열 분리
+  - 분리된 각 문자열을 정수로 변환
+4. 숫자 합계 계산
+  - 추출된 숫자들의 합 계산
+5. 결과 출력
+  - "결과 : %d" 형식으로 계산된 합계 출력
+
+### 2️⃣ 특수 상황 처리
+1. 빈 입력 처리
+  - 상황: 사용자가 빈 문자열을 입력했을 때
+  - 결과: 예외 발생하지 않음, 0 반환
+2. 구분자 연속
+  - 상황 : 사용자가 입력한 문자열에서 구분자가 연속되었을 때
+  - 결과 : 빈 값은 무시하고 정상적으로 계산됨
+4. 공백 처리
+  - 상황: 숫자 앞뒤에 공백이 있을 때
+  - 결과: 공백이 제거되고 정상적으로 계산됨
+
+### 3️⃣ 예외 처리
+1. 유효하지 않은 구분자 형식
+  - 상황: 사용자가 커스텀 구분자를 사용하려 했지만 올바른 형식을 따르지 않았을 때
+  - 결과: "유효하지 않은 구분자 형식입니다."
+2. 숫자 변환 실패
+  - 상황: 입력된 문자열이 유효한 정수로 변환될 수 없을 때
+  - 결과: "숫자 변환에 실패했습니다."
+3. 음수 입력
+  - 상황: 입력된 숫자 중 하나라도 음수일 때
+  - 결과: "음수는 입력할 수 없습니다."
+
+### 4️⃣ 테스트
+1. 단위 테스트
+2. 통합 테스트
+  - 기본 구분자 사용 테스트
+  - 커스텀 구분자 사용 테스트
+  - 기본과 터스텀 구분자 사용 테스트
+  - 빈 문자열 입력 처리
+  - 연속된 구분자 처리
+  - 공백이 있는 입력 처리
+  - 유효하지 않은 구분자 형식 테스트
+  - 숫자 변환 실패 테스트
+  - 음수 입력 테스트
+
+### 💡 참고사항
+- 모든 예외는 `IllegalArgumentException`으로 처리한다.
+- 프로그램은 예외 발생 시 해당 메시지를 출력하고 종료된다.
+- 커스텀 구분자는 문자 하나로만 지정한다.
+- 단위 테스트와 통합 테스트는 같은 시나리오를 기반으로 한다.
+
+### 입력
+- 구분자와 양의 정수로 구성된 문자열
+
+### 출력
+- 덧셈 결과
+
+### 실행 결과 예시
+````
+덧셈할 문자열을 입력해 주세요.
+1,2:3
+결과 : 6
+````
+````
+덧셈할 문자열을 입력해 주세요.
+
+결과 : 0
+````
+
+## 🎯 프로그래밍 요구 사항
+- JDK 21 버전에서 실행 가능해야 한다.
+- 프로그램 실행의 시작점은 `Application`의 `main()`이다.
+- `build.gradle` 파일은 변경할 수 없으며, 제공된 라이브러리 이외의 외부 라이브러리는 사용하지 않는다.
+- 프로그램 종료 시 `System.exit()`를 호출하지 않는다.
+- 프로그래밍 요구 사항에서 달리 명시하지 않는 한 파일, 패키지 등의 이름을 바꾸거나 이동하지 않는다.
+- 자바 코드 컨벤션을 지키면서 프로그래밍한다.
+
+### 라이브러리
+- `camp.nextstep.edu.missionutils`에서 제공하는 `Console` API를 사용하여 구현해야 한다.
+  - 사용자가 입력하는 값은 `camp.nextstep.edu.missionutils.Console`의 `readLine()`을 활용한다.
+
+## 🚨 과제 제출 전 체크 리스트
+- 기능을 올바르게 구현했더라도 요구 사항에 명시된 출력 형식을 따르지 않으면 0점을 받게 된다.
+- 기능 구현을 완료한 후 아래 가이드에 따라 모든 테스트가 성공적으로 실행되는지 확인한다.
+
+### 테스트 실행 가이드
+- 터미널에서 `java -version`을 실행하여 Java 버전이 21인지 확인한다.
+- 터미널에서 Windows 사용자의 경우 `.\\gradlew.bat clean test` 명령을 실행할 때 모든 테스트가 아래와 같이 통과하는지 확인한다.
+````
+BUILD SUCCESSFUL in 0s
+````
+

java-calculator-7.git/HEAD

@@ -0,0 +1 @@
+ref: refs/heads/main

java-calculator-7.git/config

@@ -0,0 +1,8 @@
+[core]
+	repositoryformatversion = 0
+	filemode = false
+	bare = true
+	symlinks = false
+	ignorecase = true
+[remote "origin"]
+	url = https://github.com/sonbankclerk/java-calculator-7.git

java-calculator-7.git/description

@@ -0,0 +1 @@
+Unnamed repository; edit this file 'description' to name the repository.

java-calculator-7.git/hooks/applypatch-msg.sample

@@ -0,0 +1,15 @@
+#!/bin/sh
+#
+# An example hook script to check the commit log message taken by
+# applypatch from an e-mail message.
+#
+# The hook should exit with non-zero status after issuing an
+# appropriate message if it wants to stop the commit.  The hook is
+# allowed to edit the commit message file.
+#
+# To enable this hook, rename this file to "applypatch-msg".
+
+. git-sh-setup
+commitmsg="$(git rev-parse --git-path hooks/commit-msg)"
+test -x "$commitmsg" && exec "$commitmsg" ${1+"$@"}
+:

java-calculator-7.git/hooks/commit-msg.sample

@@ -0,0 +1,24 @@
+#!/bin/sh
+#
+# An example hook script to check the commit log message.
+# Called by "git commit" with one argument, the name of the file
+# that has the commit message.  The hook should exit with non-zero
+# status after issuing an appropriate message if it wants to stop the
+# commit.  The hook is allowed to edit the commit message file.
+#
+# To enable this hook, rename this file to "commit-msg".
+
+# Uncomment the below to add a Signed-off-by line to the message.
+# Doing this in a hook is a bad idea in general, but the prepare-commit-msg
+# hook is more suited to it.
+#
+# SOB=$(git var GIT_AUTHOR_IDENT | sed -n 's/^\(.*>\).*$/Signed-off-by: \1/p')
+# grep -qs "^$SOB" "$1" || echo "$SOB" >> "$1"
+
+# This example catches duplicate Signed-off-by lines.
+
+test "" = "$(grep '^Signed-off-by: ' "$1" |
+	 sort | uniq -c | sed -e '/^[ 	]*1[ 	]/d')" || {
+	echo >&2 Duplicate Signed-off-by lines.
+	exit 1
+}

java-calculator-7.git/hooks/fsmonitor-watchman.sample

@@ -0,0 +1,174 @@
+#!/usr/bin/perl
+
+use strict;
+use warnings;
+use IPC::Open2;
+
+# An example hook script to integrate Watchman
+# (https://facebook.github.io/watchman/) with git to speed up detecting
+# new and modified files.
+#
+# The hook is passed a version (currently 2) and last update token
+# formatted as a string and outputs to stdout a new update token and
+# all files that have been modified since the update token. Paths must
+# be relative to the root of the working tree and separated by a single NUL.
+#
+# To enable this hook, rename this file to "query-watchman" and set
+# 'git config core.fsmonitor .git/hooks/query-watchman'
+#
+my ($version, $last_update_token) = @ARGV;
+
+# Uncomment for debugging
+# print STDERR "$0 $version $last_update_token\n";
+
+# Check the hook interface version
+if ($version ne 2) {
+	die "Unsupported query-fsmonitor hook version '$version'.\n" .
+	    "Falling back to scanning...\n";
+}
+
+my $git_work_tree = get_working_dir();
+
+my $retry = 1;
+
+my $json_pkg;
+eval {
+	require JSON::XS;
+	$json_pkg = "JSON::XS";
+	1;
+} or do {
+	require JSON::PP;
+	$json_pkg = "JSON::PP";
+};
+
+launch_watchman();
+
+sub launch_watchman {
+	my $o = watchman_query();
+	if (is_work_tree_watched($o)) {
+		output_result($o->{clock}, @{$o->{files}});
+	}
+}
+
+sub output_result {
+	my ($clockid, @files) = @_;
+
+	# Uncomment for debugging watchman output
+	# open (my $fh, ">", ".git/watchman-output.out");
+	# binmode $fh, ":utf8";
+	# print $fh "$clockid\n@files\n";
+	# close $fh;
+
+	binmode STDOUT, ":utf8";
+	print $clockid;
+	print "\0";
+	local $, = "\0";
+	print @files;
+}
+
+sub watchman_clock {
+	my $response = qx/watchman clock "$git_work_tree"/;
+	die "Failed to get clock id on '$git_work_tree'.\n" .
+		"Falling back to scanning...\n" if $? != 0;
+
+	return $json_pkg->new->utf8->decode($response);
+}
+
+sub watchman_query {
+	my $pid = open2(\*CHLD_OUT, \*CHLD_IN, 'watchman -j --no-pretty')
+	or die "open2() failed: $!\n" .
+	"Falling back to scanning...\n";
+
+	# In the query expression below we're asking for names of files that
+	# changed since $last_update_token but not from the .git folder.
+	#
+	# To accomplish this, we're using the "since" generator to use the
+	# recency index to select candidate nodes and "fields" to limit the
+	# output to file names only. Then we're using the "expression" term to
+	# further constrain the results.
+	my $last_update_line = "";
+	if (substr($last_update_token, 0, 1) eq "c") {
+		$last_update_token = "\"$last_update_token\"";
+		$last_update_line = qq[\n"since": $last_update_token,];
+	}
+	my $query = <<"	END";
+		["query", "$git_work_tree", {$last_update_line
+			"fields": ["name"],
+			"expression": ["not", ["dirname", ".git"]]
+		}]
+	END
+
+	# Uncomment for debugging the watchman query
+	# open (my $fh, ">", ".git/watchman-query.json");
+	# print $fh $query;
+	# close $fh;
+
+	print CHLD_IN $query;
+	close CHLD_IN;
+	my $response = do {local $/; <CHLD_OUT>};
+
+	# Uncomment for debugging the watch response
+	# open ($fh, ">", ".git/watchman-response.json");
+	# print $fh $response;
+	# close $fh;
+
+	die "Watchman: command returned no output.\n" .
+	"Falling back to scanning...\n" if $response eq "";
+	die "Watchman: command returned invalid output: $response\n" .
+	"Falling back to scanning...\n" unless $response =~ /^\{/;
+
+	return $json_pkg->new->utf8->decode($response);
+}
+
+sub is_work_tree_watched {
+	my ($output) = @_;
+	my $error = $output->{error};
+	if ($retry > 0 and $error and $error =~ m/unable to resolve root .* directory (.*) is not watched/) {
+		$retry--;
+		my $response = qx/watchman watch "$git_work_tree"/;
+		die "Failed to make watchman watch '$git_work_tree'.\n" .
+		    "Falling back to scanning...\n" if $? != 0;
+		$output = $json_pkg->new->utf8->decode($response);
+		$error = $output->{error};
+		die "Watchman: $error.\n" .
+		"Falling back to scanning...\n" if $error;
+
+		# Uncomment for debugging watchman output
+		# open (my $fh, ">", ".git/watchman-output.out");
+		# close $fh;
+
+		# Watchman will always return all files on the first query so
+		# return the fast "everything is dirty" flag to git and do the
+		# Watchman query just to get it over with now so we won't pay
+		# the cost in git to look up each individual file.
+		my $o = watchman_clock();
+		$error = $output->{error};
+
+		die "Watchman: $error.\n" .
+		"Falling back to scanning...\n" if $error;
+
+		output_result($o->{clock}, ("/"));
+		$last_update_token = $o->{clock};
+
+		eval { launch_watchman() };
+		return 0;
+	}
+
+	die "Watchman: $error.\n" .
+	"Falling back to scanning...\n" if $error;
+
+	return 1;
+}
+
+sub get_working_dir {
+	my $working_dir;
+	if ($^O =~ 'msys' || $^O =~ 'cygwin') {
+		$working_dir = Win32::GetCwd();
+		$working_dir =~ tr/\\/\//;
+	} else {
+		require Cwd;
+		$working_dir = Cwd::cwd();
+	}
+
+	return $working_dir;
+}

java-calculator-7.git/hooks/post-update.sample

@@ -0,0 +1,8 @@
+#!/bin/sh
+#
+# An example hook script to prepare a packed repository for use over
+# dumb transports.
+#
+# To enable this hook, rename this file to "post-update".
+
+exec git update-server-info

java-calculator-7.git/hooks/pre-applypatch.sample

@@ -0,0 +1,14 @@
+#!/bin/sh
+#
+# An example hook script to verify what is about to be committed
+# by applypatch from an e-mail message.
+#
+# The hook should exit with non-zero status after issuing an
+# appropriate message if it wants to stop the commit.
+#
+# To enable this hook, rename this file to "pre-applypatch".
+
+. git-sh-setup
+precommit="$(git rev-parse --git-path hooks/pre-commit)"
+test -x "$precommit" && exec "$precommit" ${1+"$@"}
+: