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 https://github.com/sun-zheng-an/gulp-shell/issues/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

[zbennett10]

gulp-clean-css has been updated scniro/gulp-clean-css#50

[demurgos]

I opened more issues (until I reached my rate limit 😄) and updated the first post. Also, thanks to @zbennett10 for sending many PRs.

Submitted a bunch of pull requests:

sindresorhus/gulp-changed#72
gulp-community/gulp-header#55
klei/gulp-inject#236
chilijung/gulp-cssmin#25
jamesknelson/gulp-rev-replace#82
armed/gulp-flatten#14
ben-eb/gulp-csso#31
colynb/gulp-data#26
shinnn/gulp-gh-pages#120
jstuckey/gulp-gzip#28
ben-eb/gulp-svgmin#77
alexgorbatchev/gulp-print#17
sasstools/gulp-sass-lint#84

[demurgos]

@TheDancingCode
Excellent, I am reviewing it and updating the list.
Please make sure that vinyl is in the devDependencies when it's only used in the tests.

Edit: It seems that vinyl is in the right dependencies except for the first 2-3 PRs, could you update them?

Edit2: I am having a lot of troubles due to rate limits: I can't comment or fork repositories at the moment. Thanks to everyone helping with this.

[demurgos]

@shinnn @TheDancingCode
I am not able to comment on the PR for gulp-gh-pages so I'll post it here:

The PR looks good but CI is failing. The last build I see was two years ago so it may be unrelated to the changes but it would be better if it was solved.

[demurgos]

I updated the list and sent most of the missing PRs. We almost finished this list. If someone knows how to easily sort the dependent modules by weekly downloads I could update the list to add more plugins.

According to npm, there are now 6726 dependent packages (instead of 6752)

[demurgos]

Thanks to @Frank3K and @TheDancingCode

I updated the list according to the issues and PRs you opened. Except for large packages, I'll stop extending the list. You can still open issues but I'll focus more on merging and publishing the already submitted PRs.

Happy new year to everyone 🎉