Ligh Swift library for user input validation

Requirements

Xcode >= 8.*
Swift >= 3.*

By default input validation can be used on all of the following value types:

String
Float
Double
Int
Bool

What is InputValidation

InputValidation is a very light weight library written in Swift, and aimed to help developers with the boring task of validating some user input. My goal was to make this as generic as possible without complicating it, and at the same time to be able to perform any validation on any value type. For example you can evaluate regex match on Int Float Double Bool and String, or to convert InputValues from one type to another.

Value type from the user input

let values = [12, 45.245, "hello", "", NSNumber(value: true), NSNumber(value: 12), NSNumber(value: 65.28), false, true]

for value:InputValue in values {
    if !value.isEmpty {
        switch value.type {
          case .string:
            print("String")
          case .int:
            print("Int")
          case .float:
            print("Float")
          case .double:
            print("Double")
          case .number:
            print("Number")
          case .bool:
            print("Boolean")
        }
    } else {
        print("value:'\(value)' of type \(value.type.rawValue) is empty")
    }
}

Above example prints:

Int
Double
String
value:'' of type string is empty
Number
Number
Number
Boolean
Boolean

Convert user input to specific value type

let userInput = "1"

print("String value: \(userInput.toString)")

if let intValue = userInput.toInt {
    print("Int value: \(intValue)")
}

if let floatValue = userInput.toFloat {
    print("Float value: \(floatValue)")
}

if let doubleValue = userInput.toDouble {
    print("Double value: \(doubleValue)")
}

if let boolValue = userInput.toBool {
    print("Boolean value: \(boolValue)")
}

Above example prints:

String value: 1
Int value: 1
Float value: 1.0
Double value: 1.0

Comparison operations

let userInput = 10

/*
  You can use either String, Int, Double or Float 
  as parameter to run the comparison. 
  See in examples below
*/

userInput.isBetween(9,11) // returns true

userInput.isLessThan("11") // returns true

userInput.isLessThanOrEqualTo(10.0) // returns true

userInput.isGreaterThan(9.1235768435214685654657854) // returns true

userInput.isGreaterThanOrEqualTo(9) // returns true

Evaluate regular expressions

let values = [12, 45.245, "hello", "", NSNumber(value: true), NSNumber(value: 12), NSNumber(value: 65.28), false, true]

for value:InputValue in values {
    if !value.isEmpty {
        let regex = "^[a-z]+$"
        if value.matches(regex: regex) {
            print("value:'\(value)' of type \(value.type.rawValue) is matching '\(regex)'")
        } else {
            print("value:'\(value)' of type \(value.type.rawValue) did not match '\(regex)'")
        }
    } else {
        print("value:'\(value)' of type \(value.type.rawValue) is empty")
    }
}

Above example prints:

value:'12' of type int did not match '^[a-z]+$'
value:'45.245' of type double did not match '^[a-z]+$'
value:'hello' of type string is matching '^[a-z]+$'
value:'' of type string is empty
value:'1' of type number did not match '^[a-z]+$'
value:'12' of type number did not match '^[a-z]+$'
value:'65.28' of type number did not match '^[a-z]+$'
value:'false' of type bool did not match '^[a-z]+$'
value:'true' of type bool did not match '^[a-z]+$'

Converting InputValue to boolean

Important

If InputValue cannot be converted to a boolean value type calling toBool will return nil. See example below

1.toBool // nil
0.toBool // nil
"Some text".toBool // nil
"true".toBool // true
"True".toBool // true
"TRUE".toBool // true
12.345.toBool // nil

Installing with carthage

Add InputValidation into your Cartfile

github "P-Panayotov/InputValidation"

Build

carthage update

Contributing and reporting an issue

Happy to see more contributors on board as well as any suggstions on improving the frameworks. Simply open a pull request on develop branch. Feel free to open an issue if you find one.