locationlabs/boa

Sample Cobra, Gorgon and Moccasin application written in Swift

Boa

Boa is a sample weather application using Cobra, Gorgon and Moccasin, written in Swift.

Bootstrapping

Cobra works by bootstrapping component frameworks, property files, and application modules on application launch, like so:

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    logDebug("Application starting...")
    
    //
    // STEP 1
    // Enabling debug logging for frameworks. You shouldn't enable logging in production
    //
    Gorgon.Log.enableDebugging = true
    Cobra.Log.enableDebugging = true
    
    //
    // STEP 2
    // Create a Cobra configuration for assembling the components and properties for the application
    //
    let config = Config(components: [
        Component<DaemonAssembly>(),
        Component<ServiceAssembly>()
    ], properties: [
        JsonProperty(name: "properties")
    ])
    
    //
    // STEP 3
    // Provide the configuration to the Cobra application
    //
    try! App.sharedInstance.config(config)

    //
    // STEP 4
    // Register Feature to Module proxies for the Cobra application routes
    //
    App.sharedInstance.registerProxies([
        Proxy<AddCityFeatureType>(modules: Module<AddCityAssembly>()),
        Proxy<WeatherFeatureType>(modules: Module<WeatherAssembly>()),
        Proxy<WeatherDetailFeatureType>(modules: Module<WeatherDetailAssembly>())
    ])
    
    //
    // STEP 5
    // Route to our first feature in our application window
    //
    try! App.sharedInstance.feature(WeatherFeatureType.self).showInWindow(window!)
    return true
}

VIPER Modules

The Weather application code consists of three VIPER-based modules: WeatherDetail, AddCity, and Weather. These correlate to respective screens the user sees in the application (Weather being the main screen). Using Moccasin, VIPER scaffolding for each of these modules were generated via Xcode templates.

TODO

• Connect to web service to get real-time weather information.
• Add persistence
• Finish add city feature

boa's Issues

Error in example app

In Boa/Modules/WeatherDetail/WeatherPageViewController.swift,
there's an error in the code snippet on line number 109:

extension WeatherPageViewController {
    fileprivate func initViewControllers() {
        let weatherDetailStoryboard = UIStoryboard(name: "WeatherDetail", bundle: nil)
        
        orderedWeatherDetailViewControllers = weatherReports.map {
            let weatherDetailVC = weatherDetailStoryboard.instantiateViewController(withIdentifier: "WeatherDetail") as! WeatherDetailViewController
            weatherDetailVC.weatherReport = $0
            weatherDetailVC.styler = styler
            return weatherDetailVC
        }
    }
}

There should be used ? or ! in order to apply correct method, which returns [T] instead of just returning optional type U? for example. I think it is a result of compiler changes explained here:
https://swift.org/blog/iuo/