hamcrest-mutliline-text-matcher

This project provides a Hamcrest matcher that gives you better diagnostics for multi-line text in case of mismatches.

In a Nutshell

import static org.itsallcode.matcher.MultilineTextMatcher.matchesAllLines;

public class TestSomeText {
	@Test
	public void testMatchesAllLines() {
		assertThat("foo\nbar", MultilineTextMatcher.matchesAllLines("foo", "bar"));
	}
}

Features

This matcher provides the following features:

• Reports mismatches in the number of lines
• Marks where in the text a mismatch is found
• Makes invisible characters visible (CR, LF, TAB)

Information for Developers

• Developer Guide

Dependencies

Runtime Dependencies

The Hamcrest Multiline Text Matcher requires Java 11 to run.

Test Dependencies

Test Dependencies

Maven Plug-ins

Development

Generate / update license file header

mvn license:update-file-header

Run local sonar analysis

mvn clean org.jacoco:jacoco-maven-plugin:prepare-agent package sonar:sonar \
    -Dsonar.host.url=https://sonarcloud.io \
    -Dsonar.organization=itsallcode \
    -Dsonar.login=[token]

See analysis results at https://sonarcloud.io/dashboard?id=org.itsallcode%3Ahamcrest-mutliline-text-matcher

Check for updated dependencies / plugins

mvn versions:display-dependency-updates

mvn versions:display-plugin-updates

Publishing to JCenter

1. Add the following to your ~/.m2/settings.xml:

   <settings>
       <servers>
           <server>
               <id>ossrh</id>
               <username>your-jira-id</username>
               <password>your-jira-pwd</password>
           </server>
       </servers>
       <profiles>
           <profile>
               <id>ossrh</id>
               <activation>
                   <activeByDefault>true</activeByDefault>
               </activation>
               <properties>
                   <gpg.executable>gpg</gpg.executable>
                   <gpg.passphrase>the_pass_phrase</gpg.passphrase>
               </properties>
           </profile>
       </profiles>
   </settings>

2. Checkout the master branch.

3. Update version in pom.xml, commit and push.

4. Run command

   mvn -DskipSigningArtifacts=false clean deploy

5. Create a release of the master branch on GitHub.

6. After some time the release will be available at Maven Central.