shelljs

KO | EN

gitlite — search

#python #hacktoberfest #ai #typescript #llm #android #nodejs #windows #cli #kubernetes #awesome-list #security #ios #mcp

(★ 14,399)

:shell: Node.js를 위한 이식 가능한 Unix shell 명령어

파일 탐색기

최종 버전 다운로드 (.zip)

- - main.yml
- ISSUE_TEMPLATE.md
- SECURITY.md
- check-node-support.js
- generate-docs.js
- cat.js
- cd.js
- chmod.js
- cmd.js
- common.js
- cp.js
- dirs.js
- echo.js
- error.js
- errorCode.js
- exec-child.js
- exec.js
- find.js
- grep.js
- head.js
- ln.js
- ls.js
- mkdir.js
- mv.js
- popd.js
- pushd.js
- pwd.js
- rm.js
- sed.js
- set.js
- sort.js
- tail.js
- tempdir.js
- test.js
- to.js
- toEnd.js
- touch.js
- uniq.js
- which.js
- - a.txt
  - badlink
  - file1
  - file1.js
  - file1.txt
  - file2
  - file2.js
  - file2.txt
  - link
- - mocks.js
  - utils.js
- .eslintrc.json
- cat.js
- cd.js
- chmod.js
- cmd.js
- common.js
- config.js
- cp.js
- dirs.js
- docs.js
- echo.js
- env.js
- exec.js
- exit.js
- find.js
- global.js
- grep.js
- head.js
- ln.js
- ls.js
- mkdir.js
- mv.js
- pipe.js
- plugin.js
- popd.js
- pushd.js
- pwd.js
- rm.js
- sed.js
- set.js
- sort.js
- tail.js
- tempdir.js
- test.js
- to.js
- toEnd.js
- touch.js
- uniq.js
- which.js
.editorconfig
.eslintignore
.eslintrc.json
.gitattributes
.gitignore
CHANGELOG.md
CONTRIBUTING.md
global.js
LICENSE
make.js
package-lock.json
package.json
plugin.js
README.md
RELEASE.md
shell.js

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ShellJS - Node.js를 위한 유닉스 쉘 명령어
[![GitHub Actions](https://img.shields.io/github/actions/workflow/status/shelljs/shelljs/main.yml?style=flat-square&logo=github)](https://github.com/shelljs/shelljs/actions/workflows/main.yml)
[![Codecov](https://img.shields.io/codecov/c/github/shelljs/shelljs/main.svg?style=flat-square&label=coverage)](https://codecov.io/gh/shelljs/shelljs)
[![npm version](https://img.shields.io/npm/v/shelljs.svg?style=flat-square)](https://www.npmjs.com/package/shelljs)
[![npm downloads](https://img.shields.io/npm/dm/shelljs.svg?style=flat-square)](https://www.npmjs.com/package/shelljs)
ShellJS는 Node.js API 기반으로 유닉스 쉘 명령어를 포식성 있게 구현한 \*\*(Windows/Linux/macOS)\*\* 라이브러리입니다. 이를 사용하여 친숙하고 강력한 유닉스 명령어를 유지하면서 쉘 스크립트의 유닉스 의존성을 없앨 수 있습니다. 또한 전역으로 설치하여 Node 프로젝트 외부에서도 실행할 수 있습니다. 복잡한 Bash 스크립트와는 이제 작별하세요!
ShellJS는 `v18` 이후의 모든 LTS Node 릴리스에서 철저한 테스트를 거칩니다!
이 프로젝트는 다음과 같은 프로젝트에서 유닛 테스트 및 실전 테스트를 거쳤습니다:
+ [Firebug](http://getfirebug.com/) - 파이어폭스의 유명한 디버거
+ [JSHint](http://jshint.com) 및 [ESLint](http://eslint.org/) - 인기 있는 자바스크립트 린터
+ [Zepto](http://zeptojs.com) - 모던 브라우저를 위한 jQuery 호환 자바스크립트 라이브러리
+ [Yeoman](http://Yeoman.io/) - 웹 애플리케이션 스택 및 개발 도구
+ [Deployd.com](http://deployd.com) - 빠른 API 백엔드 생성을 위한 오픈 소스 PaaS
+ 그 외 [다수](https://npmjs.org/browse/depended/shelljs).
피드백, 제안 사항이 있거나 도움이 필요하시면 언제든지 [이슈 트래커](https://github.com/shelljs/shelljs/issues)에 글을 남겨주세요.
ShellJS가 마음에 드시나요? [위키 페이지](https://github.com/shelljs/shelljs/wiki)에서 관련 프로젝트들도 확인해 보세요!
이전 버전에서 업그레이드하시나요? 업그레이드 시 주의해야 할 변경 사항은 [Breaking Changes](https://github.com/shelljs/shelljs/wiki/Breaking-Changes) 페이지에서 확인하세요.

## 커맨드 라인 사용법
크로스 플랫폼 유닉스 명령어만 필요하다면 `shelljs`를 커맨드 라인에서 사용할 수 있게 해주는 유틸리티인 새 프로젝트 [shelljs/shx](https://github.com/shelljs/shx)를 확인해 보세요.
예시:
```
$ shx mkdir -p foo
$ shx touch foo/bar.txt
$ shx rm -rf foo
```

## 플러그인 API
ShellJS는 이제 서드파티 플러그인을 지원합니다! 플러그인 사용법과 나만의 ShellJS 명령어 작성 방법에 대한 자세한 내용은 [위키](https://github.com/shelljs/shelljs/wiki/Using-ShellJS-Plugins)에서 확인할 수 있습니다.

## 문서에 대한 간단한 참고 사항
최신 기능에 대한 문서는 [README](https://github.com/shelljs/shelljs)를 확인하세요. 최신 릴리스와 일치하는 문서를 보려면 [npm 페이지](https://www.npmjs.com/package/shelljs)를 확인하세요.

## 설치 방법
npm을 통한 설치:
```bash
$ npm install [-g] shelljs
```

## 예시
```javascript
var shell = require('shelljs');
if (!shell.which('git')) {
shell.echo('Sorry, this script requires git');
shell.exit(1);
}
// Copy files to release dir
shell.rm('-rf', 'out/Release');
shell.cp('-R', 'stuff/', 'out/Release');
// Replace macros in each .js file
shell.cd('lib');
shell.ls('\*.js').forEach(function (file) {
shell.sed('-i', 'BUILD\_VERSION', 'v0.1.2', file);
shell.sed('-i', /^.\*REMOVE\_THIS\_LINE.\*$/, '', file);
shell.sed('-i', /.\*REPLACE\_LINE\_WITH\_MACRO.\*\n/, shell.cat('macro.js'), file);
});
shell.cd('..');
// Run external tool synchronously
if (shell.exec('git commit -am "Auto-commit"').code !== 0) {
shell.echo('Error: Git commit failed');
shell.exit(1);
}
```

## 제외 옵션
옵션처럼 보이는 파라미터를 전달해야 하는 경우 다음과 같이 할 수 있습니다:
```js
shell.grep('--', '-v', 'path/to/file'); // Search for "-v", no grep options
shell.cp('-R', '-dir', 'outdir'); // If already using an option, you're done
```

## 전역 대 로컬
더 이상 ShellJS에 대한 전역 임포트(예: `require('shelljs/global')`) 사용을 권장하지 않습니다. 편의를 위해 여전히 지원되지만, 이는 전역 네임스페이스를 오염시키므로 피해야 합니다.

이전에 주의해서만 사용해야 했습니다.
대신, 로컬 임포트를 권장합니다 (npm 패키지의 표준):
```javascript
var shell = require('shelljs');
shell.echo('hello world');
```
또는 다음과 같이 모듈로 임포트하는 방식도 지원합니다:
```javascript
import shell from 'shelljs';
shell.echo('hello world');
```
## 명령어 참조
별도로 명시되지 않는 한, 모든 명령어는 동기적으로 실행됩니다.
모든 명령어는 [`fast-glob`](https://www.npmjs.com/package/fast-glob)과 호환되는 표준 bash 글로빙 문자(`\*`, `?` 등)를 허용합니다.
자주 사용되지 않는 명령어와 기능에 대해서는 [위키 페이지](https://github.com/shelljs/shelljs/wiki)를 확인해 주세요.
### cat([options,] file [, file ...])
### cat([options,] file\_array)
사용 가능한 옵션:
+ `-n`: 모든 출력 라인에 번호 매기기
예시:
```javascript
var str = cat('file\*.txt');
var str = cat('file1', 'file2');
var str = cat(['file1', 'file2']); // 위와 동일함
```
지정된 파일을 포함하는 [ShellString](#shellstringstr)을 반환하거나, 둘 이상의 파일이 지정된 경우 파일들을 결합한 문자열을 반환합니다 (각 파일 사이에 개행 문자가 삽입됩니다).
### cd([dir])
스크립트가 실행되는 동안 디렉터리를 `dir`(으)로 변경합니다. 인자가 제공되지 않으면 홈 디렉터리로 이동합니다. 성공 또는 실패를 나타내는 [ShellString](#shellstringstr)을 반환합니다.
### chmod([options,] octal\_mode || octal\_string, file)
### chmod([options,] symbolic\_mode, file)
사용 가능한 옵션:
+ `-v`: 처리된 모든 파일에 대한 진단 정보 출력
+ `-c`: verbose와 유사하지만, 변경이 발생했을 때만 보고
+ `-R`: 파일과 디렉터리를 재귀적으로 변경
예시:
```javascript
chmod(755, '/Users/brandon');
chmod('755', '/Users/brandon'); // 위와 동일함
chmod('u+x', '/Users/brandon');
chmod('-R', 'a-w', '/Users/brandon');
```
8진수 형태로 절대 권한을 지정하거나 기호로 변경 사항을 표현하여 파일 또는 디렉터리의 권한을 수정합니다.
이 명령어는 POSIX 동작을 최대한 모방하려고 시도합니다.
주요 예외 사항:
+ 심볼릭 모드에서 `a-r`과 `-r`은 동일합니다. `umask`는 고려되지 않습니다.
+ 기본 동작이 조용히 실행되는 것이므로 "quiet" 옵션이 없습니다.
+ Windows OS는 POSIX와 매우 다른 권한 모델을 사용합니다. `chmod()`는 Windows에서 최선을 다하지만, 파일 권한을 설정하는 데는 한계가 있습니다. WSL(Windows subsystem for Linux)은 POSIX를 준수하므로, 크로스 플랫폼 호환성은 걱정할 필요가 없습니다.
성공 또는 실패를 나타내는 [ShellString](#shellstringstr)을 반환합니다.
### cmd(arg1[, arg2, ...] [, options])
사용 가능한 옵션:
+ `cwd: directoryPath`: 이번 cmd() 호출에 대해서만 현재 작업 디렉터리를 변경합니다.
+ `maxBuffer: num`: stdout/stderr의 기본 버퍼 크기를 늘리거나 줄입니다.
+ `timeout`: 기본 타임아웃을 변경합니다.
예시:
```javascript
var version = cmd('node', '--version').stdout;
cmd('git', 'commit', '-am', `Add suport for node ${version}`);
console.log(cmd('echo', '1st arg', '2nd arg', '3rd arg').stdout)
console.log(cmd('echo', 'this handles ;, |, &, etc. as literal characters').stdout)
```
주어진 명령어를 동기적으로 실행합니다. 이는 [exec()](#execcommand--options--callback)의 더 쉬운 대안으로 의도되었으며, 글로빙, 명령어 주입, 변수 확장과 관련된 보안이 개선되었습니다. 이는 단 하나의 외부 명령어만 실행하도록 보장되며, 쉘 문자에 특별한 의미를 부여하지 않습니다(예: `|`를 쉘 파이프라인이 아닌 리터럴 문자로 취급합니다).
이는 [ShellString](#shellstringstr)을 반환합니다.
기본적으로 모든 플랫폼에서 글로빙을 수행하지만, `set('-f')`를 사용하여 이를 비활성화할 수 있습니다.
이는 비동기 모드를 **지원하지 않습니다**. 비동기 명령어 실행이 필요한 경우, 대신 [execa](https://www.npmjs.com/package/execa) 또는 node 내장 `child\_process.execFile()`을 확인해 보세요.
### cp([options,] source [, source ...], dest)
### cp([options,] source\_array, dest)
사용 가능한 옵션:
+ `-f`: 강제 실행 (기본 동작)
+ `-n`: 덮어쓰기 방지
+ `-u`:

`source`가 `dest`보다 최신인 경우에만 복사
+ `-r`, `-R`: 재귀적 복사
+ `-L`: 심볼릭 링크를 따름
+ `-P`: 심볼릭 링크를 따르지 않음
+ `-p`: 파일 모드, 소유권, 타임스탬프를 보존함
예제:
```javascript
cp('file1', 'dir1');
cp('-R', 'path/to/dir/', '~/newCopy/');
cp('-Rf', '/tmp/\*', '/usr/local/\*', '/home/tmp');
cp('-Rf', ['/tmp/\*', '/usr/local/\*'], '/home/tmp'); // 위와 동일함
```
파일을 복사합니다. 성공 또는 실패를 나타내는 [ShellString](#shellstringstr)을 반환합니다.
### pushd([options,] [dir | '-N' | '+N'])
사용 가능한 옵션:
+ `-n`: 스택에 디렉터리를 추가할 때 디렉터리 변경을 생략하고 스택만 조작합니다.
+ `-q`: 콘솔 출력을 억제합니다.
인수:
+ `dir`: 현재 작업 디렉터리를 스택의 맨 위로 설정한 후, `cd dir`과 동등한 작업을 실행합니다.
+ `+N`: 스택을 회전하여 (dirs가 출력하는 목록의 왼쪽에서 시작하여 0부터 카운트) N번째 디렉터리를 목록의 맨 위로 가져옵니다.
+ `-N`: 스택을 회전하여 (dirs가 출력하는 목록의 오른쪽에서 시작하여 0부터 카운트) N번째 디렉터리를 목록의 맨 위로 가져옵니다.
예제:
```javascript
// process.cwd() === '/usr'
pushd('/etc'); // Returns /etc /usr
pushd('+1'); // Returns /usr /etc
```
현재 디렉터리를 디렉터리 스택의 맨 위에 저장한 후 `dir`로 `pushd`합니다. 인수가 없는 경우, `pushd`는 상위 두 디렉터리를 서로 교환합니다. 스택 내 경로들의 배열을 반환합니다.
### popd([options,] ['-N' | '+N'])
사용 가능한 옵션:
+ `-n`: 스택에서 디렉터리를 제거할 때 일반적인 디렉터리 변경을 생략하여 스택만 조작되도록 합니다.
+ `-q`: 콘솔 출력을 억제합니다.
인수:
+ `+N`: (dirs가 출력하는 목록의 왼쪽에서 시작하여 0부터 카운트하여) N번째 디렉터리를 제거합니다.
+ `-N`: (dirs가 출력하는 목록의 오른쪽에서 시작하여 0부터 카운트하여) N번째 디렉터리를 제거합니다.
예제:
```javascript
echo(process.cwd()); // '/usr'
pushd('/etc'); // '/etc /usr'
echo(process.cwd()); // '/etc'
popd(); // '/usr'
echo(process.cwd()); // '/usr'
```
인수가 주어지지 않으면, `popd`는 스택에서 최상위 디렉터리를 제거하고 새로운 최상위 디렉터리로 `cd`를 수행합니다. 요소들은 dirs로 나열된 첫 번째 디렉터리부터 0부터 시작하여 번호가 매겨집니다 (즉, `popd`는 `popd +0`과 동일합니다). 스택 내 경로들의 배열을 반환합니다.
### dirs([options | '+N' | '-N'])
사용 가능한 옵션:
+ `-c`: 모든 요소를 삭제하여 디렉터리 스택을 비웁니다.
+ `-q`: 콘솔 출력을 억제합니다.
인수:
+ `+N`: (옵션 없이 호출했을 때 dirs가 출력하는 목록의 왼쪽에서 시작하여 0부터 카운트하여) N번째 디렉터리를 표시합니다.
+ `-N`: (옵션 없이 호출했을 때 dirs가 출력하는 목록의 오른쪽에서 시작하여 0부터 카운트하여) N번째 디렉터리를 표시합니다.
현재 기억된 디렉터리 목록을 표시합니다. 스택의 경로 배열을 반환하며, `+N` 또는 `-N`이 지정된 경우 단일 경로를 반환합니다.
참조: `pushd`, `popd`
### echo([options,] string [, string ...])
사용 가능한 옵션:
+ `-e`: 백슬래시스케이프 해석 (기본값)
+ `-n`: 출력의 마지막 줄바꿈 제거
예제:
```javascript
echo('hello world');
var str = echo('hello world');
echo('-n', 'no newline at end');
```
`string`을 stdout에 출력하고 [ShellString](#shellstringstr)을 반환합니다.
### exec(command [, options] [, callback])
사용 가능한 옵션:
+ `async`: 비동기 실행. 콜백이 제공된 경우 전달된 값과 관계없이 `true`로 설정됩니다 (기본값: `false`).
+ `fatal`: 오류 발생 시 종료 (기본값: `false`).
+ `silent`: 프로그램 출력을 콘솔에 에코하지 않음 (기본값: `false`).
+ `encoding`: 사용할 문자 인코딩. stdout 및 stderr로 반환되는 값과, silent 모드가 아닐 때 stdout 및 stderr에 기록되는 내용에 영향을 줍니다 (기본값: `'utf8'`).
+ 그리고 Node.js의 [`child\_process.exec()`](https://nodejs.org/api/child\_process.html#child\_process\_child\_process\_exec\_command\_options\_callback)에서 사용할 수 있는 모든 옵션
예제:
```javascri

pt
var version = exec('node --version', {silent:true}).stdout;
var child = exec('some\_long\_running\_process', {async:true});
child.stdout.on('data', function(data) {
/\* ... 데이터로 무언가를 수행 ... \*/
});
exec('some\_long\_running\_process', function(code, stdout, stderr) {
console.log('Exit code:', code);
console.log('Program output:', stdout);
console.log('Program stderr:', stderr);
});
```
달리 명시되지 않는 한, 주어진 `command`를 \_동기식\_으로 실행합니다.
동기 모드일 때, 이는 [ShellString](#shellstringstr)을 반환합니다.
그렇지 않은 경우, 자식 프로세스 객체를 반환하며 `callback`은 `(code, stdout, stderr)` 인자를 받습니다.
원하는 동작이 나오지 않나요? `exec()`은 기본적으로 모든 것을 `sh`(Windows의 경우 `cmd.exe`)를 통해 실행하며, 이는 `bash`와 다릅니다. bash 고유의 동작이 필요한 경우 `{shell: 'path/to/bash'}` 옵션을 시도해 보세요.
\*\*보안 참고사항:\*\* `shell.exec()`은 시스템 셸에서 임의의 문자열을 실행하므로, \*\*명령어 주입(command injection)\*\*을 방지하기 위해 사용자 입력을 적절히 살균(sanitize)하는 것이 \*\*매우 중요합니다\*\*. 자세한 내용은 [Security Guidelines](https://github.com/shelljs/shelljs/wiki/Security-guidelines)를 참조하세요.
### find(path [, path ...])
### find(path\_array)
예시:
```javascript
find('src', 'lib');
find(['src', 'lib']); // 위와 동일함
find('.').filter(function(file) { return file.match(/\.js$/); });
```
주어진 경로에 있는 모든 파일(하위 디렉토리 포함)을 포함하는 (배열과 유사한 속성을 가진) [ShellString](#shellstringstr)을 반환합니다.
`ls('-R', path)`와의 주요 차이점은 결과 파일 이름에 베이스 디렉토리가 포함된다는 점입니다 (예: 단순히 `file1` 대신 `lib/resources/file1`).
### grep([options,] regex\_filter, file [, file ...])
### grep([options,] regex\_filter, file\_array)
사용 가능한 옵션:
+ `-v`: `regex\_filter` 반전 (일치하지 않는 줄만 출력).
+ `-l`: 일치하는 파일의 파일 이름만 출력.
+ `-i`: 대소문자 무시.
+ `-n`: 줄 번호 출력.
+ `-B `: 각 결과 앞에 `` 줄을 표시합니다.
+ `-A `: 각 결과 뒤에 `` 줄을 표시합니다.
+ `-C `: 각 결과 앞뒤로 `` 줄을 표시합니다. -B와 -A는 이 옵션을 재정의합니다.
예시:
```javascript
grep('-v', 'GLOBAL\_VARIABLE', '\*.js');
grep('GLOBAL\_VARIABLE', '\*.js');
grep('-B', 3, 'GLOBAL\_VARIABLE', '\*.js');
grep({ '-B': 3 }, 'GLOBAL\_VARIABLE', '\*.js');
grep({ '-B': 3, '-C': 2 }, 'GLOBAL\_VARIABLE', '\*.js');
```
주어진 파일에서 입력 문자열을 읽고, 주어진 `regex\_filter`와 일치하는 파일의 모든 줄이 포함된 [ShellString](#shellstringstr)을 반환합니다.
### head([{'-n': \},] file [, file ...])
### head([{'-n': \},] file\_array)
사용 가능한 옵션:
+ `-n `: 파일의 처음 `` 줄을 표시합니다.
예시:
```javascript
var str = head({'-n': 1}, 'file\*.txt');
var str = head('file1', 'file2');
var str = head(['file1', 'file2']); // 위와 동일함
```
`file`의 시작 부분을 읽습니다. [ShellString](#shellstringstr)을 반환합니다.
### ln([options,] source, dest)
사용 가능한 옵션:
+ `-s`: 심볼릭 링크
+ `-f`: 강제 실행
예시:
```javascript
ln('file', 'newlink');
ln('-sf', 'file', 'existing');
```
`source`를 `dest`에 링크합니다. `dest`가 이미 존재하는 경우 강제로 링크하려면 `-f`를 사용하세요. 성공 또는 실패를 나타내는 [ShellString](#shellstringstr)을 반환합니다.
### ls([options,] [path, ...])
### ls([options,] path\_array)
사용 가능한 옵션:
+ `-R`: 재귀적 탐색
+ `-A`: 모든 파일 (`.` 및 `..`를 제외하고 `.`으로 시작하는 파일 포함)
+ `-L`: 심볼릭 링크 따라가기
+ `-d`: 내용이 아닌 디렉토리 자체 나열
+ `-l`: 각 파일에 대한 더 자세한 정보를 제공합니다. 구체적으로, 각 파일은 파일 메타데이터에 대한 별도의 필드가 있는 구조화된 객체로 표현됩니다([`fs.Stats`](https://nodejs.org/api/fs.html#fs\_class\_fs\_stats) 참조). 반환 값은 가독성을 위해 `ls -l`의 출력 형식과 유사하도록 `.toString()`을 재정의하지만, 프로그래밍 방식의 사용은 `.toString()` 표현보다는 안정적인 객체 형식에 의존해야 합니다.
예시:
```javascript
ls('projs/\*.js');
ls('projs/\*\*/\*.js'); // 모든 js 파일을 재귀적으로 찾기

in projs
ls('-R', '/users/me', '/tmp');
ls('-R', ['/users/me', '/tmp']); // 위와 동일함
ls('-l', 'file.txt'); // { name: 'file.txt', mode: 33188, nlink: 1, ...}
```
지정한 `path`에 있는 모든 파일(또는 `path`가 제공되지 않은 경우 현재 디렉터리의 파일들)의 배열과 유사한 속성을 가진 [ShellString](#shellstringstr)을 반환합니다.
### mkdir([options,] dir [, dir ...])
### mkdir([options,] dir\_array)
사용 가능한 옵션:
+ `-p`: 전체 경로 (필요한 경우 중간 디렉터리도 생성)
예시:
```javascript
mkdir('-p', '/tmp/a/b/c/d', '/tmp/e/f/g');
mkdir('-p', ['/tmp/a/b/c/d', '/tmp/e/f/g']); // 위와 동일함
```
디렉터리를 생성합니다. 성공 또는 실패를 나타내는 [ShellString](#shellstringstr)을 반환합니다.
### mv([options ,] source [, source ...], dest')
### mv([options ,] source\_array, dest')
사용 가능한 옵션:
+ `-f`: 강제 실행 (기본 동작)
+ `-n`: 덮어쓰기 방지 (no-clobber)
예시:
```javascript
mv('-n', 'file', 'dir/');
mv('file1', 'file2', 'dir/');
mv(['file1', 'file2'], 'dir/'); // 위와 동일함
```
`source` 파일을 `dest`(으)로 이동합니다. 성공 또는 실패를 나타내는 [ShellString](#shellstringstr)을 반환합니다.
### pwd()
현재 디렉터리를 [ShellString](#shellstringstr)(으)로 반환합니다.
### rm([options,] file [, file ...])
### rm([options,] file\_array)
사용 가능한 옵션:
+ `-f`: 강제 실행
+ `-r, -R`: 재귀적(recursive) 실행
예시:
```javascript
rm('-rf', '/tmp/\*');
rm('some\_file.txt', 'another\_file.txt');
rm(['some\_file.txt', 'another\_file.txt']); // 위와 동일함
```
파일을 삭제합니다. 성공 또는 실패를 나타내는 [ShellString](#shellstringstr)을 반환합니다.
### sed([options,] search\_regex, replacement, file [, file ...])
### sed([options,] search\_regex, replacement, file\_array)
사용 가능한 옵션:
+ `-i`: `file`의 내용을 그 자리에서(in-place) 직접 수정합니다. \_백업은 생성되지 않으므로 주의하세요!\_
예시:
```javascript
sed('-i', 'PROGRAM\_VERSION', 'v0.1.3', 'source.js');
```
`file`들로부터 입력 문자열을 한 줄씩 읽어 들인 후, 주어진 `search\_regex` 및 `replacement` 문자열(또는 함수)을 사용하여 입력 문자열의 각 라인에 JavaScript `replace()`를 수행합니다. 교체가 완료된 새로운 [ShellString](#shellstringstr)을 반환합니다.
참고:
유닉스의 `sed`와 마찬가지로, ShellJS의 `sed`는 캡처 그룹을 지원합니다. 캡처 그룹은 `$n` 구문을 사용하여 지정합니다:
```javascript
sed(/(\w+)\s(\w+)/, '$2, $1', 'file.txt');
```
또한 유닉스 `sed`와 유사하게, ShellJS `sed`는 입력 파일의 각 라인(('\n'으로 분리됨)에 대해 각각 별도로 교체 작업을 수행하므로, 둘 이상의 라인에 걸쳐 있는(또는 '\n'을 포함하는) `search\_regex`는 어떤 내용도 일치시키지 못하며 아무것도 교체되지 않습니다.
### set(options)
사용 가능한 옵션:
+ `+/-e`: 에러 발생 시 종료 (`config.fatal`)
+ `+/-v`: 자세한 출력: 모든 명령어 표시 (`config.verbose`)
+ `+/-f`: 파일 이름 확장(글로빙, globbing) 비활성화
예시:
```javascript
set('-e'); // 첫 번째 에러 발생 시 종료
set('+e'); // "set('-e')" 설정을 취소함
```
전역 설정 변수를 설정합니다.
### sort([options,] file [, file ...])
### sort([options,] file\_array)
사용 가능한 옵션:
+ `-r`: 결과 반전
+ `-n`: 수치(숫자) 값에 따라 비교
예시:
```javascript
sort('foo.txt', 'bar.txt');
sort('-r', 'foo.txt');
```
`file`들의 내용을 줄 단위로 정렬하여 [ShellString](#shellstringstr)(으)로 반환합니다. 여러 파일을 정렬하면 (유닉스 `sort`와 마찬가지로) 그 내용이 서로 섞입니다.
### tail([{'-n': \},] file [, file ...])
### tail([{'-n': \},] file\_array)
사용 가능한 옵션:
+ `-n `: `file`의 마지막 `` 줄을 표시합니다.
Examples:
```javascript
var str = tail({'-n': 1}, 'file\*.txt');
var str = tail('file1', 'file2');
var str = tail(['file1', 'file2']); // 위와 동일함
```
파일의 끝부분을 읽습니다. [ShellString](#shellstringstr)을 반환합니다.
### tempdir()
예시:
```javascript
var tmp = tempdir(); // 대부분의 \*nix 플랫폼에서는 "/tmp"
```
쓰기가 가능하고 플랫폼에 종속적인 임시 디렉터리를 찾아 해당 문자열을 반환합니다.
파이썬의 [tempfile 알고리즘](http://docs.python.org/library/tempfile.html#tempfile.tempdir)을 따릅니다.
### test(expression)
사용 가능한 표현식 기본 요소:
+ `'-

+ `'-b', 'path'`: path가 블록 디바이스인 경우 참
+ `'-c', 'path'`: path가 문자 디바이스인 경우 참
+ `'-d', 'path'`: path가 디바이스인 경우 참
+ `'-e', 'path'`: path가 존재하는 경우 참
+ `'-f', 'path'`: path가 일반 파일인 경우 참
+ `'-L', 'path'`: path가 심볼릭 링크인 경우 참
+ `'-p', 'path'`: path가 파이프(FIFO)인 경우 참
+ `'-S', 'path'`: path가 소켓인 경우 참
Examples:
```javascript
if (test('-d', path)) { /* do something with dir */ };
if (!test('-f', path)) continue; // skip if it's not a regular file
```
사용 가능한 기본 검사(primary)를 사용하여 `expression`을 평가하고
해당하는 부울(boolean) 값을 반환합니다.
### ShellString.prototype.to(file)
Examples:
```javascript
cat('input.txt').to('output.txt');
```
Unix의 리다이렉션 연산자 `>`와 유사하지만, (`cat`, `grep` 등이 반환하는 것과 같은) `ShellStrings`와 함께 작동합니다. \_Unix 리다이렉션과 마찬가지로 `to()`는 기존 파일을 덮어씁니다!\_ 체이닝을 지원하기 위해 이 메서드가 실행된 동일한 [ShellString](#shellstringstr)을 반환합니다.
### ShellString.prototype.toEnd(file)
Examples:
```javascript
cat('input.txt').toEnd('output.txt');
```
Unix의 리다이렉트 앤드 어펜드(redirect-and-append) 연산자 `>>`와 유사하지만, (`cat`, `grep` 등이 반환하는 것과 같은) `ShellStrings`와 함께 작동합니다. 체이닝을 지원하기 위해 이 메서드가 실행된 동일한 [ShellString](#shellstringstr)을 반환합니다.
### touch([options,] file [, file ...])
### touch([options,] file_array)
Available options:
+ `-a`: 액세스 시간만 변경
+ `-c`: 파일을 생성하지 않음
+ `-m`: 수정 시간만 변경
+ `{'-d': someDate}`, `{date: someDate}`: 현재 시간 대신 `Date` 인스턴스(예: `someDate`) 사용
+ `{'-r': file}`, `{reference: file}`: 현재 시간 대신 `file`의 시간 사용
Examples:
```javascript
touch('source.js');
touch('-c', 'path/to/file.js');
touch({ '-r': 'referenceFile.txt' }, 'path/to/file.js');
touch({ '-d': new Date('December 17, 1995 03:24:00'), '-m': true }, 'path/to/file.js');
touch({ date: new Date('December 17, 1995 03:24:00') }, 'path/to/file.js');
```
각 파일의 액세스 및 수정 시간을 현재 시간으로 업데이트합니다.
`-c`가 제공되지 않는 한, 존재하지 않는 파일 인자는 빈 파일로 생성됩니다.
이는 [`touch(1)`](http://linux.die.net/man/1/touch)의 부분적인 구현입니다. 성공 또는 실패를 나타내는 [ShellString](#shellstringstr)을 반환합니다.
### uniq([options,] [input, [output]])
Available options:
+ `-i`: 비교 시 대소문자 무시
+ `-c`: 줄 앞에 발생 횟수 추가
+ `-d`: 동일한 줄 그룹당 하나씩, 중복된 줄만 출력
Examples:
```javascript
uniq('foo.txt');
uniq('-i', 'foo.txt');
uniq('-cd', 'foo.txt', 'bar.txt');
```
`input`에서 인접한 일치하는 줄을 필터링합니다. [ShellString](#shellstringstr)을 반환합니다.
### which(command)
Examples:
```javascript
var nodeExec = which('node');
```
시스템의 `PATH`에서 `command`를 검색합니다. Windows에서는 아직 실행 파일이 아닌 경우 `PATHEXT` 변수를 사용하여 확장자를 추가합니다. `command`의 절대 경로가 포함된 [ShellString](#shellstringstr)을 반환합니다.
### exit(code)
지정된 종료 `code`로 현재 프로세스를 종료합니다.
### error()
마지막 명령어에서 오류가 발생했는지 테스트합니다. 오류가 반환된 경우 참 같은(truthy) 값을 반환하고, 그렇지 않으면 거짓 같은(falsy) 값을 반환합니다.
\*\*참고\*\*: 반환 값이 오류 메시지일 것이라고 의존하지 마세요. 마지막 오류 메시지가 필요한 경우, 대신 마지막 명령어의 반환 값에서 `.stderr` 속성을 사용하세요.
### errorCode()
마지막 명령어의 오류 코드를 반환합니다.
### ShellString(str)
Examples:
```javascript
var foo = new ShellString('hello world');
```
이것은 대부분의 ShellJS 메서드가 반환하는 전용 타입으로, 문자열(또는 배열) 값을 감쌉니다(wrap). 이는 모든 문자열(또는 배열) 메서드를 가지고 있으며, [`.to()`](#shellstringprototypetofile), [`.toEnd()`](#shellstringprototypetoendfile) 및 모든 파이프 가능한 메서드(예: `.cat()`, `.grep()` 등)도 제공합니다. `.toString()`을 호출하여 쉽게 문자열로 변환할 수 있습니다.
이 타입은 또한 다음을 제공합니다.

해당 명령어의 stdout, stderr 및
반환 상태 코드를 각각 `.stdout`(문자열), `.stderr`(문자열),
`.code`(숫자) 속성을 통해 반환합니다.
### env['VAR\_NAME']
환경 변수를 포함하는 객체입니다 (getter와 setter 모두 지원). `process.env`의
단축 형태입니다.
### Pipes
예시:
```javascript
grep('foo', 'file1.txt', 'file2.txt').sed(/o/g, 'a').to('output.txt');
echo("files with o's in the name:\n" + ls().grep('o'));
cat('test.js').exec('node'); // pipe to exec() call
```
명령어는 파이프와 유사한 방식으로 출력을 다른 명령어로 보낼 수 있습니다.
`sed`, `grep`, `cat`, `exec`, `to`, `toEnd`는 파이프의 오른쪽에
위치할 수 있습니다. 파이프는 체인 형태로 연결할 수 있습니다.
## Configuration
### config.silent
예시:
```javascript
var sh = require('shelljs');
var silentState = sh.config.silent; // save old silent state
sh.config.silent = true;
/\* ... \*/
sh.config.silent = silentState; // restore old silent state
```
`true`로 설정하면 `echo()` 호출을 제외한 모든 명령어 출력을 억제합니다.
기본값은 `false`입니다.
### config.fatal
예시:
```javascript
require('shelljs/global');
config.fatal = true; // or set('-e');
cp('this\_file\_does\_not\_exist', '/dev/null'); // throws Error here
/\* more commands... \*/
```
`true`로 설정하면, shell.js 명령어가 에러를 마주칠 때 스크립트가 Javascript 에러를 발생시킵니다. 기본값은 `false`입니다. 이는 Bash의 `set -e`와 유사합니다.
### config.verbose
예시:
```javascript
config.verbose = true; // or set('-v');
cd('dir/');
rm('-rf', 'foo.txt', 'bar.txt');
exec('echo hello');
```
각 명령어를 다음과 같이 출력합니다:
```
cd dir/
rm -rf foo.txt bar.txt
exec echo hello
```
### config.globOptions (deprecated)
\*\*Deprecated\*\*: `config.globOptions`를 수정하지 않는 것을 권장합니다.
이 설정 옵션에 대한 지원은 향후 ShellJS 릴리스에서 변경되거나 제거될 수 있습니다.
\*\*Breaking change\*\*: ShellJS v0.8.x는 `node-glob`을 사용합니다. ShellJS v0.9.x부터는 `config.globOptions`가 `fast-glob`과 호환됩니다.
예시:
```javascript
config.globOptions = {nodir: true};
```
`config.globOptions`는 ShellJS가 글로브(와일드카드) 표현식을 확장하는 방식을 변경합니다.
사용 가능한 옵션은 [fast-glob](https://github.com/mrmlnc/fast-glob?tab=readme-ov-file#options-3)을
참조하세요. `config.globOptions`를 수정하면 \*\*ShellJS 기능이 작동하지 않을 수 있으니\*\* 주의하세요.
### config.reset()
예시:
```javascript
var shell = require('shelljs');
// Make changes to shell.config, and do stuff...
/\* ... \*/
shell.config.reset(); // reset to original state
// Do more stuff, but with original settings
/\* ... \*/
```
`shell.config`를 기본값으로 재설정합니다:
```javascript
{
fatal: false,
globOptions: {},
maxdepth: 255,
noglob: false,
silent: false,
verbose: false,
}
```
## Team
| [![Nate Fischer](https://avatars.githubusercontent.com/u/5801521?s=130)](https://github.com/nfischer) |
|:---:|
| [Nate Fischer](https://github.com/nfischer) |

shelljs

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

shelljs

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README