Ever wanted to implement your gulp task directly with powershell?

Tasks

gulpfile.js

const gulp = require('gulp');
const pulp = require('posh-gulp');

gulp.task('build', (cb) => {
   console.log('building');
   cb();
});

pulp(gulp, './gulpfile.ps1');

gulp.task('default', gulp.series('posh:simple'));

gulpfile.ps1

Import-Module ./path-to-posh-gulp/Gulp

Add-Task "posh:empty"

Add-Task "posh:simple" ("build", "posh:empty") {
    Write-Host 'simple powershell task'
}

Publish-Tasks $args

Output

Importing Tasks ./gulpfile.ps1
Using gulpfile [...]/gulpfile.js
Starting 'build'...
building
Finished 'build'
Starting 'posh:empty'...
Finished 'posh:empty'
Starting 'posh:simple'...
simple powershell task
Finished 'posh:simple'
Starting 'default'...
Finished 'default'

Development

Run powershell tests with pester (choco install):

Invoke-Pester

Streaming Output (Optional)

Set the environment variable POSH_GULP_STREAMING=true to stream each line from a PowerShell task as it is produced instead of waiting for the task to finish. This is useful for long running tasks (e.g. docker builds) to observe progress in real time.

Example quick test:

Add-Task "stream:test" @() {
    for ($i=1; $i -le 3; $i++) { Write-Host "stream-line-$i"; Start-Sleep -Seconds 1 }
}
Publish-Tasks $args
# run with
$env:POSH_GULP_STREAMING='true'; npx gulp stream:test

If POSH_GULP_STREAMING is not set or is anything other than true, the legacy buffered output behaviour is preserved for backward compatibility.