feat: add $.silent

README.md

@@ -7,12 +7,19 @@ npm i zx-extra
 ```
 
 ## Usage
-### ``$.noquote`command` ``
-Runs target cmd with disabled `shq`.
+### ``$.raw`command` ``
+Evaluates target cmd as is with disabled `shq`.
 ```js
 const cmd = 'echo foo'
 const msg = 'bar'
-const output = (await $.noquote`${cmd} ${msg}`).toString().trim()
+const output = (await $.raw`${cmd} ${msg}`).toString().trim()
 // $ echo foo bar
 ```
 
+### ``$.silent`command` ``
+Sets `verbose = false` for once invocation.
+```js
+await $.silent`echo foo`
+// <no output in console>
+```
+

index.d.ts

@@ -0,0 +1,6 @@
+export * from 'zx'
+
+interface $ {
+  raw: $
+  silent: $
+}

index.mjs

@@ -1,10 +1,19 @@
 import {$} from 'zx'
 
-$.noquote = async (...args) => {
+$.raw = async (...args) => {
   const q = $.quote
   $.quote = v => v
   const p = $(...args)
   await p
   $.quote = q
   return p
 }
+
+$.silent = async (...args) => {
+  const v = $.verbose
+  $.verbose = false
+  const p = $(...args)
+  await p
+  $.verbose = v
+  return p
+}

test.mjs

@@ -1,8 +1,14 @@
 import {strict as assert} from 'assert'
 
+// $.raw
 {
   const cmd = 'echo foo'
   const msg = 'bar'
-  const output = (await $.noquote`${cmd} ${msg}`).toString().trim()
+  const output = (await $.raw`${cmd} ${msg}`).toString().trim()
   assert(output === 'foo bar')
 }
+
+// $.silent
+{
+  await $.silent`echo foo`
+}