Add url opener and view extension

Author: danielsaidi

Readmes/Navigation.md

@@ -0,0 +1,12 @@
+# Navigation
+
+`SwiftUIKit` contains in-app `Navigation` utilities.
+
+
+## UrlOpener
+
+The `UrlOpener` can be implemeneted by anything that should be able to open a url.
+
+The protocol provides a `canOpen` and a `tryOpen` function, as well as many convenience variants.
+
+The default implementation opens a url with the shared application. You can override this in any way you want.

Release Notes.md

@@ -3,7 +3,11 @@
 
 ## 0.9.4
 
-This version adds new extensions, e.g. for taking a screenshot of any `SwiftUI` view.
+This version adds a `UrlOpener`, as well as new extensions:
+
+* `EdgeInsets+Edge` simplifies getting the inset for a certain edge.
+* `View+Screenshot` can be used to snapshot any SwiftUI view.
+* `View+Visible` has conditional extensions to hide or show a view.
 
 
 ## 0.9.3

Sources/SwiftUIKit/Extensions/EdgeInsets+Edge.swift

@@ -10,16 +10,16 @@ import CoreGraphics
 import SwiftUI
 
 public extension EdgeInsets {
-
+    
     /**
      Get the inset for a certain edge.
      */
     func inset(for edge: Edge) -> CGFloat {
         switch edge {
-            case.top: return top
-            case.bottom: return bottom
-            case.leading: return leading
-            case.trailing: return trailing
+        case.top: return top
+        case.bottom: return bottom
+        case.leading: return leading
+        case.trailing: return trailing
         }
     }
 }

Sources/SwiftUIKit/Extensions/View+Visible.swift

@@ -0,0 +1,31 @@
+//
+//  View+Visible.swift
+//  SwiftUIKit
+//
+//  Created by Daniel Saidi on 2020-10-05.
+//  Copyright © 2020 Daniel Saidi. All rights reserved.
+//
+
+import SwiftUI
+
+public extension View {
+    
+    /**
+     Hides the view if the provided `condition` is `true`.
+     */
+    @ViewBuilder
+    func hidden(if condition: Bool) -> some View {
+        if condition {
+            self.hidden()
+        } else {
+            self
+        }
+    }
+    
+    /**
+     Shows the view if the provided `condition` is `true`.
+     */
+    func visible(if condition: Bool) -> some View {
+        hidden(if: !condition)
+    }
+}

Sources/SwiftUIKit/Navigation/UrlOpener.swift

@@ -0,0 +1,79 @@
+//
+//  UrlOpener.swift
+//  SwiftUIKit
+//
+//  Created by Daniel Saidi on 2020-10-05.
+//  Copyright © 2020 Daniel Saidi. All rights reserved.
+//
+
+import SwiftUI
+
+/**
+ This protocol can be implemented by anything that should be
+ able to open a URL.
+ 
+ The default implementation uses the shared application when
+ you call it in `iOS`. It currently has no implementation on
+ the other platforms.
+ */
+public protocol UrlOpener {
+    
+    typealias OpenUrlCompletion = (Bool) -> Void
+    
+    func canOpen(_ url: URL) -> Bool
+    func tryOpen(_ url: URL, completion: OpenUrlCompletion)
+}
+
+
+// MARK: - Default Implementations
+
+public extension UrlOpener {
+    
+    func canOpen(_ url: URL) -> Bool {
+        #if os(iOS)
+        return app.canOpenURL(url)
+        #else
+        assertionFailure("Not yet implemented")
+        #endif
+    }
+    
+    func tryOpen(_ url: URL, completion: OpenUrlCompletion) {
+        #if os(iOS)
+        app.open(url, options: [:], completionHandler: nil)
+        #else
+        assertionFailure("Not yet implemented")
+        #endif
+    }
+}
+
+
+// MARK: - Convenience Functions
+
+public extension UrlOpener {
+    
+    #if os(iOS)
+    var app: UIApplication { .shared }
+    #endif
+    
+    func canOpen(_ url: URL?) -> Bool {
+        guard let url = url else { return false }
+        return canOpen(url)
+    }
+    
+    func canOpen(urlString: String) -> Bool {
+        canOpen(URL(string: urlString))
+    }
+    
+    func tryOpen(_ url: URL) {
+        tryOpen(url) { _ in }
+    }
+    
+    func tryOpen(_ url: URL?, completion: OpenUrlCompletion = { _ in }) {
+        guard let url = url else { return completion(false) }
+        tryOpen(url, completion: completion)
+    }
+    
+    func tryOpen(urlString: String, completion: OpenUrlCompletion = { _ in }) {
+        tryOpen(URL(string: urlString), completion: completion)
+    }
+}