Security News
Opengrep Emerges as Open Source Alternative Amid Semgrep Licensing Controversy
Opengrep forks Semgrep to preserve open source SAST in response to controversial licensing changes.
The shx npm package provides a way to use shell commands in a cross-platform manner. It allows you to run common shell commands like `cp`, `rm`, `mv`, `echo`, and more, directly from your Node.js scripts or npm scripts, ensuring compatibility across different operating systems.
Copy files
This command copies a file from `source.txt` to `destination.txt`. It works across different operating systems without needing to worry about platform-specific syntax.
shx cp source.txt destination.txt
Remove files or directories
This command removes a file or directory at the specified path. The `-rf` flags ensure that the removal is recursive and forces the deletion without prompting.
shx rm -rf path/to/directory
Move or rename files
This command moves or renames a file from `oldname.txt` to `newname.txt`. It provides a simple way to handle file renaming or moving operations.
shx mv oldname.txt newname.txt
Echo text
This command prints the text 'Hello, World!' to the console. It can be used to output messages or variables in scripts.
shx echo 'Hello, World!'
Create directories
This command creates a new directory at the specified path. The `-p` flag ensures that any necessary parent directories are also created.
shx mkdir -p path/to/new/directory
ShellJS is a portable (Windows/Linux/macOS) implementation of Unix shell commands on top of the Node.js API. It provides a similar set of functionalities as shx, allowing you to run shell commands in a cross-platform way. However, ShellJS is more of a library that you can use within your Node.js scripts, whereas shx is designed to be used directly in npm scripts.
fs-extra is a package that extends the native Node.js `fs` module with additional methods like `copy`, `remove`, and `mkdirp`. While it doesn't provide a direct shell-like interface, it offers similar file system manipulation capabilities with a focus on ease of use and additional features.
rimraf is a package specifically designed to delete files and directories, similar to the `rm -rf` command. It is highly reliable and handles various edge cases, making it a good alternative for file and directory removal tasks.
shx
is a wrapper around ShellJS Unix
commands, providing an easy solution for simple Unix-like, cross-platform
commands in npm package scripts.
shx
is proudly tested on every node release since v6
!
node myScript.js
)."clean": "shx rm -rf out/"
).npm install shx --save-dev
This will allow using shx
in your package.json
scripts.
If you'd like to use shx
on the command line, install it globally with the -g
flag.
The following code can be run either a Unix or Windows command line:
$ shx pwd # ShellJS commands are supported automatically
/home/username/path/to/dir
$ shx ls # files are outputted one per line
file.txt
file2.txt
$ shx rm *.txt # a cross-platform way to delete files!
$ shx ls
$ shx echo "Hi there!"
Hi there!
$ shx touch helloworld.txt
$ shx cp helloworld.txt foobar.txt
$ shx mkdir sub
$ shx ls
foobar.txt
helloworld.txt
sub
$ shx rm -r sub # options work as well
$ shx --silent ls fakeFileName # silence error output
All commands internally call the ShellJS corresponding function, guaranteeing cross-platform compatibility.
ShellJS is good for writing long scripts. If you want to write bash-like, platform-independent scripts, we recommend you go with that.
However, shx
is ideal for one-liners inside package.json
:
{
"scripts": {
"clean": "shx rm -rf build dist && shx echo Done"
}
}
Tip: because Windows treats single quotes (ex. 'some string'
) differently
than double quotes, we
recommend
wrapping your arguments in double quotes for cross platform compatibility (ex.
"some string"
).
Shx exposes most ShellJS commands. If a command is not listed here, assume it's supported!
Shx provides unix-like syntax on top of shell.sed()
. So ShellJS code like:
shell.sed('-i', /original string/g, 'replacement', 'filename.txt');
would turn into the following Shx command:
shx sed -i "s/original string/replacement/g" filename.txt
Note: like unix sed
, shx sed
treats /
as a special character, and
this must be
escaped (as
\/
in the shell, or \\/
in package.json
) if you intend to use this
character in either the regex or replacement string. Do not escape /
characters in the file path.
As mentioned above, most ShellJS commands are supported in ShellJS. Due to the
differences in execution environments between ShellJS and shx
(JS vs CLI) the
following commands are not supported:
Unsupported command | Recommend workaround |
---|---|
shx cd | Just use plain old cd (it's the same on windows too) |
shx pushd | Just use plain old pushd . Use forward slashes and double-quote the path. (e.g. pushd "../docs" . This would fail on Windows without the quotes) |
shx popd | Just use plain old popd |
shx dirs | No workaround |
shx set | See below |
shx exit | Just use plain old exit |
shx exec | Instead of shx exec cmd , just use plain old cmd |
shx ShellString | No workaround (but why would you want this?) |
Shx allows you to modify its behavior by passing arguments. Here's a list of supported options:
set flag | shell.config setting | shx command | Effect |
---|---|---|---|
-e | config.fatal = true | Not supported | Exit upon first error |
-v | config.verbose = true | shx --verbose cd foo | Log the command as it's run |
-f | config.noglob = true | shx --noglob cat '*.txt' | Don't expand wildcards |
N/A | config.silent = true | shx --silent cd noexist | Don't show error output |
Nate Fischer | Ari Porad | Levi Thomason |
FAQs
Portable Shell Commands for Node
The npm package shx receives a total of 543,429 weekly downloads. As such, shx popularity was classified as popular.
We found that shx demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Opengrep forks Semgrep to preserve open source SAST in response to controversial licensing changes.
Security News
Critics call the Node.js EOL CVE a misuse of the system, sparking debate over CVE standards and the growing noise in vulnerability databases.
Security News
cURL and Go security teams are publicly rejecting CVSS as flawed for assessing vulnerabilities and are calling for more accurate, context-aware approaches.