Added non-interactive CLI function

Author: mrjung72

CHANGELOG.md

@@ -1,5 +1,18 @@
 # SQL2Excel Version History
 
+## v1.2.10 - Non-interactive CLI & Docs (2025-10-29)
+
+### ✨ New Features
+
+#### Non-interactive CLI (app.js)
+- Added direct execution without interactive menu using `--mode`
+  - Modes: `validate`, `test`, `export`, `help`
+  - Works in Node and packaged EXE
+
+### 📝 Documentation
+- README.md / README_KR.md: Added "Non-interactive CLI" usage and examples
+- Updated highlights to v1.2.10
+
 ## v1.2.9 - Global Timezone System & Local Time Support (2025-10-21)
 
 ### ✨ New Features

CHANGELOG_KR.md

@@ -1,5 +1,18 @@
 # SQL2Excel 버전 히스토리
 
+## v1.2.10 - 비대화식 CLI 및 문서 업데이트 (2025-10-29)
+
+### ✨ 새로운 기능
+
+#### 비대화식 CLI (app.js)
+- `--mode` 플래그로 대화형 메뉴 없이 직접 실행 가능
+  - 모드: `validate`, `test`, `export`, `help`
+  - Node 환경과 패키지 EXE 모두 지원
+
+### 📝 문서
+- README.md / README_KR.md: "비대화식 CLI" 사용법과 예시 추가
+- 하이라이트를 v1.3.0으로 업데이트
+
 ## v1.2.9 - 글로벌 타임존 시스템 및 로컬 시간 지원 (2025-10-21)
 
 ### ✨ 새로운 기능

README.md

@@ -25,6 +25,41 @@ A Node.js-based tool for generating Excel files from SQL query results.
 - 📋 **SQL Query Formatting**: Preserve original SQL formatting with line breaks in Table of Contents
 - 🔧 **Input Validation**: Automatic whitespace trimming for file path inputs
 
+## v1.2.10 Highlights
+
+- **Non-interactive CLI**: Run tasks directly with `app.js --mode` (no menu)
+  - Modes: `validate`, `test`, `export`, `help`
+  - Works in both Node and packaged EXE
+
+### Non-interactive CLI (New)
+
+#### Node.js
+```bash
+# Validate query definition
+node app.js --mode=validate --xml=./queries/sample-queries.xml
+# or JSON
+node app.js --mode=validate --query=./queries/sample-queries.json
+
+# Test DB connections
+node app.js --mode=test
+
+# Export Excel
+node app.js --mode=export --xml=./queries/sample-queries.xml
+# or JSON
+node app.js --mode=export --query=./queries/sample-queries.json
+
+# Help
+node app.js --mode=help
+```
+
+#### Standalone EXE
+```bash
+sql2excel.exe --mode=validate --xml=./queries/sample-queries.xml
+sql2excel.exe --mode=test
+sql2excel.exe --mode=export --xml=./queries/sample-queries.xml
+sql2excel.exe --mode=help
+```
+
 ## 🚀 Quick Start
 
 ## 🛠️ Installation and Setup

README_KR.md

@@ -25,6 +25,41 @@ SQL 쿼리 결과를 엑셀 파일로 생성하는 Node.js 기반 도구입니
 - 📋 **SQL 쿼리 포맷팅**: 목차에서 줄바꿈을 포함한 원본 SQL 포맷 유지
 - 🔧 **입력 유효성 검증**: 파일 경로 입력에 대한 자동 공백 제거
 
