Cleanup: generation instructions, version ordering (#3451)

Author: garrettjonesgoogle

utilities/generate_api.py

@@ -122,11 +122,15 @@ def run_generate_api(config_path, artifact_type, noisy=False):
         print('**** REMAINING MANUAL WORK: *****')
         print('This script doesn\'t set up new clients. If this is a new client, you need to:')
         print('1. Add the new proto and grpc modules into google-api-grpc/pom.xml')
+        print('2. Add version declarations for the proto and grpc modules in google-api-grpc/pom.xml')
         print('3. Copy an existing client pom.xml to the new client directory, update its text')
         print('4. Copy an existing client README.md to the new client directory, update its text')
         print('5. Add the new proto, grpc, and client modules into versions.txt')
         print('6. Add the new proto, grpc, and client modules into google-cloud-bom/pom.xml')
-        print('7. Run `utilities/replace_versions.py` to update the module versions')
+        print('7. Add the API to the list in the root README.md')
+        print('8. Add the client module into the list in google-cloud-clients/pom.xml')
+        print('9. Add the stub package for the client into the stubs list in google-cloud-clients/pom.xml')
+        print('10. Run `utilities/replace_versions.py` to update the module versions')
 
 def main():
     parser = argparse.ArgumentParser(description='Regenerate a single API.')

versions.txt

@@ -18,13 +18,15 @@ grpc-google-cloud-dialogflow-v2beta1:0.18.0:0.18.1-SNAPSHOT
 grpc-google-cloud-dlp-v2:0.18.0:0.18.1-SNAPSHOT
 grpc-google-cloud-error-reporting-v1beta1:0.18.0:0.18.1-SNAPSHOT
 grpc-google-cloud-firestore-v1beta1:0.18.0:0.18.1-SNAPSHOT
+grpc-google-cloud-iot-v1:0.18.0:0.18.1-SNAPSHOT
 grpc-google-cloud-kms-v1:0.18.0:0.18.1-SNAPSHOT
 grpc-google-cloud-language-v1:1.17.0:1.17.1-SNAPSHOT
 grpc-google-cloud-language-v1beta2:0.18.0:0.18.1-SNAPSHOT
 grpc-google-cloud-logging-v2:0.18.0:0.18.1-SNAPSHOT
 grpc-google-cloud-monitoring-v3:1.17.0:1.17.1-SNAPSHOT
 grpc-google-cloud-os-login-v1:0.18.0:0.18.1-SNAPSHOT
 grpc-google-cloud-pubsub-v1:1.17.0:1.17.1-SNAPSHOT
+grpc-google-cloud-redis-v1beta1:0.18.0:0.18.1-SNAPSHOT
 grpc-google-cloud-spanner-admin-database-v1:0.18.0:0.18.1-SNAPSHOT
 grpc-google-cloud-spanner-admin-instance-v1:0.18.0:0.18.1-SNAPSHOT
 grpc-google-cloud-spanner-v1:0.18.0:0.18.1-SNAPSHOT
@@ -43,8 +45,6 @@ grpc-google-cloud-video-intelligence-v1p1beta1:0.18.0:0.18.1-SNAPSHOT
 grpc-google-cloud-vision-v1:1.17.0:1.17.1-SNAPSHOT
 grpc-google-cloud-vision-v1p1beta1:0.18.0:0.18.1-SNAPSHOT
 grpc-google-cloud-vision-v1p2beta1:1.17.0:1.17.1-SNAPSHOT
-grpc-google-cloud-iot-v1:0.18.0:0.18.1-SNAPSHOT
-grpc-google-cloud-redis-v1beta1:0.18.0:0.18.1-SNAPSHOT
 grpc-google-cloud-websecurityscanner-v1alpha:0.18.0:0.18.1-SNAPSHOT
 proto-google-cloud-bigquerydatatransfer-v1:0.18.0:0.18.1-SNAPSHOT
 proto-google-cloud-bigtable-admin-v2:0.18.0:0.18.1-SNAPSHOT
@@ -57,13 +57,15 @@ proto-google-cloud-dialogflow-v2beta1:0.18.0:0.18.1-SNAPSHOT
 proto-google-cloud-dlp-v2:0.18.0:0.18.1-SNAPSHOT
 proto-google-cloud-error-reporting-v1beta1:0.18.0:0.18.1-SNAPSHOT
 proto-google-cloud-firestore-v1beta1:0.18.0:0.18.1-SNAPSHOT
+proto-google-cloud-iot-v1:0.18.0:0.18.1-SNAPSHOT
 proto-google-cloud-kms-v1:0.18.0:0.18.1-SNAPSHOT
 proto-google-cloud-language-v1:1.17.0:1.17.1-SNAPSHOT
 proto-google-cloud-language-v1beta2:0.18.0:0.18.1-SNAPSHOT
 proto-google-cloud-logging-v2:0.18.0:0.18.1-SNAPSHOT
 proto-google-cloud-monitoring-v3:1.17.0:1.17.1-SNAPSHOT
 proto-google-cloud-os-login-v1:0.18.0:0.18.1-SNAPSHOT
 proto-google-cloud-pubsub-v1:1.17.0:1.17.1-SNAPSHOT
+proto-google-cloud-redis-v1beta1:0.18.0:0.18.1-SNAPSHOT
 proto-google-cloud-spanner-admin-database-v1:0.18.0:0.18.1-SNAPSHOT
 proto-google-cloud-spanner-admin-instance-v1:0.18.0:0.18.1-SNAPSHOT
 proto-google-cloud-spanner-v1:0.18.0:0.18.1-SNAPSHOT
@@ -82,8 +84,6 @@ proto-google-cloud-video-intelligence-v1p1beta1:0.18.0:0.18.1-SNAPSHOT
 proto-google-cloud-vision-v1:1.17.0:1.17.1-SNAPSHOT
 proto-google-cloud-vision-v1p1beta1:0.18.0:0.18.1-SNAPSHOT
 proto-google-cloud-vision-v1p2beta1:1.17.0:1.17.1-SNAPSHOT
-proto-google-cloud-iot-v1:0.18.0:0.18.1-SNAPSHOT
-proto-google-cloud-redis-v1beta1:0.18.0:0.18.1-SNAPSHOT
 proto-google-cloud-websecurityscanner-v1alpha:0.18.0:0.18.1-SNAPSHOT
 
 #
@@ -116,6 +116,7 @@ google-cloud-dns:0.53.0-alpha:0.53.1-alpha-SNAPSHOT
 google-cloud-errorreporting:0.53.0-beta:0.53.1-beta-SNAPSHOT
 google-cloud-examples:0.53.0-alpha:0.53.1-alpha-SNAPSHOT
 google-cloud-firestore:0.53.0-beta:0.53.1-beta-SNAPSHOT
+google-cloud-iot:0.53.0-beta:0.53.1-beta-SNAPSHOT
 google-cloud-kms:0.53.0-beta:0.53.1-beta-SNAPSHOT
 google-cloud-language:1.35.0:1.35.1-SNAPSHOT
 google-cloud-logging:1.35.0:1.35.1-SNAPSHOT
@@ -140,5 +141,4 @@ google-cloud-translate:1.35.0:1.35.1-SNAPSHOT
 google-cloud-util:0.53.0-alpha:0.53.1-alpha-SNAPSHOT
 google-cloud-video-intelligence:0.53.0-beta:0.53.1-beta-SNAPSHOT
 google-cloud-vision:1.35.0:1.35.1-SNAPSHOT
-google-cloud-iot:0.53.0-beta:0.53.1-beta-SNAPSHOT
 google-cloud-websecurityscanner:0.53.0-alpha:0.53.1-alpha-SNAPSHOT