google-cloud-bigtable 0.6.2 → 1.0.2

data/lib/google/cloud/bigtable/table/cluster_state.rb

@@ -19,6 +19,7 @@ module Google
   module Cloud
     module Bigtable
       class Table
+        ##
         # Table::ClusterState is the state of a table's data in a particular cluster.
         class ClusterState
           attr_reader :cluster_name
@@ -31,47 +32,57 @@ module Google
             @cluster_name = cluster_name
           end
 
+          ##
           # The state of replication for the table in this cluster.
           #   Valid values are:
           #   * `:INITIALIZING` - The cluster was recently created.
           #   * `:PLANNED_MAINTENANCE` - The table is temporarily unable to serve.
           #   * `:UNPLANNED_MAINTENANCE` - The table is temporarily unable to serve.
           #   * `:READY` - The table can serve.
-          # @return [Symbol]
+          #
+          # @return [Symbol] The state of replication.
           #
           def replication_state
             @grpc.replication_state
           end
 
+          ##
           # The cluster was recently created, and the table must finish copying
           # over pre-existing data from other clusters before it can begin
           # receiving live replication updates and serving.
-          # @return [Boolean]
+          #
+          # @return [Boolean] `true` if the cluster is initializing.
           #
           def initializing?
             replication_state == :INITIALIZING
           end
 
+          ##
           # The table is temporarily unable to serve
           # requests from this cluster due to planned internal maintenance.
-          # @return [Boolean]
+          #
+          # @return [Boolean] `true` if the cluster is in planned maintenance.
           #
           def planned_maintenance?
             replication_state == :PLANNED_MAINTENANCE
           end
 
+          ##
           # The table is temporarily unable to serve requests from this
           # cluster due to unplanned or emergency maintenance.
-          # @return [Boolean]
+          #
+          # @return [Boolean] `true` if the cluster is in unplanned maintenance.
           #
           def unplanned_maintenance?
             replication_state == :UNPLANNED_MAINTENANCE
           end
 
+          ##
           # The table can serve requests from this cluster.
           # Depending on replication delay, reads may not immediately
           # reflect the state of the table in other clusters.
-          # @return [Boolean]
+          #
+          # @return [Boolean] `true` if the cluster is ready.
           #
           def ready?
             replication_state == :READY
@@ -84,7 +95,7 @@ module Google
           # @return [Google::Cloud::Bigtable::Table::ClusterState]
           #
           def self.from_grpc grpc, cluster_name
-            new(grpc, cluster_name)
+            new grpc, cluster_name
           end
         end
       end

data/lib/google/cloud/bigtable/table/list.rb

@@ -19,8 +19,10 @@ module Google
   module Cloud
     module Bigtable
       class Table
+        ##
         # Table::List is a special-case array with additional
         # values.
+        #
         class List < DelegateClass(::Array)
           # @private
           # The gRPC Service object.
@@ -33,9 +35,10 @@ module Google
           # @private
           # Creates a new Table::List with an array of table instances.
           def initialize arr = []
-            super(arr)
+            super arr
           end
 
+          ##
           # Whether there is a next page of tables.
           #
           # @return [Boolean]
@@ -49,10 +52,12 @@ module Google
           #   if tables.next?
           #     next_tables = tables.next
           #   end
+          #
           def next?
             grpc.next_page?
           end
 
+          ##
           # Retrieves the next page of tables.
           #
           # @return [Table::List] The list of table instances.
@@ -66,14 +71,16 @@ module Google
           #   if tables.next?
           #     next_tables = tables.next
           #   end
+          #
           def next
             ensure_grpc!
 
             return nil unless next?
             grpc.next_page
-            self.class.from_grpc(grpc, service)
+            self.class.from_grpc grpc, service
           end
 
+          ##
           # Retrieves remaining results by repeatedly invoking {#next} until
           # {#next?} returns `false`. Calls the given block once for each
           # result, which is passed as the argument to the block.
