@bahmutov/cy-grep 1.6.0 → 1.7.1

package/README.md

@@ -1,4 +1,4 @@
-# @bahmutov/cy-grep ![cypress version](https://img.shields.io/badge/cypress-12.7.0-brightgreen)
+# @bahmutov/cy-grep ![cypress version](https://img.shields.io/badge/cypress-12.8.1-brightgreen)
 
 > Filter tests using substring or tag
 
@@ -70,6 +70,7 @@ Watch the video [intro to cypress-grep plugin](https://www.youtube.com/watch?v=H
     - [Debugging in the browser](#debugging-in-the-browser)
   - [Examples](#examples)
   - [See also](#see-also)
+  - [cy-grep vs cypress-grep vs @cypress/grep](#cy-grep-vs-cypress-grep-vs-cypressgrep)
   - [Small Print](#small-print)
 
 <!-- /MarkdownTOC -->
@@ -288,6 +289,13 @@ If you can pass commas in the environment variable `grepTags`, you can use `,` t
 CYPRESS_grepTags=one,two npx cypress run
 ```
 
+If a specific tag is not found in the specs, you will get a warning in the terminal:
+
+```
+$ npx cypress run --env grepTags=@wrong-tag
+cy-grep: could not find the tag "@wrong-tag" in any of the specs
+```
+
 ### Tags in the test config object
 
 Cypress tests can have their own [test config object](https://on.cypress.io/configuration#Test-Configuration), and when using this plugin you can put the test tags there, either as a single tag string or as an array of tags.
@@ -643,8 +651,25 @@ To see how to debug this plugin, watch the video [Debug cypress-grep Plugin](htt
 - [cypress-select-tests](https://github.com/bahmutov/cypress-select-tests)
 - [cypress-skip-test](https://github.com/cypress-io/cypress-skip-test)
 
+## cy-grep vs cypress-grep vs @cypress/grep
+
+Many years ago I wrote a plugin `cypress-grep`. When I left the company Cypress, I transferred that MIT-licensed plugin to the Cypress GitHub organization. They moved it to the Cypress monorepo and renamed the NPM module `@cypress/grep`. I still use this grep plugin in some projects. When Cypress v10 was released, it broke some of the things in the plugin. Since I needed to fix it quickly and the monorepo setup is suboptimal, I forked the plugin back to my own repo `bahmutov/cy-grep` (this repo) and released under NPM name `@bahmutov/cy-grep`.
+
+I plan to maintain the plugin `@bahmutov/cy-grep` in the future, since I rely on it myself **a lot**.
+
 ## Small Print
 
+Author: Gleb Bahmutov &lt;gleb.bahmutov@gmail.com&gt; &copy; 2022
+
+- [@bahmutov](https://twitter.com/bahmutov)
+- [glebbahmutov.com](https://glebbahmutov.com)
+- [blog](https://glebbahmutov.com/blog)
+- [videos](https://www.youtube.com/glebbahmutov)
+- [presentations](https://slides.com/bahmutov)
+- [cypress.tips](https://cypress.tips)
+- [Cypress Tips & Tricks Newsletter](https://cypresstips.substack.com/)
+- [my Cypress courses](https://cypress.tips/courses)
+
 License: MIT - do anything with the code, but don't blame me if it does not work.
 
 Support: if you find any problems with this module, email / tweet /

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bahmutov/cy-grep",
-  "version": "1.6.0",
+  "version": "1.7.1",
   "description": "Filter Cypress tests using title or tags",
   "main": "src/support.js",
   "scripts": {
@@ -14,11 +14,11 @@
     "cypress-plugin-config": "^1.2.0",
     "debug": "^4.3.2",
     "find-cypress-specs": "^1.29.4",
-    "find-test-names": "1.28.1",
+    "find-test-names": "1.28.3",
     "globby": "^11.0.4"
   },
   "devDependencies": {
-    "cypress": "12.7.0",
+    "cypress": "12.8.1",
     "cypress-each": "^1.11.0",
     "cypress-expect": "^3.1.0",
     "prettier": "^2.8.1",

package/src/utils.js

@@ -37,13 +37,20 @@ function parseFullTitleGrep(s) {
 
 /**
  * Parses tags to grep for.
- * @param {string} s Tags string like "@tag1+@tag2"
+ * @param {string|string[]} s Tags string like "@tag1+@tag2", or array of tags
+ * @example
+ *  parseTagsGrep('@tag1+@tag2')
+ * @example
+ *  parseTagsGrep(['@tag1', '@tag2'])
  */
 function parseTagsGrep(s) {
   if (!s) {
     return []
   }
 
+  if (Array.isArray(s)) {
+    s = s.join(',')
+  }
   const explicitNotTags = []
 
   // top level split - using space or comma, each part is OR