Merge pull request #77 from GoogleCloudPlatform/quickstarts

Add new "quickstart" samples.

bigquery/README.md

@@ -36,3 +36,4 @@ Commands:
  query <query>
  query_job <query>
 ```
+

bigquery/quickstart.rb

@@ -0,0 +1,34 @@
+# Copyright 2016 Google, Inc
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# [START bigquery_quickstart]
+# Imports the Google Cloud client library
+require "google/cloud"
+
+# Your Google Cloud Platform project ID
+project_id = "YOUR_PROJECT_ID"
+
+# Instantiates a client
+gcloud = Google::Cloud.new project_id
+bigquery = gcloud.bigquery
+
+# The name for the new dataset
+dataset_name = "my_new_dataset"
+
+# Creates the new dataset
+dataset = bigquery.create_dataset dataset_name
+
+puts "Dataset #{dataset.dataset_id} created."
+# [END bigquery_quickstart]
+

bigquery/spec/quickstart_spec.rb

@@ -0,0 +1,43 @@
+# Copyright 2016 Google, Inc
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require "rspec"
+require "google/cloud"
+
+describe "BigQuery Quickstart" do
+
+ it "creates a new dataset" do
+ gcloud = Google::Cloud.new ENV["GOOGLE_CLOUD_PROJECT"]
+ bigquery = gcloud.bigquery
+
+ if bigquery.dataset "my_new_dataset"
+ bigquery.dataset("my_new_dataset").delete
+ end
+
+ expect(bigquery.dataset "my_new_dataset").to be nil
+ expect(Google::Cloud).to receive(:new).
+ with("YOUR_PROJECT_ID").
+ and_return(gcloud)
+
+ expect {
+ load File.expand_path("../quickstart.rb", __dir__)
+ }.to output(
+ "Dataset my_new_dataset created\.\n"
+ ).to_stdout
+
+ expect(bigquery.dataset "my_new_dataset").not_to be nil
+ end
+
+end
+

datastore/quickstart.rb

@@ -0,0 +1,43 @@
+# Copyright 2016 Google, Inc
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# [START datastore_quickstart]
+# Imports the Google Cloud client library
+require "google/cloud"
+
+# Your Google Cloud Platform project ID
+project_id = "YOUR_PROJECT_ID"
+
+# Instantiates a client
+gcloud = Google::Cloud.new project_id
+datastore = gcloud.datastore
+
+# The kind for the new entity
+kind = "Task"
+# The name/ID for the new entity
+name = "sampletask1"
+# The Cloud Datastore key for the new entity
+task_key = datastore.key kind, name
+
+# Prepares the new entity
+task = datastore.entity task_key do |t|
+ t["description"] = "Buy milk"
+end
+
+# Saves the entity
+datastore.save task
+
+puts "Saved #{task.key.name}: #{task['description']}"
+# [END datastore_quickstart]
+

datastore/spec/quickstart_spec.rb

@@ -0,0 +1,45 @@
+# Copyright 2016 Google, Inc
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require "rspec"
+require "google/cloud"
+
+describe "Datastore Quickstart" do
+
+ it "creates a new entity" do
+ gcloud = Google::Cloud.new ENV["GOOGLE_CLOUD_PROJECT"]
+ datastore = gcloud.datastore
+ task_key = datastore.key "Task", "sampletask1"
+
+ if datastore.find task_key
+ task = datastore.find task_key
+ datastore.delete task
+ end
+
+ expect(datastore.find task_key).to be nil
+ expect(Google::Cloud).to receive(:new).with("YOUR_PROJECT_ID").
+ and_return(gcloud)
+
+ expect {
+ load File.expand_path("../quickstart.rb", __dir__)
+ }.to output {
+ "Saved Task: Buy milk\n"
+ }.to_stdout
+
+ task_key = datastore.find(task_key)
+ expect(task_key).not_to be nil
+ expect(task_key["description"]).to eq "Buy milk"
+ end
+
+end

language/quickstart.rb

@@ -0,0 +1,36 @@
+# Copyright 2016 Google, Inc
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# [START language_quickstart]
+# Imports the Google Cloud client library
+require "google/cloud"
+
+# Your Google Cloud Platform project ID
+project_id = "YOUR_PROJECT_ID"
+
+# Instantiates a client
+gcloud = Google::Cloud.new project_id
+language = gcloud.language
+
+# The text to analyze
+text = "Hello, world!"
+document = language.document text
+
+# Detects the sentiment of the text
+sentiment = document.sentiment
+
+puts "Text: #{text}"
+puts "Sentiment: #{sentiment.polarity}, #{sentiment.magnitude}"
+# [END language_quickstart]
+

language/spec/quickstart_spec.rb

@@ -0,0 +1,33 @@
+# Copyright 2016 Google, Inc
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require "rspec"
+require "google/cloud"
+
+describe "Language Quickstart" do
+
+ it "detect sentiment" do
+ gcloud = Google::Cloud.new ENV["GOOGLE_CLOUD_PROJECT"]
+ expect(Google::Cloud).to receive(:new).with("YOUR_PROJECT_ID").
+ and_return(gcloud)
+
+ expect {
+ load File.expand_path("../quickstart.rb", __dir__)
+ }.to output(
+ /Text: Hello, world!\nSentiment: 1.0/
+ ).to_stdout
+ end
+
+end
+

logging/quickstart.rb

@@ -0,0 +1,40 @@
+# Copyright 2016 Google, Inc
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# [START logging_quickstart]
+# Imports the Google Cloud client library
+require "google/cloud"
+
+# Your Google Cloud Platform project ID
+project_id = "YOUR_PROJECT_ID"
+
+# Instantiates a client
+gcloud = Google::Cloud.new project_id
+logging = gcloud.logging
+
+# Prepares a log entry
+entry = logging.entry
+# The data to log
+entry.payload = "Hello, world!"
+# The name of the log to write to
+entry.log_name = "my-log"
+# The resource associated with the data
+entry.resource.type = "global"
+
+# Writes the log entry
+logging.write_entries entry
+
+puts "Logged #{entry.payload}"
+# [END logging_quickstart]
+

logging/spec/quickstart_spec.rb

@@ -0,0 +1,76 @@
+# Copyright 2016 Google, Inc
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require "rspec"
+require "google/cloud"
+
+describe "Logging Quickstart" do
+
+ # Simple wait method. Test for condition 5 times, delaying 1 second each time
+ def wait_until times: 5, delay: 1, &condition
+ times.times do
+ return if condition.call
+ sleep delay
+ end
+ raise "Condition not met. Waited #{times} times with #{delay} sec delay"
+ end
+
+ before do
+ @gcloud = Google::Cloud.new ENV["GOOGLE_CLOUD_PROJECT"]
+ @logging = @gcloud.logging
+ @entry = @logging.entry
+ @log_name = "projects/#{ENV["GOOGLE_CLOUD_PROJECT"]}/logs/" +
+ "quickstart_log_#{Time.now.to_i}"
+
+ @entry.log_name = @log_name
+ end
+
+ after do
+ begin
+ @logging.delete_log @log_name
+ rescue Google::Cloud::NotFoundError
+ end
+ end
+
+ def test_log_entries
+ @logging.entries filter: %Q{logName="#{@log_name}"}
+ end
+
+ it "logs a new entry" do
+ expect(Google::Cloud).to receive(:new).with("YOUR_PROJECT_ID").
+ and_return(@gcloud)
+ expect(@gcloud).to receive(:logging).and_return(@logging)
+ expect(@logging).to receive(:entry).and_return(@entry)
+ allow(@entry).to receive(:log_name=).with("my-log")
+
+ expect(test_log_entries).to be_empty
+
+ expect {
+ load File.expand_path("../quickstart.rb", __dir__)
+ }.to output(
+ "Logged Hello, world!\n"
+ ).to_stdout
+
+ entries = []
+
+ wait_until { entries = test_log_entries; entries.any? }
+
+ expect(entries).not_to be_empty
+ expect(entries.length).to eq 1
+
+ entry = entries.first
+ expect(entry.payload).to eq "Hello, world!"
+ end
+end
+

logging/spec/sample_spec.rb

@@ -144,7 +144,7 @@ def cleanup!
  timestamp = "\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2} [^\\\\]+"
 
  expect { list_log_entries }.to output(
- %r{\[#{timestamp}\] #{my_application_log_name} "Log message"}
+ %r{\[#{timestamp}\] #{my_application_log_name} \"Log message}
  ).to_stdout
  end