google-cloud-bigtable 0.6.2 → 0.7.0

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

@@ -16,6 +16,7 @@
 module Google
   module Cloud
     module Bigtable
+      ##
       # # RowRange
       #
       # Specifies a contiguous range of rows.
@@ -59,6 +60,7 @@ module Google
           @grpc = Google::Bigtable::V2::RowRange.new
         end
 
+        ##
         # Sets a row range with a lower bound.
         #
         # @param key [String] Row key. Required.
@@ -91,6 +93,7 @@ module Google
           self
         end
 
+        ##
         # Sets a row range with an upper bound.
         #
         # @param key [String] Row key. Required.
@@ -123,6 +126,7 @@ module Google
           self
         end
 
+        ##
         # Sets a row range with inclusive upper and lower bounds.
         #
         # @param from_key [String] Inclusive from row key. Required.
@@ -142,6 +146,7 @@ module Google
           from(from_key).to(to_key, inclusive: true)
         end
 
+        ##
         # Sets a row range with an inclusive lower bound and an exclusive upper bound.
         #
         # @param from_key [String] Inclusive from row key.

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

@@ -31,8 +31,8 @@ module Google
         # Retryable status codes
         RETRYABLE_CODES = {
           Google::Rpc::Code::DEADLINE_EXCEEDED => true,
-          Google::Rpc::Code::ABORTED => true,
-          Google::Rpc::Code::UNAVAILABLE => true
+          Google::Rpc::Code::ABORTED           => true,
+          Google::Rpc::Code::UNAVAILABLE       => true
         }.freeze
 
         # @private
@@ -50,26 +50,25 @@ module Google
           @entries = entries
         end
 
+        ##
         # Applies mutations.
         #
         # @return [Array<Google::Bigtable::V2::MutateRowsResponse::Entry>]
         #
         def apply_mutations
           @req_entries = @entries.map(&:to_grpc)
-          statuses = mutate_rows(@req_entries)
+          statuses = mutate_rows @req_entries
 
           # Collects retryable mutations indices.
-          indices = statuses.each_with_object([]) do |e, r|
-            if @entries[e.index].retryable? && RETRYABLE_CODES[e.status.code]
-              r << e.index
-            end
+          indices = statuses.each_with_object [] do |e, r|
+            r << e.index if @entries[e.index].retryable? && RETRYABLE_CODES[e.status.code]
           end
 
           return statuses if indices.empty?
 
           (RETRY_LIMIT - 1).times do
             break if indices.empty?
-            indices = retry_entries(statuses, indices)
+            indices = retry_entries statuses, indices
           end
 
           statuses
@@ -77,19 +76,16 @@ module Google
 
         private
 
+        ##
         # Mutates rows.
         #
         # @param entries [Array<Google::Cloud::Bigtable::MutationEntry>]
         # @return [Array<Google::Bigtable::V2::MutateRowsResponse::Entry>]
         #
         def mutate_rows entries
-          response = @table.client.mutate_rows(
-            @table.path,
-            entries,
-            app_profile_id: @table.app_profile_id
-          )
-          response.each_with_object([]) do |res, statuses|
-            statuses.concat(res.entries)
+          response = @table.client.mutate_rows @table.path, entries, app_profile_id: @table.app_profile_id
+          response.each_with_object [] do |res, statuses|
+            statuses.concat res.entries
           end
         rescue Google::Gax::GaxError => e
           raise Google::Cloud::Error.from_error(e.cause)
@@ -97,6 +93,7 @@ module Google
           raise Google::Cloud::Error.from_error(e)
         end
 
+        ##
         # Collects failed entries, retries mutation, and updates status.
         #
         # @param statuses [Array<Google::Bigtable::V2::MutateRowsResponse::Entry>]
@@ -107,9 +104,9 @@ module Google
         #
         def retry_entries statuses, indices
           entries = indices.map { |i| @req_entries[i] }
-          retry_statuses = mutate_rows(entries)
+          retry_statuses = mutate_rows entries
 
-          retry_statuses.each_with_object([]) do |e, next_indices|
+          retry_statuses.each_with_object [] do |e, next_indices|
             next_indices << indices[e.index] if RETRYABLE_CODES[e.status.code]
             statuses[indices[e.index]].status = e.status
           end

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

@@ -56,6 +56,7 @@ module Google
           @retry_count = 0
         end
 
