Commit aef8209

@@ -441,7 +441,11 @@ function syncCwd() {
   if ($[processCwd] != process.cwd()) process.chdir($[processCwd])
 }
 
-export function cd(dir: string) {
+export function cd(dir: string | ProcessOutput) {
+  if (dir instanceof ProcessOutput) {
+    dir = dir.toString().replace(/\n+$/, '')
+  }
+
   $.log({ kind: 'cd', dir })
   process.chdir(dir)
   $[processCwd] = process.cwd()

@@ -233,6 +233,14 @@ test('cd() fails on entering not existing dir', async () => {
   assert.throws(() => cd('/tmp/abra-kadabra'))
 })
 
+test('cd() accepts ProcessOutput in addition to string', async () => {
+  within(async () => {
+    const tmpDir = await $`mktemp -d`
+    cd(tmpDir)
+    assert.match(process.cwd(), tmpDir.toString().trimEnd())
+  })
+})
+
 test('kill() method works', async () => {
   let p = $`sleep 9999`.nothrow()
   setTimeout(() => {

@@ -169,6 +169,13 @@ cd('/tmp')
 await $`pwd` // => /tmp
 ```
 
+Like `echo`, in addition to `string` arguments, `cd` accepts and trims
+trailing newlines from `ProcessOutput` enabling common idioms like:
+
+```js
+cd(await $`mktemp -d`)
+```
+
 ### `fetch()`
 
 A wrapper around the [node-fetch](https://www.npmjs.com/package/node-fetch)