A Gulp plugin that logs Vinyl file stream details to debug your build pipeline.
gulp-debug is a Gulp plugin designed to help developers debug their Gulp build pipelines by logging details about Vinyl file streams. It outputs file paths, counts, and metadata as files pass through tasks, making it easier to identify issues and understand task flow. The plugin is configurable, allowing custom titles, loggers, and detail levels.
Developers using Gulp.js for build automation who need to inspect and debug file streams during development or troubleshooting.
It provides a simple, non-intrusive way to visualize pipeline activity without modifying task logic, with flexible logging options that adapt to different debugging needs.
Debug Vinyl file streams to see what files are run through your Gulp pipeline
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Logs file paths, counts, and metadata directly in the console, providing immediate visibility into Gulp pipelines without modifying task logic, as shown in the basic usage example.
Supports custom titles, toggles between minimal and detailed views, and allows custom loggers, enabling tailored debugging based on the options API in the README.
Automatically displays additional file stats like size and timestamps when Gulp is run with --verbose, leveraging Gulp's built-in flag for deeper insights.
Seamlessly plugs into existing Gulp workflows without disrupting the file stream, aligning with the project's pragmatic philosophy of minimal interference.
Relies solely on console logging without advanced capabilities like breakpoints, visual stream mapping, or error diagnostics, making it basic for complex issues.
Exclusively tied to Gulp.js, offering no utility for projects using other build systems, which limits its relevance in diverse toolchains.
Logging every file in the stream can introduce slowdowns, especially in projects with high file counts, as it processes each Vinyl object.