feat: add helloworld samples for FastAPI and Streamlit

Author: jackwotherspoon

run/helloworld-fastapi/README.md

@@ -0,0 +1,49 @@
+# Cloud Run Hello World FastAPI Sample
+
+This sample shows how to deploy a Hello World FastAPI application to Cloud Run.
+
+[![Run in Google Cloud][run_img]][run_link]
+
+[run_img]: https://storage.googleapis.com/cloudrun/button.svg
+[run_link]: https://console.cloud.google.com/cloudshell/editor?shellonly=true&cloudshell_image=gcr.io/cloudrun/button&cloudshell_git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&cloudshell_working_dir=run/helloworld-fastapi
+
+## Build
+
+* Set an environment variable with your GCP Project ID:
+
+```
+export GOOGLE_CLOUD_PROJECT=<PROJECT_ID>
+```
+
+* Use a [Buildpack](https://github.com/GoogleCloudPlatform/buildpacks) to build the container:
+
+```sh
+gcloud builds submit --pack image=gcr.io/${GOOGLE_CLOUD_PROJECT}/helloworld-fastapi
+```
+
+## Run Locally
+
+```sh
+docker run --rm gcr.io/${GOOGLE_CLOUD_PROJECT}/helloworld-fastapi
+```
+
+## Test
+
+```
+pytest
+```
+
+_Note: you may need to install `pytest` using `pip install pytest`._
+
+## Deploy
+
+```sh
+# Set an environment variable with your GCP Project ID
+export GOOGLE_CLOUD_PROJECT=<PROJECT_ID>
+
+# Deploy to Cloud Run
+gcloud run deploy helloworld-fastapi --source .
+```
+
+
+For more details on how to work with this sample read the [Python Cloud Run Samples README](https://github.com/GoogleCloudPlatform/python-docs-samples/tree/main/run)

run/helloworld-fastapi/main.py

@@ -0,0 +1,27 @@
+# Copyright 2025 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.
+
+# [START cloudrun_helloworld_fastapi]
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+def hello(name: str = "World"):
+    """Return a friendly HTTP greeting."""
+    return {
+        "message": f"Hello {name}!"
+    }
+# [END cloudrun_helloworld_fastapi]

run/helloworld-fastapi/main_test.py

@@ -0,0 +1,37 @@
+# Copyright 2025 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 pytest
+from fastapi.testclient import TestClient
+
+import main
+
+
+@pytest.fixture
+def client():
+    return TestClient(main.app)
+
+
+def test_handler_no_param(client):
+    r = client.get("/")
+
+    assert r.json() == {"message": "Hello World!"}
+    assert r.status_code == 200
+
+
+def test_handler_with_param(client):
+    r = client.get("/", params={"name": "Foo"})
+
+    assert r.json() == {"message": "Hello Foo!"}
+    assert r.status_code == 200

run/helloworld-fastapi/requirements-test.txt

@@ -0,0 +1 @@
+pytest==8.2.0

run/helloworld-fastapi/requirements.txt

@@ -0,0 +1,2 @@
+fastapi[standard]==0.116.1
+uvicorn==0.35.0

run/helloworld-streamlit/README.md

@@ -0,0 +1,49 @@
+# Cloud Run Hello World Streamlit Sample
+
+This sample shows how to deploy a Hello World Streamlit application to Cloud Run.
+
+[![Run in Google Cloud][run_img]][run_link]
+
+[run_img]: https://storage.googleapis.com/cloudrun/button.svg
+[run_link]: https://console.cloud.google.com/cloudshell/editor?shellonly=true&cloudshell_image=gcr.io/cloudrun/button&cloudshell_git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&cloudshell_working_dir=run/helloworld-streamlit
+
+## Build
+
+* Set an environment variable with your GCP Project ID:
+
+```
+export GOOGLE_CLOUD_PROJECT=<PROJECT_ID>
+```
+
+* Use a [Buildpack](https://github.com/GoogleCloudPlatform/buildpacks) to build the container:
+
+```sh
+gcloud builds submit --pack image=gcr.io/${GOOGLE_CLOUD_PROJECT}/helloworld-streamlit
+```
+
+## Run Locally
+
+```sh
+docker run --rm gcr.io/${GOOGLE_CLOUD_PROJECT}/helloworld-streamlit
+```
+
+## Test
+
+```
+pytest
+```
+
+_Note: you may need to install `pytest` using `pip install pytest`._
+
+## Deploy
+
+```sh
+# Set an environment variable with your GCP Project ID
+export GOOGLE_CLOUD_PROJECT=<PROJECT_ID>
+
+# Deploy to Cloud Run
+gcloud run deploy helloworld-streamlit --source .
+```
+
+
+For more details on how to work with this sample read the [Python Cloud Run Samples README](https://github.com/GoogleCloudPlatform/python-docs-samples/tree/main/run)

run/helloworld-streamlit/main.py

@@ -0,0 +1,43 @@
+# Copyright 2025 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.
+
+# [START cloudrun_helloworld_streamlit]
+import streamlit as st
+
+st.title(f"Hello World! 👋🌎")
+st.markdown(
+    """
+    This is a demo Streamlit app.
+
+    Enter your name in the text box below and press a button to see some fun features in Streamlit.
+    """
+)
+
+name = st.text_input("Enter your name:")
+
+# Use columns to create buttons side by side
+col1, col2 = st.columns(2)
+
+with col1:
+    if st.button("Send balloons! 🎈"):
+        st.balloons()
+        st.write(f"Time to celebrate {name}! 🥳")
+        st.write("You deployed a Streamlit app! 👏")
+
+with col2:
+    if st.button("Send snow! ❄️"):
+        st.snow()
+        st.write(f"Let it snow {name}! 🌨️")
+        st.write("You deployed a Streamlit app! 👏")
+# [END cloudrun_helloworld_streamlit]

run/helloworld-streamlit/main_test.py

@@ -0,0 +1,20 @@
+from streamlit.testing.v1 import AppTest
+
+def test_balloons():
+    """A user presses the balloons button"""
+    at = AppTest.from_file("main.py").run()
+    at.text_input[0].set_value("Foo").run()
+    at.button[0].click().run()
+    assert at.markdown.values[0] == "This is a demo Streamlit app.\n\nEnter your name in the text box below and press a button to see some fun features in Streamlit."
+    assert at.markdown.values[1] == "Time to celebrate Foo! 🥳"
+    assert at.markdown.values[2] == "You deployed a Streamlit app! 👏"
+
+def test_snow():
+    """A user presses the snow button"""
+    at = AppTest.from_file("main.py").run()
+    at.text_input[0].set_value("Foo").run()
+    at.button[1].click().run()
+    assert at.markdown.values[0] == "This is a demo Streamlit app.\n\nEnter your name in the text box below and press a button to see some fun features in Streamlit."
+    assert at.markdown.values[1] == "Let it snow Foo! 🌨️"
+    assert at.markdown.values[2] == "You deployed a Streamlit app! 👏"
+    

run/helloworld-streamlit/requirements-test.txt

@@ -0,0 +1 @@
+pytest==8.2.0

run/helloworld-streamlit/requirements.txt

@@ -0,0 +1 @@
+streamlit==1.47.1