Struct SwiftManifestJsonParser 

pub struct SwiftManifestJsonParser;

Parses Swift Package Manager manifest files with automatic JSON generation.

Supported File Formats

• Package.swift.json - Pre-generated JSON from swift package dump-package
• Package.swift.deplock - JSON format from DepLock tool
• Package.swift - Raw Swift source (auto-generates JSON if Swift available)

Automatic JSON Generation

When scanning raw Package.swift files:

1. Checks BLAKE3-based cache for previously generated JSON
2. If cache miss, invokes swift package dump-package (requires Swift toolchain)
3. Caches result for future scans
4. Falls back gracefully if Swift unavailable (logs warning, returns empty package data)

Performance

• Pre-generated JSON: <1ms (direct file read)
• Raw Package.swift (cached): <1ms (cache hit)
• Raw Package.swift (first time): ~100-500ms (Swift toolchain execution + cache write)
• Raw Package.swift (no Swift): <1ms (immediate fallback)

Example

use provenant::parsers::{PackageParser, SwiftManifestJsonParser};
use std::path::Path;

// Works with pre-generated JSON
let json_path = Path::new("Package.swift.json");
let data1 = SwiftManifestJsonParser::extract_first_package(json_path);

// Also works with raw Package.swift (if Swift installed)
let swift_path = Path::new("Package.swift");
let data2 = SwiftManifestJsonParser::extract_first_package(swift_path);

Trait Implementations

impl PackageParser for SwiftManifestJsonParser

const PACKAGE_TYPE: PackageType = PackageType::Swift

Package URL type identifier for this parser (e.g., PackageType::Npm, PackageType::Pypi).

fn extract_packages(path: &Path) -> Vec<PackageData>

Extracts all packages from the given file path.

fn is_match(path: &Path) -> bool

Checks if the given file path matches this parser’s expected format.

fn extract_first_package(path: &Path) -> PackageData

Returns the first package from extract_packages(), or a default PackageData if the file contains no packages.