Back to Repositories

Testing ID3 Metadata Extraction Capabilities in SmartTube

This test suite validates the Id3Peeker class functionality in ExoPlayer, focusing on ID3 metadata extraction and parsing capabilities. The tests verify proper handling of ID3 tags in media files, including tag presence detection and frame content validation.

Test Coverage Overview

The test suite provides comprehensive coverage of ID3 tag parsing scenarios:

Validation of null returns when ID3 tags are absent
Verification of proper ID3 tag extraction when present
Testing of frame predicate filtering functionality
Handling of different ID3 frame types (APIC, COMM)

Implementation Analysis

The testing approach utilizes JUnit with AndroidJUnit4 runner for Android compatibility. Tests employ the FakeExtractorInput class for controlled input simulation and Truth assertions for verification. The implementation demonstrates systematic testing of ID3 parsing edge cases and frame content validation.

Technical Details

Testing tools and configuration:

JUnit test framework with AndroidJUnit4 runner
FakeExtractorInput for input stream simulation
Truth assertion library for test validations
Custom ID3 frame building utilities from Id3DecoderTest
Byte-level tag construction for precise test scenarios

Best Practices Demonstrated

The test suite exemplifies several testing best practices:

Isolated test cases with clear purpose and naming
Comprehensive validation of both positive and negative scenarios
Detailed verification of parsed metadata contents
Use of helper methods for test data construction
Clear separation of test scenarios for different ID3 frame types

yuliskov/smarttube

exoplayer-amzn-2.10.6/library/core/src/test/java/com/google/android/exoplayer2/extractor/Id3PeekerTest.java

            
/*
 * Copyright (C) 2018 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.google.android.exoplayer2.extractor;

import static com.google.common.truth.Truth.assertThat;

import androidx.test.ext.junit.runners.AndroidJUnit4;
import com.google.android.exoplayer2.metadata.Metadata;
import com.google.android.exoplayer2.metadata.id3.ApicFrame;
import com.google.android.exoplayer2.metadata.id3.CommentFrame;
import com.google.android.exoplayer2.metadata.id3.Id3DecoderTest;
import com.google.android.exoplayer2.testutil.FakeExtractorInput;
import java.io.IOException;
import org.junit.Test;
import org.junit.runner.RunWith;

/** Unit test for {@link Id3Peeker}. */
@RunWith(AndroidJUnit4.class)
public final class Id3PeekerTest {

  @Test
  public void testPeekId3Data_returnNull_ifId3TagNotPresentAtBeginningOfInput()
      throws IOException, InterruptedException {
    Id3Peeker id3Peeker = new Id3Peeker();
    FakeExtractorInput input =
        new FakeExtractorInput.Builder()
            .setData(new byte[] {1, 'I', 'D', '3', 2, 3, 4, 5, 6, 7, 8, 9, 10})
            .build();

    Metadata metadata = id3Peeker.peekId3Data(input, /* id3FramePredicate= */ null);
    assertThat(metadata).isNull();
  }

  @Test
  public void testPeekId3Data_returnId3Tag_ifId3TagPresent()
      throws IOException, InterruptedException {
    Id3Peeker id3Peeker = new Id3Peeker();

    byte[] rawId3 =
        Id3DecoderTest.buildSingleFrameTag(
            "APIC",
            new byte[] {
              3, 105, 109, 97, 103, 101, 47, 106, 112, 101, 103, 0, 16, 72, 101, 108, 108, 111, 32,
              87, 111, 114, 108, 100, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0
            });
    FakeExtractorInput input = new FakeExtractorInput.Builder().setData(rawId3).build();

    Metadata metadata = id3Peeker.peekId3Data(input, /* id3FramePredicate= */ null);
    assertThat(metadata.length()).isEqualTo(1);

    ApicFrame apicFrame = (ApicFrame) metadata.get(0);
    assertThat(apicFrame.mimeType).isEqualTo("image/jpeg");
    assertThat(apicFrame.pictureType).isEqualTo(16);
    assertThat(apicFrame.description).isEqualTo("Hello World");
    assertThat(apicFrame.pictureData).hasLength(10);
    assertThat(apicFrame.pictureData).isEqualTo(new byte[] {1, 2, 3, 4, 5, 6, 7, 8, 9, 0});
  }

  @Test
  public void testPeekId3Data_returnId3TagAccordingToGivenPredicate_ifId3TagPresent()
      throws IOException, InterruptedException {
    Id3Peeker id3Peeker = new Id3Peeker();

    byte[] rawId3 =
        Id3DecoderTest.buildMultiFramesTag(
            new Id3DecoderTest.FrameSpec(
                "COMM",
                new byte[] {
                  3, 101, 110, 103, 100, 101, 115, 99, 114, 105, 112, 116, 105, 111, 110, 0, 116,
                  101, 120, 116, 0
                }),
            new Id3DecoderTest.FrameSpec(
                "APIC",
                new byte[] {
                  3, 105, 109, 97, 103, 101, 47, 106, 112, 101, 103, 0, 16, 72, 101, 108, 108, 111,
                  32, 87, 111, 114, 108, 100, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0
                }));
    FakeExtractorInput input = new FakeExtractorInput.Builder().setData(rawId3).build();

    Metadata metadata =
        id3Peeker.peekId3Data(
            input,
            (majorVersion, id0, id1, id2, id3) ->
                id0 == 'C' && id1 == 'O' && id2 == 'M' && id3 == 'M');
    assertThat(metadata.length()).isEqualTo(1);

    CommentFrame commentFrame = (CommentFrame) metadata.get(0);
    assertThat(commentFrame.language).isEqualTo("eng");
    assertThat(commentFrame.description).isEqualTo("description");
    assertThat(commentFrame.text).isEqualTo("text");
  }
}