pythonic-js-input

Python의 input() 함수처럼 간편하게 JavaScript에서 터미널 입력을 받을 수 있는 라이브러리입니다.

✨ 특징: 여러 줄 붙여넣기를 완벽하게 지원합니다! node:readline/promises와 비동기 반복자를 사용하여 안정적인 입력 처리를 제공합니다.

설치

``bash
npm install pythonic-js-input
`

핵심 원리

이 라이브러리는 node:readline/promises와 비동기 반복자(async iterator)를 사용하여 구현되었습니다.

`javascript
// 내부 구조 (간략화)
const readline = require('node:readline/promises');
const rl = readline.createInterface({
input: process.stdin,
output: process.stdout,
terminal: false
});
const inputGenerator = rl[Symbol.asyncIterator]();

async function input(prompt = "") {
if (prompt) process.stdout.write(prompt);
const result = await inputGenerator.next();
return result.value;
}
`

이 방식의 장점:
- ✅ 여러 줄 붙여넣기 완벽 지원: 여러 줄을 한 번에 붙여넣어도 순차적으로 처리
- ✅ 안정적: readline interface를 한 번만 생성하여 재사용
- ✅ Python과 동일한 동작: 정확히 Python의 input()처럼 작동

사용법

$3

`javascript
const { input } = require("pythonic-js-input");

(async () => {
const name = await input("이름을 입력하세요: ");
console.log(안녕하세요, ${name}님!);
})();
`

$3

`javascript
const { inputInt } = require("pythonic-js-input");

(async () => {
const age = await inputInt("나이를 입력하세요: ");
console.log(당신은 ${age}살입니다.);
})();
`

$3

`javascript
const { inputFloat } = require("pythonic-js-input");

(async () => {
const height = await inputFloat("키를 입력하세요 (cm): ");
console.log(당신의 키는 ${height}cm입니다.);
})();
`

$3

`javascript
const { inputLines } = require("pythonic-js-input");

(async () => {
// 여러 줄을 한 번에 복사(Ctrl+C)해서 붙여넣기(Ctrl+V) 가능!
const lines = await inputLines("3줄을 입력하세요:", 3);
console.log("입력한 내용:");
lines.forEach((line, index) => {
console.log(${index + 1}: ${line});
});
})();
`

$3

`javascript
const { inputUntilEmpty } = require("pythonic-js-input");

(async () => {
// 여러 줄 입력 후 빈 줄(엔터만)을 입력하면 종료
const lines = await inputUntilEmpty("입력을 시작하세요 (빈 줄로 종료):");
console.log(총 ${lines.length}줄 입력되었습니다.);
})();
`

$3

`javascript
const { inputUntilKeyword } = require("pythonic-js-input");

(async () => {
// "END"를 입력하면 종료
const lines = await inputUntilKeyword("입력 시작 (END로 종료):", "END");
console.log("입력된 내용:", lines);
})();
`

$3

`javascript
const { inputText } = require("pythonic-js-input");

(async () => {
// 여러 줄을 하나의 문자열로 입력받기
const text = await inputText("메모를 작성하세요 (빈 줄로 종료):");
console.log("작성된 메모:\n" + text);
})();
`

$3

`javascript
const { inputAll } = require("pythonic-js-input");

(async () => {
// Ctrl+D (Mac/Linux) 또는 Ctrl+Z (Windows)로 종료
const lines = await inputAll("여러 줄을 입력하세요:");
lines.forEach((line) => console.log(line));
})();
`

$3

`javascript
const { inputArray, inputIntArray } = require("pythonic-js-input");

(async () => {
// 문자열 배열
const fruits = await inputArray("과일 이름을 공백으로 구분하여 입력하세요: ");
console.log("입력한 과일:", fruits);

// 정수 배열
const numbers = await inputIntArray(
"숫자들을 공백으로 구분하여 입력하세요: "
);
console.log("입력한 숫자:", numbers);
console.log(
"합계:",
numbers.reduce((a, b) => a + b, 0)
);
})();
`

$3

`javascript
const { inputArray } = require("pythonic-js-input");

