find-cypress-specs 1.4.0 → 1.8.0

package/README.md

@@ -31,6 +31,22 @@ found 2 specs (4 tests, 1 pending)
 
 Where the tags are listed inside `[ ... ]` (see [cypress-grep](https://github.com/cypress-io/cypress-grep)) and the [pending tests](https://glebbahmutov.com/blog/cypress-test-statuses/) are marked with `⊙` character.
 
+## Test tags
+
+You can count tags attached to the individual tests using `--tags` arguments
+
+```
+$ npx find-cypress-specs --tags
+# prints the tags table sorted by tag
+
+Tag    Tests
+-----  ----------
+@sign  1
+@user  2
+```
+
+Each tag count includes the tests that use the tag directly, and the _effective_ tags applied from the parent suites.
+
 ## Details
 
 Cypress uses the resolved [configuration values](https://on.cypress.io/configuration) to find the spec files to run. It searches the `integrationFolder` for all patterns listed in `testFiles` and removes any files matching the `ignoreTestFiles` patterns.
@@ -41,6 +57,10 @@ You can see how Cypress finds the specs using `DEBUG=cypress:cli,cypress:server:
 
 Run the utility with environment variable `DEBUG=find-cypress-specs` to see the verbose logs
 
+## Videos
+
+- [Use Ava Snapshots And Execa-wrap To Write End-to-End Tests For CLI Utilities](https://youtu.be/rsw17RqP0G0)
+
 ## Small print
 
 Author: Gleb Bahmutov <gleb.bahmutov@gmail.com> © 2022

package/bin/find.js

@@ -4,24 +4,38 @@ const arg = require('arg')
 const { getSpecs } = require('../src')
 const fs = require('fs')
 const pluralize = require('pluralize')
-const { getTestNames, formatTestList } = require('find-test-names')
+const { getTestNames, formatTestList, countTags } = require('find-test-names')
+const consoleTable = require('console.table')
 
 const args = arg({
   '--names': Boolean,
+  '--tags': Boolean,
+  '--json': Boolean,
 
   // aliases
   '-n': '--names',
+  '--name': '--names',
+  '-t': '--tags',
+  '--tag': '--tags',
+  '-j': '--json',
 })
 
 const specs = getSpecs()
-if (args['--names']) {
+if (args['--names'] || args['--tags']) {
   if (!specs.length) {
     console.log('no specs found')
   } else {
     console.log('')
     let testsN = 0
     let pendingTestsN = 0
+
+    // counts the number of tests for each tag across all specs
+    const tagTestCounts = {}
+
+    const jsonResults = {}
+
     specs.forEach((filename) => {
+      jsonResults[filename] = []
       const source = fs.readFileSync(filename, 'utf8')
       const result = getTestNames(source, true)
       // enable if need to debug the parsed test
@@ -31,35 +45,74 @@ if (args['--names']) {
       const testCount = pluralize('test', result.testNames.length, true)
       pendingTestsN += result.pendingTestCount
 
-      if (result.pendingTestCount) {
-        console.log(
-          '%s (%s, %d pending)',
-          filename,
-          testCount,
-          result.pendingTestCount,
-        )
+      if (args['--names']) {
+        if (args['--json']) {
+          result.structure.forEach((t) => {
+            if (t.type === 'test') {
+              jsonResults[filename].push(t.name)
+            } else if (t.type === 'suite') {
+              jsonResults[filename].push(t.name)
+            }
+          })
+        } else {
+          if (result.pendingTestCount) {
+            console.log(
+              '%s (%s, %d pending)',
+              filename,
+              testCount,
+              result.pendingTestCount,
+            )
+          } else {
+            console.log('%s (%s)', filename, testCount)
+          }
+          console.log(formatTestList(result.structure))
+          console.log('')
+        }
+      }
+
+      if (args['--tags']) {
+        const specTagCounts = countTags(result.structure)
+        Object.keys(specTagCounts).forEach((tag) => {
+          if (!(tag in tagTestCounts)) {
+            tagTestCounts[tag] = specTagCounts[tag]
+          } else {
+            tagTestCounts[tag] += specTagCounts[tag]
+          }
+        })
+      }
+    })
+
+    if (args['--names']) {
+      if (args['--json']) {
+        console.log(JSON.stringify(jsonResults, null, 2))
       } else {
-        console.log('%s (%s)', filename, testCount)
+        if (pendingTestsN) {
+          console.log(
+            'found %s (%s, %d pending)',
+            pluralize('spec', specs.length, true),
+            pluralize('test', testsN, true),
+            pendingTestsN,
+          )
+        } else {
+          console.log(
+            'found %s (%s)',
+            pluralize('spec', specs.length, true),
+            pluralize('test', testsN, true),
+          )
+        }
       }
-      console.log(formatTestList(result.structure))
       console.log('')
-    })
+    }
 
-    if (pendingTestsN) {
-      console.log(
-        'found %s (%s, %d pending)',
-        pluralize('spec', specs.length, true),
-        pluralize('test', testsN, true),
-        pendingTestsN,
-      )
-    } else {
-      console.log(
-        'found %s (%s)',
-        pluralize('spec', specs.length, true),
-        pluralize('test', testsN, true),
-      )
+    if (args['--tags']) {
+      const tagEntries = Object.entries(tagTestCounts)
+      const sortedTagEntries = tagEntries.sort((a, b) => {
+        // every entry is [tag, count], so compare the tags
+        return a[0].localeCompare(b[0])
+      })
+      const table = consoleTable.getTable(['Tag', 'Tests'], sortedTagEntries)
+      console.log(table)
     }
-    console.log('')
   }
 } else {
   console.log(specs.join(','))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "find-cypress-specs",
-  "version": "1.4.0",
+  "version": "1.8.0",
   "description": "Find Cypress spec files using the config settings",
   "main": "src",
   "files": [
@@ -15,6 +15,8 @@
     "cy:run": "DEBUG=cypress:cli,cypress:server:specs cypress run",
     "demo": "DEBUG=find-cypress-specs node ./bin/find",
     "demo-names": "node ./bin/find --names",
+    "demo-tags": "node ./bin/find --tags",
+    "demo-names-and-tags": "node ./bin/find --names --tags",
     "semantic-release": "semantic-release"
   },
   "repository": {
@@ -33,13 +35,15 @@
   "devDependencies": {
     "ava": "^4.0.0",
     "cypress": "^9.2.0",
+    "execa-wrap": "^1.4.0",
     "prettier": "^2.5.1",
     "semantic-release": "^18.0.1"
   },
   "dependencies": {
     "arg": "^5.0.1",
+    "console.table": "^0.10.0",
     "debug": "^4.3.3",
-    "find-test-names": "^1.12.1",
+    "find-test-names": "^1.14.1",
     "globby": "^11.0.4",
     "minimatch": "^3.0.4",
     "pluralize": "^8.0.0"