$ gem install cocoapods

target '
   
    '
    do
    use_frameworks!
    
    pod 'CoreNavigation', '1.0.0-beta-4'
end

$ pod install

$ brew update
$ brew install carthage

github "aronbalog/CoreNavigation" == "1.0.0-beta-4"

class PersonProfileViewController: UIViewController, DataReceivable {

    // DataReceivable associatedtype
    typealias DataType = Person

    func didReceiveData(_ data: Person) {
        // configure UI with data
    }
}

Navigate.present { $0
    .to(PersonProfileViewController())
    .withData(person)
}

Navigate.push { $0
    .to(PersonProfileViewController())
    .withData(person)
}

) { guard let personId = context.parameters?["personId"] as? String else { // cancel navigation with some error context.cancel(error: NavigationError.Destination.notFound) return } // fetch person fetchPerson(id: personId, completion: { (person: Person) in // continue to navigation context.complete(data: person) }, failure: { (error: Error) in // cancel navigation with some error context.cancel(error: error) }) } } ">

struct PersonProfile: Destination, Routable {

    // Destination associatedtype
    typealias ViewControllerType = PersonProfileViewController

    // Routable patterns
    static var patterns: [String] = [
        "https://myapp.com/person/:personId(.*)",
        "https://myapp.com/user/:personId(.*)"
    ]
    
    let personId: String
    
    init(_ personId: String) {
        self.personId = personId
    }
    
    var parameters: [String : Any]? {
        return [
            "personId": personId
        ]
    }

    static func resolve(context: Context
   ) {
        
   guard 
   let personId 
   = context.
   parameters
   ?[
   "personId"] 
   as? 
   String 
   else {
            
   // cancel navigation with some error

               context.
   cancel(
   error: NavigationError.
   Destination.
   notFound)
            
   return
        }
        
        
   // fetch person

           
   fetchPerson(
   id: personId, 
   completion: { (
   person: Person) 
   in
            
   // continue to navigation

               context.
   complete(
   data: person)
        }, 
   failure: { (
   error: 
   Error) 
   in
            
   // cancel navigation with some error

               context.
   cancel(
   error: error)
        })
    }
}
  

PersonProfile.register()

Navigate.router.register(routableType: PersonProfile.self)

Navigate.router.register(destinationType: PersonProfile.self, patterns: [
    "https://myapp.com/person/:personId(.*)",
    "https://myapp.com/user/:personId(.*)"
])

PersonProfile.self <- [
    "https://myapp.com/person/:personId(.*)",
    "https://myapp.com/user/:personId(.*)"
]

Settings.self <- [
    "https://myapp.com/settings"
]

// present
Navigate.present { $0
    .to(PersonProfile("sherlock_holmes"))
    ...
}

// or push
Navigate.push { $0
    .to(PersonProfile("sherlock_holmes"))
    ...
}

// present
PersonProfile("sherlock_holmes").present { $0
    ...
}

// or push
PersonProfile("sherlock_holmes").push { $0
    ...
}

// present
PersonProfile("sherlock_holmes").present()

// or push
PersonProfile("sherlock_holmes").push()

// present
Navigate.present { $0
    .to("https://myapp.com/person/sherlock_holmes")
    ...
}

// or push
Navigate.push { $0
    .to("https://myapp.com/person/sherlock_holmes")
    ...
}

// present
"https://myapp.com/person/sherlock_holmes".present { $0
    ...
}

// or push
"https://myapp.com/person/sherlock_holmes".push { $0
    ...
}

// present
"https://myapp.com/person/sherlock_holmes".present()

// or push
"https://myapp.com/person/sherlock_holmes".push()

PersonProfile("sherlock_holmes").viewController { (viewController) in
    // vc is `PersonProfileViewController`
}

"https://myapp.com/person/sherlock_holmes".viewController { (viewController) in
    ...
}

do {
    let viewController = try PersonProfile("sherlock_holmes").viewController()
} catch let error {
    // handle error
}

do {
    let viewController = try "https://myapp.com/person/sherlock_holmes".viewController()
} catch let error {
    // handle error
}

struct Person {
    let id: String
    ...
}

extension Person: Matchable {
    var uri: String {
        return "https://myapp.com/person/" + id
    }
}

let person: Person = Person(id: "sherlock_holmes", ...)

// getting view controller
let personProfileViewController = try! person.viewController

// or navigating
person.present()
person.push()

// or more configurable syntax
Navigate.present { $0
    .to(person)
    ...
}