diff options
author | LinuxWizard42 <computerwizard@linuxmail.org> | 2022-10-12 22:54:37 +0300 |
---|---|---|
committer | LinuxWizard42 <computerwizard@linuxmail.org> | 2022-10-12 22:54:37 +0300 |
commit | 703e03aba33f234712206769f57717ba7d92d23d (patch) | |
tree | 0041f04ccb75bd5379c764e9fe42249fffe75fc3 /node_modules/sumchecker/README.md | |
parent | ab6e257e6e9d9a483d7e86f220d8b209a2cd7753 (diff) | |
download | FlashRunner-703e03aba33f234712206769f57717ba7d92d23d.tar.gz FlashRunner-703e03aba33f234712206769f57717ba7d92d23d.tar.zst |
Added export_allowed file to make repository visible in cgit
Diffstat (limited to 'node_modules/sumchecker/README.md')
-rw-r--r-- | node_modules/sumchecker/README.md | 80 |
1 files changed, 80 insertions, 0 deletions
diff --git a/node_modules/sumchecker/README.md b/node_modules/sumchecker/README.md new file mode 100644 index 0000000..8c927b7 --- /dev/null +++ b/node_modules/sumchecker/README.md @@ -0,0 +1,80 @@ +# Sumchecker + +[](https://travis-ci.org/malept/sumchecker) +[](https://ci.appveyor.com/project/malept/sumchecker) +[](https://codeclimate.com/github/malept/sumchecker) +[](https://codeclimate.com/github/malept/sumchecker/coverage) + +Sumchecker is a pure Node.js solution to validating files specified in a checksum file, which are +usually generated by programs such as [`sha256sum`](https://en.wikipedia.org/wiki/Sha256sum). + +## Usage + +```javascript +sumchecker(algorithm, checksumFilename, baseDir, filesToCheck) + .then(() => { + console.log('All files validate!'); + }, (error) => { + console.error('An error occurred', error); + }); +``` + +Returns a [`Promise`](https://www.promisejs.org/). The promise is resolved when all files specified +in [`filesToCheck`](#filesToCheck) are validated. The promise is rejected otherwise. + +### Parameters + +#### `algorithm` + +`String` - The hash algorithm used in [`checksumFilename`](#checksumFilename). Corresponds to the +algorithms allowed by [`crypto.createHash()`]. + +#### `checksumFilename` + +`String` - The path to the checksum file. + +#### `baseDir` + +`String` - The base directory for the files specified in [`filesToCheck`](#filesToCheck). + +#### `filesToCheck` + +`Array` or `String` - one or more paths of the files that will be validated, relative to +[`baseDir`](#baseDir). + +### Errors + +These are `sumchecker`-specific error classes that are passed to the promise's reject callback. + +#### `sumchecker.ChecksumMismatchError` + +When at least one of the files does not match its expected checksum. + +Properties: + +* `filename` (`String`) - a path to a file that did not match + +#### `sumchecker.ChecksumParseError` + +When the checksum file cannot be parsed (as in, it does not match the checksum file format). + +Properties: + +* `lineNumber` (`Number`) - the line number that could not be parsed +* `line` (`String`) - the raw line data that could not be parsed, sans newline + +#### `sumchecker.NoChecksumFoundError` + +When at least one of the files specified to check is not listed in the checksum file. + +Properties: + +* `filename` (`String`)- a filename from [`filesToCheck`](#filesToCheck) + +## Legal + +This library is copyrighted under the terms of the [Apache 2.0 License]. + +[`crypto.createHash()`]: https://nodejs.org/dist/latest-v4.x/docs/api/crypto.html#crypto_crypto_createhash_algorithm +[`Promise.all`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/all +[Apache 2.0 License]: http://www.apache.org/licenses/LICENSE-2.0 |