+        ##
         # Read rows
         #
         # @param rows [Google::Bigtable::V2::RowSet]
@@ -72,22 +73,19 @@ module Google
         #   The default (zero) is to return all results.
         # @return [:yields: row]
         #   Array of row or yield block for each processed row.
-
-        def read \
-            rows: nil,
-            filter: nil,
-            rows_limit: nil
+        #
+        def read rows: nil, filter: nil, rows_limit: nil
           response = @table.client.read_rows(
             @table.path,
-            rows: rows,
-            filter: filter,
-            rows_limit: rows_limit,
+            rows:           rows,
+            filter:         filter,
+            rows_limit:     rows_limit,
             app_profile_id: @table.app_profile_id
           )
           response.each do |res|
             res.chunks.each do |chunk|
               @retry_count = 0
-              row = @chunk_processor.process(chunk)
+              row = @chunk_processor.process chunk
               next if row.nil?
               yield row
               @rows_count += 1
@@ -97,14 +95,16 @@ module Google
           @chunk_processor.validate_last_row_complete
         end
 
+        ##
         # Last read row key.
         #
         # @return [String]
-
+        #
         def last_key
           @chunk_processor.last_key
         end
 
+        ##
         # Calucates and returns the read rows limit and row set based on last read key.
         #
         # @param rows_limit [Integer]
@@ -116,7 +116,7 @@ module Google
         #   A hash of the same form as `Google::Bigtable::V2::RowSet`
         #   can also be provided.
         # @return [Integer, Google::Bigtable::V2::RowSet]
-
+        #
         def retry_options rows_limit, row_set
           return [rows_limit, row_set] unless last_key
 
@@ -129,14 +129,14 @@ module Google
             delete_indexes = []
 
             row_set.row_ranges.each_with_index do |range, i|
-              if end_key_read?(range)
+              if end_key_read? range
                 delete_indexes << i
-              elsif start_key_read?(range)
+              elsif start_key_read? range
                 range.start_key_open = last_key
               end
             end
 
-            delete_indexes.each { |i| row_set.row_ranges.delete_at(i) }
+            delete_indexes.each { |i| row_set.row_ranges.delete_at i }
           end
 
           if row_set.row_ranges.empty?
@@ -151,15 +151,18 @@ module Google
           [rows_limit, row_set]
         end
 
+        ##
         # Checks if a read operation is retryable.
         #
         # @return [Boolean]
+        #
         def retryable?
           @retry_count < RowsReader::RETRY_LIMIT
         end
 
         private
 
+        ##
         # Checks if the start key was already read for the range.
         #
         # @param range [Google::Bigtable::V2::RowRange]
@@ -175,6 +178,7 @@ module Google
           start_key.empty? || last_key >= start_key
         end
 
+        ##
         # Checks if the end key was already read for the range.
         #
         # @param range [Google::Bigtable::V2::RowRange]

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

@@ -18,6 +18,7 @@
 module Google
   module Cloud
     module Bigtable
+      ##
       # # SampleRowKey
       #
       # Sample row key with byte offset.
@@ -37,7 +38,7 @@ module Google
       #   `offset_bytes` fields.
       #
       # @example
-      #   require "google/cloud"
+      #   require "google/cloud/bigtable"
       #
       #   bigtable = Google::Cloud::Bigtable.new
       #
@@ -48,9 +49,11 @@ module Google
       #   end
       #
       class SampleRowKey
+        ##
         # @return [String] Sample row key.
         attr_reader :key
 
+        ##
         # @return [Integer] Row offset in bytes.
         attr_reader :offset
 
@@ -74,7 +77,7 @@ module Google
         # @return [Google::Cloud::Bigtable::SampleRowKey]
         #
         def self.from_grpc grpc
-          new(grpc.row_key, grpc.offset_bytes)
+          new grpc.row_key, grpc.offset_bytes
         end
       end
     end

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

@@ -35,30 +35,25 @@ module Google
         # Creates a new Service instance.
         #
         # @param project_id [String] Project identifier
