Skip to content

Type-safe URL routing for Swift

License

Notifications You must be signed in to change notification settings

Whatnot-Inc/RouteKit

 
 

Repository files navigation

RouteKit

Carthage compatible CocoaPods Swift Package Manager

Type-safe URL routing for Swift.

// Define routes
struct UserIndex: Route {
    let path = "/users"

    func map(to url: URL, parameters: [String: String], queries: [String: String]) -> UIViewController {
        return UserIndexViewController()
    }
}

struct UserDetail: Route {
    let path = "/users/{id}"

    struct Parameters: Decodable {
        let id: Int
    }

    func map(to url: URL, parameters: Parameters, queries: [String: String]) -> UIViewController {
        return UserDetailViewController(id: parameters.id)
    }
}

// Use `Navigator` (for iOS)
Navigator.append(route: UserIndex())
Navigator.append(route: UserDetail())

Navigator.push(url: URL(string: "/users/42")!, animated: true)
Navigator.present(url: URL(string: "/users/42")!, animated: true)

// Use `Router`
let router = Router<UIViewController>()
router.append(route: UserIndex())
router.append(route: UserDetail())

router.push(url: URL(string: "/users/42")!) // Return `UserDetailViewController`

Greatly inspired by ishkawa/APIKit, devxoul/URLNavigator.

Installation

Carthage

github "woxtu/RouteKit" ~> 0.3

CocoaPods

pod 'RouteKit', '~> 0.3'

Swift Package Manager

.package(url: "https://github.com/woxtu/RouteKit.git", from: "0.3.0")

License

Licensed under the MIT license.

About

Type-safe URL routing for Swift

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Swift 95.9%
  • Ruby 2.9%
  • Objective-C 1.2%