{"id":20992259,"url":"https://github.com/daniele-rapagnani/gulp-walker","last_synced_at":"2025-05-14T20:32:38.591Z","repository":{"id":30187049,"uuid":"33737755","full_name":"daniele-rapagnani/gulp-walker","owner":"daniele-rapagnani","description":"Dependencies aware incremental building for gulp","archived":false,"fork":false,"pushed_at":"2017-05-16T10:25:34.000Z","size":45,"stargazers_count":4,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-12T22:57:46.338Z","etag":null,"topics":["auto-reload","dependency-tree","gulp","gulp-plugin","watch"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"json-schema-form/angular-schema-form","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/daniele-rapagnani.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-04-10T16:06:50.000Z","updated_at":"2020-06-17T01:20:46.000Z","dependencies_parsed_at":"2022-08-17T19:50:47.761Z","dependency_job_id":null,"html_url":"https://github.com/daniele-rapagnani/gulp-walker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daniele-rapagnani%2Fgulp-walker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daniele-rapagnani%2Fgulp-walker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daniele-rapagnani%2Fgulp-walker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daniele-rapagnani%2Fgulp-walker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daniele-rapagnani","download_url":"https://codeload.github.com/daniele-rapagnani/gulp-walker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225198461,"owners_count":17436900,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["auto-reload","dependency-tree","gulp","gulp-plugin","watch"],"created_at":"2024-11-19T07:10:06.230Z","updated_at":"2024-11-19T07:10:07.671Z","avatar_url":"https://github.com/daniele-rapagnani.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Information\n**gulp-walker** is a gulp plugin that allows for dependencies aware incremental building.\nIt is conceived to scale well with big projects, with a complex dependecy tree, and to be easily extensible.\n\nIncremental building in Gulp is possible with plugins such as [gulp-newer](https://github.com/tschaub/gulp-newer) and [gulp-cached](https://github.com/wearefractal/gulp-cached), but these plugins have no way of handling dependencies between files. Correctly handling dependencies for incremental building is vital to projects using CSS preprocessors or javascript packaging systems, where the modification of an imported file should cause the whole bundle to be rebuilt.\n\n#### Usage\n\nThe following is an example of an hypothetical [stylus](https://learnboost.github.io/stylus/) task.\n\n```javascript\nvar cache  = require('gulp-cached');\nvar filter = require('gulp-filter');\n\n// Your code here...\n\n// Pass all files through the stream to be indexed\ngulp.src(\"**/*.styl\")\n    // Prevent unchanged files from being indexed again\n\t\t.pipe(cache('styles'))\n\t\t// Insert gulp-walker here\n\t\t.pipe(walker())\n\t  // Filter the files in the stream to let\n\t  // through only the files that must be compiled\n\t\t.pipe(filter(\"**/app.styl\"))\n    // Do your normal compilation/bundling/processing\n    // stuff here...\n```\nYou can find a working example for a stylus + browserify + coffee environment [here](https://github.com/daniele-rapagnani/gulp-walker/blob/master/example/gulpfile.js).\n\n#### Supported Languages\nThe following languages are actually supported but there are plans to support many more and you can easily implement your own finder.\n\n* CoffeeScript\n* JavaScript\n* Stylus\n\n#### How it works\nThe plugin builds the dependencies graph by analyzing the incoming files on the gulp stream. It does so by subdividing the analysis in two substeps: **finding** and **resolving**. In the **finding** step the plugin attempts to collect all the inclusion requests inside the source code being analyzed and returns them, unaltered, to the analyzer. The **resolving** step then tries to find the physical path of the file being requested by using a specific algorithm. To each of this steps one or more strategies can be assigned and **custom finders/resolvers** are easily implemented.\n\nWhen one of the previously analyzed files is sent again through the stream, gulp-walker pushes all of its dependencies on the stream too to be processed. By using a plugin such as [gulp-filter](https://github.com/sindresorhus/gulp-filter) one can then select which files will actually proceed down the stream to be built (for example the app.css of the bundle including the modified file).\n\n#### Similar projects\n[gulp-progeny](https://github.com/HerringtonDarkholme/gulp-progeny)\n\n## Documentation\nYou can find the documentation [here](https://github.com/daniele-rapagnani/gulp-walker/blob/master/docs/api.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaniele-rapagnani%2Fgulp-walker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaniele-rapagnani%2Fgulp-walker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaniele-rapagnani%2Fgulp-walker/lists"}