metamesh-plugin-ffmpeg/test/README.md

FFmpeg Plugin Tests

Integration tests for the FFmpeg metadata extraction plugin.

Requirements

Tests require FFprobe to be installed. Since FFprobe is typically only available in the Docker container, tests are designed to run inside Docker.

Running Tests

Quick Start (Recommended)

# From the plugin directory
./test.sh

This builds a test Docker image and runs all tests inside it.

Options

./test.sh --no-cache   # Rebuild without Docker cache
./test.sh --shell      # Start interactive shell for debugging

Running Locally (if FFprobe is installed)

npm install
npm test

Test Structure

test/
├── fixtures/
│   ├── generate-test-video.sh   # Generates test video files
│   ├── simple.mp4               # Basic video + audio (generated)
│   ├── multi-audio.mkv          # Multiple audio tracks (generated)
│   ├── with-subs.mkv            # Video with subtitles (generated)
│   └── audio-only.mp3           # Audio file for skip tests (generated)
├── integration.test.ts          # Integration tests
└── README.md                    # This file

Test Categories

Integration Tests (integration.test.ts)

1. Prerequisites - Verify FFprobe and fixtures are available
2. Manifest - Validate plugin manifest structure
3. Skip Logic - Test that non-video files are skipped
4. FFprobe Validation - Direct FFprobe output verification
5. Output Format - Validate FFprobe JSON matches plugin expectations

Test Fixtures

Test fixtures are generated automatically during Docker build using generate-test-video.sh. The script creates:

• simple.mp4 - 2-second 320x240 H.264 video with AAC audio
• multi-audio.mkv - Video with two audio tracks (English + Japanese)
• with-subs.mkv - Video with embedded SRT subtitles
• audio-only.mp3 - Audio file (for testing skip logic)

Writing New Tests

import { describe, it, expect } from 'vitest';
import path from 'path';

const FIXTURES_DIR = path.join(__dirname, 'fixtures');

describe('My New Test', () => {
    it('does something', async () => {
        // Your test here
    });
});

Debugging

Start an interactive shell in the test container:

./test.sh --shell

# Inside container:
npm test                          # Run all tests
npx vitest run -t "skip"          # Run tests matching "skip"
ffprobe test/fixtures/simple.mp4  # Manually inspect video