🎯 URLPatterns 🎯
URLPatterns is a small library to enable more idiomatic Swift pattern matching of URL path elements.
URL is extended with the method countedPathElements(), which converts the URL's' array of path elements into a Counted enum. Each case in Counted has a different number of associated values, which makes pattern-matching each element easy:
if case .n4("user", let userId, "profile", _) = url.countedPathElements() {
// show profile for userId
}Counted enables us to pattern match paths with any number of elements, and supports expression, wildcard and value-binding patterns for its associated values. It can match based on Begins and Ends, which match based on the first/ last elements only, and can even match a particular path element based on a regular expression. Here's an example of a DeepLink enum which has a failable initializer that takes a URL:
enum DeepLink {
case home, history, settings, terms, news, contact
case chat(room: String)
case profile(userId: String)
}
extension DeepLink {
init?(url: URL) {
guard url.scheme == "myscheme" else { return nil }
guard url.host == "myhost" else { return nil }
switch url.countedPathComponents() {
case .n0, .n1(""): self = .home
case .n1("history"): self = .history
case .n2(_, "settings"): self = .settings
case .n2("chat", let room): self = .chat(room: room)
case .n3("users", let userId, "profile"): self = .profile(userId: userId)
case .n1(Regex(contact.*)) self = .contact
case Begins("news", "latest"): self = .news
case Ends("terms"): self = .terms
default: return nil
}
}
}Installation
URLPatterns is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod "URLPatterns"License
URLPatterns is available under the MIT license. See the LICENSE file for more info.