jsFileTools
fileTools
is a library with methods to works with files.
Examples
NPM
# bash
npm i jsfiletools
// js
const jsFileTools = require("jsfiletools");
Methods
- readFile
- writeFile
- modifyFile
- copyFile
- copyDir
- deleteFile
- deleteDir
jsFileTools.readFile
Reads a file from source. Returns a promise.
Example
var src = './example.js';
try {
var fileData = await jsFileTools.readFile(src);
} catch (error) {
// handle error
}
// fileData type is string
jsFileTools.writeFile
Writes data into a file. Returns a promise.
Example
// src param - include route and file name
var src = './example.js';
var fileData = 'some random content';
// fileData type is string
try {
var result = await jsFileTools.writeFile(src, fileData);
} catch (error) {
// handle error
}
jsFileTools.modifyFile
Replaces a text finded by regex with a string. Allowes multiples replaces. Returns a promise.
Example
// fileSrc param - include route and file name
var fileSrc = './example.js';
var dataToReplace = [
['^.*TextToReplace.*', 'ReplacementText']
]
try {
var result = await jsFileTools.modifyFile(fileSrc, dataToReplace);
} catch (error) {
// handle error
}
jsFileTools.copyFile
Copies a file form a source to another one. Returns a promise.
Example
// fileSrc and fileTarget params - include route and file name
var fileSrc = './example.js';
var fileTarget = './newDir/example.js';
try {
var result = await jsFileTools.copyFile(fileSrc, fileTarget);
} catch (error) {
// handle error
}
jsFileTools.copyDir
Copies a directory to another one recursively. Returns a promise.
Example
var dirSrc = './example';
var dirTarget = '../newDir';
try {
var result = await jsFileTools.copyDir(dirSrc, dirTarget);
} catch (error) {
// handle error
}
jsFileTools.deleteFile
Delete a file. Returns a promise.
Example
// fileSrc param - include route and file name
var fileSrc = './example.js';
try {
var result = await jsFileTools.deleteFile(fileSrc);
} catch (error) {
// handle error
}
jsFileTools.deleteDir
Delete a directory recursively. Returns a promise.
Example
var dirSrc = './example';
try {
var result = await jsFileTools.deleteDir(dirSrc);
} catch (error) {
// handle error
}
Source Code
Contribution Notes
Clone project on github
Install libraries
npm i
Build
npm run build
Open Pull Request
Make changes and create a merge request.