supertape 6.13.0 → 7.1.0

package/ChangeLog

@@ -1,3 +1,34 @@
+2022.02.18, v7.1.0
+
+feature:
+- (supertape) exclude node_modules
+
+
+2022.02.17, v7.0.1
+
+fix:
+- (supertape) drop support of node < 16
+
+feature:
+- (package) madrun v9.0.0
+- (package) putout v25.0.0
+
+
+2022.02.14, v7.0.0
+
+fix:
+- chore(actions) add ability to fix
+
+feature:
+- supertape: check-scopes, check-assertions-count: enable by default
+
+
+2022.01.15, v6.13.1
+
+fix:
+- (supertape) revert: add exit code 5 for skip"
+
+
 2022.01.15, v6.13.0
 
 feature:

package/README.md

@@ -1,19 +1,25 @@
-# 📼 `Supertape` [![NPM version][NPMIMGURL]][NPMURL] [![Build Status][BuildStatusIMGURL]][BuildStatusURL] [![Coverage Status][CoverageIMGURL]][CoverageURL]
+# 📼 Supertape [![NPM version][NPMIMGURL]][NPMURL] [![Build Status][BuildStatusIMGURL]][BuildStatusURL] [![Coverage Status][CoverageIMGURL]][CoverageURL]
 
 [NPMURL]: https://npmjs.org/package/supertape "npm"
 [NPMIMGURL]: https://img.shields.io/npm/v/supertape.svg?style=flat&longCache=true
-[BuildStatusURL]: https://github.com/coderaiser/supertape/actions?query=workflow%3A%22Node+CI%22 "Build Status"
-[BuildStatusIMGURL]: https://github.com/coderaiser/supertape/workflows/Node%20CI/badge.svg
+[BuildStatusURL]: https://github.com/coderaiser/putout/actions?query=workflow%3A%22Node+CI%22 "Build Status"
+[BuildStatusIMGURL]: https://github.com/coderaiser/putout/workflows/Node%20CI/badge.svg
+[BuildStatusURL]: https://travis-ci.org/coderaiser/supertape "Build Status"
 [CoverageURL]: https://coveralls.io/github/coderaiser/supertape?branch=master
 [CoverageIMGURL]: https://coveralls.io/repos/coderaiser/supertape/badge.svg?branch=master&service=github
 
