Method Detail

• assertSniff

  public static void assertSniff(Extractor extractor,
                                 FakeExtractorInput input,
                                 boolean expectedResult)
                          throws IOException,
                                 InterruptedException

  Asserts that Extractor.sniff(ExtractorInput) returns the expectedResult for a given input, retrying repeatedly when FakeExtractorInput.SimulatedIOException is thrown.

  Parameters:

  extractor - The extractor to test.

  input - The extractor input.

  expectedResult - The expected return value.

  Throws:

  IOException - If reading from the input fails.

  InterruptedException - If interrupted while reading from the input.

• assertBehavior

  public static void assertBehavior(ExtractorAsserts.ExtractorFactory factory,
                                    String file)
                             throws IOException,
                                    InterruptedException

  Asserts that an extractor behaves correctly given valid input data. Can only be used from Robolectric tests.

  • Calls Extractor.seek(long, long) and Extractor.release() without calling Extractor.init(ExtractorOutput) to check these calls do not fail.
  • Calls assertOutput(Extractor, String, byte[], Context, boolean, boolean, boolean, boolean) with all possible combinations of "simulate" parameters.

  Parameters:

  factory - An ExtractorAsserts.ExtractorFactory which creates instances of the Extractor class which is to be tested.

  file - The path to the input sample.

  Throws:

  IOException - If reading from the input fails.

  InterruptedException - If interrupted while reading from the input.

• assertBehavior

  public static void assertBehavior(ExtractorAsserts.ExtractorFactory factory,
                                    String file,
                                    Context context)
                             throws IOException,
                                    InterruptedException

  Asserts that an extractor behaves correctly given valid input data:

  • Calls Extractor.seek(long, long) and Extractor.release() without calling Extractor.init(ExtractorOutput) to check these calls do not fail.
  • Calls assertOutput(Extractor, String, byte[], Context, boolean, boolean, boolean, boolean) with all possible combinations of "simulate" parameters.

  Parameters:

  factory - An ExtractorAsserts.ExtractorFactory which creates instances of the Extractor class which is to be tested.

  file - The path to the input sample.

  context - To be used to load the sample file.

  Throws:

  IOException - If reading from the input fails.

  InterruptedException - If interrupted while reading from the input.

• assertOutput

  public static void assertOutput(ExtractorAsserts.ExtractorFactory factory,
                                  String file,
                                  byte[] data,
                                  Context context)
                           throws IOException,
                                  InterruptedException

  Calls assertOutput(Extractor, String, byte[], Context, boolean, boolean, boolean, boolean) with all possible combinations of "simulate" parameters with sniffFirst set to true, and makes one additional call with the "simulate" and sniffFirst parameters all set to false.

  Parameters:

  factory - An ExtractorAsserts.ExtractorFactory which creates instances of the Extractor class which is to be tested.

  file - The path to the input sample.

  data - Content of the input file.

  context - To be used to load the sample file.

  Throws:

  IOException - If reading from the input fails.

  InterruptedException - If interrupted while reading from the input.

• assertOutput

  public static FakeExtractorOutput assertOutput(Extractor extractor,
                                                 String file,
                                                 byte[] data,
                                                 Context context,
                                                 boolean sniffFirst,
                                                 boolean simulateIOErrors,
                                                 boolean simulateUnknownLength,
                                                 boolean simulatePartialReads)
                                          throws IOException,
                                                 InterruptedException

  Asserts that extractor consumes sampleFile successfully and its output equals to a prerecorded output dump file with the name sampleFile + "". If simulateUnknownLength is true and sampleFile + "" exists, it's preferred.

  Parameters:

  extractor - The Extractor to be tested.

  file - The path to the input sample.

  data - Content of the input file.

  context - To be used to load the sample file.

  sniffFirst - Whether to sniff the data by calling Extractor.sniff(ExtractorInput) prior to consuming it.

  simulateIOErrors - Whether to simulate IO errors.

  simulateUnknownLength - Whether to simulate unknown input length.

  simulatePartialReads - Whether to simulate partial reads.

  Returns:

  The FakeExtractorOutput used in the test.

  Throws:

  IOException - If reading from the input fails.

  InterruptedException - If interrupted while reading from the input.

• assertThrows

  public static void assertThrows(ExtractorAsserts.ExtractorFactory factory,
                                  String sampleFile,
                                  Context context,
                                  Class<? extends Throwable> expectedThrowable)
                           throws IOException,
                                  InterruptedException

  Calls assertThrows(Extractor, byte[], Class, boolean, boolean, boolean) with all possible combinations of "simulate" parameters.

  Parameters:

  factory - An ExtractorAsserts.ExtractorFactory which creates instances of the Extractor class which is to be tested.

  sampleFile - The path to the input sample.

  context - To be used to load the sample file.

  expectedThrowable - Expected Throwable class.

  Throws:

  IOException - If reading from the input fails.

  InterruptedException - If interrupted while reading from the input.

  See Also:

  assertThrows(Extractor, byte[], Class, boolean, boolean, boolean)