google-cloud-core 1.2.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd3cf2a2e538cb37ffd2daae810180a7cf19dcad051f1fdce8d6b6c6dd13a566
-  data.tar.gz: e197ffcd7a014052eaeabba0f744ce0c3c86da7be88639bd9e91338eb122b7e4
+  metadata.gz: e0b557c72656343a1c1931542cd9cd3a3bd1fd5a82fb786c8c6468071cfefe41
+  data.tar.gz: 620d60ecc70baba4ed88cbea048764ae4a47307b8d87f3e184aa3f0999970b60
 SHA512:
-  metadata.gz: 27e11063ff53977170fa53a5559d272ac324225ee0ee9bc85f2b696b5b6f31f0719b605283eae7b73d12808a8326a97f9dd5308d89fab5b89df22dac5fdca8b3
-  data.tar.gz: 4ba78b2ef42de56f09660dd30c40eee1fcd7c74a6ba5c57fc126dcd05cb9af59e9087caa8f9745a44f8e332c67a6e8b16252ef8f600655ff811c74314635011b
+  metadata.gz: 9fcf42cc101c71d111ad06b9f50af49715cff12264a42353edb64304dc4b54c8bec2d9f5069937eff73c21dc0f31ad03181ac42606a32266f1c7c5fb6bac2fe3
+  data.tar.gz: 9f52bf6b7aa21cf5b14d03e5097eb389296943cdab0619f9596f1ba819ea10fadea3e940dabb82b0c3897010a0e7c54b7d0e4b53fa100ab5ed0558f75424ffd0

data/README.md

@@ -6,7 +6,14 @@ This library contains shared types, such as error classes, for the google-cloud
 
 ## Supported Ruby Versions
 
-This library is supported on Ruby 2.0+.
+This library is currently supported on Ruby 2.0+.
+
+However, Ruby 2.3 or later is strongly recommended, as earlier releases have
+reached or are nearing end-of-life. After June 1, 2018, Google will provide
+official support only for Ruby versions that are considered current and
+supported by Ruby Core (that is, Ruby versions that are either in normal
+maintenance or in security maintenance).
+See https://www.ruby-lang.org/en/downloads/branches/ for further details.
 
 ## Versioning
 

data/lib/google/cloud.rb

@@ -96,28 +96,112 @@ module Google
 
       @config
     end
