.eslintrc.json

@@ -5,6 +5,8 @@
   "extends": "airbnb-base",
   "rules": {
     "curly": [2, "multi-line"],
+    "function-call-argument-newline": 0,
+    "function-paren-newline": 0,
     "global-require": 0,
     "import/no-dynamic-require": 0,
     "import/no-extraneous-dependencies": 0,

.github/workflows/main.yml

@@ -10,27 +10,24 @@ jobs:
       fail-fast: false
       matrix:
         node-version:
-          - 6
-          - 7
-          - 8
-          - 9
-          - 10
-          - 11
-          - 12
-          - 13
-          - 14
+          - 18
+          - 20
+          - 22
         os:
           - ubuntu-latest
           - macos-latest
           - windows-latest
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
       - run: npm install
       - run: npm run test
+      - run: npm run build
       - run: npm run check-node-support
-      - uses: codecov/codecov-action@v2
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v4
         with:
+          token: ${{ secrets.CODECOV_TOKEN }}
           fail_ci_if_error: true

.gitignore

@@ -6,7 +6,6 @@ lib
 .nyc_output
 coverage
 .shxrc.json
-package-lock.json
 
 # Linux
 *~

.mocharc.js

@@ -0,0 +1,5 @@
+// https://mochajs.org/#configuring-mocha-nodejs
+module.exports = {
+  require: ['babel-register'], // Transpile files using Babel
+  recursive: true,
+};

CONTRIBUTING.md

@@ -2,7 +2,7 @@
 
 ## Releasing
 
-On the latest clean `master`:
+On the latest clean `main`:
 
 ```
 npm run release:major

README.md

@@ -1,15 +1,15 @@
 # Shx
 
-[![Build Status](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fshelljs%2Fshx%2Fbadge%3Fref%3Dmaster&style=flat-square)](https://actions-badge.atrox.dev/shelljs/shx/goto?ref=master)
-[![Codecov](https://img.shields.io/codecov/c/github/shelljs/shx/master.svg?style=flat-square&label=coverage)](https://codecov.io/gh/shelljs/shx)
+[![GitHub Actions](https://img.shields.io/github/actions/workflow/status/shelljs/shx/main.yml?style=flat-square&logo=github)](https://github.com/shelljs/shx/actions/workflows/main.yml)
+[![Codecov](https://img.shields.io/codecov/c/github/shelljs/shx/main.svg?style=flat-square&label=coverage)](https://codecov.io/gh/shelljs/shx)
 [![npm version](https://img.shields.io/npm/v/shx.svg?style=flat-square)](https://www.npmjs.com/package/shx)
 [![npm downloads](https://img.shields.io/npm/dm/shx.svg?style=flat-square)](https://www.npmjs.com/package/shx)
 
 `shx` is a wrapper around [ShellJS](https://github.com/shelljs/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 <!-- start minVersion -->`v6`<!-- stop minVersion -->!
+`shx` is proudly tested on every LTS node release since <!-- start minVersion -->`v18`<!-- stop minVersion -->!
 
 ## Difference Between ShellJS and shx
 
@@ -59,6 +59,8 @@ sub
 $ shx rm -r sub                 # options work as well
 
 $ shx --silent ls fakeFileName  # silence error output
+
+$ shx --negate test -d dir      # Negate status code output (e.g., failed commands will now have status 0)
 ```
 
 All commands internally call the ShellJS corresponding function, guaranteeing
@@ -71,19 +73,26 @@ platform-independent scripts, we recommend you go with that.
 
 However, `shx` is ideal for one-liners inside `package.json`:
 
-```javascript
+```json
 {
   "scripts": {
-    "clean": "shx rm -rf build dist && shx echo Done"
+    "clean": "shx rm -rf \"build/**/*.js\" \"build/output\" && shx echo \"Done cleaning\""
   }
 }
 ```
 
-**Tip:** because Windows treats single quotes (ex. `'some string'`) differently
-than double quotes, [we
-recommend](https://github.com/shelljs/shx/issues/165#issuecomment-563127983)
-wrapping your arguments in double quotes for cross platform compatibility (ex.
-`"some string"`).
+It's safe to use `&&` and `||` operators in npm package scripts. These will be
+interpreted by the operating system's shell (`sh` on Unix, `cmd.exe` on
+Windows). If you're using glob operators like `*` or `**`, then we recommend to
+**put these in double quotes**, which ensures that `shx` will expand the glob
+rather than the operating system shell.
+
+> [!IMPORTANT]
+> Windows treats single quotes (ex. `'some string'`) differently than double
+> quotes.
+> [We recommend](https://github.com/shelljs/shx/issues/165#issuecomment-563127983)
+> wrapping your arguments in **escaped double quotes** so that your code is
+> compatible cross platform (ex. `"clean": "shx echo \"some string\""`).
 
 ## Command reference
 
@@ -114,7 +123,7 @@ characters in the file path.
 
 ### Unsupported Commands
 
-As mentioned above, most ShellJS commands are supported in ShellJS. Due to the
+As mentioned above, most ShellJS commands are supported in `shx`. Due to the
 differences in execution environments between ShellJS and `shx` (JS vs CLI) the
 following commands are not supported:
 
@@ -136,10 +145,13 @@ supported options:
 
 | [`set`](https://github.com/shelljs/shelljs#setoptions) flag | [`shell.config`](https://github.com/shelljs/shelljs#configuration) 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 |
+| `-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. |
+| N/A | N/A | `shx --negate test -d dir` | Runs the specified command but negates the exit status. Failed command = status 0, successful command = status 1. |
+| N/A | N/A | `shx --help` | Show help text. |
+| N/A | N/A | `shx --version` | Print the shx version. |
 
 ## Team