gcloud 0.23.1 → 0.24.1

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d3cf8ba1dccb9950c803776c918c0985228ab94cb589aed974a5ef388926d832
4
- data.tar.gz: 03bad25de2fb6d969bd10abe029c3a93fd00e2f7592d75b58e9e05c2d926067d
3
+ metadata.gz: f2adbc7d818492b1950f5e7ab3e31ee8243af33843cc39bb5c91d0e64b01beea
4
+ data.tar.gz: 4a63a715dd20026f0ec5f05de9c0ec5a6f49478ab040ff2def8e0bb151a8be30
5
5
  SHA512:
6
- metadata.gz: 5b0a5fbca6bdec5d08d431eddadbe3497cf7e1bfbb43df0ef7748e948b44ecc74e4f061a2800007bd0a57651a4b2c716b0b9aa5c61b81543679ef8aaf27f8c53
7
- data.tar.gz: 9faf47abc18e200106f806eaefb97c6027d15da35ebbb3ee17ae6cc3fbc1ce12fc88daef447834c6c48852fdb835a90b299dbd17d990f650f1b58df4ef3e6a10
6
+ metadata.gz: 9ce09288bec20b3382916752dc5f81d5d2d82e41f9c0f1086e4f5846abdeb8ad292f2b6403764ed6a4dd4865634a594374858f6fdea76decba51f3e82c4fc154
7
+ data.tar.gz: 8c73e037d0aa708d92754289f70768f54d65e1453a1670516d3245fb8141b76d2d5360ae44a684918468000b02641dea261d2e6879eadbb4ddbf427344f229e9
@@ -0,0 +1,41 @@
1
+ ## With `google-cloud-ruby`
2
+
3
+ With `google-cloud-ruby` it's incredibly easy to get authenticated and start using Google's APIs. You can set your credentials on a global basis as well as on a per-API basis.
4
+
5
+ ### Google Cloud Platform environments
6
+
7
+ While running on Google Cloud Platform (GCP), including Google Compute Engine (GCE), Google Kubernetes Engine (GKE), Google App Engine (GAE), Google Cloud Functions (GCF) and Cloud Run, no extra work is needed. The **Project ID** and **Credentials** and are discovered automatically. Code should be written as if already authenticated.
8
+
9
+ ### Project and Credential Lookup
10
+
11
+ The google-cloud library aims to make authentication as simple as possible, and provides several mechanisms to configure your system without providing **Project ID** and **Service Account Credentials** directly in code.
12
+
13
+ **Project ID** is discovered in the following order:
14
+
15
+ 1. Specify project ID in code
16
+ 2. Discover project ID in environment variables
17
+ 3. Discover GCE project ID
18
+
19
+ **Credentials** are discovered in the following order:
20
+
21
+ 1. Specify credentials in code
22
+ 2. Discover credentials path in environment variables
23
+ 3. Discover credentials JSON in environment variables
24
+ 4. Discover credentials file in the Cloud SDK's path
25
+ 5. Discover GCE credentials
26
+
27
+ ### Environment Variables
28
+
29
+ The **Project ID** and **Credentials JSON** can be placed in environment variables instead of declaring them directly in code. Each service has its own environment variable, allowing for different service accounts to be used for different services. The path to the **Credentials JSON** file can be stored in the environment variable, or the **Credentials JSON** itself can be stored for environments such as Docker containers where writing files is difficult or not encouraged.
30
+
31
+ Here are the environment variables (in the order they are checked) for project ID:
32
+
33
+ 1. `GOOGLE_CLOUD_PROJECT`
34
+
35
+ Here are the environment variables (in the order they are checked) for credentials:
36
+
37
+ 1. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file
38
+ 2. `GOOGLE_CLOUD_KEYFILE_JSON` - JSON contents
39
+
40
+
41
+
@@ -0,0 +1,40 @@
1
+ # Contributor Code of Conduct
2
+
3
+ As contributors and maintainers of this project, and in the interest of
4
+ fostering an open and welcoming community, we pledge to respect all people who
5
+ contribute through reporting issues, posting feature requests, updating
6
+ documentation, submitting pull requests or patches, and other activities.
7
+
8
+ We are committed to making participation in this project a harassment-free
9
+ experience for everyone, regardless of level of experience, gender, gender
10
+ identity and expression, sexual orientation, disability, personal appearance,
11
+ body size, race, ethnicity, age, religion, or nationality.
12
+
13
+ Examples of unacceptable behavior by participants include:
14
+
15
+ * The use of sexualized language or imagery
16
+ * Personal attacks
17
+ * Trolling or insulting/derogatory comments
18
+ * Public or private harassment
19
+ * Publishing other's private information, such as physical or electronic
20
+ addresses, without explicit permission
21
+ * Other unethical or unprofessional conduct.
22
+
23
+ Project maintainers have the right and responsibility to remove, edit, or reject
24
+ comments, commits, code, wiki edits, issues, and other contributions that are
25
+ not aligned to this Code of Conduct. By adopting this Code of Conduct, project
26
+ maintainers commit themselves to fairly and consistently applying these
27
+ principles to every aspect of managing this project. Project maintainers who do
28
+ not follow or enforce the Code of Conduct may be permanently removed from the
29
+ project team.
30
+
31
+ This code of conduct applies both within project spaces and in public spaces
32
+ when an individual is representing the project or its community.
33
+
34
+ Instances of abusive, harassing, or otherwise unacceptable behavior may be
35
+ reported by opening an issue or contacting one or more of the project
36
+ maintainers.
37
+
38
+ This Code of Conduct is adapted from the [Contributor
39
+ Covenant](http://contributor-covenant.org), version 1.2.0, available at
40
+ [http://contributor-covenant.org/version/1/2/0/](http://contributor-covenant.org/version/1/2/0/)
@@ -0,0 +1,141 @@
1
+ # Contributing to Google Cloud
2
+
3
+ 1. **Sign one of the contributor license agreements below.**
4
+ 2. Fork the repo, develop and test your code changes.
5
+ 3. Send a pull request.
6
+
7
+ ## Contributor License Agreements
8
+
9
+ Before we can accept your pull requests you'll need to sign a Contributor
10
+ License Agreement (CLA):
11
+
12
+ - **If you are an individual writing original source code** and **you own the
13
+ intellectual property**, then you'll need to sign an [individual
14
+ CLA](https://developers.google.com/open-source/cla/individual).
15
+ - **If you work for a company that wants to allow you to contribute your work**,
16
+ then you'll need to sign a [corporate
17
+ CLA](https://developers.google.com/open-source/cla/corporate).
18
+
19
+ You can sign these electronically (just scroll to the bottom). After that, we'll
20
+ be able to accept your pull requests.
21
+
22
+ ## Setup
23
+
24
+ In order to use the google-cloud console and run the project's tests,
25
+ there is a small amount of setup:
26
+
27
+ 1. Install Ruby. google-cloud requires Ruby 2.4+. You may choose to
28
+ manage your Ruby and gem installations with [RVM](https://rvm.io/),
29
+ [rbenv](https://github.com/rbenv/rbenv), or
30
+ [chruby](https://github.com/postmodern/chruby).
31
+
32
+ 2. Install [Bundler](http://bundler.io/).
33
+
34
+ ```sh
35
+ $ gem install bundler
36
+ ```
37
+
38
+ 3. Install the top-level project dependencies.
39
+
40
+ ```sh
41
+ $ bundle install
42
+ ```
43
+
44
+ 4. Install the Google Cloud dependencies.
45
+
46
+ ```sh
47
+ $ cd gcloud/
48
+ $ bundle exec rake bundleupdate
49
+ ```
50
+
51
+ ## Console
52
+
53
+ In order to run code interactively, you can automatically load
54
+ google-cloud and its dependencies in IRB. This requires that your
55
+ developer environment has already been configured by following the steps
56
+ described in the {file:AUTHENTICATION.md Authentication Guide}. An IRB console
57
+ can be created with:
58
+
59
+ ```sh
60
+ $ cd gcloud/
61
+ $ bundle exec rake console
62
+ ```
63
+
64
+ ## Google Cloud Tests
65
+
66
+ Tests are very important part of google-cloud. All contributions
67
+ should include tests that ensure the contributed code behaves as expected.
68
+
69
+ To run the unit tests, documentation tests, and code style checks together for a
70
+ package:
71
+
72
+ ``` sh
73
+ $ cd gcloud/
74
+ $ bundle exec rake ci
75
+ ```
76
+
77
+ To run the command above, plus all acceptance tests, use `rake ci:acceptance` or
78
+ its handy alias, `rake ci:a`.
79
+
80
+ ### Google Cloud Unit Tests
81
+
82
+
83
+ The project uses the [minitest](https://github.com/seattlerb/minitest) library,
84
+ including [specs](https://github.com/seattlerb/minitest#specs),
85
+ [mocks](https://github.com/seattlerb/minitest#mocks) and
86
+ [minitest-autotest](https://github.com/seattlerb/minitest-autotest).
87
+
88
+ To run the Google Cloud unit tests:
89
+
90
+ ``` sh
91
+ $ cd gcloud/
92
+ $ bundle exec rake test
93
+ ```
94
+
95
+ ### Google Cloud Documentation Tests
96
+
97
+ The project tests the code examples in the gem's
98
+ [YARD](https://github.com/lsegal/yard)-based documentation.
99
+
100
+ The example testing functions in a way that is very similar to unit testing, and
101
+ in fact the library providing it,
102
+ [yard-doctest](https://github.com/p0deje/yard-doctest), is based on the
103
+ project's unit test library, [minitest](https://github.com/seattlerb/minitest).
104
+
105
+ To run the Google Cloud documentation tests:
106
+
107
+ ``` sh
108
+ $ cd gcloud/
109
+ $ bundle exec rake doctest
110
+ ```
111
+
112
+ If you add, remove or modify documentation examples when working on a pull
113
+ request, you may need to update the setup for the tests. The stubs and mocks
114
+ required to run the tests are located in `support/doctest_helper.rb`. Please
115
+ note that much of the setup is matched by the title of the
116
+ [`@example`](http://www.rubydoc.info/gems/yard/file/docs/Tags.md#example) tag.
117
+ If you alter an example's title, you may encounter breaking tests.
118
+
119
+ ## Coding Style
120
+
121
+ Please follow the established coding style in the library. The style is is
122
+ largely based on [The Ruby Style
123
+ Guide](https://github.com/bbatsov/ruby-style-guide) with a few exceptions based
124
+ on seattle-style:
125
+
126
+ * Avoid parenthesis when possible, including in method definitions.
127
+ * Always use double quotes strings. ([Option
128
+ B](https://github.com/bbatsov/ruby-style-guide#strings))
129
+
130
+ You can check your code against these rules by running Rubocop like so:
131
+
132
+ ```sh
133
+ $ cd gcloud/
134
+ $ bundle exec rake rubocop
135
+ ```
136
+
137
+ ## Code of Conduct
138
+
139
+ Please note that this project is released with a Contributor Code of Conduct. By
140
+ participating in this project you agree to abide by its terms. See
141
+ {file:CODE_OF_CONDUCT.md Code of Conduct} for more information.
data/README.md CHANGED
@@ -5,11 +5,11 @@
5
5
  The current `gcloud` gem exists only to facilitate the timely transition of
6
6
  legacy code from the deprecated `Gcloud` namespace to the new `Google::Cloud`
7
7
  namespace. Please see the [GitHub
8
- repository](https://github.com/GoogleCloudPlatform/google-cloud-ruby) for more
8
+ repository](https://github.com/googleapis/google-cloud-ruby) for more
9
9
  information about using the `google-cloud` umbrella gem and the individual
10
10
  service gems.
11
11
 
12
- - [gcloud API documentation](http://googlecloudplatform.github.io/google-cloud-ruby/docs/gcloud/latest)
12
+ - [gcloud API documentation](https://googleapis.dev/ruby/gcloud/latest)
13
13
  - [gcloud on RubyGems](https://rubygems.org/gems/gcloud)
14
14
 
15
15
  ## Quick Start
@@ -21,7 +21,7 @@ $ gem install gcloud
21
21
  ## Authentication
22
22
 
23
23
  Instructions and configuration options are covered in the [Authentication
24
- Guide](https://googlecloudplatform.github.io/google-cloud-ruby/docs/gcloud/latest/file.AUTHENTICATION).
24
+ Guide](https://googleapis.dev/ruby/gcloud/latest/file.AUTHENTICATION.html).
25
25
 
26
26
  ## Example
27
27
 
@@ -39,11 +39,11 @@ end
39
39
 
40
40
  ## Supported Ruby Versions
41
41
 
42
- This library is supported on Ruby 2.3+.
42
+ This library is supported on Ruby 2.4+.
43
43
 
44
44
  Google provides official support for Ruby versions that are actively supported
45
45
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or in
46
- security maintenance, and not end of life. Currently, this means Ruby 2.3 and
46
+ security maintenance, and not end of life. Currently, this means Ruby 2.4 and
47
47
  later. Older versions of Ruby _may_ still work, but are unsupported and not
48
48
  recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
49
49
  about the Ruby support schedule.
@@ -60,23 +60,23 @@ change at any time and the public API should not be considered stable.
60
60
  Contributions to this library are always welcome and highly encouraged.
61
61
 
62
62
  See the [Contributing
63
- Guide](https://googlecloudplatform.github.io/google-cloud-ruby/docs/gcloud/latest/file.CONTRIBUTING)
63
+ Guide](https://github.com/googleapis/google-cloud-ruby/blob/master/.github/CONTRIBUTING.md)
64
64
  for more information on how to get started.
65
65
 
66
66
  Please note that this project is released with a Contributor Code of Conduct. By
67
67
  participating in this project you agree to abide by its terms. See [Code of
68
- Conduct](https://googlecloudplatform.github.io/google-cloud-ruby/docs/gcloud/latest/file.CODE_OF_CONDUCT)
68
+ Conduct](https://github.com/googleapis/google-cloud-ruby/blob/master/CODE_OF_CONDUCT.md)
69
69
  for more information.
70
70
 
71
71
  ## License
72
72
 
73
73
  This library is licensed under Apache 2.0. Full license text is available in
74
- [LICENSE](https://googlecloudplatform.github.io/google-cloud-ruby/docs/gcloud/latest/file.LICENSE).
74
+ [LICENSE](https://github.com/googleapis/google-cloud-ruby/blob/master/LICENSE).
75
75
 
76
76
  ## Support
77
77
 
78
78
  Please [report bugs at the project on
79
- Github](https://github.com/GoogleCloudPlatform/google-cloud-ruby/issues). Don't
79
+ Github](https://github.com/googleapis/google-cloud-ruby/issues). Don't
80
80
  hesitate to [ask
81
81
  questions](http://stackoverflow.com/questions/tagged/google-cloud-platform+ruby)
82
82
  about the client or APIs on [StackOverflow](http://stackoverflow.com).
@@ -24,7 +24,8 @@ Gcloud = Google::Cloud
24
24
  #
25
25
  # The current `gcloud` gem exists only to facilitate the timely transition of
26
26
  # legacy code from the deprecated `Gcloud` namespace to the new `Google::Cloud`
27
- # namespace. Please see the top-level project [README](../README.md) for current
27
+ # namespace. Please see the top-level project
28
+ # [README](https://github.com/googleapis/google-cloud-ruby) for current
28
29
  # information about using the `google-cloud` umbrella gem and the individual
29
30
  # service gems.
30
31
  #
@@ -14,5 +14,5 @@
14
14
 
15
15
 
16
16
  module Gcloud
17
- GCLOUD_VERSION = "0.23.1".freeze
17
+ GCLOUD_VERSION = "0.24.1".freeze
18
18
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: gcloud
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.23.1
4
+ version: 0.24.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Mike Moore
@@ -9,7 +9,7 @@ authors:
9
9
  autorequire:
10
10
  bindir: bin
11
11
  cert_chain: []
12
- date: 2018-09-10 00:00:00.000000000 Z
12
+ date: 2020-05-28 00:00:00.000000000 Z
13
13
  dependencies:
14
14
  - !ruby/object:Gem::Dependency
15
15
  name: google-cloud
@@ -26,63 +26,63 @@ dependencies:
26
26
  - !ruby/object:Gem::Version
27
27
  version: '0.23'
28
28
  - !ruby/object:Gem::Dependency
29
- name: minitest
29
+ name: autotest-suffix
30
30
  requirement: !ruby/object:Gem::Requirement
31
31
  requirements:
32
32
  - - "~>"
33
33
  - !ruby/object:Gem::Version
34
- version: '5.10'
34
+ version: '1.1'
35
35
  type: :development
36
36
  prerelease: false
37
37
  version_requirements: !ruby/object:Gem::Requirement
38
38
  requirements:
39
39
  - - "~>"
40
40
  - !ruby/object:Gem::Version
41
- version: '5.10'
41
+ version: '1.1'
42
42
  - !ruby/object:Gem::Dependency
43
- name: minitest-autotest
43
+ name: google-style
44
44
  requirement: !ruby/object:Gem::Requirement
45
45
  requirements:
46
46
  - - "~>"
47
47
  - !ruby/object:Gem::Version
48
- version: '1.0'
48
+ version: 1.24.0
49
49
  type: :development
50
50
  prerelease: false
51
51
  version_requirements: !ruby/object:Gem::Requirement
52
52
  requirements:
53
53
  - - "~>"
54
54
  - !ruby/object:Gem::Version
55
- version: '1.0'
55
+ version: 1.24.0
56
56
  - !ruby/object:Gem::Dependency
57
- name: minitest-focus
57
+ name: minitest
58
58
  requirement: !ruby/object:Gem::Requirement
59
59
  requirements:
60
60
  - - "~>"
61
61
  - !ruby/object:Gem::Version
62
- version: '1.1'
62
+ version: '5.10'
63
63
  type: :development
64
64
  prerelease: false
65
65
  version_requirements: !ruby/object:Gem::Requirement
66
66
  requirements:
67
67
  - - "~>"
68
68
  - !ruby/object:Gem::Version
69
- version: '1.1'
69
+ version: '5.10'
70
70
  - !ruby/object:Gem::Dependency
71
- name: minitest-rg
71
+ name: minitest-autotest
72
72
  requirement: !ruby/object:Gem::Requirement
73
73
  requirements:
74
74
  - - "~>"
75
75
  - !ruby/object:Gem::Version
76
- version: '5.2'
76
+ version: '1.0'
77
77
  type: :development
78
78
  prerelease: false
79
79
  version_requirements: !ruby/object:Gem::Requirement
80
80
  requirements:
81
81
  - - "~>"
82
82
  - !ruby/object:Gem::Version
83
- version: '5.2'
83
+ version: '1.0'
84
84
  - !ruby/object:Gem::Dependency
85
- name: autotest-suffix
85
+ name: minitest-focus
86
86
  requirement: !ruby/object:Gem::Requirement
87
87
  requirements:
88
88
  - - "~>"
@@ -96,33 +96,33 @@ dependencies:
96
96
  - !ruby/object:Gem::Version
97
97
  version: '1.1'
98
98
  - !ruby/object:Gem::Dependency
99
- name: redcarpet
99
+ name: minitest-rg
100
100
  requirement: !ruby/object:Gem::Requirement
101
101
  requirements:
102
102
  - - "~>"
103
103
  - !ruby/object:Gem::Version
104
- version: '3.0'
104
+ version: '5.2'
105
105
  type: :development
106
106
  prerelease: false
107
107
  version_requirements: !ruby/object:Gem::Requirement
108
108
  requirements:
109
109
  - - "~>"
110
110
  - !ruby/object:Gem::Version
111
- version: '3.0'
111
+ version: '5.2'
112
112
  - !ruby/object:Gem::Dependency
113
- name: rubocop
113
+ name: redcarpet
114
114
  requirement: !ruby/object:Gem::Requirement
115
115
  requirements:
116
116
  - - "~>"
117
117
  - !ruby/object:Gem::Version
118
- version: 0.50.0
118
+ version: '3.0'
119
119
  type: :development
120
120
  prerelease: false
121
121
  version_requirements: !ruby/object:Gem::Requirement
122
122
  requirements:
123
123
  - - "~>"
124
124
  - !ruby/object:Gem::Version
125
- version: 0.50.0
125
+ version: '3.0'
126
126
  - !ruby/object:Gem::Dependency
127
127
  name: simplecov
128
128
  requirement: !ruby/object:Gem::Requirement
@@ -174,6 +174,9 @@ extensions: []
174
174
  extra_rdoc_files: []
175
175
  files:
176
176
  - ".yardopts"
177
+ - AUTHENTICATION.md
178
+ - CODE_OF_CONDUCT.md
179
+ - CONTRIBUTING.md
177
180
  - LICENSE
178
181
  - README.md
179
182
  - lib/gcloud.rb
@@ -187,7 +190,7 @@ files:
187
190
  - lib/gcloud/translate.rb
188
191
  - lib/gcloud/version.rb
189
192
  - lib/gcloud/vision.rb
190
- homepage: https://github.com/GoogleCloudPlatform/google-cloud-ruby/tree/master/gcloud
193
+ homepage: https://github.com/googleapis/google-cloud-ruby/tree/master/gcloud
191
194
  licenses:
192
195
  - Apache-2.0
193
196
  metadata: {}
@@ -200,15 +203,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
200
203
  requirements:
201
204
  - - ">="
202
205
  - !ruby/object:Gem::Version
203
- version: 2.0.0
206
+ version: '2.4'
204
207
  required_rubygems_version: !ruby/object:Gem::Requirement
205
208
  requirements:
206
209
  - - ">="
207
210
  - !ruby/object:Gem::Version
208
211
  version: '0'
209
212
  requirements: []
210
- rubyforge_project:
211
- rubygems_version: 2.7.7
213
+ rubygems_version: 3.0.6
212
214
  signing_key:
213
215
  specification_version: 4
214
216
  summary: API Client library for Google Cloud