{"id":14969275,"url":"https://github.com/cucumber/tag-expressions","last_synced_at":"2025-04-05T17:05:46.551Z","repository":{"id":37396295,"uuid":"412500959","full_name":"cucumber/tag-expressions","owner":"cucumber","description":"Cucumber tag expression parser","archived":false,"fork":false,"pushed_at":"2024-10-29T03:52:32.000Z","size":4928,"stargazers_count":9,"open_issues_count":6,"forks_count":8,"subscribers_count":67,"default_branch":"main","last_synced_at":"2024-10-29T14:46:55.451Z","etag":null,"topics":["go","java","javascript","perl","polyglot-release","python","ruby","tidelift"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cucumber.png","metadata":{"funding":{"open_collective":"cucumber","github":"cucumber"},"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-10-01T14:33:13.000Z","updated_at":"2024-10-29T03:51:50.000Z","dependencies_parsed_at":"2023-12-24T11:26:42.813Z","dependency_job_id":"8839d5c6-e675-47d5-921c-a9c9072aa7d1","html_url":"https://github.com/cucumber/tag-expressions","commit_stats":{"total_commits":1462,"total_committers":37,"mean_commits":"39.513513513513516","dds":0.5376196990424076,"last_synced_commit":"ab16b66199a55a9c86fdae6857867b661e6205b3"},"previous_names":[],"tags_count":44,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cucumber%2Ftag-expressions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cucumber%2Ftag-expressions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cucumber%2Ftag-expressions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cucumber%2Ftag-expressions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cucumber","download_url":"https://codeload.github.com/cucumber/tag-expressions/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247369952,"owners_count":20927928,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","java","javascript","perl","polyglot-release","python","ruby","tidelift"],"created_at":"2024-09-24T13:41:28.535Z","updated_at":"2025-04-05T17:05:46.520Z","avatar_url":"https://github.com/cucumber.png","language":"Python","funding_links":["https://opencollective.com/cucumber","https://github.com/sponsors/cucumber"],"categories":["Python"],"sub_categories":[],"readme":"[![test-go](https://github.com/cucumber/tag-expressions/actions/workflows/test-go.yml/badge.svg)](https://github.com/cucumber/tag-expressions/actions/workflows/test-go.yml)\n[![test-java](https://github.com/cucumber/tag-expressions/actions/workflows/test-java.yml/badge.svg)](https://github.com/cucumber/tag-expressions/actions/workflows/test-java.yml)\n[![test-javascript](https://github.com/cucumber/tag-expressions/actions/workflows/test-javascript.yml/badge.svg)](https://github.com/cucumber/tag-expressions/actions/workflows/test-javascript.yml)\n[![test-perl](https://github.com/cucumber/tag-expressions/actions/workflows/test-perl.yml/badge.svg)](https://github.com/cucumber/tag-expressions/actions/workflows/test-perl.yml)\n[![test-python](https://github.com/cucumber/tag-expressions/actions/workflows/test-python.yml/badge.svg)](https://github.com/cucumber/tag-expressions/actions/workflows/test-python.yml)\n[![test-ruby](https://github.com/cucumber/tag-expressions/actions/workflows/test-ruby.yml/badge.svg)](https://github.com/cucumber/tag-expressions/actions/workflows/test-ruby.yml)\n\n# Tag Expressions\n\nTag Expressions is a simple query language for tags. The simplest tag expression is\nsimply a single tag, for example:\n\n    @smoke\n\nA slightly more elaborate expression may combine tags, for example:\n\n    @smoke and not @ui\n\nTag Expressions are used for two purposes:\n\n1. Run a subset of scenarios (using the `--tags expression` option of the [command line](https://cucumber.io/docs/cucumber/api/#running-cucumber))\n2. Specify that a hook should only run for a subset of scenarios (using [conditional hooks](https://cucumber.io/docs/cucumber/api/#hooks))\n\nTag Expressions are [boolean expressions](https://en.wikipedia.org/wiki/Boolean_expression)\nof tags with the logical operators `and`, `or` and `not`.\n\nFor more complex Tag Expressions you can use parenthesis for clarity, or to change operator precedence:\n\n    (@smoke or @ui) and (not @slow)\n\n## Escaping\n\nIf you need to use one of the reserved characters `(`, `)`, `\\` or ` ` (whitespace) in a tag,\nyou can escape it with a `\\`. Examples:\n\n| Gherkin Tag   | Escaped Tag Expression |\n| ------------- | ---------------------- |\n| @x(y)         | @x\\\\(y\\\\)              |\n| @x\\y          | @x\\\\\\\\y                |\n\n## Migrating from old style tags\n\nOlder versions of Cucumber used a different syntax for tags. The list below\nprovides some examples illustrating how to migrate to tag expressions.\n\n| Old style command line        | Cucumber Expressions style command line |\n| ----------------------------- | --------------------------------------- |\n| --tags @dev                   | --tags @dev                             |\n| --tags ~@dev                  | --tags \"not @dev\"                       |\n| --tags @foo,@bar              | --tags \"@foo or @bar\"                   |\n| --tags @foo --tags @bar       | --tags \"@foo and bar\"                   |\n| --tags ~@foo --tags @bar,@zap | --tags \"not @foo and (@bar or @zap)\"    |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcucumber%2Ftag-expressions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcucumber%2Ftag-expressions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcucumber%2Ftag-expressions/lists"}