Ability to define a mask with arbitrary number of groups about input-mask-ios HOT 6 CLOSED

let formats: [String] = 
    Pattern("[AAAA]")
        .affineRepeat(min: 3, max: 6, separator: " ")
        .suffix("[000]")
        .build

// produces:

[
    "[AAAA] [AAAA] [AAAA]",
    "[AAAA] [AAAA] [AAAA] [AAAA]",
    "[AAAA] [AAAA] [AAAA] [AAAA] [AAAA]",
    "[AAAA] [AAAA] [AAAA] [AAAA] [AAAA] [AAAA]",
    "[AAAA] [AAAA] [AAAA] [AAAA] [AAAA] [AAAA] [000]",
]

class AffinePattern {
  init(format: String)

  /// Make a [AAAaaa] group
  /// 
  /// - parameter count: number of mandatory letters;
  /// - parameter optionalCount: number of optional letters;
  /// 
  /// - returns: An `AffinePattern` instance.
  class func makeLetters(count: Int, optionalCount: Int = 0) -> AffinePattern

  /// Make a [000999] group
  /// 
  /// - parameter count: number of mandatory digits;
  /// - parameter optionalCount: number of optional digits;
  /// 
  /// - returns: An `AffinePattern` instance.
  class func makeDigits(count: Int, optionalCount: Int = 0) -> AffinePattern

  /// Make a repetitive group.
  /// 
  /// - parameter times: number of repetitions; e.g. [3...5]
  /// - parameter separator: a string to be inserted in between repeated groups;
  /// 
  /// - returns: An `AffinePattern` instance.
  /// 
  /// - usage:
  ///   AffinePattern("[00]").repeat(times: [2..4], separator: " ") // is equal to:
  ///   [
  ///     "[00] [00]",
  ///     "[00] [00] [00]",
  ///     "[00] [00] [00] [00]",
  ///   ]
  func repeat(times: Range<Int>, separator: String = "") -> AffinePattern

  /// For each item in a repetitive group append a suffix.
  /// 
  /// - parameter suffix: a string to be appended
  /// 
  /// - returns: An `AffinePattern` instance.
  /// 
  /// - usage:
  ///   AffinePattern("[00]").repeat(times: [2..4], separator: " ").appending(suffix: "-[0]") // is equal to:
  ///   [
  ///     "[00] [00]-[0]",
  ///     "[00] [00] [00]-[0]",
  ///     "[00] [00] [00] [00]-[0]",
  ///   ]
  func appending(suffix: String) -> AffinePattern

  /// For each item in a repetitive group insert a prefix.
  /// 
  /// - parameter prefix: a string to be inserted
  /// 
  /// - returns: An `AffinePattern` instance.
  /// 
  /// - usage:
  ///   AffinePattern("[00]").repeat(times: [2..4], separator: " ").inserting(prefix: "[0]-") // is equal to:
  ///   [
  ///     "[0]-[00] [00]",
  ///     "[0]-[00] [00] [00]",
  ///     "[0]-[00] [00] [00] [00]",
  ///   ]
  func inserting(prefix: String) -> AffinePattern

  /// For the last item in a repetitive group insert a prefix and append a suffix.
  /// 
  /// - parameter prefix: a string to be inserted
  /// - parameter suffix: a string to be appended
  /// 
  /// - returns: An `AffinePattern` instance.
  /// 
  /// - usage:
  ///   AffinePattern("[00]").repeat(times: [2..4], separator: " "). paddingLast(prefix: "[0]-", suffix: "-[000]") // is equal to:
  ///   [
  ///     "[00] [00]",
  ///     "[00] [00] [00]",
  ///     "[0]-[00] [00] [00] [00]-[000]",
  ///   ]
  func paddingLast(prefix: String, suffix: String) -> AffinePattern

  /// For the first item in a repetitive group insert a prefix and append a suffix.
  /// 
  /// - parameter prefix: a string to be inserted
  /// - parameter suffix: a string to be appended
  /// 
  /// - returns: An `AffinePattern` instance.
  /// 
  /// - usage:
  ///   AffinePattern("[00]").repeat(times: [2..4], separator: " "). paddingFirst(prefix: "[0]-", suffix: "-[000]") // is equal to:
  ///   [
  ///     "[0]-[00] [00]-[000]",
  ///     "[00] [00] [00]",
  ///     "[00] [00] [00] [00]",
  ///   ]
  func paddingFirst(prefix: String, suffix: String) -> AffinePattern

  /// Build a repetitive group
  var build: [String]
}