Merge pull request #30 from vapor-community/translate

Added support for Cloud translate.

Author: Andrewangeta

Package.swift

@@ -20,6 +20,9 @@ let package = Package(
         .library(
             name: "CloudSecretManager",
             targets: ["CloudSecretManager"]),
+        .library(
+            name: "CloudTranslation",
+            targets: ["CloudTranslation"]),
     ],
     dependencies: [
         .package(url: "https://github.com/vapor/vapor.git", from: "4.0.0"),
@@ -54,5 +57,12 @@ let package = Package(
                 .product(name: "GoogleCloudSecretManager", package: "google-cloud-kit"),
                 .target(name: "GoogleCloud")
         ]),
+        .target(
+            name: "CloudTranslation",
+            dependencies: [
+                .product(name: "Vapor", package: "vapor"),
+                .product(name: "GoogleCloudTranslation", package: "google-cloud-kit"),
+                .target(name: "GoogleCloud")
+        ]),
     ]
 )

README.md

@@ -24,5 +24,7 @@ You can check each supported API's README for a getting started guide.
 
 [x] [CloudSecretManager](/Sources/CloudSecretManager/README.md)
 
+[x] [CloudTranslation](/Sources/CloudTranslation/README.md)
+
 ### A More detailed guide can be found [here](https://github.com/vapor-community/google-cloud-kit).
 

Sources/CloudTranslation/GoogleCloudTranslationAPI.swift

@@ -0,0 +1,114 @@
+//
+//  GoogleCloudTranslationAPI.swift
+//  
+//
+//  Created by Andrew Edwards on 5/4/21.
+//
+
+import Vapor
+@_exported import Translation
+@_exported import GoogleCloud
+
+extension Application.GoogleCloudPlatform {
+    
+    private struct CloudTranslationAPIKey: StorageKey {
+        typealias Value = GoogleCloudTranslationAPI
+    }
+    
+    private struct CloudSecretManagerConfigurationKey: StorageKey {
+        typealias Value = GoogleCloudTranslationConfiguration
+    }
+    
+    private struct CloudTranslationHTTPClientKey: StorageKey, LockKey {
+        typealias Value = HTTPClient
+    }
+    
+    public var translation: GoogleCloudTranslationAPI {
+        get {
+            if let existing = self.application.storage[CloudTranslationAPIKey.self] {
+                return existing
+            } else {
+                return .init(application: self.application, eventLoop: self.application.eventLoopGroup.next())
+            }
+        }
+        
+        nonmutating set {
+            self.application.storage[CloudTranslationAPIKey.self] = newValue
+        }
+    }
+    
+    public struct GoogleCloudTranslationAPI {
+        public let application: Application
+        public let eventLoop: EventLoop
+        
+        /// A client used to interact with the `GoogleCloudTranslation` API.
+        public var client: GoogleCloudTranslationClient {
+            do {
+                let new = try GoogleCloudTranslationClient(credentials: self.application.googleCloud.credentials,
+                                                           config: self.configuration,
+                                                           httpClient: self.http,
+                                                           eventLoop: self.eventLoop)
+                return new
+            } catch {
+                fatalError("\(error.localizedDescription)")
+            }
+        }
+        
+        /// The configuration for using `GoogleCloudTranslation` APIs.
+        public var configuration: GoogleCloudTranslationConfiguration {
+            get {
+                if let configuration = application.storage[CloudSecretManagerConfigurationKey.self] {
+                   return configuration
+                } else {
+                    fatalError("Cloud Translation configuration has not been set. Use app.googleCloud.translation.configuration = ...")
+                }
+            }
+            set {
+                if application.storage[CloudSecretManagerConfigurationKey.self] == nil {
+                    application.storage[CloudSecretManagerConfigurationKey.self] = newValue
+                } else {
+                    fatalError("Attempting to override credentials configuration after being set is not allowed.")
+                }
+            }
+        }
+        
+        /// Custom `HTTPClient` that ignores unclean SSL shutdown.
+        public var http: HTTPClient {
+            if let existing = application.storage[CloudTranslationHTTPClientKey.self] {
+                return existing
+            } else {
+                let lock = application.locks.lock(for: CloudTranslationHTTPClientKey.self)
+                lock.lock()
+                defer { lock.unlock() }
+                if let existing = application.storage[CloudTranslationHTTPClientKey.self] {
+                    return existing
+                }
+                let new = HTTPClient(
+                    eventLoopGroupProvider: .shared(application.eventLoopGroup),
+                    configuration: HTTPClient.Configuration(ignoreUncleanSSLShutdown: true)
+                )
+                application.storage.set(CloudTranslationHTTPClientKey.self, to: new) {
+                    try $0.syncShutdown()
+                }
+                return new
+            }
+        }
+    }
+}
+
+extension Request {
+    private struct GoogleCloudTranslationKey: StorageKey {
+        typealias Value = GoogleCloudTranslationClient
+    }
+    
+    /// A client used to interact with the `GoogleCloudTranslation` API
+    public var gcTranslation: GoogleCloudTranslationClient {
+        if let existing = application.storage[GoogleCloudTranslationKey.self] {
+            return existing.hopped(to: self.eventLoop)
+        } else {
+            let new = Application.GoogleCloudPlatform.GoogleCloudTranslationAPI(application: self.application, eventLoop: self.eventLoop).client
+            application.storage[GoogleCloudTranslationKey.self] = new
+            return new
+        }
+    }
+}

Sources/CloudTranslation/README.md

@@ -0,0 +1,45 @@
+# GoogleCloudTranslationAPI
+
+## Getting Started
+If you only need to use the [Google Cloud Translation API](https://cloud.google.com/translate), then this guide will help you get started.
+
+In your `Package.swift` file, make sure you have the following dependencies and targets
+
+```swift
+dependencies: [
+        //...
+        .package(url: "https://github.com/vapor-community/google-cloud.git", from: "1.0.0"),
+    ],
+    targets: [
+        .target(name: "MyAppName", dependencies: [
+            //...
+            .product(name: "CloudTranslation", package: "google-cloud"),
+        ]),
+    ]
+```
+
+Now you can setup the configuration for any GCP API globally via `Application`.
+
+In `configure.swift`
+
+```swift
+ import CloudTranslation
+ 
+ app.googleCloud.credentials = try GoogleCloudCredentialsConfiguration(projectId: "myprojectid-12345",
+ credentialsFile: "~/path/to/service-account.json")
+```
+Next we setup the CloudTranslation API configuration (specific to this API).
+
+```swift
+app.googleCloud.translation.configuration = .default()
+```
+
+Now we can start using the GoogleCloudTranslation API
+There's a handy extension on `Request` that you can use to get access to a translation client via a property named `gcTranslation`. 
+
+```swift
+func translateText(_ req: Request) throws -> EventLoopFuture<String> {    
+    req.gcTranslation.translate(text: "Hello World", source: "en", target: "es")
+    .map { $0.data.translations.first!.translatedText! // returns the spanish translation }
+}
+```