+## v1.2.10 하이라이트
+
+- **비대화식 CLI**: 메뉴 없이 `app.js --mode`로 직접 실행
+  - 모드: `validate`, `test`, `export`, `help`
+  - Node 실행 및 배포 EXE 모두 지원
+
+### 비대화형 CLI (신규)
+
+#### Node.js
+```bash
+# 쿼리정의 검증
+node app.js --mode=validate --xml=./queries/sample-queries.xml
+# 또는 JSON
+node app.js --mode=validate --query=./queries/sample-queries.json
+
+# DB 연결 테스트
+node app.js --mode=test
+
+# 엑셀 생성
+node app.js --mode=export --xml=./queries/sample-queries.xml
+# 또는 JSON
+node app.js --mode=export --query=./queries/sample-queries.json
+
+# 도움말
+node app.js --mode=help
+```
+
+#### 독립 실행 파일(EXE)
+```bash
+sql2excel.exe --mode=validate --xml=./queries/sample-queries.xml
+sql2excel.exe --mode=test
+sql2excel.exe --mode=export --xml=./queries/sample-queries.xml
+sql2excel.exe --mode=help
+```
+
 ## 🚀 빠른 시작
 
 ## 🛠️ 설치 및 설정

USER_MANUAL.md

@@ -229,6 +229,37 @@ node src/excel-cli.js list-styles
 sql2excel.exe list-styles
 ```
 
+## Non-interactive CLI (New in v1.2.10)
+
+Run tasks directly without the interactive menu using `--mode`.
+
+### Node.js
+```bash
+# Validate query definition
+node app.js --mode=validate --xml=./queries/sample-queries.xml
+# or JSON
+node app.js --mode=validate --query=./queries/sample-queries.json
+
+# Test DB connections
+node app.js --mode=test
+
+# Export Excel
+node app.js --mode=export --xml=./queries/sample-queries.xml
+# or JSON
+node app.js --mode=export --query=./queries/sample-queries.json
+
+# Help
+node app.js --mode=help
+```
+
+### Standalone EXE
+```bash
+sql2excel.exe --mode=validate --xml=./queries/sample-queries.xml
+sql2excel.exe --mode=test
+sql2excel.exe --mode=export --xml=./queries/sample-queries.xml
+sql2excel.exe --mode=help
+```
+
 ## 📋 Query Definition File Structure
 
 ### XML Format

USER_MANUAL_KR.md

@@ -229,6 +229,37 @@ node src/excel-cli.js list-styles
 sql2excel.exe list-styles
 ```
 
+## 비대화형 CLI (v1.2.10 신규)
+
+`--mode` 플래그를 사용해 대화형 메뉴 없이 바로 실행할 수 있습니다.
+
+### Node.js
+```bash
+# 쿼리 정의 검증
+node app.js --mode=validate --xml=./queries/sample-queries.xml
+# 또는 JSON
+node app.js --mode=validate --query=./queries/sample-queries.json
+
+# DB 연결 테스트
+node app.js --mode=test
+
+# 엑셀 내보내기
+node app.js --mode=export --xml=./queries/sample-queries.xml
+# 또는 JSON
+node app.js --mode=export --query=./queries/sample-queries.json
+
+# 도움말
+node app.js --mode=help
+```
+
+### 독립 실행 파일(EXE)
+```bash
+sql2excel.exe --mode=validate --xml=./queries/sample-queries.xml
+sql2excel.exe --mode=test
+sql2excel.exe --mode=export --xml=./queries/sample-queries.xml
+sql2excel.exe --mode=help
+```
+
 ## 📋 쿼리 정의 파일 구조
 
 ### XML 형식

app.js

@@ -576,6 +576,86 @@ async function showHelp() {
     await pause();
 }
 
