fix: restore/update cloud-functions-python-http (GoogleCloudPlatform#9721)

Co-authored-by: Dan Lee <[email protected]>

Author: PicardParis

.github/CODEOWNERS

@@ -84,6 +84,7 @@
 # Self-service
 # ---* Shared with DEE Teams
 /functions/**/*                        @GoogleCloudPlatform/functions-framework-google @GoogleCloudPlatform/torus-dpe @GoogleCloudPlatform/python-samples-reviewers
+/codelabs/**/*                         @GoogleCloudPlatform/codelabs-contributors @GoogleCloudPlatform/python-samples-reviewers
 /composer/**/*                         @GoogleCloudPlatform/cloud-dpes-composer @GoogleCloudPlatform/python-samples-reviewers
 /pubsub/**/*                           @GoogleCloudPlatform/api-pubsub-and-pubsublite @GoogleCloudPlatform/python-samples-reviewers
 /pubsublite/**/*                       @GoogleCloudPlatform/api-pubsub-and-pubsublite @GoogleCloudPlatform/python-samples-reviewers
@@ -114,4 +115,4 @@
 # BEGIN - pending clarification
 /memorystore/**/*                      @GoogleCloudPlatform/python-samples-reviewers
 /opencensus/**/*                       @GoogleCloudPlatform/python-samples-reviewers
-# END - pending clarification
+# END - pending clarification

codelabs/README.md

@@ -0,0 +1,6 @@
+# Resources in this folder
+
+- This folder contains resources used in Google Cloud codelabs on [Google Developers Codelabs](https://codelabs.developers.google.com/?category=cloud).
+- Each folder is named after the codelab ID. Example:
+  - Folder: `cloud-functions-python-http`
+  - Codelab: <https://codelabs.developers.google.com/codelabs/cloud-functions-python-http>

codelabs/cloud-functions-python-http/.gcloudignore

@@ -0,0 +1,12 @@
+# This file specifies files that are *not* uploaded to Google Cloud
+# using gcloud. It follows the same syntax as .gitignore, with the addition of
+# "#!include" directives (which insert the entries of the given .gitignore-style
+# file at that point).
+#
+# For more information, run:
+#   $ gcloud topic gcloudignore
+#
+__pycache__/**
+.gcloudignore
+test_*.py
+web_app.py

codelabs/cloud-functions-python-http/main.py

@@ -0,0 +1,48 @@
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import flask
+
+
+def hello_world(request: flask.Request) -> flask.Response:
+    """HTTP Cloud Function.
+
+    Returns:
+    - "Hello World! 👋"
+    """
+    response = "Hello World! 👋"
+
+    return flask.Response(response, mimetype="text/plain")
+
+
+def hello_name(request: flask.Request) -> flask.Response:
+    """HTTP Cloud Function.
+
+    Returns:
+    - "Hello {NAME}! 🚀" if "name=NAME" is defined in the GET request
+    - "Hello World! 🚀" otherwise
+    """
+    name = request.args.get("name", "World")
+    response = f"Hello {name}! 🚀"
+
+    return flask.Response(response, mimetype="text/plain")
+
+
+def python_powered(request: flask.Request) -> flask.Response:
+    """HTTP Cloud Function.
+
+    Returns:
+    - The official "Python Powered" logo
+    """
+    return flask.send_file("python-powered.png")

codelabs/cloud-functions-python-http/python-powered.png

@@ -0,0 +1,42 @@
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+import unittest.mock
+
+import main
+
+
+class TestHello(unittest.TestCase):
+    def test_hello_world(self):
+        request = unittest.mock.Mock()
+
+        response = main.hello_world(request)
+        assert response.status_code == 200
+        assert response.get_data(as_text=True) == "Hello World! 👋"
+
+    def test_hello_name_no_name(self):
+        request = unittest.mock.Mock(args={})
+
+        response = main.hello_name(request)
+        assert response.status_code == 200
+        assert response.get_data(as_text=True) == "Hello World! 🚀"
+
+    def test_hello_name_with_name(self):
+        name = "FirstName LastName"
+        request = unittest.mock.Mock(args={"name": name})
+
+        response = main.hello_name(request)
+        assert response.status_code == 200
+        assert response.get_data(as_text=True) == f"Hello {name}! 🚀"

codelabs/cloud-functions-python-http/test_main.py

@@ -0,0 +1,30 @@
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import flask
+
+import main
+
+app = flask.Flask(__name__)
+
+
+@app.get("/")
+def index():
+    return main.python_powered(flask.request)
+
+
+if __name__ == "__main__":
+    # Local development only
+    # Run "python web_app.py" and open http://localhost:8080
+    app.run(host="localhost", port=8080, debug=True)