-        # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
-        #   The means for authenticating requests made by the client. This parameter can
-        #   be one of the following types.
-        #   `Google::Auth::Credentials` uses the properties of its represented keyfile for
-        #   authenticating requests made by this client.
-        #   `String` will be treated as the path to the keyfile to use to construct
-        #   credentials for this client.
-        #   `Hash` will be treated as the contents of a keyfile to use to construct
-        #   credentials for this client.
+        # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel,
+        #   GRPC::Core::ChannelCredentials, Proc]
+        #   The means for authenticating requests made by the client. This parameter can be one of the following types.
+        #   `Google::Auth::Credentials` uses the properties of its represented keyfile for authenticating requests made
+        #   by this client.
+        #   `String` will be treated as the path to the keyfile to use to construct credentials for this client.
+        #   `Hash` will be treated as the contents of a keyfile to use to construct credentials for this client.
         #   `GRPC::Core::Channel` will be used to make calls through.
-        #   `GRPC::Core::ChannelCredentials` will be used to set up the gRPC client. The channel credentials
-        #   should already be composed with a `GRPC::Core::CallCredentials` object.
-        #   `Proc` will be used as an updater_proc for the gRPC channel. The proc transforms the
-        #   metadata for requests, generally, to give OAuth credentials.
+        #   `GRPC::Core::ChannelCredentials` will be used to set up the gRPC client. The channel credentials should
+        #   already be composed with a `GRPC::Core::CallCredentials` object.
+        #   `Proc` will be used as an updater_proc for the gRPC channel. The proc transforms the metadata for requests,
+        #   generally, to give OAuth credentials.
         # @param timeout [Integer]
         #   The default timeout, in seconds, for calls made through this client.
         # @param client_config [Hash]
-        #   A hash for call options for each method.
-        #   See Google::Gax#construct_settings for the structure of
-        #   this data. Falls back to the default config if not specified
-        #   or the specified config is missing data points.
-
-        def initialize project_id, credentials, host: nil, timeout: nil,
-                       client_config: nil
+        #   A hash for call options for each method. See Google::Gax#construct_settings for the structure of this data.
+        #   Falls back to the default config if not specified or the specified config is missing data points.
+        #
+        def initialize project_id, credentials, host: nil, timeout: nil, client_config: nil
           @project_id = project_id
           @credentials = credentials
           @host = host
@@ -72,74 +67,73 @@ module Google
         end
 
         def chan_args
