support local datastore

[stephenplusplus]

Fixes #389

While running the gcd server, this now works:

// gcd is running on localhost:8080

var gcloud = require("gcloud")

var ds = gcloud.datastore.dataset({
  apiEndpoint: "localhost:8080",
  projectId: "nth-circlet-705"
})

var company = ds.key("company")

ds.save({
  key: company,
  data: { name: "google" }
}, function (err) {
  if (err) throw err

  ds.get(company, console.log)
})

I'm not sure host and port are technically correct argument names, since for this PR, "host" needs to be in the format of protocol + host ("http://localhost"). Ideas I can think of:

• Ditch host and port in favor of one argument name to include protocol + host + port (but not a path):
  • uri
  • resource
  • api
  • apiPrefix
• Accept protocol, host, and port
• Not worry about it

Interested in your thoughts!

[ryanseys]

Re: protocol, host and port why not just accept a customEndpoint value that can be set to something like "http://localhost:8080" and our default will be "https://www.googleapis.com" where the port of 443 is implied. Right now if they just specify a host, the default port is assumed 443 which won't work for them if they are on http.

[ryanseys]

Looks good to me otherwise. Let me know what you think about just one string for configuration e.g. "http://localhost:8080" instead of two or three.

[stephenplusplus]

Re: protocol, host and port why not just accept a customEndpoint value that can be set to something like "http://localhost:8080" and our default will be "https://www.googleapis.com" where the port of 443 is implied.

SGTM. 👍

[stephenplusplus]

Sent in an update using apiEndpoint. Also, instead of throwing if a user doesn't include a protocol, it will default to http://. Let me know if you catch anything I overlooked.

[ryanseys]

Cool beans. Looks good. Just could benefit from a couple example as I commented.

[stephenplusplus]

Good idea. Added those: 78358d4

[ryanseys]

Thanks! 💃