Latest 0.7.10
Homepage https://github.com/IntrepidPursuits/swift-wisdom
License MIT
Platforms ios 8.0
Authors

Build Status
Coverage

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.

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

Components

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.

Latest podspec

{
    "name": "IntrepidTesting",
    "version": "0.7.10",
    "summary": "A collection of test extensions to the Swift Standard Library",
    "description": "Collection of test extensions and utility classes by and for the developers at Intrepid Pursuits.",
    "homepage": "https://github.com/IntrepidPursuits/swift-wisdom",
    "license": "MIT",
    "authors": {
        "Colden Prime": "[email protected]"
    },
    "source": {
        "git": "https://github.com/IntrepidPursuits/swift-wisdom.git",
        "tag": "0.7.10"
    },
    "platforms": {
        "ios": "8.0"
    },
    "pod_target_xcconfig": {
        "SWIFT_VERSION": "3.0"
    },
    "default_subspecs": "Core",
    "pushed_with_swift_version": "3.0",
    "subspecs": [
        {
            "name": "Core",
            "frameworks": "XCTest",
            "source_files": "SwiftWisdomTests/Testing/**/*.swift"
        }
    ]
}

Pin It on Pinterest

Share This