@@ -85,16 +92,16 @@ module Google
           # over the results returned by a single API call). Use with caution.
           #
           # @yield [table] The block for accessing each table instance.
-          # @yieldparam [Table] instance The table instance object.
+          # @yieldparam [Table] table The table instance object.
           #
           # @return [Enumerator]
           #
-          # @example Iterating each instance by passing a block:
+          # @example Iterating each table by passing a block:
           #   require "google/cloud/bigtable"
           #
           #   bigtable = Google::Cloud::Bigtable.new
           #
-          #   bigtable.tables("instance-id").all do |table|
+          #   bigtable.tables("my-instance").all do |table|
           #     puts table.table_id
           #   end
           #
@@ -103,19 +110,19 @@ module Google
           #
           #   bigtable = Google::Cloud::Bigtable.new
           #
-          #   all_table_ids = bigtable.tables("instance-id").all.map do |table|
+          #   all_table_ids = bigtable.tables("my-instance").all.map do |table|
           #     puts table.table_id
           #   end
           #
           def all
-            return enum_for(:all) unless block_given?
+            return enum_for :all unless block_given?
 
             results = self
             loop do
               results.each { |r| yield r }
               break unless next?
               grpc.next_page
-              results = self.class.from_grpc(grpc, service)
+              results = self.class.from_grpc grpc, service
             end
           end
 
@@ -124,7 +131,7 @@ module Google
           #
           def self.from_grpc grpc, service
             tables = List.new(Array(grpc.response.tables).map do |table|
-              Table.from_grpc(table, service, view: :NAME_ONLY)
+              Table.from_grpc table, service, view: :NAME_ONLY
             end)
             tables.grpc = grpc
             tables.service = service

data/lib/google/cloud/bigtable/v2.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -21,7 +21,7 @@ module Google
       # rubocop:disable LineLength
 
       ##
-      # # Ruby Client for Cloud Bigtable API ([Beta](https://github.com/googleapis/google-cloud-ruby#versioning))
+      # # Ruby Client for Cloud Bigtable API ([GA](https://github.com/googleapis/google-cloud-ruby#versioning))
       #
       # [Cloud Bigtable API][Product Documentation]:
       # API for reading and writing the contents of Bigtables associated with a

data/lib/google/cloud/bigtable/v2/bigtable_client.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -250,7 +250,7 @@ module Google
           # ReadRowsResponse documentation for details.
           #
           # @param table_name [String]
-          #   The unique name of the table from which to read.
+          #   Required. The unique name of the table from which to read.
           #   Values are of the form
           #   `projects/<project>/instances/<instance>/tables/<table>`.
           # @param app_profile_id [String]
@@ -308,7 +308,7 @@ module Google
           # mapreduces.
           #
           # @param table_name [String]
-          #   The unique name of the table from which to sample row keys.
+          #   Required. The unique name of the table from which to sample row keys.
           #   Values are of the form
           #   `projects/<project>/instances/<instance>/tables/<table>`.
           # @param app_profile_id [String]
@@ -346,13 +346,13 @@ module Google
           # unchanged unless explicitly changed by `mutation`.
           #
           # @param table_name [String]
-          #   The unique name of the table to which the mutation should be applied.
+          #   Required. The unique name of the table to which the mutation should be applied.
           #   Values are of the form
           #   `projects/<project>/instances/<instance>/tables/<table>`.
           # @param row_key [String]
-          #   The key of the row to which the mutation should be applied.
+          #   Required. The key of the row to which the mutation should be applied.
           # @param mutations [Array<Google::Bigtable::V2::Mutation | Hash>]
-          #   Changes to be atomically applied to the specified row. Entries are applied
+          #   Required. Changes to be atomically applied to the specified row. Entries are applied
           #   in order, meaning that earlier mutations can be masked by later ones.
           #   Must contain at least one entry and at most 100000.
           #   A hash of the same form as `Google::Bigtable::V2::Mutation`
@@ -403,9 +403,9 @@ module Google
           # atomically.
           #
           # @param table_name [String]
