Ecosystem migration

[demurgos]

Edit: See README.md and this medium post for details about the deprecation of gulp-util. Please help us submitting pull requests. Please also note that a patch was applied to keep all the plugins using gulp-util working with gul@4. This is only intended to help with the transition and migrating should remain a priority. More info about the Gulp 4 issue and fix

Following the deprecation of gulp-util, thousands of plugins need to be updated. According to npm, there are currently 6752 plugins depending on gulp-util. This issue tracks the progress for some of the most popular packages depending on gulp-util.

The packages listed below are from the first results for packages dependent on gulp-util.

• Edit 1 (2017-01-01): I extended the list with additional packages that referenced this issue.
• Edit 2 (2017-01-02): Full list of dependents (some download stats seems to be missing)
• Edit 3 (2017-01-11): I stopped extending the list because it's getting too long. You can still post comments linking to issues or PRs. I may still add popular packages (I'll just use some arbitrary metric such as >100 stars or >1k monthly downloads).

Legend:

• 💚 Fixed
• 💛 PR, maintainer is aware of the issue
• 🕐 PR, waiting for maintainer
• ❌ No PR
• Unchecked: Fix not on npm
• Checked: Fix on npm

Progress (last update: 2018-10-14):

• 💚 gulp
• 💚 gulp-sass: Issue PR
• 💚 run-sequence: Issue PR
• 💚 gulp-plumber: Issue PR
• 💚 gulp-babel: Issue PR
• 💚 gulp-autoprefixer: Issue PR
• 💚 gulp-template: Issue PR
• 💚 gulp-watch: Issue PR
• 🕐 gulp-install: Issue PR
• 💚 gulp-jshint: Issue PR
• 💚 gulp-notify Issue PR
• 💚 gulp-imagemin: Issue PR
• 💚 gulp-filter: PR
• 💚 gulp-shell: Issue PR
• 💚 gulp-typescript: Issue PR
• 💚 gulp-postcss: Issue PR
• 💚 gulp-mocha: Issue PR
• 💚 gulp-clean-css: PR
• 💚 gulp-changed: Issue PR
• 🕐 slush: Issue PR
• 💚 gulp-debug: Issue PR
• 💚 gulp-livereload: PR
• 💚 gulp-cssnano: Issue PR
• 💚 gulp-size: Issue PR
• 💚 webpack-stream: Issue PR
• 💚 gulp-zip: Issue PR
• 💚 gulp-connect: PR
• 💚 gulp-header: Issue PR
• 💚 gulp-coffee PR (Breaks on Node < 6 despite advertising Node 0.9 support)
• 💚 gulp-inject: Issue PR (CI is failing, can be unrelated)
• 💚 gulp-ng-annotate: Issue
• 💚 gulp-sequence: Issue Commit
• 💚 gulp-angular-templatecache: Issue PR
• 💚 gulp-istanbul: Issue PR PR
• 💚 gulp-rev-replace: Issue PR
• 💚 gulp-tslint: Issue PR
• 💚 gulp-flatten: Issue PR
• 💚 gulp-csso Issue PR
• 💚 gulp-data: Issue PR
• 💚 gulp-newer: Issue PR
• 💚 gulp-pug: Issue PR
• 💚 gulp-jscs: Issue PR (Failing CI, can be unrelated)
• 💚 laravel-elixir: PR
• 💚 gulp-gh-pages PR (CI is failing, can be unrelated)
• 💚 gulp-useref: Commit
• 💚 gulp-gzip PR
• 💚 gulp.spritesmith PR
• 💚 gulp-svgmin: PR
• 💚 gulp-cache: PR
• 💚 gulp-file: Issue PR
• 💚 gulp-print: PR
• 💚 gulp-sass-lint: Issue PR
• 🕐 gulp-webserver: Issue PR
• 💚 gulp-jasmine: PR
• 💚 gulp-minify: PR
• 💚 remap-istanbul: Issue PR
• 💚 gulp-awspublish: Issue PR
• 💚 gulp-json-editor: Issue PR
• 💚 gulp-wrap: Issue PR
• 💚 gulp-ruby-sass: Issue Commit
• 💚 gulp-iconfont: Issue PR
• 💚 gulp-concat-css: PR
• 💚 gulp-eslint: PR
• 💚 gulp-processhtml: Commit
• 💚 gulp-json-lint: Issue PR
• 🕐 gulp-csscomb: Issue PR
• 💚 gulp-scss-lint: Issue PR
• 💚 gulp-svg-sprite: Issue PR
• 💚 gulp-rev-all: Issue PR
• 💚 gulp-jsbeautifier: Issue PR
• 💚 gulp-compare-json: Issue PR
• 💚 gulp-ng-constant: Issue PR
• 💚 gulp-es3ify: PR
• 💚 gulp-s3-upload: Issue PR
• 💚 gulp-merge-json: Issue Commit
• 🕐 gulp-coveralls: Issue PR
• 🕐 gulp-run: Issue PR (Failing CI but unrelated)
• 💚 gulp-flatmap: Issue PR
• 💚 gulp-stylelint: Issue PR
• 💚 gulp-copy: Issue PR
• 💚 gulp-protractor: Issue PR
• 💚 fbjs-scripts: Issue PR
• 💚 gulp-exec: Issue PR
• 💚 gulp-remember: Issue PR
• 💚 gulp-bower: Issue PR
• 🕐 gulp-compile-handlebars PR
• 💚 gulp-file-include: Issue PR
• 💚 gulp-ng-html2js: Issue PR
• 💚 gulp-clone: Issue Commit
• 💚 gulp-inject-string: Issue PR
• 💚 gulp-angular-filesort: Issue PR
• 💚 semantic-ui: Issue PR
• 💚 gulp-cheerio: Issue PR
• 💚 gulp-include: Issue PR Commit
• 💚 gulp-handlebars: Issue Commit
• 💚 gulp-nunjucks-render PR
• 💚 gulp-unzip: Issue PR
• 💚 gulp-untar: Issue PR
• 💚 gulp-count: Issue PR
• 🕐 gulp-transform: Issue PR
• 💚 gulp-htmllint: Issue PR
• 💚 gulp-hb: Issue
• 💚 gulp-jsoncombine: Issue
• 💚 gulp-string-replace: Issue
• 💚 gulp-phplint: Issue
• 💚 gulp-responsive: PR

