Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Kms] Regenerate with the new gapic config #1165

Merged
merged 5 commits into from
Jul 12, 2018

Conversation

tmatsuo
Copy link
Contributor

@tmatsuo tmatsuo commented Jul 9, 2018

No description provided.

@tmatsuo tmatsuo requested a review from dwsupplee July 9, 2018 19:56
@googlebot googlebot added the cla: yes This human has signed the Contributor License Agreement. label Jul 9, 2018
@tmatsuo tmatsuo added the api: cloudkms Issues related to the Cloud Key Management Service API. label Jul 9, 2018
Copy link
Contributor

@dwsupplee dwsupplee left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice! It's great to see the new generated proto updates coming through.

Since it is unlikely we have too many users on this at the moment and we are in beta, what do you think about ripping the bandaid off and removing the classes which use the old namespace structure? Is there a flag to toggle whether or not they get generated again in the future in the case we were to remove them now?

@tmatsuo
Copy link
Contributor Author

tmatsuo commented Jul 9, 2018

I'm ok deleting them!

@tmatsuo
Copy link
Contributor Author

tmatsuo commented Jul 9, 2018

and removed! @dwsupplee PTAL

@tmatsuo
Copy link
Contributor Author

tmatsuo commented Jul 9, 2018

Interesting. The unit test still refers to the old namespace and now it fails.

On the second thoughts, keeping the old namespace doesn't harm anything, and according to the comment, the future version will remove the old namespaces.

What do you think about keeping them?

@dwsupplee
Copy link
Contributor

dwsupplee commented Jul 10, 2018

Good eye on that.

After looking a bit more, the code samples in the GAPIC reference the old namespaces as well. This ends up teaching users to utilize the deprecated approach which will eventually break them. Since we have the tools available to us to avoid that to a large degree right now, I still lean towards doing what we can to remove the deprecated classes. What do you think about us taking the time to update the GAPIC tooling to remove the usage of the old namespaces before releasing this?

@tmatsuo
Copy link
Contributor Author

tmatsuo commented Jul 10, 2018

@dwsupplee

Yeah that seems like the right thing to do. We need to remove the old namespace usage in the code sample in the client at least.

The old namespace is also used in \Google\Cloud\Kms\V1\CryptoKey.php.

Filed a bug: googleapis/gapic-generator#2141

Add back the deprecated files
@tmatsuo
Copy link
Contributor Author

tmatsuo commented Jul 11, 2018

Until we have a fix in gapic-generator, maybe we can have a patch in our synthtool script for the code sample. Other usages are not user visible, so not a big problem.

@dwsupplee PTAL

@dwsupplee
Copy link
Contributor

That sounds like a good compromise until we have this addressed in the GAPIC generation.

I do have one slight concern, which I am on the fence about. Please let me know what you think. The deprecated classes trigger a warning about being removed in the next major release. It seems as though this warning is intended for the next major release of protobuf - but since we are publishing the classes in this library it strikes me as though we should be following our own guidelines instead. My hope would be that since we are in beta we can remove the deprecated classes sooner than when we flip KMS to GA. Do you think it would also be worth it to use the synth tool to update the warning messages?

@tmatsuo
Copy link
Contributor Author

tmatsuo commented Jul 12, 2018

@dwsupplee Very good point. Thanks for pointing out. I updated the wording for the deprecation warning. PTAL!

Copy link
Contributor

@dwsupplee dwsupplee left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍 Looks great!

@dwsupplee dwsupplee merged commit aa17757 into googleapis:master Jul 12, 2018
@tmatsuo tmatsuo mentioned this pull request Jul 18, 2018
sduskis pushed a commit that referenced this pull request Jul 23, 2018
* Add isRacy() to SafeSearch (#1166)

The SafeSearch class included `is` functions for each SafeSearch feature (adult, spoof, medical, violence), but was missing Racy. This Pull Request adds `isRacy()` to the SafeSearch class.

* Exclude component vendor folder from snippet coverage (#1168)

cc @tmatsuo

* Allow context to handle Throwable interface (#1164)

* Add getServiceAccount to the BigQueryClient (#1167)

* Add getServiceAccount to the BigQueryClient

See:
https://cloud.google.com/bigquery/docs/reference/rest/v2/projects/getServiceAccount

* Added $options to getServiceAccount and fixed the indent

* Use single quote

* Add snippet test

* Comment update, use self instead of $this

* Comment update

* Prepare v0.71.0 (#1169)

* Prepare v0.71.0

* patch release for Logging

* Correct version for Logging

* [Kms] Regenerate with the new gapic config (#1165)

* Update for the new gapic configuration

* Docs update for the new and nicer namespace

* Removed the files with the old namespace

* Use the new namespace in the code sample

Add back the deprecated files

* Changed the wording for the deprecation warning

* Fix firestore queries (#1161)

* Bump gax to 0.35 (#1170)

* Add an interactive release builder. (#1160)

* Add an interactive release builder.

* Create build directory if it doesn't exist

* Add getServiceAccount method to StorageClient (#1173)

* Re-generate library using Tasks/synth.py (#1174)

* Re-generate library using Tasks/synth.py

* Use new namespace in user visible area, tweak the deprecation wording

* Add support for Numeric type (#1172)

* Add support for Numeric type

* Added a cast in Numeric's constructor, added system tests

* Allow '123.' and '.123', update tests

* [Breaking Change] Add support for Document Snapshots in Firestore Query Cursors (#1162)

cc @schmidt-sebastian

Extracted from #923 and updated to address pull request comments.

Breaking change is the standardization in Query of using `InvalidArgumentException`, replacing various throws of `BadMethodCallException`.

Closes #851.

* Fix Storage Requesterpays system tests (#1180)

The requester pays system tests have been broken for some time. This change fixes them.

* Bandaid for protobuf 4761 (#1176)

* Temporary workaround for protobuf extension issue

protocolbuffers/protobuf#4761

* Bump gax to 0.36

* Configure comparators for the unit test

* Revert back to normal TestCase

* Install protobuf extension in the PHP 7.2 test runner

* Revert to TestCase

* Prepare v0.72.0 (#1181)

* Added a document for the time filter on BigQueryClient->jobs() (#1183)

* Narrowed the time filter in the system test (#1185)

* Re-generate library using BigQueryDataTransfer/synth.py (#1184)

* Re-generate library using BigQueryDataTransfer/synth.py

* Tweak the wording on the deprecation warning

Also use the new namespace in the sample code

* pin auth version until we have a way to silence warnings (#1189)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
api: cloudkms Issues related to the Cloud Key Management Service API. cla: yes This human has signed the Contributor License Agreement.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants