@bahmutov/cy-grep 1.4.2 → 1.5.0

package/README.md

@@ -1,4 +1,4 @@
-# @bahmutov/cy-grep ![cypress version](https://img.shields.io/badge/cypress-12.4.1-brightgreen)
+# @bahmutov/cy-grep ![cypress version](https://img.shields.io/badge/cypress-12.7.0-brightgreen)
 
 > Filter tests using substring or tag
 
@@ -19,13 +19,25 @@ All other tests will be marked pending, see why in the [Cypress test statuses](h
 
 If you have multiple spec files, all specs will be loaded, and every test will be filtered the same way, since the grep is run-time operation and cannot eliminate the spec files without loading them. If you want to run only specific tests, use the built-in [--spec](https://on.cypress.io/command-line#cypress-run-spec-lt-spec-gt) CLI argument.
 
-Watch the video [intro to cypress-grep plugin](https://www.youtube.com/watch?v=HS-Px-Sghd8) and study my 🎓 Cypress course [Cypress Plugins](https://cypress.tips/courses/cypress-plugins).
+## Training
 
-Table of Contents
+Watch the video [intro to cypress-grep plugin](https://www.youtube.com/watch?v=HS-Px-Sghd8) and study my 🎓 Cypress course [Cypress Plugins](https://cypress.tips/courses/cypress-plugins):
+
+- [Lesson k1: Set up the test grep plugin](https://cypress.tips/courses/cypress-plugins/lessons/k1)
+- [Lesson k2: Filter the tests using test and suite tags](https://cypress.tips/courses/cypress-plugins/lessons/k2)
+- [Lesson k3: Filter the specs without the tag we want to run](https://cypress.tips/courses/cypress-plugins/lessons/k3)
+- [Lesson k4: Filter the tests to run using several tags](https://cypress.tips/courses/cypress-plugins/lessons/k4)
+- [Lesson k5: Filter the tests to run using OR of several tags](https://cypress.tips/courses/cypress-plugins/lessons/k5)
+- [Lesson k6: Repeat selected tests N times](https://cypress.tips/courses/cypress-plugins/lessons/k6)
+- [Lesson k7: Pick the tests to run in the interactive mode](https://cypress.tips/courses/cypress-plugins/lessons/k7)
+
+## Table of Contents
 
 <!-- MarkdownTOC autolink="true" -->
 
 - [@bahmutov/cy-grep ](#bahmutovcy-grep-)
+  - [Training](#training)
+  - [Table of Contents](#table-of-contents)
   - [Install](#install)
     - [Support file](#support-file)
     - [Config file](#config-file)
@@ -72,7 +84,7 @@ npm i -D @bahmutov/cy-grep
 yarn add -D @bahmutov/cy-grep
 ```
 
-**Note**: @bahmutov/cy-grep only works with Cypress version >= 10.
+**Note**: @bahmutov/cy-grep should work with all Cypress versions, but I mostly test it on the newest versions.
 
 ### Support file
 

package/package.json

@@ -1,26 +1,28 @@
 {
   "name": "@bahmutov/cy-grep",
-  "version": "1.4.2",
+  "version": "1.5.0",
   "description": "Filter Cypress tests using title or tags",
   "main": "src/support.js",
   "scripts": {
     "cy:run": "cypress run --config specPattern='**/unit.js'",
     "cy:open": "cypress open --e2e -b electron --config specPattern='**/unit.js'",
     "badges": "npx -p dependency-version-badge update-badge cypress",
-    "semantic-release": "semantic-release"
+    "semantic-release": "semantic-release",
+    "deps": "npm audit --report --omit dev"
   },
   "dependencies": {
     "cypress-plugin-config": "^1.2.0",
     "debug": "^4.3.2",
-    "find-test-names": "1.26.0",
+    "find-cypress-specs": "^1.29.4",
+    "find-test-names": "1.28.1",
     "globby": "^11.0.4"
   },
   "devDependencies": {
-    "cypress": "12.4.1",
+    "cypress": "12.7.0",
     "cypress-each": "^1.11.0",
     "cypress-expect": "^3.1.0",
     "prettier": "^2.8.1",
-    "semantic-release": "^20.1.0",
+    "semantic-release": "^20.1.1",
     "typescript": "^4.7.4"
   },
   "peerDependencies": {

package/src/plugin.js

@@ -1,27 +1,19 @@
+// @ts-check
 const debug = require('debug')('cy-grep')
 const globby = require('globby')
+
+const { getSpecs } = require('find-cypress-specs')
 const { getTestNames, findEffectiveTestTags } = require('find-test-names')
 const fs = require('fs')
+const path = require('path')
 const { version } = require('../package.json')
 const { parseGrep, shouldTestRun } = require('./utils')
 
-/**
- * Prints the cy-grep environment values if any.
- * @param {Cypress.ConfigOptions} config
- */
-function cypressGrepPlugin(config) {
-  if (!config || !config.env) {
-    return config
-  }
+const isCypressV9 = (config) => !('specPattern' in config)
 
+function getGrepSettings(config) {
   const { env } = config
 
-  if (!config.specPattern) {
-    throw new Error(
-      'Incompatible versions detected, cy-grep requires Cypress 10.0.0+',
-    )
-  }
-
   debug('cy-grep plugin version %s', version)
   debug('Cypress config env object: %o', env)
 
@@ -58,20 +50,24 @@ function cypressGrepPlugin(config) {
     console.log('cy-grep: will omit filtered tests')
   }
 
-  const { specPattern, excludeSpecPattern } = config
-  const integrationFolder = env.grepIntegrationFolder || process.cwd()
-
   const grepFilterSpecs = env.grepFilterSpecs === true
 
+  return { grep, grepTags, grepFilterSpecs }
+}
+
+/**
+ * Prints the cy-grep environment values if any.
+ * @param {Cypress.ConfigOptions} config
+ */
+function cypressGrepPlugin(config) {
+  if (!config || !config.env) {
+    return config
+  }
+
+  const { grep, grepTags, grepFilterSpecs } = getGrepSettings(config)
+
   if (grepFilterSpecs) {
-    debug('specPattern', specPattern)
-    debug('excludeSpecPattern', excludeSpecPattern)
-    debug('integrationFolder', integrationFolder)
-    const specFiles = globby.sync(specPattern, {
-      cwd: integrationFolder,
-      ignore: excludeSpecPattern,
-      absolute: true,
-    })
+    const specFiles = getSpecs(config)
 
     debug('found %d spec files', specFiles.length)
     debug('%o', specFiles)
@@ -86,7 +82,7 @@ function cypressGrepPlugin(config) {
         const text = fs.readFileSync(specFile, { encoding: 'utf8' })
 
         try {
-          const names = getTestNames(text)
+          const names = getTestNames(text, false)
           const testAndSuiteNames = names.suiteNames.concat(names.testNames)
 
           debug('spec file %s', specFile)
@@ -127,7 +123,7 @@ function cypressGrepPlugin(config) {
             const requiredTags = testTags[testTitle].requiredTags
             return shouldTestRun(
               parsedGrep,
-              null,
+              undefined,
               effectiveTags,
               false,
               requiredTags,
@@ -173,7 +169,25 @@ function cypressGrepPlugin(config) {
     }
 
     if (greppedSpecs.length) {
-      config.specPattern = greppedSpecs
+      if (isCypressV9(config)) {
+        debug('setting selected %d specs (< v10)', greppedSpecs.length)
+        // @ts-ignore
+        const integrationFolder = config.integrationFolder
+        const relativeNames = greppedSpecs.map((filename) =>
+          path.relative(integrationFolder, filename),
+        )
+        debug(
+          'specs in the integration folder %s %s',
+          integrationFolder,
+          relativeNames.join(', '),
+        )
+        // @ts-ignore
+        config.testFiles = relativeNames.join(',')
+      } else {
+        debug('setting selected %d specs (>= v10)', greppedSpecs.length)
+        // @ts-ignore
+        config.specPattern = greppedSpecs
+      }
     } else {
       // hmm, we filtered out all specs, probably something is wrong
       console.warn('grep and/or grepTags has eliminated all specs')