+function getArgValue(name) {
+    const prefix = `--${name}=`;
+    const found = process.argv.find(a => a.startsWith(prefix));
+    return found ? found.substring(prefix.length) : null;
+}
+
+async function runValidateNonInteractive(filePath, type) {
+    if (!filePath || !type) {
+        process.exit(2);
+        return;
+    }
+    try {
+        if (process.pkg) {
+            const options = { configFilePath: path.join(APP_ROOT, 'config', 'dbinfo.json'), variables: {} };
+            if (type === 'XML') options.xmlFilePath = filePath; else options.queryFilePath = filePath;
+            const ok = await excelCli.validateQueryFile(options);
+            if (!ok) throw new Error('validation failed');
+        } else {
+            const cmd = type === 'XML'
+                ? `node src/excel-cli.js validate --xml "${filePath}"`
+                : `node src/excel-cli.js validate --query "${filePath}"`;
+            execSync(cmd, { cwd: APP_ROOT, stdio: 'inherit', encoding: 'utf8' });
+        }
+        process.exit(0);
+    } catch (e) {
+        process.exit(1);
+    }
+}
+
+async function runTestNonInteractive() {
+    try {
+        if (process.pkg) {
+            const configPath = path.join(APP_ROOT, 'config', 'dbinfo.json');
+            await excelCli.testAllDatabaseConnections(configPath);
+        } else {
+            execSync('node src/excel-cli.js list-dbs', { cwd: APP_ROOT, stdio: 'inherit', encoding: 'utf8' });
+        }
+        process.exit(0);
+    } catch (e) {
+        process.exit(1);
+    }
+}
+
+async function runExportNonInteractive(filePath, type) {
+    if (!filePath || !type) {
+        process.exit(2);
+        return;
+    }
+    try {
+        if (process.pkg) {
+            const originalArgv = process.argv;
+            const originalExit = process.exit;
+            process.exit = (code) => { if (code && code !== 0) throw new Error(String(code)); };
+            const filteredArgs = originalArgv.slice(2).filter(arg => !arg.startsWith('--lang='));
+            process.argv = type === 'XML'
+                ? ['node', 'src/excel-cli.js', 'export', '--xml', filePath, ...filteredArgs]
+                : ['node', 'src/excel-cli.js', 'export', '--query', filePath, ...filteredArgs];
+            try { await excelCli.main(); }
+            finally { process.argv = originalArgv; process.exit = originalExit; }
+        } else {
+            const cmd = type === 'XML'
+                ? `node src/excel-cli.js export --xml "${filePath}"`
+                : `node src/excel-cli.js export --query "${filePath}"`;
+            execSync(cmd, { cwd: APP_ROOT, stdio: 'inherit', encoding: 'utf8' });
+        }
+        process.exit(0);
+    } catch (e) {
+        process.exit(1);
+    }
+}
+
+async function runHelpNonInteractive() {
+    try {
+        await showHelp();
+        process.exit(0);
+    } catch (e) {
+        process.exit(1);
+    }
+}
+
 // 메인 메뉴
 async function mainMenu() {
     while (true) {
@@ -618,6 +698,33 @@ async function mainMenu() {
 // 프로그램 시작
 async function main() {
     try {
+        const mode = getArgValue('mode');
+        if (mode) {
+            const xml = getArgValue('xml');
+            const query = getArgValue('query');
+            if (mode === 'validate') {
+                const filePath = xml || query;
+                const type = xml ? 'XML' : (query ? 'JSON' : null);
+                await runValidateNonInteractive(filePath, type);
+                return;
+            }
+            if (mode === 'test') {
+                await runTestNonInteractive();
+                return;
+            }
+            if (mode === 'export') {
+                const filePath = xml || query;
+                const type = xml ? 'XML' : (query ? 'JSON' : null);
+                await runExportNonInteractive(filePath, type);
+                return;
+            }
+            if (mode === 'help') {
+                await runHelpNonInteractive();
+                return;
+            }
+            process.exit(2);
+            return;
+        }
         await mainMenu();
     } catch (error) {
         console.error(colors.red + `\n  ${msg.error} ${error.message}` + colors.reset);

package.json

@@ -1,6 +1,6 @@
 {
   "name": "sql2excel",
-  "version": "1.2.9",
+  "version": "1.2.10",
   "description": "SQL 쿼리 결과를 엑셀 파일로 저장하는 도구 (시트별 쿼리, 변수, XML/JSON 지원)",
   "main": "app.js",
   "scripts": {