[
https://issues.apache.org/jira/browse/SUREFIRE-1309?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16684779#comment-16684779
]
ASF GitHub Bot commented on SUREFIRE-1309:
------------------------------------------
Tibor17 commented on a change in pull request #138: SUREFIRE-1309: Clarifying
use of regular expressions for inclusion/exclusion
URL: https://github.com/apache/maven-surefire/pull/138#discussion_r232911709
##########
File path:
maven-surefire-plugin/src/site/apt/examples/inclusion-exclusion.apt.vm
##########
@@ -164,7 +164,16 @@ Inclusions and Exclusions of Tests
+---+
Note the syntax <<<%regex[expr]>>>, where <<<expr>>> is the actual
expression and the rest is just wrapping. Also
- note that regex matches are done over <<<*.class>>> files and not
<<<*.java>>> files.
+ note the following about the use of regular expressions:
+
+ * Regex matches are done over <<<*.class>>> files and not <<<*.java>>> files
+
+ * Regex matches are done over paths using slashes ("<<</>>>") and not
package names using dots ("<<<.>>>"), so the
+ "<<<.>>>" in <<<pkg.*Slow.*.class>>> is a regex metacharacter, which
happens to match any character, notably
+ the (forward) slashes ("<<</>>>") that make up the path. Slashes here
are <forward>, even on Windows
Review comment:
We have a plan to discontinue this old format in Version `3.0.0` and use
only `fully qualified class name` w/o regex. It does not make sense to maintain
current feature. It is complicated since we have to use the filter twice, on
file system and then in JUnit/TestNG f/w. In the future all paths will be just
classes (with dot `.`) and then the filter would work on file systems and test
frameworks.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
> Clarify %regex
> --------------
>
> Key: SUREFIRE-1309
> URL: https://issues.apache.org/jira/browse/SUREFIRE-1309
> Project: Maven Surefire
> Issue Type: Bug
> Affects Versions: 2.19.1
> Environment: Probably any environment
> Reporter: Sander Verhagen
> Assignee: Tibor Digana
> Priority: Major
> Fix For: 2.20
>
>
> It would be good to clarify the {{%regex ...}} feature:
> 1. While it is said to be regular expression, it really is a {{regular
> expression + ".class"}} kind of thing. This does not work (while it is proper
> regex):
> {noformat}.+\.class{noformat} The following works (while it is not proper
> regex): {noformat}.+.class{noformat}
> 2. Clarify that one is supposed to match slashes between packages and class
> name, not periods. The following [current
> documentation|http://maven.apache.org/components/surefire/maven-surefire-plugin/examples/inclusion-exclusion.html]
> doesn't clarify that by just using "{{.*}}":
> {noformat}!%regex[pkg.*Slow.*.class]{noformat}
> 3. Clarify what the expectations are in terms of escaping characters
> I just spend literally ten hours figuring out a complex regex, going into
> TeamCity (which by itself complicated the troubleshooting for me), and the
> documentation could have saved my butt, here.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)