should be it

external/duckdb/tools/swift/duckdb-swift/Sources/DuckDB/Configuration.swift

@@ -0,0 +1,133 @@
+//
+//  DuckDB
+//  https://github.com/duckdb/duckdb-swift
+//
+//  Copyright © 2018-2024 Stichting DuckDB Foundation
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to
+//  deal in the Software without restriction, including without limitation the
+//  rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+//  sell copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+//  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+//  IN THE SOFTWARE.
+
+@_implementationOnly import Cduckdb
+
+public extension Database {
+  
+  /// An object representing a DuckDB database configuration
+  ///
+  /// Configuration options can be provided to change different settings of the
+  /// database system. Note that many of these settings can be changed later on
+  /// using PRAGMA statements as well. The configuration object should be
+  /// created, filled with values using ``setValue(_:forKey:)`` and passed to
+  /// ``Database/init(store:configuration:)``
+  ///
+  /// The following example sets up an in-memory database with some
+  /// configuration options set
+  ///
+  /// ```swift
+  /// do {
+    /// let configuration = Configuration()
+  ///   configuration.setValue("READ_WRITE", forKey: "access_mode")
+  ///   configuration.setValue("8", forKey: "threads")
+  ///   configuration.setValue("8GB", forKey: "max_memory")
+  ///   configuration.setValue("DESC", forKey: "default_order")
+  ///   let database = try Database(store: .inMemory, configuration: configuration)
+  ///   let connection = try database.connect()
+  /// }
+  /// catch {
+  ///   // handle error
+  /// }
+  /// ```
+  /// Use ``Database/Configuration/options`` to see the full list of available
+  /// configuration options.
+  final class Configuration {
+    
+    private let ptr = UnsafeMutablePointer<duckdb_config?>.allocate(capacity: 1)
+    
+    /// Creates a DuckDB configuration
+    public init() {
+      let status = duckdb_create_config(ptr)
+      guard status == .success else { fatalError("malloc failure") }
+    }
+    
+    deinit {
+      duckdb_destroy_config(ptr)
+      ptr.deallocate()
+    }
+    
+    func withCConfiguration<T>(_ body: (duckdb_config?) throws -> T) rethrows -> T {
+      try body(ptr.pointee)
+    }
+    
+    /// Set a value on the configuration object
+    ///
+    /// Applies a configuration option to the configuration object. Use
+    /// ``Database/Configuration/options`` to see the full list of available
+    /// configuration options.
+    ///
+    /// - Parameter key: the name of the option being set
+    /// - Parameter value: the desired value of the option being set
+    /// - Throws: ``DatabaseError/configurationFailedToSetFlag`` if the option
+    ///   is not available or the value is malformed
+    public func setValue(_ value: String, forKey key: String) throws {
+      try value.withCString { valueCStr in
+        try key.withCString { keyCStr in
+          let status = duckdb_set_config(ptr.pointee, keyCStr, valueCStr)
+          guard .success == status else {
+            throw DatabaseError.configurationFailedToSetFlag
+          }
+        }
+      }
+    }
+  }
+}
+
+// MARK: - Option
+
+public extension Database.Configuration {
+  
+  /// A DuckDB database configuration option information type
+  struct OptionInfo {
+    /// The name/key of the option
+    public let name: String
+    /// An overview of the option and its potential values
+    public let description: String
+  }
+  
+  /// A list of all available database configuration options with their
+  /// descriptions
+  static var options: [OptionInfo] {
+    let count = duckdb_config_count()
+    var options = [OptionInfo]()
+    let outName = UnsafeMutablePointer<UnsafePointer<CChar>?>.allocate(capacity: 1)
+    let outDesc = UnsafeMutablePointer<UnsafePointer<CChar>?>.allocate(capacity: 1)
+    defer {
+      outName.deallocate()
+      outDesc.deallocate()
+    }
+    for i in 0..<count {
+      duckdb_get_config_flag(i, outName, outDesc)
+      if let nameCStr = outName.pointee, let descCStr = outDesc.pointee {
+        let name = String(cString: nameCStr)
+        let desc = String(cString: descCStr)
+        options.append(OptionInfo(name: name, description: desc))
+      }
+      outName.pointee = nil
+      outDesc.pointee = nil
+    }
+    return options
+  }
+}