-          #   The unique name of the table to which the mutations should be applied.
+          #   Required. The unique name of the table to which the mutations should be applied.
           # @param entries [Array<Google::Bigtable::V2::MutateRowsRequest::Entry | Hash>]
-          #   The row keys and corresponding mutations to be applied in bulk.
+          #   Required. The row keys and corresponding mutations to be applied in bulk.
           #   Each entry is applied as an atomic mutation, but the entries may be
           #   applied in arbitrary order (even between entries for the same row).
           #   At least one entry must be specified, and in total the entries can
@@ -451,12 +451,12 @@ module Google
           # Mutates a row atomically based on the output of a predicate Reader filter.
           #
           # @param table_name [String]
-          #   The unique name of the table to which the conditional mutation should be
+          #   Required. The unique name of the table to which the conditional mutation should be
           #   applied.
           #   Values are of the form
           #   `projects/<project>/instances/<instance>/tables/<table>`.
           # @param row_key [String]
-          #   The key of the row to which the conditional mutation should be applied.
+          #   Required. The key of the row to which the conditional mutation should be applied.
           # @param app_profile_id [String]
           #   This value specifies routing for replication. If not specified, the
           #   "default" application profile will be used.
@@ -529,14 +529,14 @@ module Google
           # time. The method returns the new contents of all modified cells.
           #
           # @param table_name [String]
-          #   The unique name of the table to which the read/modify/write rules should be
+          #   Required. The unique name of the table to which the read/modify/write rules should be
           #   applied.
           #   Values are of the form
           #   `projects/<project>/instances/<instance>/tables/<table>`.
           # @param row_key [String]
-          #   The key of the row to which the read/modify/write rules should be applied.
+          #   Required. The key of the row to which the read/modify/write rules should be applied.
           # @param rules [Array<Google::Bigtable::V2::ReadModifyWriteRule | Hash>]
-          #   Rules specifying how the specified row's contents are to be transformed
+          #   Required. Rules specifying how the specified row's contents are to be transformed
           #   into writes. Entries are applied in order, meaning that earlier rules will
           #   affect the results of later ones.
           #   A hash of the same form as `Google::Bigtable::V2::ReadModifyWriteRule`

data/lib/google/cloud/bigtable/v2/credentials.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/bigtable/v2/doc/google/bigtable/v2/bigtable.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -19,7 +19,7 @@ module Google
       # Request message for Bigtable.ReadRows.
       # @!attribute [rw] table_name
       #   @return [String]
-      #     The unique name of the table from which to read.
+      #     Required. The unique name of the table from which to read.
       #     Values are of the form
       #     `projects/<project>/instances/<instance>/tables/<table>`.
       # @!attribute [rw] app_profile_id
@@ -42,6 +42,7 @@ module Google
       # Response message for Bigtable.ReadRows.
       # @!attribute [rw] chunks
       #   @return [Array<Google::Bigtable::V2::ReadRowsResponse::CellChunk>]
+      #     A collection of a row's contents as part of the read request.
       # @!attribute [rw] last_scanned_row_key
       #   @return [String]
       #     Optionally the server might return the row key of the last row it
@@ -117,7 +118,7 @@ module Google
       # Request message for Bigtable.SampleRowKeys.
       # @!attribute [rw] table_name
       #   @return [String]
-      #     The unique name of the table from which to sample row keys.
+      #     Required. The unique name of the table from which to sample row keys.
       #     Values are of the form
       #     `projects/<project>/instances/<instance>/tables/<table>`.
       # @!attribute [rw] app_profile_id
@@ -147,7 +148,7 @@ module Google
       # Request message for Bigtable.MutateRow.
       # @!attribute [rw] table_name
       #   @return [String]
-      #     The unique name of the table to which the mutation should be applied.
+      #     Required. The unique name of the table to which the mutation should be applied.
       #     Values are of the form
       #     `projects/<project>/instances/<instance>/tables/<table>`.
       # @!attribute [rw] app_profile_id