Deprecated packages (no need to update?):

• gulp-minify-css: Deprecated in favor of gulp-clean-css
• gulp-clean: Deprecated in favor of recipe
• gulp-jade: Deprecated in favor of gulp-pug
• gulp-minify-html: Deprecated in favor of gulp-htmlmin
• 💚 gulp-rimraf: Deprecated in favor of recipe, Issue PR
• gulp-browserify: Deprecated in favor of recipes
• gulp-foreach: Renamed to gulp-flatmap
• gulp-cssmin: Deprecated in favor of gulp-clean-css
• gulp-webpack: Deprecated in favor of webpack-stream

Issue template:

Replace deprecated dependency gulp-util

[`gulp-util`](https://www.npmjs.com/package/gulp-util) has been deprecated recently. Continuing to use this dependency may prevent the use of your library with the recently released version 4 of Gulp, **it is important to replace `gulp-util`**.

The [README.md](https://github.com/gulpjs/gulp-util) lists alternatives for all the components so a simple replacement should be enough.

Your package is popular but still relying on `gulp-util`, it would be good to publish a fixed version to npm as soon as possible.

See:
- https://medium.com/gulpjs/gulp-util-ca3b1f9f9ac5
- https://github.com/gulpjs/gulp-util/issues/143

[phated]

This is awesome! Thanks @demurgos

A quick note about fancy-log - once more people are on gulp4 or gulp-cli, it'll need to be replaced by gulplog but we don't want to have people on it yet so logging doesn't get blackholed in the meantime.

[demurgos]

Ok,
For the moment I am using fancy-log then.

The biggest issue when going over all these packages was that about half of them hasn't been updated in months even if they are very popular. Even if we sent PRs to all the package overnight, the biggest problem is that maintainers need to actually accept the PR and publish the update to npm. I had some quick answers from some maintainers, so it's a good sign. It would be nice to have @sindresorhus to accept its PRs because he owns many popular plugins.

Another issue related to the lack of regular maintainance is that many packages are still tested against unmaintained Node versions (pre-Node 4). I know that Gulp itself did not switch to Node 4+ but many other dependencies did. With the lack of lock files and transitive dependencies, CI tends to break for many packages so it requires additional maintenance to first get a working package and then drop gulp-util.

[phated]

Yeah, I noticed that in some PRs. We've landed a temporary fix in vinyl-fs that upgrades the Vinyl objects passing through the stream, so the problem shouldn't be as immediate as it seemed but we will want to get these modules updated.

[yocontra]

Thanks a ton for putting your time towards this - I'll go through all of my modules today.

[zbennett10]

^^ Yeah, thanks alot for compiling this list.

[stephenlacy]

I opened issues in:
gulp-notify mikaelbr/gulp-notify#123
gulp-shell sun-zheng-an/gulp-shell#94
gulp-cssmin https://github.com/chilijung/gulp-cssmin/issues/24
gulp-csso ben-eb/gulp-csso#30
gulp-debug sindresorhus/gulp-debug#40
slush slushjs/slush#61
gulp-rimraf robrich/gulp-rimraf#25

And PRs:
gulp-rimraf robrich/gulp-rimraf#26