Implement the Quickstart example. (#944)

This fixes #615 for realsies.

Author: coryan

google/cloud/bigtable/doc/bigtable-main.dox

@@ -5,6 +5,8 @@ This page contains the reference guide to the Cloud Bigtable C++ Client Library.
 
 ## Examples
 
+* @ref bigtable-quickstart "Quickstart Example"
+
 * @ref bigtable-hello-world "Hello World Example"
 
 * @ref bigtable-samples-instance-admin "Instance Admin Example"

google/cloud/bigtable/doc/bigtable-quickstart.dox

@@ -0,0 +1,23 @@
+/*!
+@page bigtable-quickstart Example: C++ Quickstart Application
+
+Quickstart is a sample program demonstrating use of the Cloud Bigtable client
+library to read a row from an existing table.
+
+## Running the example
+
+This example uses the
+[Cloud Bigtable C++ Client Library](https://GoogleCloudPlatform.github.io/google-cloud-cpp)
+to communicate with Cloud Bigtable.
+
+To run the example program, follow the
+[instructions](https://github.com/GoogleCloudPlatform/google-cloud-cpp/tree/master/bigtable/examples/)
+for the example on GitHub.
+
+## The Code
+
+Here is the full example
+
+@snippet bigtable_quickstart.cc all code
+
+*/

google/cloud/bigtable/examples/BUILD

@@ -28,6 +28,12 @@ cc_binary(
     deps = ["//google/cloud/bigtable:bigtable_client"],
 )
 
+cc_binary(
+    name = "bigtable_quickstart",
+    srcs = ["bigtable_quickstart.cc"],
+    deps = ["//google/cloud/bigtable:bigtable_client"],
+)
+
 cc_binary(
     name = "bigtable_samples",
     srcs = ["bigtable_samples.cc"],

google/cloud/bigtable/examples/CMakeLists.txt

@@ -24,6 +24,9 @@ target_link_libraries(bigtable_hello_world bigtable_client)
 add_executable(bigtable_hello_app_profile bigtable_hello_app_profile.cc)
 target_link_libraries(bigtable_hello_app_profile bigtable_client)
 
+add_executable(bigtable_quickstart bigtable_quickstart.cc)
+target_link_libraries(bigtable_quickstart bigtable_client)
+
 add_executable(bigtable_samples bigtable_samples.cc)
 target_link_libraries(bigtable_samples bigtable_client)
 

google/cloud/bigtable/examples/bigtable_quickstart.cc

@@ -0,0 +1,59 @@
+// Copyright 2018 Google LLC
+//
+// 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.
+
+//! [all code] [START bigtable_quickstart]
+
+#include "google/cloud/bigtable/table.h"
+
+int main(int argc, char* argv[]) try {
+  if (argc != 4) {
+    std::string const cmd = argv[0];
+    auto last_slash = std::string(cmd).find_last_of('/');
+    std::cerr << "Usage: " << cmd.substr(last_slash + 1)
+              << " <project_id> <instance_id> <table_id>" << std::endl;
+    return 1;
+  }
+
+  std::string const project_id = argv[1];
+  std::string const instance_id = argv[2];
+  std::string const table_id = argv[3];
+
+  google::cloud::bigtable::Table table(
+      google::cloud::bigtable::CreateDefaultDataClient(
+          project_id, instance_id, google::cloud::bigtable::ClientOptions()),
+      table_id);
+
+  std::string row_key = "r1";
+  std::string column_family = "cf1";
+
+  std::cout << "Getting a single row by row key:" << std::flush;
+  auto result = table.ReadRow(
+      row_key, google::cloud::bigtable::Filter::FamilyRegex(column_family));
+  if (not result.first) {
+    std::cout << "Cannot find row " << row_key << " in the table: " << table_id
+              << std::endl;
+    return 0;
+  }
+
+  auto const& cell = result.second.cells().front();
+  std::cout << cell.family_name() << ":" << cell.column_qualifier() << "    @ "
+            << cell.timestamp().count() << "us\n"
+            << '"' << cell.value() << '"' << std::endl;
+
+  return 0;
+} catch (std::exception const& ex) {
+  std::cerr << "Standard C++ exception raised: " << ex.what() << std::endl;
+  return 1;
+}
+//! [all code] [END bigtable_quickstart]