Initial commit of version 1.0.

Author: markrenaud

LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Mark Renaud
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Package.swift

@@ -5,6 +5,10 @@ import PackageDescription
 
 let package = Package(
     name: "FilePicker",
+    platforms: [
+        .macOS(.v10_15),
+        .iOS(.v14)
+    ],
     products: [
         // Products define the executables and libraries a package produces, and make them visible to other packages.
         .library(

README.md

@@ -1,3 +1,52 @@
 # FilePicker
+> A cross platform file picker for SwiftUI.
 
-A description of this package.
+[![License][license-image]][license-url]
+
+The `FilePicker` package implements a SwiftUI view that can be used in **both** iOS and macOS.
+The `FilePicker`  provides a `Button` that presents a platform-native file picker that is a modern way for use in SwiftUI.
+
+## Installation
+
+Add the `FilePicker` package to your Xcode project using the package manager.
+Import `FilePicker` to your file.
+
+If you are using the package with macOS, ensure that you grant appropriate `File Access` permissions for `User Selected File` under `Signing & Capabilities`  (on the macOS target)
+
+## Example Usage
+
+```swift
+import SwiftUI
+import FilePicker
+
+struct DebugView: View {
+    
+    var body: some View {
+        HStack {
+            //  
+        
+            // Use custom content for the button label
+            FilePicker(types: [.plainText], allowMultiple: true) { urls in
+                print("selected \(urls.count) files")
+            } label: {
+                HStack {
+                    Image(systemName: "doc.on.doc")
+                    Text("Pick Files")
+                }
+            }
+            
+            FilePicker(types: [.plainText], allowMultiple: false, title: "pick single file") { urls in
+                print("selected \(urls.count) files")
+            }
+            
+        }
+    }
+    
+}
+```
+
+## Licence
+Distributed under the MIT license. See ``LICENSE`` for more information.
+
+[license-image]: https://img.shields.io/badge/License-MIT-blue.svg
+[license-url]: LICENSE

Sources/FilePicker/FilePicker.swift

@@ -1,3 +1,84 @@
-struct FilePicker {
-    var text = "Hello, World!"
+//  FilePicker.swift
+//  FilePicker Package
+//
+//  Created by Mark Renaud on 20/4/21.
+//
+//  Licence: MIT
+
+import SwiftUI
+import UniformTypeIdentifiers
+
+public struct FilePicker<LabelView: View>: View {
+    
+    public typealias PickedURLsCompletionHandler = (_ urls: [URL]) -> Void
+    public typealias LabelViewContent = () -> LabelView
+    
+    @State private var isPresented: Bool = false
+    
+    public let types: [UTType]
+    public let allowMultiple: Bool
+    public let pickedCompletionHandler: PickedURLsCompletionHandler
+    public let labelViewContent: LabelViewContent
+    
+    public init(types: [UTType], allowMultiple: Bool, onPicked completionHandler: @escaping PickedURLsCompletionHandler, @ViewBuilder label labelViewContent: @escaping LabelViewContent) {
+        self.types = types
+        self.allowMultiple = allowMultiple
+        self.pickedCompletionHandler = completionHandler
+        self.labelViewContent = labelViewContent
+    }
+
+    public init(types: [UTType], allowMultiple: Bool, title: String, onPicked completionHandler: @escaping PickedURLsCompletionHandler) where LabelView == Text {
+        self.init(types: types, allowMultiple: allowMultiple, onPicked: completionHandler) { Text(title) }
+    }
+    
+    #if os(iOS)
+    
+    public var body: some View {
+        Button(
+            action: {
+                if !isPresented { isPresented = true }
+            },
+            label: {
+                labelViewContent()
+            }
+        )
+        .disabled(isPresented)
+        .sheet(isPresented: $isPresented) {
+            FilePickerUIRepresentable(types: types, allowMultiple: allowMultiple, onPicked: pickedCompletionHandler)
+        }
+    }
+    
+    #endif
+    
+    #if os(macOS)
+    public var body: some View {
+        Button(
+            action: {
+                if !isPresented { isPresented = true }
+            },
+            label: {
+                labelViewContent()
+            }
+        )
+        .disabled(isPresented)
+        .onChange(of: isPresented, perform: { presented in
+            // binding changed from false to true
+            if presented == true {
+                let panel = NSOpenPanel()
+                panel.allowsMultipleSelection = allowMultiple
+                panel.canChooseDirectories = false
+                panel.canChooseFiles = true
+                panel.allowedFileTypes = types.map { $0.identifier }
+                panel.begin { reponse in
+                    if reponse == .OK {
+                        pickedCompletionHandler(panel.urls)
+                    }
+                    // reset the isPresented variable to false
+                    isPresented = false
+               }
+            }
+        })
+    }
+    #endif
+    
 }

Sources/FilePicker/FilePickerUIRepresentable.swift

@@ -0,0 +1,56 @@
+//  FilePicker Package
+//
+//  Created by Mark Renaud on 20/4/21.
+//
+//  Licence: MIT
+
+
+import SwiftUI
+import UniformTypeIdentifiers
+
+#if os(iOS)
+
+public struct FilePickerUIRepresentable: UIViewControllerRepresentable {
+    public typealias UIViewControllerType = UIDocumentPickerViewController
+    public typealias PickedURLsCompletionHandler = (_ urls: [URL]) -> Void
+    
+    @Environment(\.presentationMode) var presentationMode
+    
+    public let types: [UTType]
+    public let allowMultiple: Bool
+    public let pickedCompletionHandler: PickedURLsCompletionHandler
+    
+    public init(types: [UTType], allowMultiple: Bool, onPicked completionHandler: @escaping PickedURLsCompletionHandler) {
+        self.types = types
+        self.allowMultiple = allowMultiple
+        self.pickedCompletionHandler = completionHandler
+    }
+    
+    public func makeCoordinator() -> Coordinator {
+        Coordinator(parent: self)
+    }
+    
+    public func makeUIViewController(context: Context) -> UIDocumentPickerViewController {
+        let picker = UIDocumentPickerViewController(forOpeningContentTypes: types, asCopy: true)
+        picker.delegate = context.coordinator
+        picker.allowsMultipleSelection = allowMultiple
+        return picker
+    }
+    
+    public func updateUIViewController(_ controller: UIDocumentPickerViewController, context: Context) {}
+    
+    public class Coordinator: NSObject, UIDocumentPickerDelegate {
+        var parent: FilePickerUIRepresentable
+        
+        init(parent: FilePickerUIRepresentable) {
+            self.parent = parent
+        }
+        
+        public func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
+            parent.pickedCompletionHandler(urls)
+            parent.presentationMode.wrappedValue.dismiss()
+        }
+    }
+}
+
+#endif