Require 2.0.0

Require 2.0.0

LangLanguage SwiftSwift
License MIT
ReleasedLast Release Oct 2017
SwiftSwift Version 4.0
SPMSupports SPM

Maintained by John Sundell.

Require 2.0.0


Require lets you easily require Optional values to be non-nil, or crash gracefully.

Sometimes you have optional values in your code that are not really optional, and will cause your
application to enter an undefined state if nil. Require makes it easy to avoid such states, by
causing a crash with rich debug information, to enable you to much easier hunt down & fix the bug.


Call require() on any Optional, optionally giving a hint for debugging purposes:

class ConfigurationLoader {
    func load() -> Configuration {
        let data = readJSONFile().require(hint: "Verify that Config.JSON is valid")
        let config: Configuration? = try? unbox(data: data)
        return config.require()


Swift Package Manager:

Add .Package(url: "[email protected]:johnsundell/require.git", majorVersion: 1) to your Package.swift file.


Add pod "Require" to your Podfile.


Add github "johnsundell/require" to your Cartfile.


Clone the repo and drag the file Require.swift into your Xcode project.

Help, feedback or suggestions?

  • Open an issue if you need help, if you found a bug, or if you want to discuss a feature request.
  • Open a PR if you want to make some change to Require.
  • Contact @johnsundell on Twitter for discussions, news & announcements about Require.