var path = require( 'path' ); module.exports = { createFromFile: function ( filePath ) { var fname = path.basename( filePath ); var dir = path.dirname( filePath ); return this.create( fname, dir ); }, create: function ( cacheId, _path ) { var fs = require( 'fs' ); var flatCache = require( 'flat-cache' ); var cache = flatCache.load( cacheId, _path ); var assign = require( 'object-assign' ); var normalizedEntries = { }; return { /** * the flat cache storage used to persist the metadata of the files * @type {Object} */ cache: cache, /** * Return whether or not a file has changed since last time reconcile was called. * @method hasFileChanged * @param {String} file the filepath to check * @return {Boolean} wheter or not the file has changed */ hasFileChanged: function ( file ) { return this.getFileDescriptor( file ).changed; }, /** * given an array of file paths it return and object with three arrays: * - changedFiles: Files that changed since previous run * - notChangedFiles: Files that haven't change * - notFoundFiles: Files that were not found, probably deleted * * @param {Array} files the files to analyze and compare to the previous seen files * @return {[type]} [description] */ analyzeFiles: function ( files ) { var me = this; files = files || [ ]; var res = { changedFiles: [], notFoundFiles: [], notChangedFiles: [] }; me.normalizeEntries( files ).forEach( function ( entry ) { if ( entry.changed ) { res.changedFiles.push( entry.key ); return; } if ( entry.notFound ) { res.notFoundFiles.push( entry.key ); return; } res.notChangedFiles.push( entry.key ); } ); return res; }, getFileDescriptor: function ( file ) { var meta = cache.getKey( file ); var cacheExists = !!meta; var fstat; var me = this; try { fstat = fs.statSync( file ); } catch (ex) { me.removeEntry( file ); return { key: file, notFound: true, err: ex }; } var cSize = fstat.size; var cTime = fstat.mtime.getTime(); if ( !meta ) { meta = { size: cSize, mtime: cTime }; } else { var isDifferentDate = cTime !== meta.mtime; var isDifferentSize = cSize !== meta.size; } var nEntry = normalizedEntries[ file ] = { key: file, changed: !cacheExists || isDifferentDate || isDifferentSize, meta: meta }; return nEntry; }, /** * Return the list o the files that changed compared * against the ones stored in the cache * * @method getUpdated * @param files {Array} the array of files to compare against the ones in the cache * @returns {Array} */ getUpdatedFiles: function ( files ) { var me = this; files = files || [ ]; return me.normalizeEntries( files ).filter( function ( entry ) { return entry.changed; } ).map( function ( entry ) { return entry.key; } ); }, /** * return the list of files * @method normalizeEntries * @param files * @returns {*} */ normalizeEntries: function ( files ) { files = files || [ ]; var me = this; var nEntries = files.map( function ( file ) { return me.getFileDescriptor( file ); } ); //normalizeEntries = nEntries; return nEntries; }, /** * Remove an entry from the file-entry-cache. Useful to force the file to still be considered * modified the next time the process is run * * @method removeEntry * @param entryName */ removeEntry: function ( entryName ) { delete normalizedEntries[ entryName ]; cache.removeKey( entryName ); }, /** * Delete the cache file from the disk * @method deleteCacheFile */ deleteCacheFile: function () { cache.removeCacheFile(); }, /** * remove the cache from the file and clear the memory cache */ destroy: function () { normalizedEntries = { }; cache.destroy(); }, /** * Sync the files and persist them to the cache * * @method reconcile */ reconcile: function () { var entries = normalizedEntries; var keys = Object.keys( entries ); if ( keys.length === 0 ) { return; } keys.forEach( function ( entryName ) { var cacheEntry = entries[ entryName ]; var stat = fs.statSync( cacheEntry.key ); var meta = assign( cacheEntry.meta, { size: stat.size, mtime: stat.mtime.getTime() } ); cache.setKey( entryName, meta ); } ); cache.save(); } }; } };