gapic-generator-cloud 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac86ed068a512a634033c1c1d15336857f9d3cc4fdc3818e37d339dc80df7814
-  data.tar.gz: 19553dab1dc41089de60dd030760e362d14335575283f8d3229acfeb018c4615
+  metadata.gz: 417ab2b02d4393ee7aa32224d20f1b8d6bf9408bd9c3e54bb834e98de4e66f5d
+  data.tar.gz: b5059c5c751d1c0b2628879a8c91503fa2a468c75e5df5224d361657dca7956c
 SHA512:
-  metadata.gz: 014b1551a395518c0da9182cda3d183040af720bb47079c68325597bb44baa251a634c697feacd19fdf20ec53430837a6efbd36bc75f8d8214d44ba4b4a0c7fb
-  data.tar.gz: 398bc287670e347e178c6e7e84c604866162e1e69733cdc72311ef98832c9a783b8956a14f9695d5a178117dbfb01d260eb5e45d2717fa2997d9233fa6b13724
+  metadata.gz: 7948811d0ae712c0020828aa4609db23891c7d99d1c5f84c6e5c956f2b432920d49c75c790824014e49318a026bf90a70e5ad5fe667cad89902e1b0387e3be29
+  data.tar.gz: 00a19859f19ae6688ec50aacd1bd0991fbfec3f2e59858c4513e73ed35d911db4a649ad36a9bf021599d20130f1b9f006e4d0a4c085f33586dcd84827c676c8a

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release History for gapic-generator-cloud
 
+### 0.9.0 / 2021-06-29
+
+* Includes changes from gapic-generator 0.9.0
+
 ### 0.8.0 / 2021-06-16
 
 * Includes changes from gapic-generator 0.8.0

data/lib/gapic/generator/cloud/version.rb

@@ -18,7 +18,7 @@
 module Gapic
   module Generator
     module Cloud
-      VERSION = "0.8.0"
+      VERSION = "0.9.0"
     end
   end
 end

data/lib/gapic/generators/cloud_generator_parameters.rb

@@ -42,6 +42,8 @@ module Gapic
         "ruby-cloud-api-id"                => ":gem.:api_id",
         "ruby-cloud-api-shortname"         => ":gem.:api_shortname",
         "ruby-cloud-factory-method-suffix" => ":gem.:factory_method_suffix",
+        "ruby-cloud-quick-start-service"   => ":gem.:quick_start_service",
+        "ruby-cloud-quick-start-method"    => ":gem.:quick_start_method",
         "ruby-cloud-default-service-host"  => ":defaults.:service.:default_host",
         "ruby-cloud-grpc-service-config"   => "grpc_service_config",
         "ruby-cloud-wrapper-gem-override"  => ":overrides.:wrapper_gem_name"

data/lib/gapic/presenters/cloud_gem_presenter.rb

@@ -77,6 +77,10 @@ module Gapic
         desc
       end
 
+      def cloud_env_prefix
+        env_prefix || "GOOGLE_CLOUD"
+      end
+
       ##
       # Returns a hash of extra generator arguments to be rendered into the
       # repo-metadata.json file.
@@ -84,12 +88,14 @@ module Gapic
       def generator_args_for_metadata
         result = {}
         result["ruby-cloud-description"] = description
-        result["ruby-cloud-env-prefix"] = env_prefix
+        result["ruby-cloud-env-prefix"] = env_prefix if env_prefix
         result["ruby-cloud-product-url"] = product_documentation_url if product_documentation_url
         path_overrides = @api.overrides_of(:file_path).map { |k, v| "#{k}=#{v}" }.join ";"
         result["ruby-cloud-path-override"] = path_overrides unless path_overrides.empty?
         namespace_overrides = @api.overrides_of(:namespace).map { |k, v| "#{k}=#{v}" }.join ";"
         result["ruby-cloud-namespace-override"] = namespace_overrides unless namespace_overrides.empty?
+        service_overrides = @api.overrides_of(:service).map { |k, v| "#{k}=#{v}" }.join ";"
+        result["ruby-cloud-service-override"] = service_overrides unless service_overrides.empty?
         result
       end
     end

data/lib/gapic/presenters/wrapper_gem_presenter.rb

@@ -107,9 +107,18 @@ module Gapic
 
       def dependencies
         @dependencies ||= begin
-          deps = { "google-cloud-core" => "~> 1.5" }
+          deps = { "google-cloud-core" => "~> 1.6" }
           version_dependencies.each do |version, requirement|