+
+    ##
+    # Initialize toplevel configuration
+    # @private
+    #
+    def self.init_configuration
+      configure do |config|
+        default_project = Google::Cloud::Config.deferred do
+          ENV["GOOGLE_CLOUD_PROJECT"] || ENV["GCLOUD_PROJECT"]
+        end
+        default_creds = Google::Cloud::Config.deferred do
+          Google::Cloud::Config.credentials_from_env \
+            "GOOGLE_CLOUD_CREDENTIALS", "GOOGLE_CLOUD_CREDENTIALS_JSON",
+            "GOOGLE_CLOUD_KEYFILE", "GOOGLE_CLOUD_KEYFILE_JSON",
+            "GCLOUD_KEYFILE", "GCLOUD_KEYFILE_JSON"
+        end
+
+        config.add_field! :project_id, default_project,
+                          match: String, allow_nil: true
+        config.add_alias! :project, :project_id
+        config.add_field! :credentials, default_creds, match: Object
+        config.add_alias! :keyfile, :credentials
+      end
+    end
+
+    # In June, 2018, set supported version to 2.3 and recommended to 2.4.
+    # Thereafter, follow the MRI support schedule: supported means non-EOL,
+    # and recommended means in normal (rather than security) maintenance.
+    # See https://www.ruby-lang.org/en/downloads/branches/
+
+    ##
+    # Minimum "supported" Ruby version (non-EOL)
+    # @private
+    #
+    SUPPORTED_VERSION_THRESHOLD = "2.0".freeze
+
+    ##
+    # Minimum "recommended" Ruby version (normal maintenance)
+    # @private
+    #
+    RECOMMENDED_VERSION_THRESHOLD = "2.3".freeze
+
+    ##
+    # Check Ruby version and emit a warning if it is old
+    # @private
+    #
+    def self.warn_on_old_ruby_version \
+        supported_version: SUPPORTED_VERSION_THRESHOLD,
+        recommended_version: RECOMMENDED_VERSION_THRESHOLD
+      return if ENV["GOOGLE_CLOUD_SUPPRESS_RUBY_WARNINGS"]
+      cur_version = Gem::Version.new RUBY_VERSION
+      if cur_version < Gem::Version.new(supported_version)
+        warn_unsupported_ruby cur_version, recommended_version
+      elsif cur_version < Gem::Version.new(recommended_version)
+        warn_nonrecommended_ruby cur_version, recommended_version
+      end
+    rescue ArgumentError
+      warn "Unable to determine current Ruby version."
+    end
+
+    ##
+    # Print a warning for an EOL version of Ruby
+    # @private
+    #
+    def self.warn_unsupported_ruby cur_version, recommended_version
+      warn "WARNING: You are running Ruby #{cur_version}, which has reached" \
+        " end-of-life and is no longer supported by Ruby Core."
+      warn "The Google Cloud API clients work best on supported versions of" \
+        " Ruby. It is strongly recommended that you upgrade to Ruby" \
+        " #{recommended_version} or later."
+      warn "See https://www.ruby-lang.org/en/downloads/branches/ for more" \
+        " info on the Ruby maintenance schedule."
+      warn "To suppress this message, set the" \
+        " GOOGLE_CLOUD_SUPPRESS_RUBY_WARNINGS environment variable."
+    end
+
+    ##
+    # Print a warning for a supported but nearing EOL version of Ruby
+    # @private
+    #
+    def self.warn_nonrecommended_ruby cur_version, recommended_version
+      warn "WARNING: You are running Ruby #{cur_version}, which is nearing" \
+        " end-of-life."
+      warn "The Google Cloud API clients work best on supported versions of" \
+        " Ruby. Consider upgrading to Ruby #{recommended_version} or later."
+      warn "See https://www.ruby-lang.org/en/downloads/branches/ for more" \
+        " info on the Ruby maintenance schedule."
+      warn "To suppress this message, set the" \
+        " GOOGLE_CLOUD_SUPPRESS_RUBY_WARNINGS environment variable."
+    end
   end
 end
 
 # Set the default top-level configuration
-Google::Cloud.configure do |config|
-  default_project = Google::Cloud::Config.deferred do
-    ENV["GOOGLE_CLOUD_PROJECT"] || ENV["GCLOUD_PROJECT"]
-  end
-  default_creds = Google::Cloud::Config.deferred do
-    Google::Cloud::Config.credentials_from_env \
-      "GOOGLE_CLOUD_CREDENTIALS", "GOOGLE_CLOUD_CREDENTIALS_JSON",
-      "GOOGLE_CLOUD_KEYFILE", "GOOGLE_CLOUD_KEYFILE_JSON",
-      "GCLOUD_KEYFILE", "GCLOUD_KEYFILE_JSON"
-  end
+Google::Cloud.init_configuration
 
-  config.add_field! :project_id, default_project, match: String, allow_nil: true
-  config.add_alias! :project, :project_id
-  config.add_field! :credentials, default_creds, match: Object
-  config.add_alias! :keyfile, :credentials
-end
+# Emit a warning if current Ruby is at or nearing end-of-life
+Google::Cloud.warn_on_old_ruby_version
 
 # Auto-load all Google Cloud service gems.
-Gem.find_files("google-cloud-*.rb").each do |google_cloud_service|
+auto_load_files = if Gem.respond_to? :find_latest_files
+                    Gem.find_latest_files "google-cloud-*.rb"
+                  else
+                    # Ruby 2.0 does not have Gem.find_latest_files
+                    Gem.find_files "google-cloud-*.rb"
+                  end
+auto_load_files.each do |google_cloud_service|
   require google_cloud_service
 end

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Core
-      VERSION = "1.2.0".freeze
+      VERSION = "1.2.1".freeze
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-core
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.2.1
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-02-27 00:00:00.000000000 Z
+date: 2018-06-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-env
@@ -187,7 +187,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 2.7.7
 signing_key: 
 specification_version: 4
 summary: Internal shared library for google-cloud-ruby