File-changed NPM

file-changed

A node module to check and store file changed.

Install

By npm:

npm i file-changed --save

By yarn:

yarn add file-changed

Class

This package export a class since version 1.0.0 which means you could have multiple instances and save the information where you like.

constructor(dbPath)

Arguments

dbPath {string}

Default: ./\_timestamp.json

Path to save collection informations on disk.

Return

Collection instance.

Instance Methods

get(file, type)

Access to a file last modified information.

Arguments

file {string}: The target file path
type {string}: The information type
- ts: timestamp (default)
- md5: md5 hash

Return

false {boolean}: no such file in collection
timestamp or md5 {string}: depends on type

list()

Get all file paths in collection.

Return

file paths {array}

addFile(path, path2 ... pathN)

Add files to collection.

Arguments

path {string}: the target file path or glob

Return

this {object}: for chain operation

rmFile(path, path2 ... pathN)

Remove files from collection.

Arguments

path {string}: the target file path or glob

Return

this {object}: for chain operation

check(path1 ... pathN)

Check collection files changed or not.

Arguments

no arguments: check all files.
path {string}: the target file path or glob

Return

changed files {array}

update(path1 ... pathN)

Update files last modified information.

Arguments

no arguments: update all files
path {string}: the target file path or glob

Return

this {object}: for chain operation

clean()

Clean files in collection which could not found.

Return

this {object}: for chain operation

save()

Save collection information onto disk.

Return

this {object}: for chain operation

Usage Examples

const Fc = require('file-changed');
const collectionA = new Fc('./path/to/save/info'); // Create collection instance whill will load modified info from that path if that path exists

collectionA.addFile('test/files/file1', 'test/files/file2'); // Add 2 files in collectionA

const fileList = collectionA.list(); // Get file list in collectionA

collectionA.rmFile('test/files/file1'); // Remove 1 file from collectionA

collectionA.addFile('test/files/*'); // Add file by glob

const modifiedList1 = collectionA.check('test/files/file1'); // Check 1 file modified or not
const modifiedList2 = collectionA.check()); // Check all files in collectionA modified or not

collectionA.update('test/files/file1'); // Update last modified info for 1 file
collectionA.update(); // Update last modified info for all files in collectionA

const lastModifiedTS = collectionA.get('test/files/file1'); // Get last modified timestamp for that file
const lastModifiedMD5 = collectionA.get('test/files/file1', 'md5'); // Get last modified md5 for that file

collectionA.save(); // Save collectionA modified info to disk