google-cloud-spanner 1.6.1 → 1.6.2

data/lib/google/cloud/spanner/database/job.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 require "google/cloud/spanner/status"
 
 module Google

data/lib/google/cloud/spanner/instance/job.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 require "google/cloud/spanner/status"
 
 module Google

data/lib/google/cloud/spanner/v1/credentials.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 require "googleauth"
 
 module Google

data/lib/google/cloud/spanner/v1/doc/google/protobuf/duration.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Protobuf
     # A Duration represents a signed, fixed-length span of time represented

data/lib/google/cloud/spanner/v1/doc/google/protobuf/empty.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Protobuf
     # A generic empty message that you can re-use to avoid defining duplicated

data/lib/google/cloud/spanner/v1/doc/google/protobuf/struct.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Protobuf
     # +Struct+ represents a structured data value, consisting of fields

data/lib/google/cloud/spanner/v1/doc/google/protobuf/timestamp.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Protobuf
     # A Timestamp represents a point in time independent of any time zone
@@ -72,12 +73,14 @@ module Google
     #
     # In JSON format, the Timestamp type is encoded as a string in the
     # [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. That is, the
-    # format is "{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z"
-    # where {year} is always expressed using four digits while {month}, {day},
-    # {hour}, {min}, and {sec} are zero-padded to two digits each. The fractional
+    # format is "\\{year}-\\{month}-\\{day}T\\{hour}:\\{min}:\\{sec}[.\\{frac_sec}]Z"
+    # where \\{year} is always expressed using four digits while \\{month}, \\{day},
+    # \\{hour}, \\{min}, and \\{sec} are zero-padded to two digits each. The fractional
     # seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution),
     # are optional. The "Z" suffix indicates the timezone ("UTC"); the timezone
-    # is required, though only UTC (as indicated by "Z") is presently supported.
+    # is required. A proto3 JSON serializer should always use UTC (as indicated by
+    # "Z") when printing the Timestamp type and a proto3 JSON parser should be
+    # able to accept both UTC and other timezones (as indicated by an offset).
     #
     # For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past
     # 01:30 UTC on January 15, 2017.
@@ -88,8 +91,8 @@ module Google
     # to this format using [+strftime+](https://docs.python.org/2/library/time.html#time.strftime)
     # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
     # can use the Joda Time's [+ISODateTimeFormat.dateTime()+](
-    # http://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime())
-    # to obtain a formatter capable of generating timestamps in this format.
+    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime--
+    # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [Integer]
     #     Represents seconds of UTC time since Unix epoch

data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/keys.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Spanner
     module V1

data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/mutation.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Spanner
     module V1

data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/query_plan.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Spanner
     module V1

data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/result_set.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Spanner
     module V1

data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/spanner.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Spanner
     module V1

data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/transaction.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Spanner
     module V1

data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/type.rb

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 module Google
   module Spanner
     module V1

data/lib/google/cloud/spanner/v1/spanner_client.rb

@@ -19,6 +19,7 @@
 # For the short term, the refresh process will only be runnable by Google
 # engineers.
 
+
 require "json"
 require "pathname"
 
@@ -39,6 +40,7 @@ module Google
         # @!attribute [r] spanner_stub
         #   @return [Google::Spanner::V1::Spanner::Stub]
         class SpannerClient
+          # @private
           attr_reader :spanner_stub
 
           # The default address of the service.
@@ -316,9 +318,9 @@ module Google
           # @return [Google::Spanner::V1::Session]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/spanner"
+          #   require "google/cloud/spanner/v1"
           #
-          #   spanner_client = Google::Cloud::Spanner.new(version: :v1)
+          #   spanner_client = Google::Cloud::Spanner::V1::SpannerClient.new
           #   formatted_database = Google::Cloud::Spanner::V1::SpannerClient.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
           #   response = spanner_client.create_session(formatted_database)
 
@@ -350,9 +352,9 @@ module Google
           # @return [Google::Spanner::V1::Session]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/spanner"
+          #   require "google/cloud/spanner/v1"
           #
-          #   spanner_client = Google::Cloud::Spanner.new(version: :v1)
+          #   spanner_client = Google::Cloud::Spanner::V1::SpannerClient.new
           #   formatted_name = Google::Cloud::Spanner::V1::SpannerClient.session_path("[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]")
           #   response = spanner_client.get_session(formatted_name)
 