-            deps["#{name}-#{version}"] = "~> #{requirement}"
+            # For pre-release dependencies on versioned clients, support both
+            # 0.x and 1.x versions to ease the transition to 1.0 (GA) releases
+            # for those dependencies. (Note the 0.x->1.0 transition is
+            # generally not breaking.)
+            deps["#{name}-#{version}"] =
+              if requirement.start_with? "0."
+                [">= #{requirement}", "< 2.a"]
+              else
+                "~> #{requirement}"
+              end
           end
           extra_deps = gem_config_dependencies
           deps.merge! extra_deps if extra_deps

data/templates/cloud/gem/authentication.erb

@@ -22,7 +22,7 @@ during development.
 2. Set the [environment variable](#environment-variables).
 
 ```sh
-export <%= gem.env_prefix %>_CREDENTIALS=path/to/keyfile.json
+export <%= gem.cloud_env_prefix %>_CREDENTIALS=path/to/keyfile.json
 ```
 
 3. Initialize the client.
@@ -69,16 +69,18 @@ The environment variables that <%= gem.name %>
 checks for credentials are configured on the service Credentials class (such as
 <%= service.credentials_class_xref %>):
 
-1. `<%= gem.env_prefix %>_CREDENTIALS` - Path to JSON file, or JSON contents
-2. `<%= gem.env_prefix %>_KEYFILE` - Path to JSON file, or JSON contents
-3. `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
-4. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
-5. `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
+<%- if gem.env_prefix -%>
+* `<%= gem.env_prefix %>_CREDENTIALS` - Path to JSON file, or JSON contents
+* `<%= gem.env_prefix %>_KEYFILE` - Path to JSON file, or JSON contents
+<%- end -%>
+* `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
+* `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
+* `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
 
 ```ruby
 require "<%= gem.entrypoint_require %>"
 
-ENV["<%= gem.env_prefix %>_CREDENTIALS"] = "path/to/keyfile.json"
+ENV["<%= gem.cloud_env_prefix %>_CREDENTIALS"] = "path/to/keyfile.json"
 
 client = <%= service.create_client_call %>
 ```

data/templates/cloud/gem/rakefile.erb

@@ -56,29 +56,29 @@ task :acceptance, :project, :keyfile do |t, args|
   <%- if service && !gem.generic_endpoint? -%>
   project = args[:project]
   project ||=
-    ENV["<%= gem.env_prefix %>_TEST_PROJECT"] ||
+    ENV["<%= gem.cloud_env_prefix %>_TEST_PROJECT"] ||
     ENV["GCLOUD_TEST_PROJECT"]
   keyfile = args[:keyfile]
   keyfile ||=
-    ENV["<%= gem.env_prefix %>_TEST_KEYFILE"] ||
+    ENV["<%= gem.cloud_env_prefix %>_TEST_KEYFILE"] ||
     ENV["GCLOUD_TEST_KEYFILE"]
   if keyfile
     keyfile = File.read keyfile
   else
     keyfile ||=
-      ENV["<%= gem.env_prefix %>_TEST_KEYFILE_JSON"] ||
+      ENV["<%= gem.cloud_env_prefix %>_TEST_KEYFILE_JSON"] ||
       ENV["GCLOUD_TEST_KEYFILE_JSON"]
   end
   if project.nil? || keyfile.nil?
-    fail "You must provide a project and keyfile. e.g. rake acceptance[test123, /path/to/keyfile.json] or <%= gem.env_prefix %>_TEST_PROJECT=test123 <%= gem.env_prefix %>_TEST_KEYFILE=/path/to/keyfile.json rake acceptance"
+    fail "You must provide a project and keyfile. e.g. rake acceptance[test123, /path/to/keyfile.json] or <%= gem.cloud_env_prefix %>_TEST_PROJECT=test123 <%= gem.cloud_env_prefix %>_TEST_KEYFILE=/path/to/keyfile.json rake acceptance"
   end
   require "<%= service.credentials_require %>"
   <%= service.credentials_name_full %>.env_vars.each do |path|
     ENV[path] = nil
   end
-  ENV["<%= gem.env_prefix %>_PROJECT"] = project
-  ENV["<%= gem.env_prefix %>_TEST_PROJECT"] = project
-  ENV["<%= gem.env_prefix %>_KEYFILE_JSON"] = keyfile
+  ENV["<%= gem.cloud_env_prefix %>_PROJECT"] = project
+  ENV["<%= gem.cloud_env_prefix %>_TEST_PROJECT"] = project
+  ENV["<%= gem.cloud_env_prefix %>_KEYFILE_JSON"] = keyfile
 
   <%- end -%>
   Rake::Task["acceptance:run"].invoke

data/templates/cloud/gem/readme.erb

@@ -44,12 +44,12 @@ In order to use this library, you first need to go through the following steps:
 <%- if gem.packages? -%>
 ```ruby
 require "<%= gem.entrypoint_require %>"
-<%- service = gem.first_non_common_service -%>
-<%- method = service&.methods.first -%>
+<%- service = gem.quick_start_service -%>
+<%- method = service&.quick_start_method -%>
 <%- if service && method -%>
 
 client = <%= service.create_client_call %>
-request = my_create_request
+request = <%= method.request_type %>.new # (request fields as keyword arguments...)
 response = client.<%= method.name %> request
 <%- end -%>
 ```

data/templates/cloud/service/client/_credentials.erb

@@ -13,13 +13,17 @@ class <%= service.credentials_name %> < ::Google::Auth::Credentials
   ]
   <%- end -%>
   self.env_vars = [
+    <%- if service.gem.env_prefix -%>
     "<%= service.gem.env_prefix %>_CREDENTIALS",
     "<%= service.gem.env_prefix %>_KEYFILE",
+    <%- end -%>
     "GOOGLE_CLOUD_CREDENTIALS",
     "GOOGLE_CLOUD_KEYFILE",
     "GCLOUD_KEYFILE",
+    <%- if service.gem.env_prefix -%>
     "<%= service.gem.env_prefix %>_CREDENTIALS_JSON",
     "<%= service.gem.env_prefix %>_KEYFILE_JSON",
+    <%- end -%>
     "GOOGLE_CLOUD_CREDENTIALS_JSON",
     "GOOGLE_CLOUD_KEYFILE_JSON",
     "GCLOUD_KEYFILE_JSON"

data/templates/cloud/wrapper_gem/rakefile.erb

@@ -56,29 +56,29 @@ desc "Run the <%= gem.name %> acceptance tests."
 task :acceptance, :project, :keyfile do |t, args|
   project = args[:project]
   project ||=
-    ENV["<%= gem.env_prefix %>_TEST_PROJECT"] ||
+    ENV["<%= gem.cloud_env_prefix %>_TEST_PROJECT"] ||
     ENV["GCLOUD_TEST_PROJECT"]
   keyfile = args[:keyfile]
   keyfile ||=
-    ENV["<%= gem.env_prefix %>_TEST_KEYFILE"] ||
+    ENV["<%= gem.cloud_env_prefix %>_TEST_KEYFILE"] ||
     ENV["GCLOUD_TEST_KEYFILE"]
   if keyfile
     keyfile = File.read keyfile
   else
     keyfile ||=
-      ENV["<%= gem.env_prefix %>_TEST_KEYFILE_JSON"] ||
+      ENV["<%= gem.cloud_env_prefix %>_TEST_KEYFILE_JSON"] ||
       ENV["GCLOUD_TEST_KEYFILE_JSON"]
   end
   if project.nil? || keyfile.nil?
-    fail "You must provide a project and keyfile. e.g. rake acceptance[test123, /path/to/keyfile.json] or <%= gem.env_prefix %>_TEST_PROJECT=test123 <%= gem.env_prefix %>_TEST_KEYFILE=/path/to/keyfile.json rake acceptance"
+    fail "You must provide a project and keyfile. e.g. rake acceptance[test123, /path/to/keyfile.json] or <%= gem.cloud_env_prefix %>_TEST_PROJECT=test123 <%= gem.cloud_env_prefix %>_TEST_KEYFILE=/path/to/keyfile.json rake acceptance"
   end
   require "<%= service.credentials_require %>"
   <%= service.credentials_name_full %>.env_vars.each do |path|
     ENV[path] = nil
   end
-  ENV["<%= gem.env_prefix %>_PROJECT"] = project
-  ENV["<%= gem.env_prefix %>_TEST_PROJECT"] = project
-  ENV["<%= gem.env_prefix %>_KEYFILE_JSON"] = keyfile
+  ENV["<%= gem.cloud_env_prefix %>_PROJECT"] = project
+  ENV["<%= gem.cloud_env_prefix %>_TEST_PROJECT"] = project
+  ENV["<%= gem.cloud_env_prefix %>_KEYFILE_JSON"] = keyfile
 
   Rake::Task["acceptance:run"].invoke
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gapic-generator-cloud
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Ernest Landrito
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-06-16 00:00:00.000000000 Z
+date: 2021-06-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -32,14 +32,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.8.0
+        version: 0.9.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.8.0
+        version: 0.9.0
 - !ruby/object:Gem::Dependency
   name: google-style
   requirement: !ruby/object:Gem::Requirement