@@ -156,10 +157,10 @@ module Google
       #     "default" application profile will be used.
       # @!attribute [rw] row_key
       #   @return [String]
-      #     The key of the row to which the mutation should be applied.
+      #     Required. The key of the row to which the mutation should be applied.
       # @!attribute [rw] mutations
       #   @return [Array<Google::Bigtable::V2::Mutation>]
-      #     Changes to be atomically applied to the specified row. Entries are applied
+      #     Required. Changes to be atomically applied to the specified row. Entries are applied
       #     in order, meaning that earlier mutations can be masked by later ones.
       #     Must contain at least one entry and at most 100000.
       class MutateRowRequest; end
@@ -170,25 +171,26 @@ module Google
       # Request message for BigtableService.MutateRows.
       # @!attribute [rw] table_name
       #   @return [String]
-      #     The unique name of the table to which the mutations should be applied.
+      #     Required. The unique name of the table to which the mutations should be applied.
       # @!attribute [rw] app_profile_id
       #   @return [String]
       #     This value specifies routing for replication. If not specified, the
       #     "default" application profile will be used.
       # @!attribute [rw] entries
       #   @return [Array<Google::Bigtable::V2::MutateRowsRequest::Entry>]
-      #     The row keys and corresponding mutations to be applied in bulk.
+      #     Required. The row keys and corresponding mutations to be applied in bulk.
       #     Each entry is applied as an atomic mutation, but the entries may be
       #     applied in arbitrary order (even between entries for the same row).
       #     At least one entry must be specified, and in total the entries can
       #     contain at most 100000 mutations.
       class MutateRowsRequest
+        # A mutation for a given row.
         # @!attribute [rw] row_key
         #   @return [String]
         #     The key of the row to which the `mutations` should be applied.
         # @!attribute [rw] mutations
         #   @return [Array<Google::Bigtable::V2::Mutation>]
-        #     Changes to be atomically applied to the specified row. Mutations are
+        #     Required. Changes to be atomically applied to the specified row. Mutations are
         #     applied in order, meaning that earlier mutations can be masked by
         #     later ones.
         #     You must specify at least one mutation.
@@ -200,6 +202,7 @@ module Google
       #   @return [Array<Google::Bigtable::V2::MutateRowsResponse::Entry>]
       #     One or more results for Entries from the batch request.
       class MutateRowsResponse
+        # The result of applying a passed mutation in the original request.
         # @!attribute [rw] index
         #   @return [Integer]
         #     The index into the original request's `entries` list of the Entry
@@ -216,7 +219,7 @@ module Google
       # Request message for Bigtable.CheckAndMutateRow.
       # @!attribute [rw] table_name
       #   @return [String]
-      #     The unique name of the table to which the conditional mutation should be
+      #     Required. The unique name of the table to which the conditional mutation should be
       #     applied.
       #     Values are of the form
       #     `projects/<project>/instances/<instance>/tables/<table>`.
@@ -226,7 +229,7 @@ module Google
       #     "default" application profile will be used.
       # @!attribute [rw] row_key
       #   @return [String]
-      #     The key of the row to which the conditional mutation should be applied.
+      #     Required. The key of the row to which the conditional mutation should be applied.
       # @!attribute [rw] predicate_filter
       #   @return [Google::Bigtable::V2::RowFilter]
       #     The filter to be applied to the contents of the specified row. Depending
@@ -259,7 +262,7 @@ module Google
       # Request message for Bigtable.ReadModifyWriteRow.
       # @!attribute [rw] table_name
       #   @return [String]
-      #     The unique name of the table to which the read/modify/write rules should be
+      #     Required. The unique name of the table to which the read/modify/write rules should be
       #     applied.
       #     Values are of the form
       #     `projects/<project>/instances/<instance>/tables/<table>`.
@@ -269,10 +272,10 @@ module Google
       #     "default" application profile will be used.
       # @!attribute [rw] row_key
       #   @return [String]