-[Tape](https://github.com/substack/tape) compatible [TAP](https://testanything.org/) test runner with superpowers. Contains:
+[![supertape](https://asciinema.org/a/Cgc3rDOfZAeDnJSxzEYpPfBMY.svg)](https://asciinema.org/a/Cgc3rDOfZAeDnJSxzEYpPfBMY)
+
+[Tape](https://github.com/substack/tape)-inspired [TAP](https://testanything.org/)-compatible simplest high speed test runner with superpowers.
+
+📼`Supertape` written from scratch after messing a lot with `tape`, it willing to be compatible with it as much as possible.
+and has a couple differences. It contains:
 
 - ability to work with [esm modules](https://nodejs.org/api/esm.html) (take a look at [mock-import](https://github.com/coderaiser/mock-import) for mocking).
 - shows colored diff when test not `equal` or not `deepEqual`;
 - produces deteiled stack traces for `async functions`;
-- as many `only` as you wish
-- ability to extend
+- as many `only` as you wish;
+- ability to extend;
 - smart timeouts for long running tests 🏃‍♂️(configured with `SUPERTAPE_TIMEOUT`);
 - more natural assertions: `expected, result` -> `result, expected`, for example:
 
@@ -27,8 +33,6 @@ Doesn't contain:
 - aliases, methods list much shorter;
 - `throws`, `doesNotThrows` - use [tryCatch](https://github.com/coderaiser/try-catch), [tryToCatch](https://github.com/coderaiser/try-to-catch) with `equal` instead.
 
-`Supertape` was written from scratch after messing a lot with `tape`, it inspired by `tape` and willing to be compatible with it.
-
 ## Install
 
 ```
@@ -44,8 +48,8 @@ Options
    -v, --version               output version information and exit
    -f, --format                use a specific output format - default: progress-bar/tap on CI
    -r, --require               require module
-   --check-scopes              check that messages contains scope: 'scope: message'
-   --check-assertions-count    check that assertion count is no more then 1
+   --no-check-scopes           do not check that messages contains scope: 'scope: message'
+   --no-check-assertions-count do not check that assertion count is no more then 1
    --no-check-duplicates       do not check messages for duplicates
 ```
 
@@ -63,20 +67,74 @@ test('tape: error', (t) => {
 });
 ```
 
-## Codemod
+## 🤷 How to migrate from `tape`?
+
+You can convert your codebase from `tape` to 📼`Supertape` with help of 🐊[`Putout`](https://github.com/coderaiser/putout), which has built-in [@putout/plugin-tape](https://github.com/coderaiser/putout/tree/master/packages/plugin-tape),
+which has a lot of rules that helps to write tests.
+Here is [result example](https://github.com/coderaiser/cloudcmd/commit/74d56f795d22e98937dce0641ee3c7514a79e9e6).
+
+## `ESLint` rules
+
+[`eslint-plugin-putout`](https://github.com/coderaiser/putout/tree/master/packages/eslint-plugin-putout#readme) has rules for 📼`Supertape`:
+
+- ✅ [`remove-newline-before-t-end`](https://github.com/coderaiser/putout/tree/master/packages/eslint-plugin-putout/lib/tape-remove-newline-before-t-end#readme)
+- ✅ [`add-newline-before-assertion`](https://github.com/coderaiser/putout/tree/master/packages/eslint-plugin-putout/lib/tape-add-newline-before-assertion#readme)
+- ✅ [`add-newline-between-tests`](https://github.com/coderaiser/putout/tree/master/packages/eslint-plugin-putout/lib/tape-add-newline-between-tests#readme)
+
+## Operators
+
+To simplify `supertape` core operators located in separate packages, called `operators`:
+
+Here is a list of built-int operators:
+
+| Package | Version |
+|--------|-------|
+| [`@supertape/operator-stub`](/packages/operator-stub) | [![npm](https://img.shields.io/npm/v/@supertape/operator-stub.svg?maxAge=86400)](https://www.npmjs.com/package/@supertape/operator-stub) |
+
+## Formatters
 
-You can convert your codebase from `tape` to `supertape` with help of a [putout](https://github.com/coderaiser/putout) and built-in [@putout/plugin-tape](https://github.com/coderaiser/putout/tree/master/packages/plugin-tape).
-Here is [example of a result](https://github.com/coderaiser/cloudcmd/commit/74d56f795d22e98937dce0641ee3c7514a79e9e6).
+There is a list of built-int `formatters` to customize output:
+
+| Package | Version |
+|--------|-------|
+| [`@supertape/formatter-tap`](/packages/formatter-tap) | [![npm](https://img.shields.io/npm/v/@supertape/formatter-tap.svg?maxAge=86400)](https://www.npmjs.com/package/@supertape/formatter-tap) |
+| [`@supertape/formatter-fail`](/packages/formatter-fail) | [![npm](https://img.shields.io/npm/v/@supertape/formatter-fail.svg?maxAge=86400)](https://www.npmjs.com/package/@supertape/formatter-fail) |
+| [`@supertape/formatter-short`](/packages/formatter-short) | [![npm](https://img.shields.io/npm/v/@supertape/formatter-short.svg?maxAge=86400)](https://www.npmjs.com/package/@supertape/formatter-short) |
+| [`@supertape/formatter-progress-bar`](/packages/formatter-progress-bar) | [![npm](https://img.shields.io/npm/v/@supertape/formatter-progress-bar.svg?maxAge=86400)](https://www.npmjs.com/package/@supertape/formatter-progress-bar) |
+| [`@supertape/formatter-json-lines`](/packages/formatter-json-lines) | [![npm](https://img.shields.io/npm/v/@supertape/formatter-json-lines.svg?maxAge=86400)](https://www.npmjs.com/package/@supertape/formatter-json-lines) |
 
 ## API
 
 ### Methods
 
-The assertion methods in `supertape` are heavily influenced or copied from the methods
-in [tape](https://github.com/substack/tape).
+The assertion methods in `supertape` are heavily influenced by [tape](https://github.com/substack/tape).
 
 ```js
 const test = require('supertape');
+const {sum} = require('./calc.js');
+
+test('calc: sum', (t) => {
+    const result = sum(1, 2);
+    const expected = 3;
+    
+    t.equal(result, expected);
+    t.end();
+});
+```
+
+or in `ESM`:
+
+```js
+import {test} from 'supertape';
+import {sum} from './calc.js';
+
+test('calc: sum', (t) => {
+    const result = sum(1, 2);
+    const expected = 3;
+    
+    t.equal(result, expected);
+    t.end();
+});
 ```
 
 ## test(name, cb)
@@ -176,9 +234,8 @@ const test = require('supertape');
 
 test('lib: arguments', async (t) => {
     throw Error('hello');
-    // will call t.fail() with an error
-    // will call t.end()
-    t.end();
+    // will call t.fail with an error
+    // will call t.end
 });
 
 test('lib: diff', (t) => {

package/help.json

@@ -3,7 +3,7 @@
     "-v, --version              ": "output version information and exit",
     "-f, --format               ": "use a specific output format - default: progress-bar/tap on CI",
     "-r, --require              ": "require module",
-    "--check-scopes             ": "check that messages contains scope: 'scope: message'",
-    "--check-assertions-count   ": "check that assertion count is no more then 1",
+    "--no-check-scopes          ": "do not check that messages contains scope: 'scope: message'",
+    "--no-check-assertions-count": "do not check that assertion count is no more then 1",
     "--no-check-duplicates      ": "do not check messages for duplicates"
 }

package/lib/cli.js

@@ -18,13 +18,13 @@ const {
     WAS_STOP,
     UNHANDLED,
     INVALID_OPTION,
-    SKIP,
 } = require('./exit-codes');
 
 const {isArray} = Array;
 
 const maybeFirst = (a) => isArray(a) ? a.pop() : a;
 const maybeArray = (a) => isArray(a) ? a : [a];
+const isExclude = (a) => !a.includes('node_modules');
 
 const removeDuplicates = (a) => Array.from(new Set(a));
 const filesCount = fullstore(0);
@@ -52,7 +52,6 @@ module.exports = async ({argv, cwd, stdout, stderr, exit}) => {
     
     const {
         failed,
-        skiped,
         code,
         message,
     } = result;
@@ -66,13 +65,8 @@ module.exports = async ({argv, cwd, stdout, stderr, exit}) => {
         return exit(code);
     }
     
-    if (isStop()) {
+    if (isStop())
         return exit(WAS_STOP);
-    }
-    
-    if (skiped) {
-        return exit(SKIP);
-    }
     
     return exit(OK);
 };
@@ -147,7 +141,7 @@ async function cli({argv, cwd, stdout, isStop}) {
     
     const allFiles = [];
     for (const arg of args._) {
-        const files = glob.sync(arg);
+        const files = glob.sync(arg).filter(isExclude);
         allFiles.push(...files);
     }
     
@@ -182,16 +176,13 @@ async function cli({argv, cwd, stdout, isStop}) {
     filesCount(files.length);
     
     if (!promises.length)
-        return {
-            failed: false,
-        };
+        return OK;
     
     await Promise.all(promises);
-    const [{failed, skiped}] = await once(supertape.run(), 'end');
+    const [{failed}] = await once(supertape.run(), 'end');
     
     return {
         failed,
-        skiped,
     };
 }
 

package/lib/exit-codes.js

@@ -5,7 +5,6 @@ const FAIL = 1;
 const WAS_STOP = 2;
 const UNHANDLED = 3;
 const INVALID_OPTION = 4;
-const SKIP = 5;
 
 module.exports = {
     OK,
@@ -13,6 +12,5 @@ module.exports = {
     WAS_STOP,
     UNHANDLED,
     INVALID_OPTION,
-    SKIP,
 };
 

package/lib/supertape.js

@@ -34,8 +34,8 @@ const defaultOptions = {
     isStop: () => false,
     checkDuplicates: true,
     checkIfEnded: true,
-    checkAssertionsCount: false,
-    checkScopes: false,
+    checkAssertionsCount: true,
+    checkScopes: true,
 };
 
 function _createEmitter({quiet, format, getOperators, isStop}) {
@@ -68,13 +68,13 @@ function _createEmitter({quiet, format, getOperators, isStop}) {
             harness.pipe(stdout);
         
         const operators = await getOperators();
-        const {failed, skiped} = await runTests(tests, {
+        const {failed} = await runTests(tests, {
             formatter,
             operators,
             isStop,
         });
         
-        emitter.emit('end', {failed, skiped});
+        emitter.emit('end', {failed});
     });
     
     return emitter;

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "supertape",
-  "version": "6.13.0",
+  "version": "7.1.0",
   "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
-  "description": "📼 Supertape fastest simplest test runner with lots of formatters",
+  "description": "📼 Supertape simplest high speed test runner with superpowers",
   "homepage": "http://github.com/coderaiser/supertape",
   "main": "./lib/supertape.js",
   "exports": {
@@ -77,22 +77,23 @@
     "@iocmd/wait": "^1.0.0",
     "c8": "^7.3.5",
     "check-dts": "^0.6.5",
-    "eslint": "^8.0.0-beta.0",
+    "eslint": "^8.0.0",
     "eslint-plugin-node": "^11.1.0",
     "eslint-plugin-putout": "^13.0.1",
-    "madrun": "^8.0.0",
+    "find-up": "^6.3.0",
+    "madrun": "^9.0.0",
     "mock-require": "^3.0.2",
     "montag": "^1.0.0",
     "nodemon": "^2.0.2",
     "pullout": "^4.0.0",
-    "putout": "^24.1.0",
+    "putout": "^25.0.0",
     "runsome": "^1.0.0",
     "try-catch": "^3.0.0",
     "typescript": "^4.4.4"
   },
   "license": "MIT",
   "engines": {
-    "node": ">=14"
+    "node": ">=16"
   },
   "publishConfig": {
     "access": "public"