Validation Toolkit · Validation Components

Validation Components is now an integrated part of Validation Toolkit and we don't maintain it as a standalone framework anymore.

For more details on how you can empower data validation in your projects, checkout Validation Toolkit 😋.

1. Introduction
2. Requirements
3. Installation
   • Carthage
   • CocoaPods
   • Swift Package Manager
   • Manually
4. Usage Examples
   • Email Predicate
   • URL Predicate
   • Pair Matching Predicate
5. Contribute
6. Meta

Validation Components extends the ValidationToolkit framework by offering a collection of common validation predicates that most of the projects can benefit of.

• iOS 8.0+ / macOS 10.10+ / tvOS 9.0+ / watchOS 2.0+
• Xcode 8.1+
• Swift 3.0+

Please note that ValidationComponents requires ValidationToolkit.

You can use Carthage to install ValidationComponents by adding it to your Cartfile:

github "nsagora/validation-components"

Run carthage update to build the framework and drag the built ValidationComponents.framework into your Xcode project.

$ brew update
$ brew install carthage

You can use CocoaPods to install ValidationComponents by adding it to your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!

target 'YOUR_TARGET_NAME' do
	pod 'ValidationComponents'
end

Then, run the following command:

$ pod install

Note that this requires CocoaPods version 1.0.0, and your iOS deployment target to be at least 8.0.

$ gem install cocoapods

You can use the Swift Package Manager to install ValidationComponents by adding it to your Package.swift file:

import PackageDescription

let package = Package(
    name: "YOUR_PROJECT_NAME",
    targets: [],
    dependencies: [
        .Package(url: "https://github.com/nsagora/validation-components", majorVersion: 1),
    ]
)

Note that the Swift Package Manager is still in early design and development, for more information checkout its GitHub Page.

To use this library in your project manually you may:

1. for Projects, just drag the Sources folder into the project tree
2. for Workspaces, include the whole ValidationComponents.xcodeproj

For a comprehensive list of examples try the ValidationComponents.playground:

1. Download the repository locally on your machine
2. Run carthage update to build the required version of ValidationToolkit

$ brew update
$ brew install carthage

3. Open ValidationComponents.workspace
4. Build ValidationComponents iOS target
5. Select the ValidationComponents playgrounds from the Project navigator.

Use a EmailPredicate to evaluate if a given email address is syntactically valid.

import ValidationComponents

let predicate = EmailPredicate()
predicate.evaluate(with: "hello@") // returns false
predicate.evaluate(with: "[email protected]") // returns true
predicate.evaluate(with: "hé[email protected]") // returns true

Use a URLPredicate to evaluate if a given URL is syntactically valid.

import ValidationComponents

let predicate = URLPredicate()
predicate.evaluate(with: "http://www.url.com") // returns true
predicate.evaluate(with: "http:\\www.url.com") // returns false

Use a PairMatchingPredicate to evaluate if a given pair of values match.

import ValidationComponents

let predicate = PairMatchingPredicate()
predicate.evaluate(with: ("swift", "swift")) // returns true
predicate.evaluate(with: ("swift", "obj-c")) // returns false

We would love you for the contribution to ValidationComponents, check the LICENSE file for more info.

This project developed and maintained by the members of iOS NSAgora, the community of iOS Developers of Iași, Romania.

Distributed under the MIT license. See LICENSE for more information.

https://github.com/nsagora/validation-components