Add FileIO.write

Sources/Vapor/Utilities/FileIO.swift

@@ -186,4 +186,23 @@ public struct FileIO {
             return self.request.eventLoop.makeFailedFuture(error)
         }
     }
+
+    /// Write the contents of buffer to a file at the supplied path.
+    ///
+    /// - parameters:
+    ///     - path: Path to file on the disk.
+    ///     - buffer: The `ByteBuffer` to write.
+    /// - returns: `Future` that will complete when the file write is finished.
+    public func write(to path: String, buffer: ByteBuffer) -> EventLoopFuture<Void> {
+        do {
+            let fd = try NIOFileHandle.init(path: path, mode: .write, flags: .allowFileCreation())
+            let done = io.write(fileHandle: fd, buffer: buffer, eventLoop: self.request.eventLoop)
+            done.whenComplete { _ in
+                try? fd.close()
+            }
+            return done
+        } catch {
+            return self.request.eventLoop.makeFailedFuture(error)
+        }
+    }
 }

Tests/VaporTests/FileTests.swift

@@ -32,6 +32,25 @@ final class FileTests: XCTestCase {
             XCTAssertContains(res.body.string, test)
         }
     }
+
+    func testFileWrite() throws {
+        let app = Application(.testing)
+        defer { app.shutdown() }
+
+        let request = Request(application: app, on: app.eventLoopGroup.next())
+
+        let data = "Hello".data(using: .utf8)!
+        let path = "/tmp/fileio_write.txt"
+
+        try request.fileio.write(to: path, buffer: ByteBuffer(data: data)).wait()
+        defer { try? FileManager.default.removeItem(atPath: path) }
+
+        let content = try request.fileio.collectFile(at: path).wait()
+
+        let result = Data(content.readableBytesView)
+
+        XCTAssertEqual(result, data)
+    }
 
     func testPercentDecodedFilePath() throws {
         let app = Application(.testing)