A Swift package providing shared test resources and utilities for all SPFK test targets. Bundles a catalog of audio and image files used across the SPFK ecosystem, with platform-aware resource resolution for macOS and iOS.

SPFKTesting provides two main components:

• TestBundleResources — A Sendable singleton exposing 30+ named audio and image test files organized into collections by purpose (format coverage, metadata markers, edge cases).
• Tag extensions — Custom Swift Testing tags (development, file, automation, realtime, engine) for categorizing tests across SPFK modules.

Singleton providing typed access to bundled test resources. Used by downstream packages for audio format testing, metadata parsing, and file I/O validation.

let resources = TestBundleResources.shared

// Access individual files
let wav = resources.tabla_wav
let mp3 = resources.mp3_id3

// Iterate format collections
for url in resources.formats {
    // tabla.aac, tabla.aif, tabla.caf, tabla.flac,
    // tabla.m4a, tabla.mp3, tabla.mp4, tabla.ogg, tabla.wav
}

for url in resources.markerFormats {
    // Formats supporting RIFF/Chapter markers and metadata
}

for url in resources.audioCases {
    // Diverse set for broad audio testing
}

Generic resource resolver that maps file names to URLs within a bundle. Handles platform-specific bundle directory structures (macOS Contents/Resources vs iOS bundle root).

let br = BundleResources(bundleURL: Bundle.module.bundleURL)
let url = br.resource(named: "tabla.wav")

Custom tags for filtering test execution in Swift Testing test plans:

@Test(.tags(.file))
func readWavMetadata() { ... }

@Test(.tags(.realtime))
func displayLinkTiming() { ... }

Sources/SPFKTesting/
  ├── BundleResources.swift        — Generic bundle resource resolver (macOS/iOS)
  ├── TestBundleResources.swift    — Singleton with named audio/image properties
  ├── Tags+.swift                  — Swift Testing tag extensions
  └── Resources/
      ├── audio/                   — 24 audio test files
      └── image/                   — 1 image test file

Add SPFKTesting as a dependency in your test target only:

.testTarget(
    name: "MyPackageTests",
    dependencies: ["SPFKTesting"]
)

• Swift 6.2+
• macOS 13+

Spongefork (SPFK) is the personal software projects of Ryan Francesconi. Dedicated to creative sound manipulation, his first application, Spongefork, was released in 1999 for macOS 8. From 2016 to 2025 he was the lead macOS developer at Audio Design Desk.