@@ -401,9 +403,9 @@ module Google
           #   object.
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/spanner"
+          #   require "google/cloud/spanner/v1"
           #
-          #   spanner_client = Google::Cloud::Spanner.new(version: :v1)
+          #   spanner_client = Google::Cloud::Spanner::V1::SpannerClient.new
           #   formatted_database = Google::Cloud::Spanner::V1::SpannerClient.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
           #
           #   # Iterate over all results.
@@ -446,9 +448,9 @@ module Google
           # @yieldparam operation [GRPC::ActiveCall::Operation]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/spanner"
+          #   require "google/cloud/spanner/v1"
           #
-          #   spanner_client = Google::Cloud::Spanner.new(version: :v1)
+          #   spanner_client = Google::Cloud::Spanner::V1::SpannerClient.new
           #   formatted_name = Google::Cloud::Spanner::V1::SpannerClient.session_path("[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]")
           #   spanner_client.delete_session(formatted_name)
 
@@ -538,9 +540,9 @@ module Google
           # @return [Google::Spanner::V1::ResultSet]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/spanner"
+          #   require "google/cloud/spanner/v1"
           #
-          #   spanner_client = Google::Cloud::Spanner.new(version: :v1)
+          #   spanner_client = Google::Cloud::Spanner::V1::SpannerClient.new
           #   formatted_session = Google::Cloud::Spanner::V1::SpannerClient.session_path("[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]")
           #
           #   # TODO: Initialize +sql+:
@@ -639,9 +641,9 @@ module Google
           #
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/spanner"
+          #   require "google/cloud/spanner/v1"
           #
-          #   spanner_client = Google::Cloud::Spanner.new(version: :v1)
+          #   spanner_client = Google::Cloud::Spanner::V1::SpannerClient.new
           #   formatted_session = Google::Cloud::Spanner::V1::SpannerClient.session_path("[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]")
           #
           #   # TODO: Initialize +sql+:
@@ -744,9 +746,9 @@ module Google
           # @return [Google::Spanner::V1::ResultSet]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/spanner"
+          #   require "google/cloud/spanner/v1"
           #
-          #   spanner_client = Google::Cloud::Spanner.new(version: :v1)
+          #   spanner_client = Google::Cloud::Spanner::V1::SpannerClient.new
           #   formatted_session = Google::Cloud::Spanner::V1::SpannerClient.session_path("[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]")
           #
           #   # TODO: Initialize +table+:
@@ -847,9 +849,9 @@ module Google
           #
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/spanner"
+          #   require "google/cloud/spanner/v1"
           #
-          #   spanner_client = Google::Cloud::Spanner.new(version: :v1)
+          #   spanner_client = Google::Cloud::Spanner::V1::SpannerClient.new
           #   formatted_session = Google::Cloud::Spanner::V1::SpannerClient.session_path("[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]")
           #
           #   # TODO: Initialize +table+:
@@ -910,9 +912,9 @@ module Google
           # @return [Google::Spanner::V1::Transaction]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/spanner"
+          #   require "google/cloud/spanner/v1"
           #
-          #   spanner_client = Google::Cloud::Spanner.new(version: :v1)
+          #   spanner_client = Google::Cloud::Spanner::V1::SpannerClient.new
           #   formatted_session = Google::Cloud::Spanner::V1::SpannerClient.session_path("[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]")
           #
           #   # TODO: Initialize +options_+:
@@ -972,9 +974,9 @@ module Google
           # @return [Google::Spanner::V1::CommitResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/spanner"
+          #   require "google/cloud/spanner/v1"
           #
-          #   spanner_client = Google::Cloud::Spanner.new(version: :v1)
+          #   spanner_client = Google::Cloud::Spanner::V1::SpannerClient.new
           #   formatted_session = Google::Cloud::Spanner::V1::SpannerClient.session_path("[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]")
           #
           #   # TODO: Initialize +mutations+:
@@ -1019,9 +1021,9 @@ module Google
           # @yieldparam operation [GRPC::ActiveCall::Operation]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/spanner"
+          #   require "google/cloud/spanner/v1"
           #
