README.md

GoogleCloudDatastoreAPI

Getting Started

If you only need to use the Google Cloud Datastore API, then this guide will help you get started.

In your Package.swift file, make sure you have the following dependencies and targets

dependencies: [
        //...
        .package(url: "https://github.com/vapor-community/google-cloud.git", from: "1.0.0-rc"),
    ],
    targets: [
        .target(name: "MyAppName", dependencies: [
            //...
            .product(name: "CloudDatastore", package: "google-cloud"),
        ]),
    ]

Now you can setup the configuration for any GCP API globally via Application.

In configure.swift

 import CloudDatastore
 
 app.googleCloud.credentials = try GoogleCloudCredentialsConfiguration(projectId: "myprojectid-12345",
 credentialsFile: "~/path/to/service-account.json")

Next we setup the CloudDatastore API configuration (specific to this API).

app.googleCloud.datastore.configuration = .default()

Now we can start using the GoogleCloudDatastore API There's a handy extension on Request that you can use to get access to a cloud datastore client via a property named gcDatastore.

struct LookupRequest: Content {
    var name: String
}

func lookupEntities(_ req: Request) throws {
    let name = try req.content.decode(LookupRequest.self)

    let pathElement = PathElement(.name(name.name), kind: "MyEntity")
    let partitionId = PartitionId(projectId: "my-project")
    let key = Key(partitionId: partitionId, path: [pathElement])

    req.gcDatastore.project.lookup(keys: [key]).map { response in
        print(response.found.count) // prints 1 if entity exists
    }
}