chore(gae): rename regions in standard/storage/appengine-client/main.py (#13055)

* chore(gae): add support for Python 3 to requirements-test.txt

* chore(gae): rename regions in appengine-client/main.py

* chore(gae): fix typo in region tag

Author: eapl-gemugami

appengine/standard/storage/appengine-client/main.py

@@ -14,32 +14,29 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# [START sample]
+# [START gae_storage_sample]
 """A sample app that uses GCS client to operate on bucket and file."""
 
-# [START imports]
+# [START gae_storage_imports]
 import os
 
 import cloudstorage
 from google.appengine.api import app_identity
 
 import webapp2
+# [END gae_storage_imports]
 
-# [END imports]
-
-# [START retries]
 cloudstorage.set_default_retry_params(
     cloudstorage.RetryParams(
         initial_delay=0.2, max_delay=5.0, backoff_factor=2, max_retry_period=15
     )
 )
-# [END retries]
 
 
 class MainPage(webapp2.RequestHandler):
     """Main page for GCS demo application."""
 
-    # [START get_default_bucket]
+    # [START gae_storage_get_default_bucket]
     def get(self):
         bucket_name = os.environ.get(
             "BUCKET_NAME", app_identity.get_default_gcs_bucket_name()
@@ -52,7 +49,7 @@ def get(self):
             )
         )
         self.response.write("Using bucket name: {}\n\n".format(bucket_name))
-        # [END get_default_bucket]
+        # [END gae_storage_get_default_bucket]
 
         bucket = "/" + bucket_name
         filename = bucket + "/demo-testfile"
@@ -79,7 +76,7 @@ def get(self):
         self.delete_files()
         self.response.write("\n\nThe demo ran successfully!\n")
 
-    # [START write]
+    # [START gae_storage_write]
     def create_file(self, filename):
         """Create a file."""
 
@@ -98,19 +95,17 @@ def create_file(self, filename):
             cloudstorage_file.write("abcde\n")
             cloudstorage_file.write("f" * 1024 * 4 + "\n")
         self.tmp_filenames_to_clean_up.append(filename)
+    # [END gae_storage_write]
 
-    # [END write]
-
-    # [START read]
+    # [START gae_storage_read]
     def read_file(self, filename):
         self.response.write("Abbreviated file content (first line and last 1K):\n")
 
         with cloudstorage.open(filename) as cloudstorage_file:
             self.response.write(cloudstorage_file.readline())
             cloudstorage_file.seek(-1024, os.SEEK_END)
             self.response.write(cloudstorage_file.read())
-
-    # [END read]
+    # [END gae_storage_read]
 
     def stat_file(self, filename):
         self.response.write("File stat:\n")
@@ -126,7 +121,7 @@ def create_files_for_list_bucket(self, bucket):
         for f in filenames:
             self.create_file(f)
 
-    # [START list_bucket]
+    # [START gae_storage_list_bucket]
     def list_bucket(self, bucket):
         """Create several files and paginate through them."""
 
@@ -147,8 +142,7 @@ def list_bucket(self, bucket):
             stats = cloudstorage.listbucket(
                 bucket + "/foo", max_keys=page_size, marker=stat.filename
             )
-
-    # [END list_bucket]
+    # [END gae_storage_list_bucket]
 
     def list_bucket_directory_mode(self, bucket):
         self.response.write("Listbucket directory mode result:\n")
@@ -162,7 +156,6 @@ def list_bucket_directory_mode(self, bucket):
                     self.response.write("  {}".format(subdir_file))
                     self.response.write("\n")
 
-    # [START delete_files]
     def delete_files(self):
         self.response.write("Deleting files...\n")
         for filename in self.tmp_filenames_to_clean_up:
@@ -173,8 +166,5 @@ def delete_files(self):
                 pass
 
 
-# [END delete_files]
-
-
 app = webapp2.WSGIApplication([("/", MainPage)], debug=True)
-# [END sample]
+# [END gae_storage_sample]

appengine/standard/storage/appengine-client/requirements-test.txt

@@ -1,3 +1,8 @@
 # pin pytest to 4.6.11 for Python2.
 pytest==4.6.11; python_version < '3.0'
 WebTest==2.0.35; python_version < '3.0'
+# 2025-01-14 - Added support for Python 3
+pytest==8.3.2; python_version >= '3.0'
+WebTest==3.0.1; python_version >= '3.0'
+six==1.16.0
+