feat(batch): add cache and concurrency options to batch command

Author: alexey1312

.claude/EXFIG.toon

@@ -65,6 +65,11 @@ commands:
       maxRetries: --max-retries N (default 4)
       resume: --resume
       report: --report PATH
+      cache: --cache
+      noCache: --no-cache
+      force: --force
+      cachePath: --cache-path PATH
+      concurrentDownloads: --concurrent-downloads N (default 20)
 
   download:
     purpose: Export Figma data as JSON

README.md

@@ -4,7 +4,7 @@
 [![Swift-versions](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Falexey1312%2FExFig%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/alexey1312/ExFig)
 [![CI](https://github.com/alexey1312/ExFig/actions/workflows/ci.yml/badge.svg)](https://github.com/alexey1312/ExFig/actions/workflows/ci.yml)
 [![Release](https://github.com/alexey1312/ExFig/actions/workflows/release.yml/badge.svg)](https://github.com/alexey1312/ExFig/actions/workflows/release.yml)
-![Coverage](https://img.shields.io/badge/coverage-58.52%25-yellow)
+![Coverage](https://img.shields.io/badge/coverage-58.51%25-yellow)
 [![License](https://img.shields.io/github/license/alexey1312/ExFig.svg)](LICENSE)
 
 Command-line utility to export colors, typography, icons, and images from Figma to Xcode, Android Studio, and Flutter

Sources/ExFig/Batch/BatchConfigRunner.swift

@@ -13,6 +13,11 @@ protocol ConfigExportPerforming: Sendable {
 struct SubcommandConfigExporter: ConfigExportPerforming {
     let globalOptions: GlobalOptions
     let resume: Bool
+    let cache: Bool
+    let noCache: Bool
+    let force: Bool
+    let cachePath: String?
+    let concurrentDownloads: Int
 
     func export(
         configFile: ConfigFile,
@@ -21,11 +26,17 @@ struct SubcommandConfigExporter: ConfigExportPerforming {
         ui: TerminalUI
     ) async throws -> ExportStats {
         try await InjectedClientStorage.$client.withValue(client) {
-            let cacheOptions = CacheOptions()
+            var cacheOptions = CacheOptions()
+            cacheOptions.cache = cache
+            cacheOptions.noCache = noCache
+            cacheOptions.force = force
+            cacheOptions.cachePath = cachePath
+
             let faultToleranceOptions = FaultToleranceOptions()
 
             var heavyFaultToleranceOptions = HeavyFaultToleranceOptions()
             heavyFaultToleranceOptions.resume = resume
+            heavyFaultToleranceOptions.concurrentDownloads = concurrentDownloads
 
             let colors = makeColors(
                 options: options,
@@ -71,6 +82,11 @@ struct BatchConfigRunner: Sendable {
     let globalOptions: GlobalOptions
     let maxRetries: Int
     let resume: Bool
+    let cache: Bool
+    let noCache: Bool
+    let force: Bool
+    let cachePath: String?
+    let concurrentDownloads: Int
     let exporter: any ConfigExportPerforming
 
     init(
@@ -79,16 +95,31 @@ struct BatchConfigRunner: Sendable {
         globalOptions: GlobalOptions,
         maxRetries: Int,
         resume: Bool,
+        cache: Bool = false,
+        noCache: Bool = false,
+        force: Bool = false,
+        cachePath: String? = nil,
+        concurrentDownloads: Int = FileDownloader.defaultMaxConcurrentDownloads,
         exporter: ConfigExportPerforming? = nil
     ) {
         self.rateLimiter = rateLimiter
         self.retryPolicy = retryPolicy
         self.globalOptions = globalOptions
         self.maxRetries = maxRetries
         self.resume = resume
+        self.cache = cache
+        self.noCache = noCache
+        self.force = force
+        self.cachePath = cachePath
+        self.concurrentDownloads = concurrentDownloads
         self.exporter = exporter ?? SubcommandConfigExporter(
             globalOptions: globalOptions,
-            resume: resume
+            resume: resume,
+            cache: cache,
+            noCache: noCache,
+            force: force,
+            cachePath: cachePath,
+            concurrentDownloads: concurrentDownloads
         )
     }
 

Sources/ExFig/Subcommands/Batch.swift

@@ -1,3 +1,4 @@
+// swiftlint:disable file_length
 import ArgumentParser
 import FigmaAPI
 import Foundation
@@ -44,6 +45,23 @@ extension ExFigCommand {
         @Option(name: .long, help: "Path to write JSON report")
         var report: String?
 
+        // Cache options
+        @Flag(name: .long, help: "Enable version tracking cache (skip export if unchanged)")
+        var cache: Bool = false
+
+        @Flag(name: .long, help: "Disable version tracking cache (always export)")
+        var noCache: Bool = false
+
+        @Flag(name: .long, help: "Force export and update cache (ignore cached version)")
+        var force: Bool = false
+
+        @Option(name: .long, help: "Custom path to cache file (default: .exfig-cache.json)")
+        var cachePath: String?
+
+        // Download concurrency
+        @Option(name: .long, help: "Maximum concurrent CDN downloads")
+        var concurrentDownloads: Int = FileDownloader.defaultMaxConcurrentDownloads
+
         @Argument(help: "Config files or directory to process")
         var paths: [String]
 
@@ -173,7 +191,12 @@ extension ExFigCommand {
                 retryPolicy: retryPolicy,
                 globalOptions: globalOptions,
                 maxRetries: maxRetries,
-                resume: resume
+                resume: resume,
+                cache: cache,
+                noCache: noCache,
+                force: force,
+                cachePath: cachePath,
+                concurrentDownloads: concurrentDownloads
             )
 
             ui.info("Processing \(configs.count) config(s) with up to \(parallel) parallel workers...")