{"id":45067,"library":"gulp-file-cache","title":"gulp-file-cache","description":"A Gulp plugin for caching files to disk, enabling incremental builds by filtering out unchanged files between runs. Version 0.0.1 is the initial and only release, published with a sparse API including filter() and cache() methods. It creates a cache file (default .gulp-cache) and uses through2 streams. The project is unmaintained since 2014, with no updates, no TypeScript typings, and limited error handling. It is a simple alternative to more robust caching tools like gulp-cached or gulp-changed, but lacks features such as content-based hashing or cache invalidation.","status":"abandoned","version":"0.0.1","language":"javascript","source_language":"en","source_url":"git://github.com/pgherveou/gulp-file-cache","tags":["javascript","gulpplugin","cache"],"install":[{"cmd":"npm install gulp-file-cache","lang":"bash","label":"npm"},{"cmd":"yarn add gulp-file-cache","lang":"bash","label":"yarn"},{"cmd":"pnpm add gulp-file-cache","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"used to create transform streams for piping","package":"through2","optional":false}],"imports":[{"note":"The package is CommonJS only and does not support ES module imports. Use require() to load.","wrong":"import FileCache from 'gulp-file-cache';","symbol":"FileCache","correct":"var FileCache = require('gulp-file-cache');\nvar fileCache = new FileCache();"},{"note":"filter() is an instance method on FileCache objects. Not available as a static method.","symbol":"filter","correct":"fileCache.filter()"},{"note":"cache() is an instance method that must be called after processing to update the cache. It returns a through stream.","symbol":"cache","correct":"fileCache.cache()"}],"quickstart":{"code":"var FileCache = require('gulp-file-cache');\nvar gulp = require('gulp');\nvar jshint = require('gulp-jshint');\n\nvar fileCache = new FileCache();\n\ngulp.task('lint-cached', function() {\n  return gulp.src('./src/**/*.js')\n    .pipe(fileCache.filter())\n    .pipe(jshint())\n    .pipe(fileCache.cache());\n});","lang":"javascript","description":"Lints only new or modified JavaScript files since last run, using file-cache to skip unchanged files."},"warnings":[{"fix":"Use new FileCache('my-cache-file') or FileCache.create('my-cache-file') to specify a custom cache file.","message":"Cache file name can be set via constructor or create() method.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Always call fileCache.cache() after the transform to save the current file list for next run.","message":"filter() and cache() must be used as a pair; cache() updates the cache after processing.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Manual type declarations may be needed for TypeScript projects.","message":"No TypeScript definitions available.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Consider migrating to actively maintained plugins like gulp-newer or gulp-changed.","message":"Package is unmaintained since 2014.","severity":"deprecated","affected_versions":">=0.0.0"}],"env_vars":null,"search_vec":"'0.0.1':24 '2014':59 'altern':74 'api':35 'base':95 'build':15 'cach':4,9,39,44,49,78,83,98,102 'chang':87 'content':94 'content-bas':93 'creat':42 'default':46 'disk':12 'enabl':13 'error':68 'featur':90 'file':3,10,20,45 'filter':17,37 'gulp':2,6,48,82,86 'gulp-cach':47,81 'gulp-chang':85 'gulp-file-cach':1 'gulpplugin':101 'handl':69 'hash':96 'includ':36 'increment':14 'initi':27 'invalid':99 'javascript':100 'lack':89 'like':80 'limit':67 'method':40 'plugin':7 'project':55 'publish':31 'releas':30 'robust':77 'run':22 'simpl':73 'sinc':58 'spars':34 'stream':53 'through2':52 'tool':79 'type':65 'typescript':64 'unchang':19 'unmaintain':57 'updat':62 'use':51 'version':23","created_at":"2026-06-07T12:53:12.504150+00:00","updated_at":"2026-06-07T12:53:12.504150+00:00","problems":[{"fix":"Run 'npm install --save-dev gulp-file-cache'.","cause":"The package is not installed or not in node_modules.","error":"Error: Cannot find module 'gulp-file-cache'"},{"fix":"Use 'var fileCache = new FileCache();' then call 'fileCache.filter()'.","cause":"Instantiating FileCache incorrectly, e.g., calling require() as function or missing new.","error":"TypeError: fileCache.filter is not a function"},{"fix":"This error appears if the cache file is read before creation. Ensure filter() and cache() are used together, and the first run will create the cache file.","cause":"First run, cache file does not exist yet.","error":"Error: no such file or directory, open '.gulp-cache'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/pgherveou/gulp-file-cache","github":"git://github.com/pgherveou/gulp-file-cache","docs":null,"changelog":null,"pypi":null,"npm":"gulp-file-cache","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops","testing"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}