Swift Package Index


A pure-Swift INI Config parser


  • The latest stable release is 0.4.0. Released about 1 year ago.
  • The last commit to master was about 1 year ago.

Swift Version Compatibility

  • 0.4.0 and master
    5.3
    5.2
    5.1
    5.0
    4.2
Full build results

Platform Compatibility

  • 0.4.0 and master
    iOS
    macOS(Intel)
    macOS(ARM)
    Linux
    tvOS
    watchOS
Full build results

ConfigParser

A pure-Swift implementation of the INI config parser

Installation

Swift Package Manager

.package(url: "https://github.com/Ponyboy47/ConfigParser.git", from: "0.4.0")

Usage

import ConfigParser

let confString = """
[section1]
key1 = value1
key2 = 1, 2, 3, 4

[section2]
key1 = test
key2 = 1234
"""

let config = try ConfigParser.parse(confString)

// Use subscripts to get the value you want in the type you want
let key1s1: String? = config[section: "section1", key: "key1"] // Optional<String>(value1)
let key2s1 = config[section: "section2", key: "key1", default: [4, 3, 2, 1]] // [1, 2, 3, 4]

Supported Types:

  • String
  • Bool
  • Int (8,16,32,64 and all the UInt variants)
  • Double
  • Float and Float80
  • Arrays of any of the above types

TODO

  • Section/Key name validation (must start with an alphabet character)
  • Retrieve values as specified type
    • Bool
    • String (default)
    • Double/Float
    • Int
    • Array
  • Write config to file
  • Escape sequences (bug fix)
  • Multi-line values
  • Read from string
  • Customizable options
    • Delimeter (ie: ':' instead of '=')
    • Don't trim whitespace
    • Nested sections
      • Dotted section titles
      • Indented sections
    • Duplicate key behavior
      • Keep first
      • Overwrite
      • Error

License

MIT