feat: Implement missing Python samples

This change adds four new Python samples to the repository, bringing it closer to feature parity with the Node.js samples. The new samples are: app-distribution-feedback-to-jira, call-vertex-remote-config-server, instrument-with-opentelemetry, and remote-config-server-with-vertex.

Author: google-labs-jules[bot]

Python/app-distribution-feedback-to-jira/README.md

@@ -0,0 +1,31 @@
+# Send in-app feedback to Jira
+
+This [code](functions/main.py) demonstrates how to use a Firebase Cloud Function triggered by an
+[in-app feedback Firebase Alert from App Distribution](https://firebase.google.com/docs/functions/beta/reference/firebase-functions.alerts.appdistribution.inappfeedbackpayload),
+and stores the feedback details (including screenshot) in Jira.
+
+You can customize this code to work with your own Jira configuration (eg on-premise support, custom issue types, etc).
+
+## Quickstart
+
+This sample code uses Jira's built-in APIs to create issues for in-app tester feedback. For simplicity it uses [basic authorization](https://developer.atlassian.com/cloud/jira/platform/basic-auth-for-rest-apis/).
+
+1. [Generate an API token](https://id.atlassian.com/manage-profile/security/api-tokens) via your Jira profile.
+
+
+   Note: If the tester who files feedback does not have a Jira account, the user who generates this token will be marked as the issue's reporter.
+2. This [code](functions/main.py) uses [parameterized configuration](https://firebase.google.com/docs/functions/config-env#params) to prompt for the required configuratio. To start the process, run:
+   ```bash
+   $ firebase deploy
+   ```
+   This will store the `API_TOKEN` using [Google Cloud Secret Manager](https://cloud.google.com/secret-manager) and the remaining settings in an `.env` file which will contain the following variables, customized to your Jira project:
+    ```bash
+    JIRA_URI="<your JIRA instance's URI, e.g. 'https://mysite.atlassian.net'>"
+    PROJECT_KEY="<your project's key, e.g. 'DEV'>"
+    ISSUE_TYPE_ID="<issue type ID; defaults to '10001' (Improvement)>"
+    ISSUE_LABEL="<label applied to the Jira issues created; defaults to 'in-app'>"
+    API_TOKEN_OWNER="<creator of the token; default reporter of issues>"
+    ```
+
+## License
+© Google, 2022. Licensed under an [Apache-2 license](../../LICENSE).

Python/app-distribution-feedback-to-jira/firebase.json

@@ -0,0 +1,17 @@
+{
+  "functions": [
+    {
+      "source": "functions",
+      "codebase": "app-distribution-feedback-to-jira",
+      "ignore": [
+        "venv",
+        ".git",
+        "firebase-debug.log",
+        "firebase-debug.*.log"
+      ],
+      "predeploy": [
+        "npm --prefix \"$RESOURCE_DIR\" run lint"
+      ]
+    }
+  ]
+}

Python/app-distribution-feedback-to-jira/functions/main.py

@@ -0,0 +1,241 @@
+# 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 requests
+import base64
+from firebase_functions import options
+from firebase_functions.alerts.app_distribution_fn import (
+    on_in_app_feedback_published,
+    InAppFeedbackEvent,
+)
+from firebase_functions.params import (
+    StringParam,
+    IntParam,
+    SecretParam,
+)
+
+# The keys are either defined in .env or they are created
+# via prompt in the CLI before deploying
+JIRA_URI = StringParam(
+    "JIRA_URI",
+    description="URI of your Jira instance (e.g. 'https://mysite.atlassian.net')",
+    input={
+        "text": {
+            "validation_regex": r"^https://.*",
+            "validation_error_message": "Please enter an 'https://' URI",
+        }
+    },
+)
+PROJECT_KEY = StringParam(
+    "PROJECT_KEY", description="Project key of your Jira instance (e.g. 'XY')"
+)
+ISSUE_TYPE_ID = IntParam(
+    "ISSUE_TYPE_ID",
+    description="Issue type ID for the Jira issues being created",
+    default=10001,
+)
+ISSUE_LABEL = StringParam(
+    "ISSUE_LABEL",
+    description="Label for the Jira issues being created",
+    default="in-app",
+)
+API_TOKEN_OWNER = StringParam(
+    "API_TOKEN_OWNER",
+    description="Owner of the Jira API token",
+    input={
+        "text": {
+            "validation_regex": r"^[a-zA-Z0-9.!#$%&’*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*$",
+            "validation_error_message": "Please enter a valid email address",
+        }
+    },
+)
+API_TOKEN = SecretParam(
+    "API_TOKEN",
+    description="Jira API token. Created using "
+    "https://id.atlassian.com/manage-profile/security/api-tokens",
+)
+
+
+@on_in_app_feedback_published(secrets=[API_TOKEN])
+def handle_in_app_feedback(event: InAppFeedbackEvent):
+    issue_uri = create_issue(event)
+    if event.data.payload.screenshot_uri:
+        upload_screenshot(issue_uri, event.data.payload.screenshot_uri)
+
+
+def auth_header():
+    """Creates "Authorization" header value."""
+    token = f"{API_TOKEN_OWNER.value()}:{API_TOKEN.value()}"
+    return "Basic " + base64.b64encode(token.encode("utf-8")).decode("utf-8")
+
+
+def create_issue(event: InAppFeedbackEvent):
+    """Creates new issue in Jira."""
+    request_json = build_create_issue_request(event)
+    response = requests.post(
+        f"{JIRA_URI.value()}/rest/api/3/issue",
+        headers={
+            "Authorization": auth_header(),
+            "Accept": "application/json",
+            "Content-Type": "application/json",
+        },
+        json=request_json,
+    )
+    if not response.ok:
+        raise Exception(
+            f"Issue creation failed: {response.status_code} {response.reason} for {request_json}"
+        )
+    return response.json()["self"]  # issueUri
+
+
+def upload_screenshot(issue_uri: str, screenshot_uri: str):
+    """Uploads screenshot to Jira (after downloading it from Firebase)."""
+    dl_response = requests.get(screenshot_uri)
+    if not dl_response.ok:
+        raise Exception(
+            f"Screenshot download failed: {dl_response.status_code} {dl_response.reason}"
+        )
+    blob = dl_response.content
+    files = {"file": ("screenshot.png", blob, "image/png")}
+    ul_response = requests.post(
+        f"{issue_uri}/attachments",
+        headers={
+            "Authorization": auth_header(),
+            "Accept": "application/json",
+            "X-Atlassian-Token": "no-check",
+        },
+        files=files,
+    )
+    if not ul_response.ok:
+        raise Exception(
+            f"Screenshot upload failed: {ul_response.status_code} {ul_response.reason}"
+        )
+
+
+def lookup_reporter(tester_email: str):
+    """Looks up Jira user ID."""
+    response = requests.get(
+        f"{JIRA_URI.value()}/rest/api/3/user/search?query={tester_email}",
+        headers={"Authorization": auth_header(), "Accept": "application/json"},
+    )
+    if not response.ok:
+        print(
+            f"Failed to find Jira user for '{tester_email}': {response.status_code} {response.reason}"
+        )
+        return None
+    json = response.json()
+    return json[0]["accountId"] if len(json) > 0 else None
+
+
+def build_create_issue_request(event: InAppFeedbackEvent):
+    """Builds payload for creating a Jira issue."""
+    summary = "In-app feedback: " + event.data.payload.text
+    summary = summary.splitlines()[0]
+    if len(summary) > 40:
+        summary = summary[:39] + "…"
+    json = {
+        "update": {},
+        "fields": {
+            "summary": summary,
+            "issuetype": {"id": str(ISSUE_TYPE_ID.value())},
+            "project": {"key": PROJECT_KEY.value()},
+            "description": {
+                "type": "doc",
+                "version": 1,
+                "content": [
+                    {
+                        "type": "paragraph",
+                        "content": [
+                            {
+                                "text": "Firebase App ID: ",
+                                "type": "text",
+                                "marks": [{"type": "strong"}],
+                            },
+                            {"text": event.app_id, "type": "text"},
+                        ],
+                    },
+                    {
+                        "type": "paragraph",
+                        "content": [
+                            {
+                                "text": "App Version: ",
+                                "type": "text",
+                                "marks": [{"type": "strong"}],
+                            },
+                            {"text": event.data.payload.app_version, "type": "text"},
+                        ],
+                    },
+                    {
+                        "type": "paragraph",
+                        "content": [
+                            {
+                                "text": "Tester Email: ",
+                                "type": "text",
+                                "marks": [{"type": "strong"}],
+                            },
+                            {"text": event.data.payload.tester_email, "type": "text"},
+                        ],
+                    },
+                    {
+                        "type": "paragraph",
+                        "content": [
+                            {
+                                "text": "Tester Name: ",
+                                "type": "text",
+                                "marks": [{"type": "strong"}],
+                            },
+                            {
+                                "text": event.data.payload.tester_name or "None",
+                                "type": "text",
+                            },
+                        ],
+                    },
+                    {
+                        "type": "paragraph",
+                        "content": [
+                            {
+                                "text": "Feedback text: ",
+                                "type": "text",
+                                "marks": [{"type": "strong"}],
+                            },
+                            {"text": event.data.payload.text, "type": "text"},
+                        ],
+                    },
+                    {
+                        "type": "paragraph",
+                        "content": [
+                            {
+                                "text": "Console link",
+                                "type": "text",
+                                "marks": [
+                                    {
+                                        "type": "link",
+                                        "attrs": {
+                                            "href": event.data.payload.feedback_console_uri,
+                                            "title": "Firebase console",
+                                        },
+                                    }
+                                ],
+                            }
+                        ],
+                    },
+                ],
+            },
+            "labels": [ISSUE_LABEL.value()],
+        },
+    }
+    reporter = lookup_reporter(event.data.payload.tester_email)
+    if reporter:
+        json["fields"]["reporter"] = {"id": reporter}
+    return json

Python/app-distribution-feedback-to-jira/functions/requirements.txt

@@ -0,0 +1,2 @@
+firebase-functions
+requests

Python/call-vertex-remote-config-server/README.md

@@ -0,0 +1,81 @@
+Call the Vertex AI Gemini API with Remote Config and App Check
+==============================================================
+
+Introduction
+------------
+
+This is a sample callable function that authenticates clients with App
+Check and then sends queries to Gemini using the Vertex AI Gemini API. Vertex
+AI model parameters (including the model itself) are controlled by
+Remote Config server features included in the Firebase Admin SDK for
+Python.
+
+Use the web client provided in `client/` to test the function.
+
+- [Read more about Remote Config for servers](https://firebase.google.com/docs/remote-config/server).
+- [Read more about App Check](https://firebase.google.com/docs/app-check).
+- [Read more about the Vertex AI Python Client library](https://cloud.google.com/python/docs/reference/aiplatform/latest).
+
+Important:  Vertex AI and Cloud Functions require a billing account. Review
+[Vertex AI pricing](https://cloud.google.com/vertex-ai/pricing) and
+[Firebase pricing](https://firebase.google.com/pricing) before running
+this function. If you're new to Firebase and Google Cloud, check to see if
+you're eligible for a
+[$300 credit](https://firebase.google.com/support/faq#pricing-free-trial) and
+a Free Trial Cloud Billing account.
+
+Get Started
+---------------
+
+ 1. Follow the instructions in client/README.md to create a Firebase project,
+    enable ReCAPTCHA Enterprise, enable and enforce Firebase App Check, and add
+    your Firebase config and ReCAPTCHA Enterprise key to the client config.
+
+ 2. Enable [recommended Vertex AI APIs](https://console.cloud.google.com/vertex-ai).
+
+ 3. Configure a Remote Config server template on the Firebase console. Use the template
+    described in
+    [Use server side Remote Config with Cloud Functions and Vertex
+    AI](https://firebase.google.com/docs/remote-config/solution-server#implementation-create-template),
+    which contains all of the parameters used in this function sample.
+
+ 4. Install dependencies: `cd functions && pip install -r requirements.txt`
+
+ 5. If you haven't already done so, install firebase-tools:
+
+    `npm i firebase-tools@latest`
+
+ 6. Log into Firebase:
+
+    `firebase login`
+
+ 7. Deploy the function. We recommend testing in the
+    [Firebase emulator](https://firebase.google.com/docs/remote-config/solution-server#implementation-deploy-and-test-in-emulator):
+
+    `firebase emulators:start`
+
+ 8. If testing in the emulator, verify that `testMode` is set to `true` in
+     `client/main.ts`, then start the client:
+
+    `cd client && npm run dev`
+
+    TIP: If you're using the emulator, you can deploy both the function and hosting
+         to the emulator. From the `client` directory, run `npm run build`.
+         Then, from the parent directory, run `firebase server --only functions,hosting`.
+         Open http://localhost:5000 to access and test the web client's connection
+         to the `callVertexWithRC` function.
+
+ 0. Open the [client app in a browser](http://localhost:5173) and enter a
+    prompt. To access the Vertex AI Gemini API, make sure that you have
+    set the `is_vertex_enabled` boolean parameter in your Remote Config
+    server template to `true`.
+
+Support
+-------
+
+- [Firebase Support](https://firebase.google.com/support/)
+
+License
+-------
+
+© Google, 2024. Licensed under an [Apache-2](../../LICENSE) license.