-          #   spanner_client = Google::Cloud::Spanner.new(version: :v1)
+          #   spanner_client = Google::Cloud::Spanner::V1::SpannerClient.new
           #   formatted_session = Google::Cloud::Spanner::V1::SpannerClient.session_path("[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]")
           #
           #   # TODO: Initialize +transaction_id+:
@@ -1106,9 +1108,9 @@ module Google
           # @return [Google::Spanner::V1::PartitionResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/spanner"
+          #   require "google/cloud/spanner/v1"
           #
-          #   spanner_client = Google::Cloud::Spanner.new(version: :v1)
+          #   spanner_client = Google::Cloud::Spanner::V1::SpannerClient.new
           #   formatted_session = Google::Cloud::Spanner::V1::SpannerClient.session_path("[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]")
           #
           #   # TODO: Initialize +sql+:
@@ -1184,9 +1186,9 @@ module Google
           # @return [Google::Spanner::V1::PartitionResponse]
           # @raise [Google::Gax::GaxError] if the RPC is aborted.
           # @example
-          #   require "google/cloud/spanner"
+          #   require "google/cloud/spanner/v1"
           #
-          #   spanner_client = Google::Cloud::Spanner.new(version: :v1)
+          #   spanner_client = Google::Cloud::Spanner::V1::SpannerClient.new
           #   formatted_session = Google::Cloud::Spanner::V1::SpannerClient.session_path("[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]")
           #
           #   # TODO: Initialize +table+:

data/lib/google/cloud/spanner/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Spanner
-      VERSION = "1.6.1".freeze
+      VERSION = "1.6.2".freeze
     end
   end
 end

data/lib/google/spanner/admin/database/v1/spanner_database_admin_pb.rb

@@ -1,10 +1,10 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/admin/database/v1/spanner_database_admin.proto
 
+
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
-require 'google/api/auth_pb'
 require 'google/iam/v1/iam_policy_pb'
 require 'google/iam/v1/policy_pb'
 require 'google/longrunning/operations_pb'

data/lib/google/spanner/admin/database/v1/spanner_database_admin_services_pb.rb

@@ -1,13 +1,13 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/spanner/admin/database/v1/spanner_database_admin.proto for package 'google.spanner.admin.database.v1'
 # Original file comments:
-# Copyright 2017 Google Inc.
+# Copyright 2018 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
 #
-#     https://www.apache.org/licenses/LICENSE-2.0
+#     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,
@@ -16,6 +16,7 @@
 # limitations under the License.
 #
 
+
 require 'grpc'
 require 'google/spanner/admin/database/v1/spanner_database_admin_pb'
 

data/lib/google/spanner/admin/instance/v1/spanner_instance_admin_pb.rb

@@ -1,10 +1,10 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/admin/instance/v1/spanner_instance_admin.proto
 
+
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
-require 'google/api/auth_pb'
 require 'google/iam/v1/iam_policy_pb'
 require 'google/iam/v1/policy_pb'
 require 'google/longrunning/operations_pb'

data/lib/google/spanner/admin/instance/v1/spanner_instance_admin_services_pb.rb

@@ -1,13 +1,13 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/spanner/admin/instance/v1/spanner_instance_admin.proto for package 'google.spanner.admin.instance.v1'
 # Original file comments:
-# Copyright 2017 Google Inc.
+# Copyright 2018 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
 #
-#     https://www.apache.org/licenses/LICENSE-2.0
+#     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,
@@ -16,6 +16,7 @@
 # limitations under the License.
 #
 
+
 require 'grpc'
 require 'google/spanner/admin/instance/v1/spanner_instance_admin_pb'
 

data/lib/google/spanner/v1/keys_pb.rb

@@ -1,6 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/v1/keys.proto
 
+
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'

data/lib/google/spanner/v1/mutation_pb.rb

@@ -1,6 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/v1/mutation.proto
 
+
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'

data/lib/google/spanner/v1/query_plan_pb.rb

@@ -1,6 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/v1/query_plan.proto
 
+
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'

data/lib/google/spanner/v1/result_set_pb.rb

@@ -1,6 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/v1/result_set.proto
 
+
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'

data/lib/google/spanner/v1/spanner_pb.rb

@@ -1,6 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/v1/spanner.proto
 
+
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'