feat: Support connecting to multiple Parse Servers (#12)

* update dependencies

* add support for multiple servers

* Remove leaf dependency

* Update README.md

* add new methods

* Update ci.yml

* Update ci.yml

* increase codecov

* add more tests

Author: cbaker6

Package.resolved

@@ -11,17 +11,17 @@ let package = Package(
     ],
     dependencies: [
         // 💧 A server-side Swift web framework.
-        .package(url: "https://github.com/vapor/vapor.git", .upToNextMajor(from: "4.68.0")),
+        .package(url: "https://github.com/vapor/vapor.git", .upToNextMajor(from: "4.69.1")),
         .package(url: "https://github.com/vapor/leaf.git", .upToNextMajor(from: "4.2.4")),
         .package(url: "https://github.com/netreconlab/Parse-Swift.git",
-                 .upToNextMajor(from: "4.16.2")),
+                 .upToNextMajor(from: "5.0.0-beta.3")),
     ],
     targets: [
         .target(
             name: "ParseServerSwift",
             dependencies: [
-                .product(name: "Leaf", package: "leaf"),
                 .product(name: "Vapor", package: "vapor"),
+                .product(name: "Leaf", package: "leaf"),
                 .product(name: "ParseSwift", package: "Parse-Swift")
             ],
             swiftSettings: [

Package.swift

@@ -1,10 +1,14 @@
 # ParseServerSwift
 
+[![Documentation](http://img.shields.io/badge/read_the-docs-2196f3.svg)](https://swiftpackageindex.com/netreconlab/parse-server-swift/documentation)
+[![Tuturiol](http://img.shields.io/badge/read_the-tuturials-2196f3.svg)](https://netreconlab.github.io/parse-server-swift/release/tutorials/parseserverswift/)
 [![Build Status CI](https://github.com/netreconlab/parse-server-swift/workflows/ci/badge.svg?branch=main)](https://github.com/netreconlab/parse-server-swift/actions?query=workflow%3Aci+branch%3Amain)
 [![codecov](https://codecov.io/gh/netreconlab/parse-server-swift/branch/main/graph/badge.svg?token=RC3FLU6BGW)](https://codecov.io/gh/netreconlab/parse-server-swift)
 [![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fnetreconlab%2Fparse-server-swift%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/netreconlab/parse-server-swift)
 [![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fnetreconlab%2Fparse-server-swift%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/netreconlab/parse-server-swift)
 
+---
+
 Write Parse Cloud Code in Swift!
 
 What is Cloud Code? For complex apps, sometimes you just need logic that isn’t running on a mobile device. Cloud Code makes this possible.
@@ -33,7 +37,7 @@ Configure the SDK as described in the [documentation](https://netreconlab.github
 
 ```swift
 // Required: Change to your Parse Server serverURL.
-guard let parseServerUrl = URL(string: "http://localhost:1337/1") else {
+guard let parseServerURL = URL(string: "http://localhost:1337/1") else {
     throw ParseError(code: .unknownError,
                      message: "Could not make Parse Server URL")
 }
@@ -42,7 +46,7 @@ guard let parseServerUrl = URL(string: "http://localhost:1337/1") else {
 ParseSwift.initialize(applicationId: "applicationId", // Required: Change to your applicationId.
                       clientKey: "clientKey", // Required: Change to your clientKey.
                       primaryKey: "primaryKey", // Required: Change to your primaryKey.
-                      serverURL: parseServerUrl,
+                      serverURL: parseServerURL,
                       usingPostForQuery: true) { _, completionHandler in
     completionHandler(.performDefaultHandling, nil)
 }

README.md

@@ -30,7 +30,7 @@
                 Configure the SDK as described in the [documentation](https://parseplatform.org/Parse-Swift/release/documentation/parseswift/).
                 ```swift
                 // Required: Change to your Parse Server serverURL.
-                guard let parseServerUrl = URL(string: "http://localhost:1337/1") else {
+                guard let parseServerURL = URL(string: "http://localhost:1337/1") else {
                     throw ParseError(code: .unknownError,
                                      message: "Could not make Parse Server URL")
                 }
@@ -39,7 +39,7 @@
                 ParseSwift.initialize(applicationId: "applicationId", // Required: Change to your applicationId.
                                       clientKey: "clientKey", // Required: Change to your clientKey.
                                       primaryKey: "primaryKey", // Required: Change to your primaryKey.
-                                      serverURL: parseServerUrl,
+                                      serverURL: parseServerURL,
                                       usingPostForQuery: true) { _, completionHandler in
                     completionHandler(.performDefaultHandling, nil)
                 }

Sources/ParseServerSwift/Documentation.docc/Configuring Parse Server Swift.tutorial

@@ -11,3 +11,22 @@ import ParseSwift
 extension ParseHookFunctionRequest: Content {}
 extension ParseHookTriggerRequest: Content {}
 extension ParseHookResponse: Content {}
+extension ParseHookRequestable {
+    /**
+     Produce the set of options that should be used for subsequent `ParseHook` requests.
+     - parameter request: The HTTP request of the application.
+     - parameter parseServerURLStrings: A set of Parse Server `URL`'s
+     to check the `URI` against. Defaults to the set of servers added during configuration.
+     - returns: The set of options produced by the current request.
+     - throws: An error of `ParseError` type.
+     - note: This options method should be used in a multi Parse Server environment.
+     In a single Parse Server environment, use options().
+     */
+    public func options(_ request: Request,
+                        parseServerURLStrings: [String] = parseServerURLStrings) throws -> API.Options {
+        var options = self.options()
+        options.insert(.serverURL(try serverURLString(request.url,
+                                                      parseServerURLStrings: parseServerURLStrings)))
+        return options
+    }
+}