SwiftConfig: Управление конфигурацией приложений на Swift

SwiftConfig — это легковесная библиотека для Swift (iOS/macOS), предназначенная для централизованного управления настройками приложения. Она позволяет загружать, парсить и получать доступ к конфигурационным данным из JSON, YAML или plist-файлов, а также поддерживает переменные окружения. Библиотека особенно полезна для проектов, где требуется гибкая настройка поведения приложения без перекомпиляции (например, переключение между staging/production серверами).

Зачем нужна SwiftConfig?

В стандартной разработке под iOS/macOS часто используют UserDefaults, Info.plist или жестко закодированные константы. Это приводит к проблемам:

• Смешивание кода и конфигурации
• Отсутствие типизации (все значения — строки)
• Сложность переключения между средами

SwiftConfig решает эти задачи, предоставляя строго типизированный API и поддержку нескольких источников данных.

Установка

Добавьте SwiftConfig через Swift Package Manager в Xcode:

// Package.swift или через меню Xcode: File > Add Packages...
.package(url: "https://github.com/example/SwiftConfig", from: "1.0.0")

Или через CocoaPods:

pod 'SwiftConfig', '~> 1.0'

Основные функции

• Поддержка форматов: JSON, YAML, plist, .env
• Типизированный доступ: автоматическое преобразование в Int, Bool, URL, Date
• Иерархические ключи: доступ к вложенным полям через точку (например, "database.host")
• Переменные окружения: приоритет env-переменных над файловыми настройками
• Кэширование: однократная загрузка с возможностью принудительного обновления

Пример кода

import SwiftConfig

// Определяем структуру конфигурации
struct AppConfig: Codable {
    let apiURL: URL
    let timeout: Double
    let features: [String: Bool]
}

// Загрузка из файла config.json
let config = try SwiftConfig.load(
    from: "config",          // имя файла без расширения
    type: .json,
    as: AppConfig.self
)

// Использование
print(config.apiURL)         // https://api.example.com
print(config.timeout)        // 30.0
print(config.features["darkMode"]) // true

// Доступ к вложенным полям без декодирования
let host: String = try SwiftConfig.value(for: "database.host")
print(host) // localhost

Когда использовать SwiftConfig?

Рекомендуется применять в следующих сценариях:

• Приложения с несколькими средами (development, staging, production)
• Проекты, где настройки меняются часто (A/B тесты, фиче-флаги)
• Командная разработка (единый файл конфигурации в репозитории)
• Консольные утилиты или серверные Swift-приложения (Vapor, Kitura)

Библиотека не подходит для хранения пользовательских данных (используйте UserDefaults или CoreData).

Заключение

SwiftConfig упрощает управление конфигурацией, делая код чище и поддерживаемее. Благодаря строгой типизации вы избегаете ошибок времени выполнения, а поддержка нескольких форматов позволяет легко интегрировать библиотеку в существующий проект.