builderman verion 0.1.0, initial commit/release.

node_modules/try-to-catch/README.md

@@ -0,0 +1,74 @@
+# Try to Catch [![NPM version][NPMIMGURL]][NPMURL] [![Build Status][BuildStatusIMGURL]][BuildStatusURL] [![Coverage Status][CoverageIMGURL]][CoverageURL]
+
+[NPMIMGURL]: https://img.shields.io/npm/v/try-to-catch.svg?style=flat&longCache=true
+[BuildStatusIMGURL]: https://img.shields.io/travis/coderaiser/try-to-catch/master.svg?style=flat&longCache=true
+[NPMURL]: https://npmjs.org/package/try-to-catch "npm"
+[BuildStatusURL]: https://travis-ci.org/coderaiser/try-to-catch "Build Status"
+[CoverageURL]: https://coveralls.io/github/coderaiser/try-to-catch?branch=master
+[CoverageIMGURL]: https://coveralls.io/repos/coderaiser/try-to-catch/badge.svg?branch=master&service=github
+
+Functional `try-catch` wrapper for `promises`.
+
+## Install
+
+```
+npm i try-to-catch
+```
+
+## API
+
+### tryToCatch(fn, [...args])
+
+Wrap function to avoid `try-catch` block, resolves `[error, result]`;
+
+### Example
+
+Simplest example with `async-await`:
+
+```js
+const tryToCatch = require('try-to-catch');
+const reject = Promise.reject.bind(Promise);
+await tryToCatch(reject, 'hi');
+// returns
+// [ Error: hi]
+```
+
+Can be used with functions:
+
+```js
+const tryToCatch = require('try-to-catch');
+await tryToCatch(() => 5);
+// returns
+[null, 5];
+```
+
+Advanced example:
+
+```js
+const {readFile, readdir} = require('fs/promises');
+const tryToCatch = require('try-to-catch');
+
+read(process.argv[2])
+    .then(console.log)
+    .catch(console.error);
+
+async function read(path) {
+    const [error, data] = await tryToCatch(readFile, path, 'utf8');
+    
+    if (!error)
+        return data;
+    
+    if (error.code !== 'EISDIR')
+        return error;
+    
+    return await readdir(path);
+}
+```
+
+## Related
+
+- [try-catch](https://github.com/coderaiser/try-catch "try-catch") - functional try-catch wrapper.
+
+## License
+
+MIT