[DO NOT MERGE] Upgrade Pub/Sub samples.

[jmdobry]

• Tweak region tags/comments to match Upgrade Pub/Sub samples. nodejs-docs-samples#216
• Split Pub/Sub samples into topics.rb and subscriptions.rb
• Add CLI to samples
• Switch to using google-cloud-pubsub package

Compare to:

• Upgrade Pub/Sub samples. nodejs-docs-samples#216
• [DO NOT MERGE] Upgrade pubsub samples. python-docs-samples#543

[beccasaurus]

Thanks for working on this Jason!

Changes required to match some Ruby idioms (eg. don't use globals), match Ruby sample snippet templates, and specs are needed before merge.

[beccasaurus]

Please do not use global variables

[beccasaurus]

Please include gem requirement and client instantiation in snippets

See example of Ruby sample snippet template: create_dataset

[beccasaurus]

Please do not include method definition in Ruby sample snippet

See example of Ruby sample snippet template: create_dataset

[beccasaurus]

Ruby sample snippets use in-line variable definitions that document required variables.

Example of Ruby sample snippet template: create_dataset

# project_id = "Your Google Cloud project ID"
# dataset_id = "ID of the dataset to create"

require "google/cloud"

gcloud   = Google::Cloud.new project_id
bigquery = gcloud.bigquery

bigquery.create_dataset dataset_id

puts "Created dataset: #{dataset_id}"

This provides a good developer user experience allowing the developer to copy the whole snippet into IRB or an .rb file, replace the placeholder variable, and get up-and-running

[beccasaurus]

Do not use skip_lookup option

To get a topic using google-cloud-pubsub:

require "google/cloud"

gcloud = Google::Cloud.new
pubsub = gcloud.pubsub

topic = pubsub.topic "existing-topic"

[beccasaurus]

Sample snippets should not contain conditional logic. This snippet should not include a reference to environment variables. The project ID should be stored in variable that the developer can edit.

Please use a project_id variable such as the following convention followed by Ruby sample snippets:

# project_id        = "Your Google Cloud project ID"
# topic_name        = "Name of topic to subscribe to, eg. my-topic"
# subscription_name = "Name of subscription to create, eg. my-subscription"

require "google/cloud"

gcloud = Google::Cloud.new
pubsub = gcloud.pubsub
topic  = pubsub.topic

subscription = topic.subscribe(
  subscription_name,
  # Set to an HTTPS endpoint of your choice. If necessary, register
  # (authorize) the domain on which the server is hosted.
  endpoint: "https://#{project_id}.appspot.com/push"
)

puts "Subscription #{subscription.name} created."

[jmdobry]

See also Proposals implemented by the 3 PRs:

[beccasaurus]

Pub/Sub sample has been updated to use the latest google-cloud-pubsub library. Existing Pub/Sub code is continuing to be improved, as is.

This code does not match idioms of Ruby, Google Cloud Ruby library, or that of other samples in this repository. Also missing test coverage. Can be reopened pending fixes and offline consistency decision making.