Splitting and merging files with NodeJS
npm install split-fileSplit and merge file in multiple parts. Splittable with number of parts or maximum bytes per part
npm i --save split-file
$3
All methods return a Promise (bluebird) which results in some respose if some.#### Splitting file with number of parts
splitFile(file, dest?) => Promise
Consumes:
- file: Path to the file to split.
- dest: Folder for output, defaults to . (current folder)Produces:
- Promise: Promise with results in an array of part names (full paths) of the splitted files.
Example:
javascript
const splitFile = require('split-file');splitFile.splitFile(__dirname + '/testfile.bin', 3)
.then((names) => {
console.log(names);
})
.catch((err) => {
console.log('Error: ', err);
});
`#### Splitting file with maximum bytes per part
splitFileBySize(file, maxSize, dest?) => Promise
Consumes:
- file: Path to the file to split.
- maxSize: Max size of the splitted parts. (bytes)
- dest: Folder for output, defaults to . (current folder)Produces:
- Promise: Promise with results in an array of part names (full paths) of the splitted files.
Example:
javascript
const splitFile = require('split-file');splitFile.splitFileBySize(__dirname + '/testfile.bin', 457000)
.then((names) => {
console.log(names);
})
.catch((err) => {
console.log('Error: ', err);
});
`#### Merge parts
mergeFiles(names, outputFile) => Promise<>
Consumes:
- names: Input files, array with full part paths.
- outputFile: Full path of the output file.Produces:
- Promise<>: Promise that results in an empty resolving.
Example:
javascript
const splitFile = require('split-file');splitFile.mergeFiles(names, __dirname + '/testfile-output.bin')
.then(() => {
console.log('Done!');
})
.catch((err) => {
console.log('Error: ', err);
});
`CLI Tool
$3
To use the module from the commandline you can install this package in your global context:
npm i -g split-file
Some situations you need admin rights (sudo or windows run as admin)$3
The CLI tool works like you use it in your own package.
Usage: split-file -s input.bin 5
split-file -x input.bin 457000
split-file -m output.bin part1 part2 ... -s
Split the input file in the number of parts given.
-x
Split the input file into multiple parts with file size maximum of max_size bytes
-m