├── .swift-version ├── Logo ├── logo.png └── logo.sketch ├── Package.swift ├── SwiftlyExt.xcworkspace └── contents.xcworkspacedata ├── SwiftlyExt.xcodeproj ├── project.xcworkspace │ └── contents.xcworkspacedata ├── xcshareddata │ └── xcschemes │ │ ├── SwiftlyExt watchOS.xcscheme │ │ ├── SwiftlyExt macOS.xcscheme │ │ ├── SwiftlyExt iOS.xcscheme │ │ └── SwiftlyExt tvOS.xcscheme └── project.pbxproj ├── Source ├── Swiftly.h ├── CGFloatExtensions.swift ├── Swiftly.swift ├── Info.plist ├── CGPointExtensions.swift ├── Info-tvOS.plist ├── DictionaryExtensions.swift ├── RangeExtensions.swift ├── IntExtensions.swift ├── StringExtensions.swift ├── DateExtensions.swift └── ArrayExtensions.swift ├── .swiftlint.yml ├── SwiftlyExt.podspec ├── .gitignore ├── Tests ├── Info.plist ├── CGFloatTests.swift ├── CGPointTests.swift ├── SwiftlyTests.swift ├── DictionaryTests.swift ├── IntTests.swift ├── DateTests.swift ├── StringTests.swift └── ArrayTests.swift ├── CHANGELOG.md ├── LICENSE ├── .travis.yml └── README.md /.swift-version: -------------------------------------------------------------------------------- 1 | 3.0 -------------------------------------------------------------------------------- /Logo/logo.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/khoi-backyard/SwiftlyExt/HEAD/Logo/logo.png -------------------------------------------------------------------------------- /Logo/logo.sketch: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/khoi-backyard/SwiftlyExt/HEAD/Logo/logo.sketch -------------------------------------------------------------------------------- /Package.swift: -------------------------------------------------------------------------------- 1 | import PackageDescription 2 | 3 | let package = Package( 4 | name: "SwiftlyExt", 5 | exclude: ["Tests"] 6 | ) 7 | -------------------------------------------------------------------------------- /SwiftlyExt.xcworkspace/contents.xcworkspacedata: -------------------------------------------------------------------------------- 1 | 2 | 4 | 6 | 7 | 8 | -------------------------------------------------------------------------------- /SwiftlyExt.xcodeproj/project.xcworkspace/contents.xcworkspacedata: -------------------------------------------------------------------------------- 1 | 2 | 4 | 6 | 7 | 8 | -------------------------------------------------------------------------------- /Source/Swiftly.h: -------------------------------------------------------------------------------- 1 | // 2 | // Swiftly.h 3 | // Swiftly 4 | // 5 | // Created by Khoi Lai on 9/19/16. 6 | // Copyright © 2016 Khoi Lai. All rights reserved. 7 | // 8 | 9 | @import Foundation; 10 | 11 | FOUNDATION_EXPORT double SwiftlyVersionNumber; 12 | 13 | FOUNDATION_EXPORT const unsigned char SwiftlyVersionString[]; 14 | 15 | 16 | 17 | -------------------------------------------------------------------------------- /.swiftlint.yml: -------------------------------------------------------------------------------- 1 | included: 2 | - Source 3 | excluded: 4 | - Tests 5 | opt_in_rules: 6 | - attributes 7 | - empty_count 8 | - vertical_whitespace 9 | - closure_end_indentation 10 | - closure_spacing 11 | - explicit_init 12 | - first_where 13 | - operator_usage_whitespace 14 | - overridden_super_call 15 | - prohibited_super_call 16 | - redundant_nil_coalescing 17 | - switch_case_on_newline 18 | disabled_rules: 19 | - variable_name 20 | - file_length 21 | line_length: 200 22 | 23 | -------------------------------------------------------------------------------- /SwiftlyExt.podspec: -------------------------------------------------------------------------------- 1 | Pod::Spec.new do |s| 2 | s.name = 'SwiftlyExt' 3 | s.version = '1.3.0' 4 | s.license = 'MIT' 5 | s.summary = 'Extensions for native standard Swift types and classes' 6 | s.homepage = 'https://github.com/khoiln/Swiftly' 7 | s.authors = {'Khoi Lai' => 'k@khoi.io' } 8 | s.source = { :git => 'https://github.com/khoiln/Swiftly.git', :tag => s.version } 9 | s.ios.deployment_target = '9.0' 10 | s.osx.deployment_target = '10.11' 11 | s.tvos.deployment_target = '9.0' 12 | s.watchos.deployment_target = '2.0' 13 | s.source_files = 'Source/*.swift' 14 | end -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # Mac OS X 2 | .DS_Store 3 | 4 | # Xcode 5 | 6 | ## Build generated 7 | build/ 8 | DerivedData 9 | 10 | ## Various settings 11 | *.pbxuser 12 | !default.pbxuser 13 | *.mode1v3 14 | !default.mode1v3 15 | *.mode2v3 16 | !default.mode2v3 17 | *.perspectivev3 18 | !default.perspectivev3 19 | xcuserdata 20 | 21 | ## Other 22 | *.xccheckout 23 | *.moved-aside 24 | *.xcuserstate 25 | *.xcscmblueprint 26 | 27 | ## Obj-C/Swift specific 28 | *.hmap 29 | *.ipa 30 | 31 | ## Playgrounds 32 | timeline.xctimeline 33 | playground.xcworkspace 34 | 35 | # Swift Package Manager 36 | .build/ 37 | 38 | # Carthage 39 | Carthage/Build -------------------------------------------------------------------------------- /Source/CGFloatExtensions.swift: -------------------------------------------------------------------------------- 1 | // 2 | // CGFloatExtensions.swift 3 | // SwiftlyExt 4 | // 5 | // Created by Khoi Lai on 12/30/16. 6 | // Copyright © 2016 Khoi Lai. All rights reserved. 7 | // 8 | 9 | import Foundation 10 | import CoreGraphics 11 | 12 | public extension CGFloat { 13 | 14 | /// Convert from degrees to radians 15 | /// 16 | /// - Returns: Radian value 17 | func degreesToRadians() -> CGFloat { 18 | return (self * .pi) / 180.0 19 | } 20 | 21 | /// Convert from radians to degrees 22 | /// 23 | /// - Returns: Degree value 24 | func radiansToDegrees() -> CGFloat { 25 | return (self * 180.0) / .pi 26 | } 27 | 28 | } 29 | -------------------------------------------------------------------------------- /Source/Swiftly.swift: -------------------------------------------------------------------------------- 1 | // 2 | // Swiftly.swift 3 | // SwiftlyExt 4 | // 5 | // Created by Khoi Lai on 1/30/17. 6 | // Copyright © 2017 Khoi Lai. All rights reserved. 7 | // 8 | 9 | import Foundation 10 | 11 | public struct Swiftly { 12 | /// Return a random integer from lowerbound to upperbound inclusively 13 | /// 14 | /// - Parameters: 15 | /// - lower: The lower bound 16 | /// - upper: The upper bound 17 | /// - Returns: A random Int 18 | public static func random(lower: Int = 0, upper: Int = 1) -> Int { 19 | precondition(upper >= lower, "Lowerbound must be smaller than upper bound") 20 | return Int(arc4random_uniform(UInt32(upper - lower + 1))) + lower 21 | } 22 | } 23 | -------------------------------------------------------------------------------- /Tests/Info.plist: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | CFBundleDevelopmentRegion 6 | en 7 | CFBundleExecutable 8 | $(EXECUTABLE_NAME) 9 | CFBundleIdentifier 10 | $(PRODUCT_BUNDLE_IDENTIFIER) 11 | CFBundleInfoDictionaryVersion 12 | 6.0 13 | CFBundleName 14 | $(PRODUCT_NAME) 15 | CFBundlePackageType 16 | BNDL 17 | CFBundleShortVersionString 18 | 1.0 19 | CFBundleVersion 20 | 1 21 | 22 | 23 | -------------------------------------------------------------------------------- /Source/Info.plist: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | CFBundleDevelopmentRegion 6 | en 7 | CFBundleExecutable 8 | $(EXECUTABLE_NAME) 9 | CFBundleIdentifier 10 | $(PRODUCT_BUNDLE_IDENTIFIER) 11 | CFBundleInfoDictionaryVersion 12 | 6.0 13 | CFBundleName 14 | $(PRODUCT_NAME) 15 | CFBundlePackageType 16 | FMWK 17 | CFBundleShortVersionString 18 | 1.0 19 | CFBundleVersion 20 | $(CURRENT_PROJECT_VERSION) 21 | NSPrincipalClass 22 | 23 | 24 | 25 | -------------------------------------------------------------------------------- /Tests/CGFloatTests.swift: -------------------------------------------------------------------------------- 1 | // 2 | // CGFloatTests.swift 3 | // SwiftlyExt 4 | // 5 | // Created by Khoi Lai on 12/30/16. 6 | // Copyright © 2016 Khoi Lai. All rights reserved. 7 | // 8 | 9 | import XCTest 10 | 11 | class CGFloatTests: XCTestCase { 12 | 13 | override func setUp() { 14 | super.setUp() 15 | // Put setup code here. This method is called before the invocation of each test method in the class. 16 | } 17 | 18 | override func tearDown() { 19 | // Put teardown code here. This method is called after the invocation of each test method in the class. 20 | super.tearDown() 21 | } 22 | 23 | func testDegreeToRadians() { 24 | XCTAssert(CGFloat(180).degreesToRadians() == CGFloat.pi) 25 | } 26 | 27 | func testRadiansToDegrees() { 28 | XCTAssert(CGFloat(CGFloat.pi).radiansToDegrees() == 180) 29 | 30 | } 31 | } 32 | -------------------------------------------------------------------------------- /Tests/CGPointTests.swift: -------------------------------------------------------------------------------- 1 | // 2 | // CGPointTests.swift 3 | // SwiftlyExt 4 | // 5 | // Created by Khoi Lai on 12/30/16. 6 | // Copyright © 2016 Khoi Lai. All rights reserved. 7 | // 8 | 9 | import XCTest 10 | 11 | class CGPointTests: XCTestCase { 12 | 13 | override func setUp() { 14 | super.setUp() 15 | // Put setup code here. This method is called before the invocation of each test method in the class. 16 | } 17 | 18 | override func tearDown() { 19 | // Put teardown code here. This method is called after the invocation of each test method in the class. 20 | super.tearDown() 21 | } 22 | 23 | func testDistance() { 24 | XCTAssert(CGPoint(x: 0, y: 0).distance(to: CGPoint(x: 0, y: 0)) == 0) 25 | XCTAssert(CGPoint(x: 4, y: 4).distance(to: CGPoint(x: 4, y: 4)) == 0) 26 | XCTAssert(CGPoint(x: 2, y: 8).distance(to: CGPoint(x: 5, y: 4)) == 5) 27 | } 28 | 29 | } 30 | -------------------------------------------------------------------------------- /Source/CGPointExtensions.swift: -------------------------------------------------------------------------------- 1 | // 2 | // CGPointExtensions.swift 3 | // SwiftlyExt 4 | // 5 | // Created by Khoi Lai on 12/30/16. 6 | // Copyright © 2016 Khoi Lai. All rights reserved. 7 | // 8 | 9 | import Foundation 10 | import CoreGraphics 11 | 12 | public extension CGPoint { 13 | 14 | /// Calculate distance from self to another point. 15 | /// 16 | /// - Parameter to: destination point 17 | /// - Returns: distance between two points. 18 | func distance(to point: CGPoint) -> CGFloat { 19 | return CGPoint.distance(from: self, to: point) 20 | } 21 | 22 | /// Calculate distance between 2 CGPoint. 23 | /// 24 | /// - Parameters: 25 | /// - from: origin point 26 | /// - to: destination point 27 | /// - Returns: distance between two points. 28 | static func distance(from: CGPoint, to: CGPoint) -> CGFloat { 29 | return sqrt(pow(to.x - from.x, 2) + pow(to.y - from.y, 2)) 30 | } 31 | } 32 | -------------------------------------------------------------------------------- /Source/Info-tvOS.plist: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | CFBundleDevelopmentRegion 6 | en 7 | CFBundleExecutable 8 | $(EXECUTABLE_NAME) 9 | CFBundleIdentifier 10 | $(PRODUCT_BUNDLE_IDENTIFIER) 11 | CFBundleInfoDictionaryVersion 12 | 6.0 13 | CFBundleName 14 | $(PRODUCT_NAME) 15 | CFBundlePackageType 16 | FMWK 17 | CFBundleShortVersionString 18 | 1.0 19 | CFBundleVersion 20 | $(CURRENT_PROJECT_VERSION) 21 | NSPrincipalClass 22 | 23 | UIRequiredDeviceCapabilities 24 | 25 | arm64 26 | 27 | 28 | 29 | -------------------------------------------------------------------------------- /CHANGELOG.md: -------------------------------------------------------------------------------- 1 | # Change Log 2 | `SwiftlyExt` adheres to [Semantic Versioning](http://semver.org/). 3 | 4 | ## [1.3.0](https://github.com/khoiln/SwiftlyExt/releases/tag/1.3.0) 5 | 6 | Remove Equatable on E of .groupBy 7 | 8 | ## [1.2.0](https://github.com/khoiln/SwiftlyExt/releases/tag/1.2.0) 9 | 10 | Added .groupBy, .reject 11 | 12 | ## [1.1.0](https://github.com/khoiln/SwiftlyExt/releases/tag/1.1.0) 13 | 14 | Added Swiftly struct for public static methods 15 | Added Array .random, .sample, .sampleSize 16 | Added String .between, .count, .initials, .isEmail, .hasNumbers, .hasLetters, .isAlpha, .isAlphaNumeric 17 | 18 | ## [1.0.2](https://github.com/khoiln/SwiftlyExt/releases/tag/1.0.2) 19 | 20 | Added Array .without, .shuffle, .shuffled 21 | 22 | ## [1.0.1](https://github.com/khoiln/SwiftlyExt/releases/tag/1.0.1) 23 | 24 | Added Array static methods: xor, xorBy, xorWith 25 | 26 | ## [1.0](https://github.com/khoiln/SwiftlyExt/releases/tag/1.0) 27 | 28 | First stable release 🚀 29 | 30 | -------------------------------------------------------------------------------- /Tests/SwiftlyTests.swift: -------------------------------------------------------------------------------- 1 | // 2 | // SwiftlyTests.swift 3 | // SwiftlyExt 4 | // 5 | // Created by Khoi Lai on 1/30/17. 6 | // Copyright © 2017 Khoi Lai. All rights reserved. 7 | // 8 | 9 | import XCTest 10 | @testable import SwiftlyExt 11 | 12 | class SwiftlyTests: XCTestCase { 13 | 14 | override func setUp() { 15 | super.setUp() 16 | // Put setup code here. This method is called before the invocation of each test method in the class. 17 | } 18 | 19 | override func tearDown() { 20 | // Put teardown code here. This method is called after the invocation of each test method in the class. 21 | super.tearDown() 22 | } 23 | 24 | func testRandom(){ 25 | (0...100).forEach { _ in 26 | let random = Swiftly.random(lower: 0, upper: 1) 27 | XCTAssert( [0,1].some{ $0 == random } , "Should return number 0 or 1") 28 | } 29 | 30 | XCTAssert(Swiftly.random(lower: 2, upper: 2) == 2, "Return the same number if lower == upper") 31 | } 32 | 33 | 34 | } 35 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Copyright (c) 2016 Swiftly 2 | 3 | Permission is hereby granted, free of charge, to any person obtaining a copy 4 | of this software and associated documentation files (the "Software"), to deal 5 | in the Software without restriction, including without limitation the rights 6 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 7 | copies of the Software, and to permit persons to whom the Software is 8 | furnished to do so, subject to the following conditions: 9 | 10 | The above copyright notice and this permission notice shall be included in 11 | all copies or substantial portions of the Software. 12 | 13 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 14 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 15 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 16 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 17 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 18 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 19 | THE SOFTWARE. -------------------------------------------------------------------------------- /Source/DictionaryExtensions.swift: -------------------------------------------------------------------------------- 1 | // 2 | // DictionaryExtensions.swift 3 | // SwiftlyExt 4 | // 5 | // Created by Khoi Lai on 12/30/16. 6 | // Copyright © 2016 Khoi Lai. All rights reserved. 7 | // 8 | 9 | import Foundation 10 | 11 | public extension Dictionary { 12 | 13 | init?(fromJsonString json: String) { 14 | guard let data = (try? JSONSerialization.jsonObject(with: json.data(using: String.Encoding.utf8, allowLossyConversion: true)!, 15 | options: JSONSerialization.ReadingOptions.mutableContainers)) as? Dictionary else { 16 | return nil 17 | } 18 | self = data 19 | } 20 | 21 | /// Convert from dictionary to Json String 22 | /// 23 | /// - Parameter prettify: Pretty printed or not 24 | /// - Returns: Json String if exist 25 | func toJsonString(prettify: Bool = false) -> String? { 26 | guard let data = try? JSONSerialization.data(withJSONObject: self, options: prettify ? .prettyPrinted : JSONSerialization.WritingOptions()) else { return nil } 27 | let str = String(data: data, encoding: String.Encoding(rawValue: String.Encoding.utf8.rawValue)) 28 | return String(str ?? "") 29 | } 30 | 31 | } 32 | -------------------------------------------------------------------------------- /Source/RangeExtensions.swift: -------------------------------------------------------------------------------- 1 | // 2 | // RangeExtensions.swift 3 | // Swiftly 4 | // 5 | // Created by Khoi Lai on 9/19/16. 6 | // Copyright © 2016 Khoi Lai. All rights reserved. 7 | // 8 | 9 | import Foundation 10 | 11 | internal extension CountableRange { 12 | 13 | func each(callback: (Bound) -> Void) { 14 | for i in self { 15 | callback(i) 16 | } 17 | } 18 | 19 | func each(callback: () -> Void) { 20 | for _ in self { 21 | callback() 22 | } 23 | } 24 | 25 | func toArray() -> [Bound] { 26 | var result = [Bound]() 27 | self.each { (bound) in 28 | result.append(bound) 29 | } 30 | return result 31 | } 32 | } 33 | 34 | internal extension CountableClosedRange { 35 | func each(callback: (Bound) -> Void) { 36 | for i in self { 37 | callback(i) 38 | } 39 | } 40 | 41 | func each(callback: () -> Void) { 42 | for _ in self { 43 | callback() 44 | } 45 | } 46 | 47 | func toArray() -> [Bound] { 48 | var result = [Bound]() 49 | self.each { (bound) in 50 | result.append(bound) 51 | } 52 | return result 53 | } 54 | 55 | } 56 | -------------------------------------------------------------------------------- /Tests/DictionaryTests.swift: -------------------------------------------------------------------------------- 1 | // 2 | // DictionaryTests.swift 3 | // SwiftlyExt 4 | // 5 | // Created by Khoi Lai on 12/30/16. 6 | // Copyright © 2016 Khoi Lai. All rights reserved. 7 | // 8 | 9 | import XCTest 10 | 11 | class DictionaryTests: XCTestCase { 12 | 13 | 14 | typealias JSONDict = [String: Any] 15 | 16 | let jsonString = "{\"list\":[1234,45.234],\"number\":5443.1,\"name\":\"Swiftly\",\"object\":{\"sub_number\":877.2323,\"sub_name\":\"SwiftlySub\"},\"bool\":true}" 17 | 18 | override func setUp() { 19 | super.setUp() 20 | // Put setup code here. This method is called before the invocation of each test method in the class. 21 | } 22 | 23 | override func tearDown() { 24 | // Put teardown code here. This method is called after the invocation of each test method in the class. 25 | super.tearDown() 26 | } 27 | 28 | 29 | func testInitFromJSON() { 30 | let dict = JSONDict(fromJsonString: jsonString)! 31 | XCTAssert((dict["number"] as! Double) == 5443.1, "number prop") 32 | XCTAssert((dict["name"] as! String) == "Swiftly", "string prop") 33 | 34 | 35 | XCTAssert((dict["list"] as! [Double])[0] == 1234, "array list prop int") 36 | XCTAssert((dict["list"] as! [Double])[1] == 45.234, "array list prop double") 37 | XCTAssert((dict["object"] as! JSONDict)["sub_number"] as! Double == 877.2323, "subobject number") 38 | XCTAssert((dict["object"] as! JSONDict)["sub_name"] as! String == "SwiftlySub", "subobject string") 39 | XCTAssert(dict["bool"] as! Bool, "bool prop") 40 | } 41 | 42 | 43 | } 44 | -------------------------------------------------------------------------------- /.travis.yml: -------------------------------------------------------------------------------- 1 | language: objective-c 2 | osx_image: xcode8 3 | env: 4 | global: 5 | - LC_CTYPE=en_US.UTF-8 6 | - LANG=en_US.UTF-8 7 | - WORKSPACE=SwiftlyExt.xcworkspace 8 | - IOS_FRAMEWORK_SCHEME="SwiftlyExt iOS" 9 | - MACOS_FRAMEWORK_SCHEME="SwiftlyExt macOS" 10 | - TVOS_FRAMEWORK_SCHEME="SwiftlyExt tvOS" 11 | - WATCHOS_FRAMEWORK_SCHEME="SwiftlyExt watchOS" 12 | - IOS_SDK=iphonesimulator10.0 13 | - MACOS_SDK=macosx10.12 14 | - TVOS_SDK=appletvsimulator10.0 15 | - WATCHOS_SDK=watchsimulator3.0 16 | matrix: 17 | - DESTINATION="OS=3.0,name=Apple Watch - 42mm" SCHEME="$WATCHOS_FRAMEWORK_SCHEME" SDK="$WATCHOS_SDK" RUN_TESTS="NO" POD_LINT="NO" 18 | - DESTINATION="OS=2.0,name=Apple Watch - 42mm" SCHEME="$WATCHOS_FRAMEWORK_SCHEME" SDK="$WATCHOS_SDK" RUN_TESTS="NO" POD_LINT="NO" 19 | 20 | - DESTINATION="OS=10.0,name=iPhone 7 Plus" SCHEME="$IOS_FRAMEWORK_SCHEME" SDK="$IOS_SDK" RUN_TESTS="YES" POD_LINT="YES" 21 | - DESTINATION="OS=9.0,name=iPhone 5" SCHEME="$IOS_FRAMEWORK_SCHEME" SDK="$IOS_SDK" RUN_TESTS="YES" POD_LINT="NO" 22 | 23 | - DESTINATION="OS=10.0,name=Apple TV 1080p" SCHEME="$TVOS_FRAMEWORK_SCHEME" SDK="$TVOS_SDK" RUN_TESTS="YES" POD_LINT="NO" 24 | - DESTINATION="OS=9.0,name=Apple TV 1080p" SCHEME="$TVOS_FRAMEWORK_SCHEME" SDK="$TVOS_SDK" RUN_TESTS="YES" POD_LINT="NO" 25 | 26 | - DESTINATION="arch=x86_64" SCHEME="$MACOS_FRAMEWORK_SCHEME" SDK="$MACOS_SDK" RUN_TESTS="YES" POD_LINT="NO" 27 | before_install: 28 | - gem install cocoapods --pre --no-rdoc --no-ri --no-document --quiet 29 | script: 30 | - set -o pipefail 31 | - xcodebuild -version 32 | - xcodebuild -showsdks 33 | 34 | # Build Framework in Debug and Run Tests if specified 35 | - if [ $RUN_TESTS == "YES" ]; then 36 | travis_retry xcodebuild -workspace "$WORKSPACE" -scheme "$SCHEME" -sdk "$SDK" -destination "$DESTINATION" -configuration Debug ONLY_ACTIVE_ARCH=NO ENABLE_TESTABILITY=YES test | xcpretty; 37 | else 38 | travis_retry xcodebuild -workspace "$WORKSPACE" -scheme "$SCHEME" -sdk "$SDK" -destination "$DESTINATION" -configuration Debug ONLY_ACTIVE_ARCH=NO build | xcpretty; 39 | fi 40 | 41 | # Build Framework in Release and Run Tests if specified 42 | - if [ $RUN_TESTS == "YES" ]; then 43 | travis_retry xcodebuild -workspace "$WORKSPACE" -scheme "$SCHEME" -sdk "$SDK" -destination "$DESTINATION" -configuration Release ONLY_ACTIVE_ARCH=NO ENABLE_TESTABILITY=YES test | xcpretty; 44 | else 45 | travis_retry xcodebuild -workspace "$WORKSPACE" -scheme "$SCHEME" -sdk "$SDK" -destination "$DESTINATION" -configuration Release ONLY_ACTIVE_ARCH=NO build | xcpretty; 46 | fi 47 | 48 | # Run `pod lib lint` if specified 49 | - if [ $POD_LINT == "YES" ]; then 50 | pod lib lint; 51 | fi 52 | after_success: 53 | - bash <(curl -s https://codecov.io/bash) -------------------------------------------------------------------------------- /Source/IntExtensions.swift: -------------------------------------------------------------------------------- 1 | // 2 | // IntExtensions.swift 3 | // Swiftly 4 | // 5 | // Created by Khoi Lai on 9/19/16. 6 | // Copyright © 2016 Khoi Lai. All rights reserved. 7 | // 8 | 9 | import Foundation 10 | 11 | public extension Int { 12 | /// Convert current int to an [Int] 13 | /// 14 | /// - returns: An array of digits 15 | func digits() -> [Int] { 16 | 17 | var digits: [Int] = [] 18 | var curr = self 19 | 20 | while curr > 0 { 21 | digits.append(curr % 10) 22 | curr /= 10 23 | } 24 | 25 | return digits.reversed() 26 | } 27 | 28 | /// Invoke the callback with indexes from current int down to and including n. 29 | /// 30 | /// - parameter lowBound: The lowBound to go to 31 | /// - parameter callback: The block to invoke with current index 32 | func downTo(_ lowBound: Int, callback: (Int) -> Void) { 33 | var curr = self 34 | while curr >= lowBound { 35 | callback(curr) 36 | curr -= 1 37 | } 38 | } 39 | 40 | /// Return the factorial of int 41 | /// 42 | /// - returns: Factorial of int 43 | func factorial() -> Int { 44 | guard self > 0 else { return 1 } 45 | return self * (self - 1).factorial() 46 | } 47 | 48 | /// Check if the integer is even. 49 | /// 50 | /// - returns: Bool whether the int is even 51 | func isEven() -> Bool { 52 | return self % 2 == 0 53 | } 54 | 55 | /// Test whether the int is in a range 56 | /// 57 | /// - parameter range: The range to check 58 | /// 59 | /// - returns: BOOL whether the int is in range 60 | func isIn(range: Range) -> Bool { 61 | return range ~= self 62 | } 63 | 64 | /// Test whether the int is in a range 65 | /// 66 | /// - parameter range: The range to check 67 | /// 68 | /// - returns: BOOL whether the int is in range 69 | func isIn(range: ClosedRange) -> Bool { 70 | return range ~= self 71 | } 72 | 73 | /// Check if the integer is odd. 74 | /// 75 | /// - returns: Bool whether the int is odd 76 | func isOdd() -> Bool { 77 | return !isEven() 78 | } 79 | 80 | /// Invoke the callback function n times with zero-based indexes. 81 | /// 82 | /// - parameter callback: The block with current index 83 | func times(_ callback: (Int) -> Void) { 84 | guard self > 0 else { return } 85 | (0.. Void) { 95 | guard self <= upBound else { return } 96 | (self...upBound).each { (idx) in 97 | callback(idx) 98 | } 99 | } 100 | } 101 | -------------------------------------------------------------------------------- /SwiftlyExt.xcodeproj/xcshareddata/xcschemes/SwiftlyExt watchOS.xcscheme: -------------------------------------------------------------------------------- 1 | 2 | 5 | 8 | 9 | 15 | 21 | 22 | 23 | 24 | 25 | 31 | 32 | 33 | 34 | 35 | 36 | 46 | 47 | 53 | 54 | 55 | 56 | 57 | 58 | 64 | 65 | 71 | 72 | 73 | 74 | 76 | 77 | 80 | 81 | 82 | -------------------------------------------------------------------------------- /Tests/IntTests.swift: -------------------------------------------------------------------------------- 1 | // 2 | // IntTests.swift 3 | // IntTests 4 | // 5 | // Created by Khoi Lai on 9/19/16. 6 | // Copyright © 2016 Khoi Lai. All rights reserved. 7 | // 8 | 9 | import XCTest 10 | import SwiftlyExt 11 | 12 | class IntTests: XCTestCase { 13 | 14 | override func setUp() { 15 | super.setUp() 16 | 17 | 1.upTo(3) { print($0) } 18 | // Put setup code here. This method is called before the invocation of each test method in the class. 19 | } 20 | 21 | override func tearDown() { 22 | // Put teardown code here. This method is called after the invocation of each test method in the class. 23 | super.tearDown() 24 | } 25 | 26 | func testTimes() { 27 | var count = 0 28 | 29 | 5.times { _ in 30 | count += 1 31 | } 32 | XCTAssertEqual(count, 5) 33 | 34 | var zero = 0 35 | 0.times { _ in 36 | zero += 1 37 | } 38 | XCTAssertEqual(zero, 0) 39 | 40 | 41 | (-9).times { _ in 42 | zero += 1 43 | } 44 | XCTAssertEqual(zero, 0) 45 | 46 | } 47 | 48 | func testTimesWithIndex() { 49 | var indexes = [Int]() 50 | 51 | 5.times { (idx) in 52 | indexes.append(idx) 53 | } 54 | 55 | XCTAssertEqual(indexes, [0, 1,2, 3,4]) 56 | } 57 | 58 | func testOddAndEven() { 59 | XCTAssert(4.isEven()) 60 | XCTAssert(0.isEven()) 61 | XCTAssertFalse(1.isEven()) 62 | XCTAssertFalse(3.isEven()) 63 | 64 | XCTAssertFalse(4.isOdd()) 65 | XCTAssertFalse(0.isOdd()) 66 | XCTAssert(1.isOdd()) 67 | XCTAssert(3.isOdd()) 68 | } 69 | 70 | func testUpTo() { 71 | var count = 0 72 | 0.upTo(5) { _ in 73 | count += 1 74 | } 75 | XCTAssertEqual(count, 6) 76 | 77 | var zero = 0 78 | 0.upTo(-1) { _ in 79 | zero += 1 80 | } 81 | XCTAssertEqual(zero, 0) 82 | 83 | 12.upTo(-1) { _ in 84 | zero += 1 85 | } 86 | XCTAssertEqual(zero, 0) 87 | 88 | var indexes = [Int]() 89 | 90 | 0.upTo(5) { (idx) in 91 | indexes.append(idx) 92 | } 93 | 94 | XCTAssertEqual(indexes, [0, 1,2, 3,4, 5]) 95 | } 96 | 97 | 98 | func testDownTo() { 99 | var count = 0 100 | 5.downTo(0) { _ in 101 | count += 1 102 | } 103 | XCTAssertEqual(count, 6) 104 | 105 | var zero = 0 106 | (-1).downTo(0) { _ in 107 | zero += 1 108 | } 109 | XCTAssertEqual(zero, 0) 110 | 111 | (-1).downTo(12) { _ in 112 | zero += 1 113 | } 114 | XCTAssertEqual(zero, 0) 115 | 116 | var indexes = [Int]() 117 | 5.downTo(0) { (idx) in 118 | indexes.append(idx) 119 | } 120 | XCTAssertEqual(indexes, [5, 4,3, 2,1, 0]) 121 | } 122 | 123 | 124 | 125 | func testDigits() { 126 | XCTAssertEqual(1234.digits(), [1, 2,3, 4]) 127 | XCTAssertEqual(01234.digits(), [1, 2,3, 4]) 128 | } 129 | 130 | func testIsIn() { 131 | XCTAssert(0.isIn(range: 0..<200)) 132 | XCTAssertFalse(200.isIn(range: 0..<200)) 133 | XCTAssertFalse((-1).isIn(range: 0..<200)) 134 | 135 | XCTAssert(0.isIn(range: 0...200)) 136 | XCTAssert(200.isIn(range: 0...200)) 137 | XCTAssertFalse((-1).isIn(range: 0...200)) 138 | XCTAssertFalse(201.isIn(range: 0...200)) 139 | } 140 | 141 | func testFactorial() { 142 | XCTAssertEqual(5.factorial(), 120) 143 | XCTAssertEqual(10.factorial(), 3628800) 144 | XCTAssertEqual(0.factorial(), 1) 145 | 146 | 147 | } 148 | } 149 | -------------------------------------------------------------------------------- /Tests/DateTests.swift: -------------------------------------------------------------------------------- 1 | // 2 | // DateTests.swift 3 | // Swiftly 4 | // 5 | // Created by Khoi Lai on 08/10/2016. 6 | // Copyright © 2016 Khoi Lai. All rights reserved. 7 | // 8 | 9 | import XCTest 10 | 11 | class DateTests: XCTestCase { 12 | 13 | 14 | let dateFormatString = "dd/MM/yyyy HH:mm:ss" 15 | 16 | let currentDate = Date() 17 | 18 | var sameDate: Date? 19 | var futureDate: Date? 20 | var pastDate: Date? 21 | 22 | 23 | let calendar = Calendar.current 24 | 25 | override func setUp() { 26 | super.setUp() 27 | sameDate = calendar.date(byAdding: .day, value: 0, to: currentDate) 28 | futureDate = calendar.date(byAdding: .day, value: 1, to: currentDate) 29 | pastDate = calendar.date(byAdding: .day, value: -1, to: currentDate) 30 | } 31 | 32 | func testBefore() { 33 | XCTAssert(currentDate.isBefore(futureDate!)) 34 | XCTAssertFalse(currentDate.isBefore(pastDate!)) 35 | XCTAssertFalse(currentDate.isBefore(sameDate!)) 36 | } 37 | 38 | func testAfter() { 39 | XCTAssert(currentDate.isAfter(pastDate!)) 40 | XCTAssertFalse(currentDate.isAfter(futureDate!)) 41 | XCTAssertFalse(currentDate.isAfter(sameDate!)) 42 | } 43 | 44 | func testCustomInit() { 45 | XCTAssertNotNil(Date(from: "01/01/1970 00:34:22", format: dateFormatString), "Should return a valid date") 46 | XCTAssertNil(Date(from: "01/34/1970 00:34:22", format: dateFormatString), "Should return a invalid date") 47 | } 48 | 49 | func testCustomerProperty() { 50 | let aDate = Date(from: "01/01/1970 00:34:22", format: dateFormatString) 51 | XCTAssertEqual(aDate?.era, 1) 52 | XCTAssertEqual(aDate?.year, 1970) 53 | XCTAssertEqual(aDate?.month, 1) 54 | XCTAssertEqual(aDate?.day, 1) 55 | XCTAssertEqual(aDate?.hour, 00) 56 | XCTAssertEqual(aDate?.minute, 34) 57 | XCTAssertEqual(aDate?.second, 22) 58 | XCTAssertEqual(aDate?.weekday, 5) 59 | } 60 | 61 | func testStringFormat() { 62 | let aDate = Date(from: "30/12/2016 14:34:22", format: dateFormatString) 63 | XCTAssertEqual(aDate?.toString(format: dateFormatString), "30/12/2016 14:34:22") 64 | XCTAssertEqual(aDate?.toString(format: "MMM yyyy"), "Dec 2016") 65 | } 66 | 67 | func testAddingDate() { 68 | let aDate = Date(from: "30/12/2016 14:34:22", format: dateFormatString) 69 | XCTAssertEqual(aDate?.date(byAddingYears: 1)?.year, 2017) 70 | XCTAssertEqual(aDate?.date(byAddingYears: -1)?.year, 2015) 71 | 72 | XCTAssertEqual(aDate?.date(byAddingMonths: 1)?.year, 2017, "Should switch to next year if current month is 12") 73 | XCTAssertEqual(aDate?.date(byAddingMonths: 1)?.month, 1) 74 | XCTAssertEqual(aDate?.date(byAddingMonths: -1)?.month, 11) 75 | 76 | XCTAssertEqual(aDate?.date(byAddingDays: 1)?.day, 31) 77 | XCTAssertEqual(aDate?.date(byAddingDays: 2)?.day, 1) 78 | XCTAssertEqual(aDate?.date(byAddingDays: -1)?.day, 29) 79 | 80 | XCTAssertEqual(aDate?.date(byAddingHours: 1)?.hour, 15) 81 | XCTAssertEqual(aDate?.date(byAddingHours: -1)?.hour, 13) 82 | XCTAssertEqual(aDate?.date(byAddingHours: 10)?.hour, 0) 83 | XCTAssertEqual(aDate?.date(byAddingHours: 10)?.day, 31) 84 | 85 | XCTAssertEqual(aDate?.date(byAddingMinutes: 1)?.minute, 35) 86 | XCTAssertEqual(aDate?.date(byAddingMinutes: -1)?.minute, 33) 87 | XCTAssertEqual(aDate?.date(byAddingMinutes: 26)?.hour, 15) 88 | XCTAssertEqual(aDate?.date(byAddingMinutes: 26)?.minute, 0) 89 | 90 | XCTAssertEqual(aDate?.date(byAddingSeconds: 1)?.second, 23) 91 | XCTAssertEqual(aDate?.date(byAddingSeconds: -1)?.second, 21) 92 | XCTAssertEqual(aDate?.date(byAddingSeconds: 38)?.second, 0) 93 | XCTAssertEqual(aDate?.date(byAddingSeconds: 38)?.minute, 35) 94 | } 95 | } 96 | -------------------------------------------------------------------------------- /SwiftlyExt.xcodeproj/xcshareddata/xcschemes/SwiftlyExt macOS.xcscheme: -------------------------------------------------------------------------------- 1 | 2 | 5 | 8 | 9 | 15 | 21 | 22 | 23 | 24 | 25 | 31 | 32 | 34 | 40 | 41 | 42 | 43 | 44 | 50 | 51 | 52 | 53 | 54 | 55 | 65 | 66 | 72 | 73 | 74 | 75 | 76 | 77 | 83 | 84 | 90 | 91 | 92 | 93 | 95 | 96 | 99 | 100 | 101 | -------------------------------------------------------------------------------- /Tests/StringTests.swift: -------------------------------------------------------------------------------- 1 | // 2 | // StringTests.swift 3 | // SwiftlyExt 4 | // 5 | // Created by Khoi Lai on 10/10/2016. 6 | // Copyright © 2016 Khoi Lai. All rights reserved. 7 | // 8 | 9 | import XCTest 10 | 11 | class StringTests: XCTestCase { 12 | 13 | let dateFormatString = "dd/MM/yyyy HH:mm:ss" 14 | 15 | override func setUp() { 16 | super.setUp() 17 | } 18 | 19 | func testInitials(){ 20 | XCTAssert("John Doe".initials == "JD") 21 | XCTAssert("John With Middle Name Doe".initials == "JWMND") 22 | } 23 | 24 | func testIsEmail(){ 25 | XCTAssertTrue("swift@swiftly.com".isEmail) 26 | XCTAssertFalse("swift@@swiftly.com".isEmail) 27 | } 28 | 29 | func testCount(){ 30 | XCTAssert("Swiftlylylyly ly".count("as") == 0) 31 | XCTAssert("Swiftlylylyly ly".count("ly") == 5) 32 | } 33 | 34 | func testBetween(){ 35 | XCTAssert("foo".between("", "") == "foo") 36 | XCTAssert("foo".between("", "") == "foo") 37 | XCTAssert("foo".between("", "") == nil) 38 | XCTAssert("Some strings } are very {weird}, dont you think?".between("{", "}") == "weird") 39 | XCTAssert("".between("", "") == nil) 40 | XCTAssert("foo".between("", "") == nil) 41 | } 42 | 43 | func testDate() { 44 | guard let date = "01/01/1970 00:34:22".date(format: dateFormatString) else { 45 | XCTFail("Can't parse a valid date") 46 | return 47 | } 48 | XCTAssertNil("13/14/1780 14:38:88".date(format: dateFormatString), "Should return nil for invalid date") 49 | XCTAssertEqual(date.year, 1970) 50 | XCTAssertEqual(date.month, 1) 51 | XCTAssertEqual(date.day, 1) 52 | XCTAssertEqual(date.hour, 0) 53 | XCTAssertEqual(date.minute, 34) 54 | XCTAssertEqual(date.second, 22) 55 | XCTAssertEqual(date.nanosecond, 0) 56 | } 57 | 58 | func testBase64Encode() { 59 | XCTAssert("a".base64Encoded == "YQ==", "2 padding chars") 60 | XCTAssert("aa".base64Encoded == "YWE=", "1 padding char") 61 | XCTAssert("aaa".base64Encoded == "YWFh", "0 padding char") 62 | XCTAssert("foo\0".base64Encoded == "Zm9vAA==", "U+0000") 63 | XCTAssert("foo\0\0".base64Encoded == "Zm9vAAA=", "0 padding char") 64 | XCTAssert("https://github.com/Swiftly".base64Encoded == "aHR0cHM6Ly9naXRodWIuY29tL1N3aWZ0bHk=") 65 | } 66 | 67 | func testBase64Decode() { 68 | XCTAssert("aHR0cHM6Ly9naXRodWIuY29tL1N3aWZ0bHk=".base64Decoded == "https://github.com/Swiftly") 69 | } 70 | 71 | func testReversed() { 72 | XCTAssert("Swiftly".reversed == "yltfiwS") 73 | XCTAssert("abcdef".reversed == "fedcba") 74 | XCTAssert("a".reversed == "a") 75 | XCTAssert("".reversed == "") 76 | } 77 | 78 | func testTrimmed() { 79 | XCTAssert("\r\n\n\n Swiftly \r\n\n".trimmed == "Swiftly") 80 | XCTAssert("\n\n\n Swiftly ".trimmed.reversed == "yltfiwS") 81 | } 82 | 83 | func testURLEncoded() { 84 | XCTAssert("abcd".urlEncoded == "abcd", "String must be unchanged") 85 | XCTAssert("\n\t".urlEncoded == "%0A%09") 86 | XCTAssert("Swiftly\t\nString\nTest".urlEncoded == "Swiftly%09%0AString%0ATest") 87 | } 88 | 89 | func testURLDecoded() { 90 | XCTAssert("https%3A%2F%2Fgithub.com%2Fkhoiln%2FSwiftlyEXT".urlDecoded == "https://github.com/khoiln/SwiftlyEXT") 91 | } 92 | 93 | func testHasNumbers(){ 94 | XCTAssertTrue("hoho2".hasNumbers) 95 | XCTAssertFalse("swiftly".hasNumbers) 96 | } 97 | 98 | func testHasLetters(){ 99 | XCTAssertFalse("12389723".hasLetters) 100 | XCTAssertTrue("3749347a98423".hasLetters) 101 | XCTAssertFalse("!@#$%^&*()🐶".hasLetters) 102 | } 103 | 104 | func testIsAlpha(){ 105 | XCTAssertFalse("fdafaf3".isAlpha) 106 | XCTAssert("afaf".isAlpha) 107 | XCTAssertFalse("dfda@#(*&@#dfd".isAlpha) 108 | } 109 | 110 | func testIsAlphaNumeric() { 111 | XCTAssert("afaf35353afaf".isAlphaNumeric) 112 | XCTAssert("FFFF99fff".isAlphaNumeric) 113 | XCTAssert("99".isAlphaNumeric) 114 | XCTAssert("afff".isAlphaNumeric) 115 | XCTAssertFalse("-33".isAlphaNumeric) 116 | XCTAssertFalse("aaff..".isAlphaNumeric) 117 | } 118 | } 119 | -------------------------------------------------------------------------------- /Source/StringExtensions.swift: -------------------------------------------------------------------------------- 1 | // 2 | // StringExtensions.swift 3 | // SwiftlyExt 4 | // 5 | // Created by Khoi Lai on 10/10/2016. 6 | // Copyright © 2016 Khoi Lai. All rights reserved. 7 | // 8 | 9 | import Foundation 10 | 11 | public extension String { 12 | 13 | /// Find the string between two string. 14 | /// 15 | /// - Parameters: 16 | /// - left: The left bookend 17 | /// - right: The right bookend 18 | /// - Returns: Return the String if found else `nil` 19 | func between(_ left: String, _ right: String) -> String? { 20 | guard let leftRange = range(of: left), 21 | let rightRange = range(of: right, options: .backwards), 22 | left != right && leftRange.upperBound != rightRange.lowerBound else { 23 | return nil 24 | } 25 | return self[leftRange.upperBound...index(before: rightRange.lowerBound)] 26 | } 27 | 28 | /// Count number of occurences for a substring 29 | /// 30 | /// - Parameter str: The string to count 31 | /// - Returns: Number of occurences 32 | func count(_ str: String) -> Int { 33 | return components(separatedBy: str).count - 1 34 | } 35 | 36 | /// Return a date from current string. 37 | /// 38 | /// - parameter format: The date format 39 | /// - parameter locale: The locale. default to `.current` 40 | /// 41 | /// - returns: A Date. 42 | func date(format: String, locale: Locale = .current) -> Date? { 43 | let df = DateFormatter() 44 | df.dateFormat = format 45 | df.locale = locale 46 | return df.date(from: self) 47 | } 48 | 49 | /// Check whether the string is an email or not. 50 | var isEmail: Bool { 51 | let regex = "[A-Z0-9a-z._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}" 52 | let predicate = NSPredicate(format:"SELF MATCHES %@", regex) 53 | return predicate.evaluate(with: self) 54 | } 55 | 56 | /// Check whether the string contains one or more letters. 57 | public var hasLetters: Bool { 58 | return rangeOfCharacter(from: .letters, options: .literal) != nil 59 | } 60 | 61 | /// Check whether the string contains one or more numbers. 62 | public var hasNumbers: Bool { 63 | return rangeOfCharacter(from: .decimalDigits, options: .literal) != nil 64 | } 65 | 66 | /// Check whether the string contains only letters. 67 | var isAlpha: Bool { 68 | for c in characters { 69 | if !(c >= "a" && c <= "z") && !(c >= "A" && c <= "Z") { 70 | return false 71 | } 72 | } 73 | return true 74 | } 75 | 76 | /// Check if string contains at least one letter and one number 77 | var isAlphaNumeric: Bool { 78 | return components(separatedBy: .alphanumerics).joined(separator: "").characters.isEmpty 79 | } 80 | 81 | /// Return the initials of the String 82 | var initials: String { 83 | return self.components(separatedBy: " ").reduce("") { $0 + $1[0...0] } 84 | } 85 | 86 | /// Decoded Base 64 String if applicable 87 | var base64Decoded: String? { 88 | guard let decodedData = Data(base64Encoded: self) else { return nil } 89 | return String(data: decodedData, encoding: .utf8) 90 | } 91 | 92 | /// Encoded Base 64 String if applicable 93 | var base64Encoded: String? { 94 | return data(using: .utf8)?.base64EncodedString() 95 | } 96 | 97 | /// Reversed String 98 | var reversed: String { 99 | return String(self.characters.reversed()) 100 | } 101 | 102 | /// A String without white spaces and new lines 103 | var trimmed: String { 104 | return trimmingCharacters(in: .whitespacesAndNewlines) 105 | } 106 | 107 | /// Decoded URL String 108 | var urlDecoded: String { 109 | return removingPercentEncoding ?? self 110 | } 111 | 112 | /// Encoded URL String 113 | var urlEncoded: String { 114 | return self.addingPercentEncoding(withAllowedCharacters: .urlHostAllowed) ?? self 115 | } 116 | 117 | } 118 | 119 | extension String { 120 | subscript (r: CountableClosedRange) -> String { 121 | get { 122 | let startIndex = self.index(self.startIndex, offsetBy: r.lowerBound) 123 | let endIndex = self.index(startIndex, offsetBy: r.upperBound - r.lowerBound) 124 | return self[startIndex...endIndex] 125 | } 126 | } 127 | } 128 | -------------------------------------------------------------------------------- /SwiftlyExt.xcodeproj/xcshareddata/xcschemes/SwiftlyExt iOS.xcscheme: -------------------------------------------------------------------------------- 1 | 2 | 5 | 8 | 9 | 15 | 21 | 22 | 23 | 24 | 25 | 31 | 32 | 34 | 40 | 41 | 42 | 43 | 44 | 50 | 51 | 52 | 53 | 54 | 55 | 65 | 66 | 72 | 73 | 74 | 75 | 79 | 80 | 81 | 82 | 83 | 84 | 90 | 91 | 97 | 98 | 99 | 100 | 102 | 103 | 106 | 107 | 108 | -------------------------------------------------------------------------------- /SwiftlyExt.xcodeproj/xcshareddata/xcschemes/SwiftlyExt tvOS.xcscheme: -------------------------------------------------------------------------------- 1 | 2 | 5 | 8 | 9 | 15 | 21 | 22 | 23 | 24 | 25 | 31 | 32 | 34 | 40 | 41 | 42 | 43 | 44 | 50 | 51 | 52 | 53 | 54 | 55 | 65 | 66 | 72 | 73 | 74 | 75 | 79 | 80 | 81 | 82 | 83 | 84 | 90 | 91 | 97 | 98 | 99 | 100 | 102 | 103 | 106 | 107 | 108 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | ![](Logo/logo.png) 2 | 3 | [![Build Status](https://travis-ci.org/khoiln/SwiftlyExt.svg?branch=master)](https://travis-ci.org/khoiln/SwiftlyExt) 4 | [![codecov](https://codecov.io/gh/khoiln/SwiftlyExt/branch/master/graph/badge.svg)](https://codecov.io/gh/khoiln/SwiftlyExt) 5 | [![CocoaPods Compatible](https://img.shields.io/cocoapods/v/SwiftlyExt.svg)](https://img.shields.io/cocoapods/v/SwiftlyExt.svg) 6 | [![Carthage Compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage) 7 | ![Swift 3.0.x](https://img.shields.io/badge/Swift-3.0.x-orange.svg) 8 | [![Platform](https://img.shields.io/cocoapods/p/SwiftlyExt.svg?style=flat)](http://cocoadocs.org/docsets/SwiftlyExt) 9 | [![MIT](https://img.shields.io/badge/License-MIT-red.svg)](https://opensource.org/licenses/MIT) 10 | 11 | SwiftlyExt is a library that extends certain Swift standard types and classes using extension feature in the Swift language. 12 | 13 | - [Requirements](#requirements) 14 | - [Installation](#installation) 15 | - [Documentation via CocoaDocs](http://cocoadocs.org/docsets/SwiftlyExt/) 16 | - [FAQ](#faq) 17 | - [License](#license) 18 | 19 | ## Requirements 20 | 21 | - iOS 9.0+ / macOS 10.11+ / tvOS 9.0+ / watchOS 2.0+ 22 | - Xcode 8.0+ 23 | - Swift 3.0+ 24 | 25 | ## Installation 26 | 27 | ### CocoaPods 28 | 29 | [CocoaPods](http://cocoapods.org) is a dependency manager for Cocoa projects. You can install it with the following command: 30 | 31 | ```bash 32 | $ gem install cocoapods 33 | ``` 34 | 35 | > CocoaPods 1.1.0+ is required to build SwiftlyExt. 36 | 37 | To integrate SwiftlyExt into your Xcode project using CocoaPods, specify it in your `Podfile`: 38 | 39 | ```ruby 40 | source 'https://github.com/CocoaPods/Specs.git' 41 | platform :ios, '10.0' 42 | use_frameworks! 43 | 44 | target '' do 45 | pod 'SwiftlyExt', '~> 1.3' 46 | end 47 | ``` 48 | 49 | Then, run the following command: 50 | 51 | ```bash 52 | $ pod install 53 | ``` 54 | 55 | ### Carthage 56 | 57 | [Carthage](https://github.com/Carthage/Carthage) is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. 58 | 59 | You can install Carthage with [Homebrew](http://brew.sh/) using the following command: 60 | 61 | ```bash 62 | $ brew update 63 | $ brew install carthage 64 | ``` 65 | 66 | To integrate SwiftlyExt into your Xcode project using Carthage, specify it in your `Cartfile`: 67 | 68 | ```ogdl 69 | github "khoiln/SwiftlyExt" ~> 1.3 70 | ``` 71 | 72 | Run `carthage update` to build the framework and drag the built `SwiftlyExt.framework` into your Xcode project. U 73 | 74 | ### Swift Package Manager 75 | 76 | Adding SwiftlyExt as a dependency is as easy as adding it to the `dependencies` value of your `Package.swift` file. 77 | 78 | ```swift 79 | dependencies: [ 80 | .Package(url: "https://github.com/khoiln/SwiftlyExt.git", majorVersion: 1) 81 | ] 82 | ``` 83 | 84 | Note that the [Swift Package Manager](https://swift.org/package-manager/) is still in early design and development, but SwiftlyExt does support its use on supported platforms. 85 | 86 | ## Usage 87 | 88 | There are many handy usages of `SwiftlyExt`, head over [CocoaDocs](http://cocoadocs.org/docsets/SwiftlyExt/) for the comprehensive documentation. 89 | 90 | We'll try to list some of the cool examples here. 91 | 92 | ### Array Extensions 93 | 94 | ```swift 95 | [😀,🤡,❤️,💋].sample() // Return a random element 96 | // => 💋 97 | [😀,🤡,❤️,💋].sampleSize(2) // Return n random elements 98 | // => [🤡, 💋] 99 | [1, 2, 3, 4, 5].dropWhile { $0 < 3 } //Drop elements that passes the predicate from the beginning to end 100 | // => [3, 4, 5] 101 | [1, 2, 3, 4, 5].dropWhile { $0 < 3 }.some {$0 % 2 == 0} //And YES you can use method chaining too 👍 102 | // => true 103 | [0, 11, 28, 10].every { $0 % 2 == 0 } //Check if all elements in the array passed the condition 104 | // => false 105 | [0, 11, 28, 10].some { $0 % 2 != 0 } //Check if one of the element passes the condition 106 | // => true 107 | [1, 2, 3, 4, 5].findLastIndex {$0 % 2 == 0} //Find index of the last number which predicate return true for. 108 | // => 3 109 | [1, 2, 3, 4, 5].groupBy { $0 % 2 == 0 ? "even" : "odd"} //Group common elements from an array to a dictionary of [Hashable : [Element]] 110 | // => ["even": [2,4], "odd": [1,3,5]] 111 | // Any many more.... 112 | ``` 113 | 114 | ### Date Extensions 115 | 116 | ```swift 117 | let now = Date() 118 | let tmr = now.date(byAddingDays: 1) 119 | .date(byAddingMinutes: 20) // You could also add year, month... and other time units 120 | 121 | now.isBefore(tmr) 122 | // => true 123 | 124 | now?.toString(format: "dd/MM/yyyy HH:mm:ss") // Return the string representation for a date. 125 | // => "03/15/2017 14:34:22" 126 | 127 | tmr.year == 2017 // Access time unit properties 128 | tmr.hour == 14 129 | tmr.minute == 54 130 | ``` 131 | 132 | ### String Extensions 133 | 134 | ```swift 135 | "John Doe".initials // Return the initials of the String 136 | // => "JD" 137 | "swift@swiftly.com".isEmail // Email validation 138 | // => true 139 | "

💯

", "