find-cypress-specs 1.0.3 → 1.2.0

package/README.md

@@ -8,6 +8,27 @@ $ npx find-cypress-specs
 cypress/e2e/spec.js,cypress/e2e/featureA/user.js
 ```
 
+## Test names
+
+You can print each spec file with the suite and test names inside of it (found using [find-test-names](https://github.com/bahmutov/find-test-names))
+
+```bash
+$ npx find-cypress-specs --names
+# prints something like
+
+cypress/e2e/spec.js
+└─ parent suite [@main]
+  ├─ works
+  └─ inner suite
+    └─ shows something [@user]
+
+cypress/e2e/featureA/user.js
+├─ works
+└⊙ needs to be written
+```
+
+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.
+
 ## 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.

package/bin/find.js

@@ -1,6 +1,37 @@
 #!/usr/bin/env node
 
+const arg = require('arg')
 const { getSpecs } = require('../src')
+const fs = require('fs')
+const pluralize = require('pluralize')
+const { getTestNames, formatTestList } = require('find-test-names')
+
+const args = arg({
+  '--names': Boolean,
+
+  // aliases
+  '-n': '--names',
+})
 
 const specs = getSpecs()
-console.log(specs.join(','))
+if (args['--names']) {
+  if (!specs.length) {
+    console.log('no specs found')
+  } else {
+    console.log('')
+    specs.forEach((filename) => {
+      const source = fs.readFileSync(filename, 'utf8')
+      const result = getTestNames(source, true)
+      // enable if need to debug the parsed test
+      // console.dir(result.structure, { depth: null })
+
+      const testCount = pluralize('test', result.testNames.length, true)
+
+      console.log('%s (%s)', filename, testCount)
+      console.log(formatTestList(result.structure))
+      console.log('')
+    })
+  }
+} else {
+  console.log(specs.join(','))
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "find-cypress-specs",
-  "version": "1.0.3",
+  "version": "1.2.0",
   "description": "Find Cypress spec files using the config settings",
   "main": "src",
   "files": [
@@ -14,6 +14,7 @@
     "test": "ava",
     "cy:run": "DEBUG=cypress:cli,cypress:server:specs cypress run",
     "demo": "DEBUG=find-cypress-specs node ./bin/find",
+    "demo-names": "node ./bin/find --names",
     "semantic-release": "semantic-release"
   },
   "repository": {
@@ -36,8 +37,11 @@
     "semantic-release": "^18.0.1"
   },
   "dependencies": {
+    "arg": "^5.0.1",
     "debug": "^4.3.3",
+    "find-test-names": "^1.9.3",
     "globby": "^11.0.4",
-    "minimatch": "^3.0.4"
+    "minimatch": "^3.0.4",
+    "pluralize": "^8.0.0"
   }
 }

package/src/index.js

@@ -59,7 +59,8 @@ function findCypressSpecs(opts = {}) {
   }
 
   const filtered = files.filter(doesNotMatchAllIgnoredPatterns)
-  debug('filtered specs %o', filtered)
+  debug('filtered %d specs', filtered.length)
+  debug(filtered.join('\n'))
 
   // return spec files with the added integration folder prefix
   return filtered.map((file) => path.join(options.integrationFolder, file))