(async () => {
const items = await inputArray("쉼표로 구분하여 입력하세요: ", ",");
console.log("입력한 항목:", items);
})();
`

API

$3

- prompt (string): 사용자에게 표시할 메시지
- 반환값: Promise\ - 입력받은 문자열

$3

- prompt (string): 사용자에게 표시할 메시지
- 반환값: Promise\ - 입력받은 정수

$3

- prompt (string): 사용자에게 표시할 메시지
- 반환값: Promise\ - 입력받은 실수

$3

- prompt (string): 사용자에게 표시할 메시지
- count (number): 입력받을 줄의 개수
- 반환값: Promise\ - 입력받은 문자열 배열
- 특징: 여러 줄을 한 번에 복사해서 붙여넣기 가능 ✨

$3

- prompt (string): 사용자에게 표시할 메시지
- 반환값: Promise\ - 입력받은 문자열 배열 (빈 줄 제외)
- 특징: 빈 줄(엔터만)을 입력하면 입력 종료

$3

- prompt (string): 사용자에게 표시할 메시지
- endKeyword (string): 종료 키워드 (기본값: 'END')
- includeKeyword (boolean): 종료 키워드를 결과에 포함할지 여부 (기본값: false)
- 반환값: Promise\ - 입력받은 문자열 배열
- 특징: 특정 키워드를 입력하면 종료

$3

- prompt (string): 사용자에게 표시할 메시지
- 반환값: Promise\ - 입력받은 텍스트 (줄바꿈으로 연결)
- 특징: 여러 줄을 하나의 문자열로 반환, 빈 줄로 종료

$3

- prompt (string): 사용자에게 표시할 메시지
- 반환값: Promise\ - 입력받은 모든 줄의 배열
- 특징: EOF(Ctrl+D 또는 Ctrl+Z)까지 모든 입력 받기

$3

- prompt (string): 사용자에게 표시할 메시지
- separator (string): 구분자 (기본값: 공백)
- 반환값: Promise\ - 입력받은 문자열 배열

$3

- prompt (string): 사용자에게 표시할 메시지
- separator (string): 구분자 (기본값: 공백)
- 반환값: Promise\ - 입력받은 정수 배열

$3

- prompt (string): 사용자에게 표시할 메시지
- separator (string): 구분자 (기본값: 공백)
- 반환값: Promise\ - 입력받은 실수 배열

붙여넣기 기능 (New! ✨)

이제 여러 줄을 한 번에 복사해서 붙여넣을 수 있습니다!

`javascript
const { inputLines } = require("pythonic-js-input");

(async () => {
// 다음 텍스트를 복사:
// 첫 번째 줄
// 두 번째 줄
// 세 번째 줄

const lines = await inputLines("3줄을 입력하세요:", 3);
// Ctrl+V로 한 번에 붙여넣기하면 모든 줄이 입력됩니다!

console.log(lines); // ['첫 번째 줄', '두 번째 줄', '세 번째 줄']
})();
`

Python과 비교

$3

`python
name = input("이름을 입력하세요: ")
age = int(input("나이를 입력하세요: "))
numbers = list(map(int, input("숫자들을 입력하세요: ").split()))

여러 줄 입력


lines = []
for i in range(3):
lines.append(input())
`

$3

`javascript
const {
input,
inputInt,
inputIntArray,
inputLines,
} = require("pythonic-js-input");

(async () => {
const name = await input("이름을 입력하세요: ");
const age = await inputInt("나이를 입력하세요: ");
const numbers = await inputIntArray("숫자들을 입력하세요: ");

// 여러 줄 입력 (붙여넣기 지원!)
const lines = await inputLines("", 3);
})();
``

라이선스

MIT