-      #     The key of the row to which the read/modify/write rules should be applied.
+      #     Required. The key of the row to which the read/modify/write rules should be applied.
       # @!attribute [rw] rules
       #   @return [Array<Google::Bigtable::V2::ReadModifyWriteRule>]
-      #     Rules specifying how the specified row's contents are to be transformed
+      #     Required. Rules specifying how the specified row's contents are to be transformed
       #     into writes. Entries are applied in order, meaning that earlier rules will
       #     affect the results of later ones.
       class ReadModifyWriteRowRequest; end

data/lib/google/cloud/bigtable/v2/doc/google/bigtable/v2/data.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/bigtable/v2/doc/google/protobuf/any.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/bigtable/v2/doc/google/protobuf/wrappers.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/cloud/bigtable/v2/doc/google/rpc/status.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -17,67 +17,19 @@ module Google
   module Rpc
     # The `Status` type defines a logical error model that is suitable for
     # different programming environments, including REST APIs and RPC APIs. It is
-    # used by [gRPC](https://github.com/grpc). The error model is designed to be:
+    # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+    # three pieces of data: error code, error message, and error details.
     #
-    # * Simple to use and understand for most users
-    # * Flexible enough to meet unexpected needs
-    #
-    # = Overview
-    #
-    # The `Status` message contains three pieces of data: error code, error
-    # message, and error details. The error code should be an enum value of
-    # {Google::Rpc::Code}, but it may accept additional error codes
-    # if needed.  The error message should be a developer-facing English message
-    # that helps developers *understand* and *resolve* the error. If a localized
-    # user-facing error message is needed, put the localized message in the error
-    # details or localize it in the client. The optional error details may contain
-    # arbitrary information about the error. There is a predefined set of error
-    # detail types in the package `google.rpc` that can be used for common error
-    # conditions.
-    #
-    # = Language mapping
-    #
-    # The `Status` message is the logical representation of the error model, but it
-    # is not necessarily the actual wire format. When the `Status` message is
-    # exposed in different client libraries and different wire protocols, it can be
-    # mapped differently. For example, it will likely be mapped to some exceptions
-    # in Java, but more likely mapped to some error codes in C.
-    #
-    # = Other uses
-    #
-    # The error model and the `Status` message can be used in a variety of
-    # environments, either with or without APIs, to provide a
-    # consistent developer experience across different environments.
-    #
-    # Example uses of this error model include:
-    #
-    # * Partial errors. If a service needs to return partial errors to the client,
-    #   it may embed the `Status` in the normal response to indicate the partial
-    #   errors.
-    #
-    # * Workflow errors. A typical workflow has multiple steps. Each step may
-    #   have a `Status` message for error reporting.
-    #
-    # * Batch operations. If a client uses batch request and batch response, the
-    #   `Status` message should be used directly inside batch response, one for
-    #   each error sub-response.
-    #
-    # * Asynchronous operations. If an API call embeds asynchronous operation
-    #   results in its response, the status of those operations should be
-    #   represented directly using the `Status` message.
-    #
-    # * Logging. If some API errors are stored in logs, the message `Status` could
-    #   be used directly after any stripping needed for security/privacy reasons.
+    # You can find out more about this error model and how to work with it in the
+    # [API Design Guide](https://cloud.google.com/apis/design/errors).
     # @!attribute [rw] code
     #   @return [Integer]
-    #     The status code, which should be an enum value of
-    #     {Google::Rpc::Code}.
+    #     The status code, which should be an enum value of {Google::Rpc::Code}.
     # @!attribute [rw] message
     #   @return [String]
     #     A developer-facing error message, which should be in English. Any
     #     user-facing error message should be localized and sent in the
-    #     {Google::Rpc::Status#details} field, or localized
-    #     by the client.
+    #     {Google::Rpc::Status#details} field, or localized by the client.
     # @!attribute [rw] details
     #   @return [Array<Google::Protobuf::Any>]
     #     A list of messages that carry the error details.  There is a common set of