-          { "grpc.max_send_message_length" => -1,
-            "grpc.max_receive_message_length" => -1,
+          { "grpc.max_send_message_length"           => -1,
+            "grpc.max_receive_message_length"        => -1,
             "grpc.service_config_disable_resolution" => 1 }
         end
 
         def chan_creds
           return credentials if insecure?
           require "grpc"
-          GRPC::Core::ChannelCredentials.new.compose \
-            GRPC::Core::CallCredentials.new credentials.client.updater_proc
+          GRPC::Core::ChannelCredentials.new.compose GRPC::Core::CallCredentials.new credentials.client.updater_proc
         end
 
+        ##
         # Creates or returns an instance of an instance admin client.
         #
         # @return [Google::Cloud::Bigtable::Admin::V2::BigtableInstanceAdminClient]
-
+        #
         def instances
-          @instances ||= begin
-            instances_channel = channel(
-              Admin::V2::BigtableInstanceAdminClient::SERVICE_ADDRESS
-            )
-            Admin::V2::BigtableInstanceAdminClient.new(
-              credentials: instances_channel,
-              timeout: timeout,
-              client_config: client_config,
-              lib_name: "gccl",
-              lib_version: Google::Cloud::Bigtable::VERSION
-            )
-          end
+          return mocked_instances if mocked_instances
+          @instances ||= Admin::V2::BigtableInstanceAdminClient.new(
+            credentials:   channel(Admin::V2::BigtableInstanceAdminClient::SERVICE_ADDRESS),
+            timeout:       timeout,
+            client_config: client_config,
+            lib_name:      "gccl",
+            lib_version:   Google::Cloud::Bigtable::VERSION
+          )
         end
+        attr_accessor :mocked_instances
 
+        ##
         # Creates or returns an instance of a table admin client.
         #
         # @return [Google::Cloud::Bigtable::Admin::V2::BigtableTableAdminClient]
-
+        #
         def tables
-          @tables ||= begin
-            tables_channel = channel(
-              Admin::V2::BigtableTableAdminClient::SERVICE_ADDRESS
-            )
-            Admin::V2::BigtableTableAdminClient.new(
-              credentials: tables_channel,
-              timeout: timeout,
-              client_config: client_config,
-              lib_name: "gccl",
-              lib_version: Google::Cloud::Bigtable::VERSION
-            )
-          end
+          return mocked_tables if mocked_tables
+          @tables ||= Admin::V2::BigtableTableAdminClient.new(
+            credentials:   channel(Admin::V2::BigtableTableAdminClient::SERVICE_ADDRESS),
+            timeout:       timeout,
+            client_config: client_config,
+            lib_name:      "gccl",
+            lib_version:   Google::Cloud::Bigtable::VERSION
+          )
         end
+        attr_accessor :mocked_tables
 
+        ##
         # Creates an instance of a data client.
         #
         # @return [Google::Cloud::Bigtable::V2::BigtableClient]
-
+        #
         def client
-          @client ||= \
-            V2::BigtableClient.new(
-              credentials: channel(V2::BigtableClient::SERVICE_ADDRESS),
-              timeout: timeout,
-              client_config: client_config,
-              lib_name: "gccl",
-              lib_version: Google::Cloud::Bigtable::VERSION
-            )
+          return mocked_client if mocked_client
+          @client ||= V2::BigtableClient.new(
+            credentials:   channel(V2::BigtableClient::SERVICE_ADDRESS),
+            timeout:       timeout,
+            client_config: client_config,
+            lib_name:      "gccl",
+            lib_version:   Google::Cloud::Bigtable::VERSION
+          )
         end
+        attr_accessor :mocked_client
 
         def insecure?
           credentials == :this_channel_is_insecure
         end
+
+        ##
         # Creates an instance within a project.
         #
         # @param instance_id [String]
@@ -153,50 +147,40 @@ module Google
         #   +projects/myproject/instances/myinstance/clusters/mycluster+.
         #   Alternatively, provide a hash in the form of `Google::Bigtable::Admin::V2::Cluster`
         # @return [Google::Gax::Operation]
-
-        def create_instance \
-            instance_id,
-            instance,
-            clusters
+        #
+        def create_instance instance_id, instance, clusters
           execute do
-            instances.create_instance(
-              project_path,
-              instance_id,
-              instance,
-              clusters
-            )
+            instances.create_instance project_path, instance_id, instance, clusters
           end
         end
 
+        ##
         # Lists the instances in a project.
         #
         # @param token [String]
         #   The value of +next_page_token+ returned by a previous call.
         # @return [Google::Bigtable::Admin::V2::ListInstancesResponse]
-
+        #
         def list_instances token: nil
           execute do
-            instances.list_instances(
-              project_path,
-              page_token: token
-            )
+            instances.list_instances project_path, page_token: token
           end
         end
 
+        ##
         # Gets information about an instance.
         #
         # @param instance_id [String]
         #   Unique ID of the requested instance.
         # @return [Google::Bigtable::Admin::V2::Instance]
-
+        #
         def get_instance instance_id
           execute do
-            instances.get_instance(
-              instance_path(instance_id)
-            )
+            instances.get_instance instance_path(instance_id)
           end
         end
 
+        ##
         # Partially updates an instance.
         #
         # @param instance [Google::Bigtable::Admin::V2::Instance | Hash]
@@ -207,18 +191,19 @@ module Google
         #   Must be explicitly set.
         #   Alternatively, provide a hash in the form of `Google::Protobuf::FieldMask`.
         # @return [Google::Gax::Operation]
-
+        #
         def partial_update_instance instance, update_mask
           execute do
-            instances.partial_update_instance(instance, update_mask)
+            instances.partial_update_instance instance, update_mask
           end
         end
 
+        ##
         # Deletes an instance from a project.
         #
         # @param instance_id [String]
         #   Unique ID of the instance to be deleted.
-
+        #
         def delete_instance instance_id
           execute do
             instances.delete_instance(
@@ -227,6 +212,7 @@ module Google
           end
         end
 
+        ##
         # Creates a cluster within an instance.
         #
         # @param instance_id [String]
@@ -238,21 +224,16 @@ module Google
         #   Alternatively, provide a hash in the form of `Google::Bigtable::Admin::V2::Cluster`
         #
         # @return [Google::Gax::Operation]
-
+        #
         def create_cluster instance_id, cluster_id, cluster
-          unless cluster.location == ""
-            cluster.location = location_path(cluster.location)
-          end
+          cluster.location = location_path cluster.location unless cluster.location == ""
 
           execute do
-            instances.create_cluster(
-              instance_path(instance_id),
-              cluster_id,
-              cluster
-            )
+            instances.create_cluster instance_path(instance_id), cluster_id, cluster
           end
         end
 
+        ##
         # Lists information about clusters in an instance.
         #
         # @param instance_id [String]
@@ -260,16 +241,14 @@ module Google
         # @param token [String]
         #   The value of +next_page_token+ returned by a previous call.
         # @return [Google::Bigtable::Admin::V2::ListClustersResponse]
-
+        #
         def list_clusters instance_id, token: nil
           execute do
-            instances.list_clusters(
-              instance_path(instance_id),
-              page_token: token
-            )
+            instances.list_clusters instance_path(instance_id), page_token: token
           end
         end
 
+        ##
         # Gets information about a cluster.
         #
         # @param instance_id [String]
@@ -277,15 +256,14 @@ module Google
         # @param cluster_id [String]
         #   Unique ID of the requested cluster.
         # @return [Google::Bigtable::Admin::V2::Cluster]
-
+        #
         def get_cluster instance_id, cluster_id
           execute do
-            instances.get_cluster(
-              cluster_path(instance_id, cluster_id)
-            )
+            instances.get_cluster cluster_path(instance_id, cluster_id)
           end
         end
 
+        ##
         # Updates a cluster within an instance.
         #
         # @param instance_id [String]
@@ -301,32 +279,28 @@ module Google
         #   The number of nodes allocated to this cluster. More nodes enable higher
         #   throughput and more consistent performance.
         # @return [Google::Gax::Operation]
-
+        #
         def update_cluster instance_id, cluster_id, location, serve_nodes
           execute do
-            instances.update_cluster(
-              cluster_path(instance_id, cluster_id),
-              location,
-              serve_nodes
-            )
+            instances.update_cluster cluster_path(instance_id, cluster_id), location, serve_nodes
           end
         end
 
+        ##
         # Deletes a cluster from an instance.
         #
         # @param instance_id [String]
         #   Unique ID of the instance the cluster is in.
         # @param cluster_id [String]
         #    Unique ID of the cluster to be deleted.
-
+        #
         def delete_cluster instance_id, cluster_id
           execute do
-            instances.delete_cluster(
-              cluster_path(instance_id, cluster_id)
-            )
+            instances.delete_cluster cluster_path(instance_id, cluster_id)
           end
         end
 
+        ##
         # Creates a new table in the specified instance.
         # Optionally, creates the table with a full set of initial column families.
         #
@@ -357,26 +331,16 @@ module Google
         #   Alternatively, provide a hash in the form of
         #   `Google::Bigtable::Admin::V2::CreateTableRequest::Split`
         # @return [Google::Bigtable::Admin::V2::Table]
-
-        def create_table \
-            instance_id,
-            table_id,
-            table,
-            initial_splits: nil
-          if initial_splits
-            initial_splits = initial_splits.map { |key| { key: key } }
-          end
+        #
+        def create_table instance_id, table_id, table, initial_splits: nil
+          initial_splits = initial_splits.map { |key| { key: key } } if initial_splits
 
           execute do
-            tables.create_table(
-              instance_path(instance_id),
-              table_id,
-              table,
-              initial_splits: initial_splits
-            )
+            tables.create_table instance_path(instance_id), table_id, table, initial_splits: initial_splits
           end
         end
 
+        ##
         # Lists all tables in an instance.
         #
         # @param instance_id [String]
@@ -388,16 +352,14 @@ module Google
         #   An enumerable of Google::Bigtable::Admin::V2::Table instances.
         #   See Google::Gax::PagedEnumerable documentation for other
         #   operations such as per-page iteration or access to the response.
-
+        #
         def list_tables instance_id, view: nil
           execute do
-            tables.list_tables(
-              instance_path(instance_id),
-              view: view
-            )
+            tables.list_tables instance_path(instance_id), view: view
           end
         end
 
+        ##
         # Gets metadata about the specified table.
         #
         # @param instance_id [String]
@@ -408,31 +370,28 @@ module Google
         #   View to be applied to the returned table's fields.
         #   Defaults to +SCHEMA_VIEW+ if unspecified.
         # @return [Google::Bigtable::Admin::V2::Table]
-
+        #
         def get_table instance_id, table_id, view: nil
           execute do
-            tables.get_table(
-              table_path(instance_id, table_id),
-              view: view
-            )
+            tables.get_table table_path(instance_id, table_id), view: view
           end
         end
 
+        ##
         # Permanently deletes a table and all of its data.
         #
         # @param instance_id [String]
         #   Unique ID of the instance the table is in.
         # @param table_id [String]
         #   Unique ID of the table to be deleted.
-
+        #
         def delete_table instance_id, table_id
           execute do
-            tables.delete_table(
-              table_path(instance_id, table_id)
-            )
+            tables.delete_table table_path(instance_id, table_id)
           end
         end
 
+        ##
         # Performs a series of column family modifications on the specified table.
         # Either all or none of the modifications will occur before this method
         # returns. Data requests received prior to completion of this method may reach a table
@@ -450,16 +409,14 @@ module Google
         #   Alternatively, provide a hash in the form of
         #    `Google::Bigtable::Admin::V2::ModifyColumnFamiliesRequest::Modification`.
         # @return [Google::Bigtable::Admin::V2::Table]
-
+        #
         def modify_column_families instance_id, table_id, modifications
           execute do
-            tables.modify_column_families(
-              table_path(instance_id, table_id),
-              modifications
-            )
+            tables.modify_column_families table_path(instance_id, table_id), modifications
           end
         end
 
+        ##
         # Generates a consistency token for a table.
         # The consistency token can be be used in CheckConsistency to check whether
         # mutations to the table that finished before this call started have been replicated.
@@ -470,15 +427,14 @@ module Google
         # @param table_id [String]
         #   Unique ID of the table the consistency token is for.
         # @return [Google::Bigtable::Admin::V2::GenerateConsistencyTokenResponse]
-
+        #
         def generate_consistency_token instance_id, table_id
           execute do
-            tables.generate_consistency_token(
-              table_path(instance_id, table_id)
-            )
+            tables.generate_consistency_token table_path(instance_id, table_id)
           end
         end
 
+        ##
         # Checks replication consistency based on a consistency token.
         # Determines if replication has caught up, based on the conditions in the token
         # and the check request.
@@ -490,16 +446,14 @@ module Google
         # @param token [String] Consistency token
         #   The token created for the table using GenerateConsistencyToken.
         # @return [Google::Bigtable::Admin::V2::CheckConsistencyResponse]
-
+        #
         def check_consistency instance_id, table_id, token
           execute do
-            tables.check_consistency(
-              table_path(instance_id, table_id),
-              token
-            )
+            tables.check_consistency table_path(instance_id, table_id), token
           end
         end
 
+        ##
         # Permanently deletes a row range from a table. The request can
         # specify whether to delete all rows in a table or only rows that match a
         # particular row key prefix.
@@ -515,13 +469,8 @@ module Google
         #   If true, delete all rows in the table. Setting this to false is a no-op.
         # @param timeout [Integer]
         #   Sets the API call timeout if deadline exceeds exception.
-
-        def drop_row_range \
-             instance_id,
-             table_id,
-             row_key_prefix: nil,
-             delete_all_data_from_table: nil,
-             timeout: nil
+        #
+        def drop_row_range instance_id, table_id, row_key_prefix: nil, delete_all_data_from_table: nil, timeout: nil
           call_options = nil
 
           # Pass a timeout with a larger value if the drop operation throws
@@ -531,21 +480,20 @@ module Google
               [],
               Google::Gax::BackoffSettings.new(0, 0, 0, timeout * 1000, 0, 0, 0)
             )
-            call_options = Google::Gax::CallOptions.new(
-              retry_options: retry_options
-            )
+            call_options = Google::Gax::CallOptions.new retry_options: retry_options
           end
 
           execute do
             tables.drop_row_range(
               table_path(instance_id, table_id),
-              row_key_prefix: row_key_prefix,
+              row_key_prefix:             row_key_prefix,
               delete_all_data_from_table: delete_all_data_from_table,
-              options: call_options
+              options:                    call_options
             )
           end
         end
 
+        ##
         # Creates an app profile within an instance.
         #
         # @param instance_id [String]
@@ -559,12 +507,8 @@ module Google
         # @param ignore_warnings [Boolean]
         #   If true, ignore safety checks when creating the app profile.
         # @return [Google::Bigtable::Admin::V2::AppProfile]
-
-        def create_app_profile \
-            instance_id,
-            app_profile_id,
-            app_profile,
-            ignore_warnings: nil
+        #
+        def create_app_profile instance_id, app_profile_id, app_profile, ignore_warnings: nil
           execute do
             instances.create_app_profile(
               instance_path(instance_id),
@@ -575,6 +519,7 @@ module Google
           end
         end
 
+        ##
         # Gets information about an app profile.
         #
         # @param instance_id [String]
@@ -582,15 +527,14 @@ module Google
         # @param app_profile_id [String]
         #   Unique ID of the requested app profile.
         # @return [Google::Bigtable::Admin::V2::AppProfile]
-
+        #
         def get_app_profile instance_id, app_profile_id
           execute do
-            instances.get_app_profile(
-              app_profile_path(instance_id, app_profile_id)
-            )
+            instances.get_app_profile app_profile_path(instance_id, app_profile_id)
           end
         end
 
+        ##
         # Lists information about app profiles in an instance.
         #
         # @param instance_id [String]
@@ -600,14 +544,14 @@ module Google
         #   See Google::Gax::PagedEnumerable documentation for other
         #   operations such as per-page iteration or access to the response
         #   object.
+        #
         def list_app_profiles instance_id
           execute do
-            instances.list_app_profiles(
-              instance_path(instance_id)
-            )
+            instances.list_app_profiles instance_path(instance_id)
           end
         end
 
+        ##
         # Updates an app profile within an instance.
         #
         # @param app_profile [Google::Bigtable::Admin::V2::AppProfile | Hash]
@@ -621,17 +565,14 @@ module Google
         # @param ignore_warnings [Boolean]
         #   If true, ignore safety checks when updating the app profile.
         # @return [Google::Longrunning::Operation]
-
+        #
         def update_app_profile app_profile, update_mask, ignore_warnings: nil
           execute do
-            instances.update_app_profile(
-              app_profile,
-              update_mask,
-              ignore_warnings: ignore_warnings
-            )
+            instances.update_app_profile app_profile, update_mask, ignore_warnings: ignore_warnings
           end
         end
 
+        ##
         # Deletes an app profile from an instance.
         #
         # @param instance_id [String]
@@ -640,31 +581,28 @@ module Google
         #   Unique ID of the app profile to be deleted.
         # @param ignore_warnings [Boolean]
         #   If true, ignore safety checks when deleting the app profile.
-
+        #
         def delete_app_profile instance_id, app_profile_id, ignore_warnings: nil
           execute do
-            instances.delete_app_profile(
-              app_profile_path(instance_id, app_profile_id),
-              ignore_warnings
-            )
+            instances.delete_app_profile app_profile_path(instance_id, app_profile_id), ignore_warnings
           end
         end
 
+        ##
         # Gets the access control policy for an instance resource. Returns an empty
         # policy if an instance exists but does not have a policy set.
         #
         # @param instance_id [String]
         #   Unique ID of the instance for which the policy is being requested.
         # @return [Google::Iam::V1::Policy]
-
+        #
         def get_instance_policy instance_id
           execute do
-            instances.get_iam_policy(
-              instance_path(instance_id)
-            )
+            instances.get_iam_policy instance_path(instance_id)
           end
         end
 
+        ##
         # Sets the access control policy on an instance resource. Replaces any
         # existing policy.
         #
@@ -677,16 +615,14 @@ module Google
         #   might reject an empty policy.
         #   Alternatively, provide a hash similar to `Google::Iam::V1::Policy`.
         # @return [Google::Iam::V1::Policy]
-
+        #
         def set_instance_policy instance_id, policy
           execute do
-            instances.set_iam_policy(
-              instance_path(instance_id),
-              policy
-            )
+            instances.set_iam_policy instance_path(instance_id), policy
           end
         end
 
+        ##
         # Returns permissions that the caller has for the specified instance resource.
         #
         # @param instance_id [String]
@@ -697,20 +633,18 @@ module Google
         #   information see
         #   [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
         # @return [Google::Iam::V1::TestIamPermissionsResponse]
-
+        #
         def test_instance_permissions instance_id, permissions
           execute do
-            instances.test_iam_permissions(
-              instance_path(instance_id),
-              permissions
-            )
+            instances.test_iam_permissions instance_path(instance_id), permissions
           end
         end
 
+        ##
         # Executes the API call and wrap errors to {Google::Cloud::Error}.
         #
         # @raise [Google::Cloud::Error]
-
+        #
         def execute
           yield
         rescue Google::Gax::GaxError => e
@@ -719,30 +653,30 @@ module Google
           raise Google::Cloud::Error.from_error(e)
         end
 
+        ##
         # Creates a formatted project path.
         #
         # @return [String]
         #   Formatted project path
         #   +projects/<project>+
-
+        #
         def project_path
-          Admin::V2::BigtableInstanceAdminClient.project_path(project_id)
+          Admin::V2::BigtableInstanceAdminClient.project_path project_id
         end
 
+        ##
         # Creates a formatted instance path.
         #
         # @param instance_id [String]
         # @return [String]
         #   Formatted instance path
         #   +projects/<project>/instances/[a-z][a-z0-9\\-]+[a-z0-9]+.
-
+        #
         def instance_path instance_id
-          Admin::V2::BigtableInstanceAdminClient.instance_path(
-            project_id,
-            instance_id
-          )
+          Admin::V2::BigtableInstanceAdminClient.instance_path project_id, instance_id
         end
 
+        ##
         # Creates a formatted cluster path.
         #
         # @param instance_id [String]
@@ -750,15 +684,12 @@ module Google
         # @return [String]
         #   Formatted cluster path
         #   +projects/<project>/instances/<instance>/clusters/<cluster>+.
-
+        #
         def cluster_path instance_id, cluster_id
-          Admin::V2::BigtableInstanceAdminClient.cluster_path(
-            project_id,
-            instance_id,
-            cluster_id
-          )
+          Admin::V2::BigtableInstanceAdminClient.cluster_path project_id, instance_id, cluster_id
         end
 
+        ##
         # Creates a formatted location path.
         #
         # @param location [String]
@@ -766,29 +697,24 @@ module Google
         # @return [String]
         #   Formatted location path
         #   +projects/<project_id>/locations/<location>+.
-
+        #
         def location_path location
-          Admin::V2::BigtableInstanceAdminClient.location_path(
-            project_id,
-            location
-          )
+          Admin::V2::BigtableInstanceAdminClient.location_path project_id, location
         end
 
+        ##
         # Creates a formatted table path.
         #
         # @param table_id [String]
         # @return [String]
         #   Formatted table path
         #   +projects/<project>/instances/<instance>/tables/<table>+
-
+        #
         def table_path instance_id, table_id
-          Admin::V2::BigtableTableAdminClient.table_path(
-            project_id,
-            instance_id,
-            table_id
-          )
+          Admin::V2::BigtableTableAdminClient.table_path project_id, instance_id, table_id
         end
 
+        ##
         # Creates a formatted snapshot path.
         #
         # @param instance_id [String]
@@ -797,16 +723,12 @@ module Google
         # @return [String]
         #   Formatted snapshot path
         #   +projects/<project>/instances/<instance>/clusters/<cluster>/snapshots/<snapshot>+
-
+        #
         def snapshot_path instance_id, cluster_id, snapshot_id
-          Admin::V2::BigtableTableAdminClient.snapshot_path(
-            project_id,
-            instance_id,
-            cluster_id,
-            snapshot_id
-          )
+          Admin::V2::BigtableTableAdminClient.snapshot_path project_id, instance_id, cluster_id, snapshot_id
         end
 
+        ##
         # Creates a formatted app profile path.
         #
         # @param instance_id [String]
@@ -814,18 +736,15 @@ module Google
         # @return [String]
         #   Formatted snapshot path
         #   +projects/<project>/instances/<instance>/appProfiles/<app_profile>+
-
+        #
         def app_profile_path instance_id, app_profile_id
-          Admin::V2::BigtableInstanceAdminClient.app_profile_path(
-            project_id,
-            instance_id,
-            app_profile_id
-          )
+          Admin::V2::BigtableInstanceAdminClient.app_profile_path project_id, instance_id, app_profile_id
         end
 
+        ##
         # Inspects the service object.
         # @return [String]
-
+        #
         def inspect
           "#{self.class}(#{@project_id})"
         end