Package it.tidalwave.util.test

Class FileComparisonUtils

java.lang.Object

it.tidalwave.util.test.FileComparisonUtils

public class FileComparisonUtils
extends java.lang.Object

A utility class to compare two text files and assert that they have the same contents.

Author:

Fabrizio Giudici

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	P_TABULAR_LIMIT
static java.lang.String	P_TABULAR_OUTPUT

Constructor Summary

Constructors

Constructor	Description
FileComparisonUtils()

Method Summary

Modifier and Type	Method	Description
static void	assertSameContents(java.io.File expectedFile, java.io.File actualFile)	Asserts that two files have the same contents.
static void	assertSameContents(java.nio.file.Path expectedFile, java.nio.file.Path actualFile)	Asserts that two files have the same contents.
static void	assertSameContents(java.util.List<java.lang.String> expected, java.util.List<java.lang.String> actual)	Asserts that two collections of strings have the same contents.
static java.lang.String	commonPrefix(java.lang.String s1, java.lang.String s2)	Given a string that represents a path whose segments are separated by the standard separator of the platform, returns the common prefix - which means the common directory parents.
static java.util.List<java.lang.String>	fileToStrings(java.io.File file)	Reads a file into a list of strings.
static java.util.List<java.lang.String>	fileToStrings(java.io.InputStream is)	Reads an input stream into a list of strings.
static java.util.List<java.lang.String>	fileToStrings(java.lang.String path)	Reads a classpath resource into a list of strings.
static java.util.List<java.lang.String>	stringToStrings(java.lang.String string)	Converts a string which contains newlines into a list of strings.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

P_TABULAR_OUTPUT

public static final java.lang.String P_TABULAR_OUTPUT

P_TABULAR_LIMIT

public static final java.lang.String P_TABULAR_LIMIT

Constructor Detail

FileComparisonUtils

public FileComparisonUtils()

Method Detail

assertSameContents

public static void assertSameContents(@Nonnull
                                      java.nio.file.Path expectedFile,
                                      @Nonnull
                                      java.nio.file.Path actualFile)
                               throws java.io.IOException

Asserts that two files have the same contents.

Parameters:

expectedFile - the file with the expected contents

actualFile - the file with the contents to probe

Throws:

java.io.IOException - in case of error

assertSameContents

public static void assertSameContents(@Nonnull
                                      java.io.File expectedFile,
                                      @Nonnull
                                      java.io.File actualFile)
                               throws java.io.IOException

Asserts that two files have the same contents.

Parameters:

expectedFile - the file with the expected contents

actualFile - the file with the contents to probe

Throws:

java.io.IOException - in case of error

assertSameContents

public static void assertSameContents(@Nonnull
                                      java.util.List<java.lang.String> expected,
                                      @Nonnull
                                      java.util.List<java.lang.String> actual)

Asserts that two collections of strings have the same contents.

Parameters:

expected - the expected values

actual - the actual values

stringToStrings

@Nonnull
public static java.util.List<java.lang.String> stringToStrings(@Nonnull
                                                               java.lang.String string)
                                                        throws java.io.IOException

Converts a string which contains newlines into a list of strings.

Parameters:

string - the source

Returns:

the strings

Throws:

java.io.IOException - in case of error

fileToStrings

@Nonnull
public static java.util.List<java.lang.String> fileToStrings(@Nonnull
                                                             java.io.File file)
                                                      throws java.io.IOException

Reads a file into a list of strings.

Parameters:

file - the file

Returns:

the strings

Throws:

java.io.IOException - in case of error

fileToStrings

@Nonnull
public static java.util.List<java.lang.String> fileToStrings(@Nonnull
                                                             java.lang.String path)
                                                      throws java.io.IOException

Reads a classpath resource into a list of strings.

Parameters:

path - the path of the classpath resource

Returns:

the strings

Throws:

java.io.IOException - in case of error

fileToStrings

@Nonnull
public static java.util.List<java.lang.String> fileToStrings(@Nonnull
                                                             java.io.InputStream is)
                                                      throws java.io.IOException

Reads an input stream into a list of strings.

Parameters:

is - the input stream

Returns:

the strings

Throws:

java.io.IOException - in case of error

commonPrefix

@Nonnull
public static java.lang.String commonPrefix(@Nonnull
                                            java.lang.String s1,
                                            @Nonnull
                                            java.lang.String s2)

Given a string that represents a path whose segments are separated by the standard separator of the platform, returns the common prefix - which means the common directory parents.

Parameters:

s1 - the former string

s2 - the latter string

Returns:

the common prefix