IntrepidPursuits/swift-wisdom

This library is meant to be a general grab bag of Swift methods made by the engineers at IntrepidPursuits. As this library goes, useful components will be isolated into separate podspecs where appropriate.

The reason for the grab bag approach is to make it easier to facilitate the adding of materials and encourage componentization and sharing of common functionality.

iOS Versions

iOS <= 9 -> <0.11.0

Swift Versions

Swift 5.0 -> 0.13.0 +
Swift 4.2 -> 0.11.0 through 0.12.0
Swift 4.1.50 (Xcode 10 Compatible) -> 0.10.3
Swift 4.0 -> 0.9.0 through 0.10.x
Swift 3.2 (Xcode 9 Compatible) -> 0.8.3 through 0.8.4
Swift 3 -> 0.6.1 through 0.8.1
Swift 2 -> anything through 0.5.2

Core

pod 'Intrepid'

Subspecs

pod 'Intrepid/Rx' # Intrepid's RxSwift Extensions

Testing Additions

source 'https://github.com/IntrepidPursuits/swift-wisdom.git'
target 'YourTestTarget',
    use_frameworks!
    pod 'IntrepidSwiftWisdomTesting'
end

Qu

A basic wrapper for dispatch operations in Swift. Syntax example:

    Qu.Background {
        // Sleep for long operation
        sleep(4)
        print("1")
    } .Also {
        sleep(4)
        print("2")
    } .Also {
        sleep(1)
        print("3")
    } .Also {
        sleep(1)
        print("4")
    } .Also {
        sleep(1)
        print("5")
    } .ThenAfter(.previous(3)) {
        print("6: After 5, 4, & 3")
    } .Then {
        sleep(1)
        print("7: After 6")
    } .FinallyOn(.main) {
        sleep(1)
        print("Finished: After All")
    }

After

A simple way to perform or repeat future operations:

After(2.5) {
  print("Two and a half seconds later")
}

RepeatAtInterval(1.0, numberOfTimes: 5) {
  print("Once a second, 5 times")
}

Nib Initable

Load views from nibs:

let myCustomView = MyCustomView.fromNib()

Color Descriptor

Setup Easy Color Schemes. Note, if you're using Zeplin that it auto generates color schemes if you'd like

enum ColorPalette : ColorDescriptor {
    case White = "254,216,130,255"
    case DarkGreen = "51,58,24,255"
    case DarkGray = "64,48,56,255"
    case BrightWhite = "#ffffff"

    var color: UIColor {
        return rawValue.color
    }
}

And use:

someView.backgroundColor = ColorPalette.White.color

Cell Configuring

A simple way to cover most table view registering / dequeing

Register

tableView.ip_registerCell(YourCell.self)
tableView.ip_registerHeader(YourHeader.self)

Dequeue

let cell: YourCell = tableView.ip_dequeueCell(indexPath)
//
let header: YourHeader = tableView.ip_dequeueHeader(section)

User Defaults

A way to read and write from defaults simply and type-safe

Define

enum Setting : String, EnumSettingsKeyAccessible {
    case DisplayName
    case LastOpenDate
}

Read

let displayName: String? = Setting.DisplayName.readFromDefaults

Write

Setting.DisplayName.writeToDefaults(displayName)

Implement

struct ApplicationSettings {
    var displayName: String {
        get {
            return Setting.DisplayName.readFromDefaults ?? ""
        }
        set {
            Setting.DisplayName.writeToDefaults(newValue)
        }
    }
}

Result

As opposed to using objective-c style async completion blocks like (possibleObject: AnyObject?, error: NSError?), Result types are preferable:

func fetchName(completion: Result<String> -> Void)

And use:

fetchName { result in
    switch result {
    case let .Success(name):
        print("Successfully got name: \(name)")
    case let .Failure(error):
        print("Failed to get name: \(error)")
    }

}

Time Of Day

Used to convert times of day back and forth from NSDate

To Time

let date = ...
let timeOfDay = TimeOfDay(date)
// or

let timeOfDay = TimeOfDay("1:30")

To Date:

let timeOfDay = ...

// Time Today
let todayAtThatTime = timeOfDay.timeToday()

// Time on given date
let someDate = ...
let timeOnThatDate = timeOfDay.timeOnDate(someDate)

Contributions

All contributions and updates are welcome! Here's some basic guidelines when submitting an addition:

Submit via a Pull Request documenting the addition
Follow appropriate folder conventions
Prefix all extension methods and variables with ip_ to avoid namespacing. Swift namespacing doesn't apply the same way to extensions and prefixes help avoid issues.
Document functionality if it is ambiguous
Bump podspec and tag on branch before merging
On approval, push the podspec to trunk using pod trunk push Intrepid.podspec.