featur(try-to-catch add

Author: coderaiser

.babelrc

@@ -0,0 +1,5 @@
+{
+  "presets": [
+    "env"
+  ]
+}

.eslintrc

@@ -0,0 +1,19 @@
+{
+    "env": {
+        "es6": true,
+        "node": true,
+        "browser": true
+    },
+    "parserOptions": {
+        "ecmaVersion": 2017,
+        "sourceType": "module"
+    },
+    "rules": {
+        "indent": ["error", 4],
+        "semi": "error",
+        "no-use-before-define": ["error", "nofunc"]
+    },
+    "extends": [
+        "eslint:recommended"
+    ]
+}

.gitignore

@@ -0,0 +1,4 @@
+node_modules
+.nyc_output
+legacy
+

.npmignore

@@ -0,0 +1,3 @@
+.*
+test
+

.travis.yml

@@ -0,0 +1,17 @@
+language: node_js
+node_js:
+    - 6
+    - 8
+    - 9
+
+script:
+  - npm run lint
+  - npm run coverage && npm run report
+
+notifications:
+    email:
+        on_success: never
+        on_failure: change
+
+sudo: false
+

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) coderaiser
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,66 @@
+# Try to Catch [![License][LicenseIMGURL]][LicenseURL] [![NPM version][NPMIMGURL]][NPMURL] [![Dependency Status][DependencyStatusIMGURL]][DependencyStatusURL] [![Build Status][BuildStatusIMGURL]][BuildStatusURL] [![Coverage Status][CoverageIMGURL]][CoverageURL]
+
+[NPMIMGURL]:                https://img.shields.io/npm/v/try-to-catch.svg?style=flat
+[BuildStatusIMGURL]:        https://img.shields.io/travis/coderaiser/try-to-catch/master.svg?style=flat
+[DependencyStatusIMGURL]:   https://img.shields.io/gemnasium/coderaiser/try-to-catch.svg?style=flat
+[LicenseIMGURL]:            https://img.shields.io/badge/license-MIT-317BF9.svg?style=flat
+[NPMURL]:                   https://npmjs.org/package/try-to-catch "npm"
+[BuildStatusURL]:           https://travis-ci.org/coderaiser/try-to-catch  "Build Status"
+[DependencyStatusURL]:      https://gemnasium.com/coderaiser/try-to-catch "Dependency Status"
+[LicenseURL]:               https://tldrlegal.com/license/mit-license "MIT License"
+
+[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, [arg1, arg2, ..., argN])
+
+Wrap function to `await try-catch block` resolve `[error, result]`;
+
+### Example
+
+```js
+const fs = require('fs');
+const tryCatch = require('.');
+const {promisify} = require('util');
+const readFile = promisify(fs.readFile);
+const readDir = promisify(fs.readdir);
+
+read(process.argv[2])
+    .then(console.log)
+    .catch(console.error);
+
+async function read(path) {
+    const [error, data] = await tryCatch(readFile, path, 'utf8');
+    
+    if (!error)
+        return data;
+    
+    if (error.code !== 'EISDIR')
+        return error;
+    
+    return await readDir(path);
+}
+```
+
+## Environments
+
+In old `node.js` environments that not fully supports `es2015`, `try-to-catch` can be used with:
+
+```js
+var tryToCatch = require('try-to-catch/legacy');
+```
+
+## License
+
+MIT
+

lib/try-to-catch.js

@@ -0,0 +1,18 @@
+'use strict';
+
+const success = (a) => [null, a];
+const fail = (a) => [a];
+
+module.exports = (fn, ...args) => {
+    check(fn);
+    
+    return fn(...args)
+        .then(success)
+        .catch(fail);
+};
+
+function check(fn) {
+    if (typeof fn !== 'function')
+        throw Error('fn should be a function!');
+}
+

package.json

@@ -0,0 +1,44 @@
+{
+  "name": "try-to-catch",
+  "version": "1.0.0",
+  "author": "coderaiser <[email protected]> (https://github.com/coderaiser)",
+  "description": "function try-catch wrapper for promises",
+  "homepage": "http://github.com/coderaiser/try-to-catch",
+  "main": "lib/try-to-catch.js",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/coderaiser/try-to-catch.git"
+  },
+  "scripts": {
+    "test": "tape 'test/*.js'",
+    "watch:test": "nodemon -w lib -w test -x \"npm test\"",
+    "lint": "eslint lib test",
+    "coverage": "nyc npm test",
+    "report": "nyc report --reporter=text-lcov | coveralls",
+    "build": "babel lib -d legacy",
+    "wisdom": "redrun build legacy",
+    "legacy": "echo \"require('./try-to-catch')\"> legacy/index.js"
+  },
+  "dependencies": {
+  },
+  "keywords": [
+    "try",
+    "catch",
+    "function",
+    "promise",
+    "async",
+    "await",
+    "try-catch"
+  ],
+  "devDependencies": {
+    "babel-cli": "^6.26.0",
+    "babel-preset-env": "^1.6.1",
+    "coveralls": "^3.0.0",
+    "eslint": "^4.17.0",
+    "nodemon": "^1.14.12",
+    "nyc": "^11.4.1",
+    "redrun": "^5.10.2",
+    "tape": "^4.8.0"
+  },
+  "license": "MIT"
+}

test/try-to-catch.js

@@ -0,0 +1,32 @@
+'use strict';
+
+const test = require('tape');
+const tryToCatch = require('..');
+
+test('try-to-catch: no args', (t) => {
+    const fn = () => tryToCatch();
+    
+    t.throws(fn, /fn should be a function!/, 'should throw');
+    t.end();
+});
+
+test('try-to-catch: resolves', async (t) => {
+    const message = 'hello';
+    const fn = (a) => Promise.resolve(a);
+    
+    const [, result] = await tryToCatch(fn, message);
+    
+    t.equal(result, message, 'should equal');
+    t.end();
+});
+
+test('try-to-catch: rejects', async (t) => {
+    const message = 'hello';
+    const fn = (a) => Promise.reject(a);
+    
+    const [error] = await tryToCatch(fn, message);
+    
+    t.equal(error, message, 'should equal');
+    t.end();
+});
+