Merge pull request #221001 from JialinXin/patch-12

[WebPubSub] Add python section.

Author: Maggiemouse1

articles/azure-web-pubsub/tutorial-serverless-notification.md

@@ -42,6 +42,16 @@ In this tutorial, you learn how to:
 
 * The [Azure CLI](/cli/azure) to manage Azure resources.
 
+# [Python](#tab/python)
+
+* A code editor, such as [Visual Studio Code](https://code.visualstudio.com/).
+
+* [Python](https://www.python.org/downloads/) (v3.6 ~ v3.9). See [supported Python versions](../azure-functions/functions-reference-python.md#python-version).
+
+* [Azure Functions Core Tools](https://github.com/Azure/azure-functions-core-tools#installing) (v3 or higher preferred) to run Azure Function apps locally and deploy to Azure.
+
+* The [Azure CLI](/cli/azure) to manage Azure resources.
+
 ---
 
 [!INCLUDE [quickstarts-free-trial-note](../../includes/quickstarts-free-trial-note.md)]
@@ -61,6 +71,11 @@ In this tutorial, you learn how to:
     ```bash
     func init --worker-runtime dotnet
     ```
+
+    # [Python](#tab/python)
+    ```bash
+    func init --worker-runtime python
+    ```
 
 2. Install `Microsoft.Azure.WebJobs.Extensions.WebPubSub`.
 
@@ -81,6 +96,18 @@ In this tutorial, you learn how to:
     dotnet add package Microsoft.Azure.WebJobs.Extensions.WebPubSub
     ```
 
+    # [Python](#tab/python)
+    Update `host.json`'s extensionBundle to version _3.3.0_ or later to get Web PubSub support.
+    ```json
+    {
+        "version": "2.0",
+        "extensionBundle": {
+            "id": "Microsoft.Azure.Functions.ExtensionBundle",
+            "version": "[3.3.*, 4.0.0)"
+        }
+    }
+    ```
+
 3. Create an `index` function to read and host a static web page for clients.
     ```bash
     func new -n index -t HttpTrigger
@@ -89,23 +116,23 @@ In this tutorial, you learn how to:
    - Update `index/function.json` and copy following json codes.
         ```json
         {
-            "bindings": [
-                {
-                    "authLevel": "anonymous",
-                    "type": "httpTrigger",
-                    "direction": "in",
-                    "name": "req",
-                    "methods": [
-                      "get",
-                      "post"
-                    ]
-                },
-                {
-                    "type": "http",
-                    "direction": "out",
-                    "name": "res"
-                }
-            ]
+          "bindings": [
+            {
+              "authLevel": "anonymous",
+              "type": "httpTrigger",
+              "direction": "in",
+              "name": "req",
+              "methods": [
+                "get",
+                "post"
+              ]
+            },
+            {
+              "type": "http",
+              "direction": "out",
+              "name": "res"
+            }
+          ]
         }
         ```
    - Update `index/index.js` and copy following codes.
@@ -157,6 +184,41 @@ In this tutorial, you learn how to:
         }
         ```
 
+   # [Python](#tab/python)
+   - Update `index/function.json` and copy following json codes.
+        ```json
+        {
+          "scriptFile": "__init__.py",
+          "bindings": [
+            {
+              "authLevel": "anonymous",
+              "type": "httpTrigger",
+              "direction": "in",
+              "name": "req",
+              "methods": [
+                "get",
+                "post"
+              ]
+            },
+            {
+              "type": "http",
+              "direction": "out",
+              "name": "$return"
+            }
+          ]
+        }
+        ```
+   - Update `index/__init__.py` and copy following codes.
+        ```py
+        import os
+
+        import azure.functions as func
+
+        def main(req: func.HttpRequest) -> func.HttpResponse:
+            f = open(os.path.dirname(os.path.realpath(__file__)) + '/../index.html')
+            return func.HttpResponse(f.read(), mimetype='text/html')
+        ```
+
 4. Create a `negotiate` function to help clients get service connection url with access token.
     ```bash
     func new -n negotiate -t HttpTrigger
@@ -165,25 +227,25 @@ In this tutorial, you learn how to:
    - Update `negotiate/function.json` and copy following json codes.
         ```json
         {
-            "bindings": [
-                {
-                    "authLevel": "anonymous",
-                    "type": "httpTrigger",
-                    "direction": "in",
-                    "name": "req"
-                },
-                {
-                    "type": "http",
-                    "direction": "out",
-                    "name": "res"
-                },
-                {
-                    "type": "webPubSubConnection",
-                    "name": "connection",
-                    "hub": "notification",
-                    "direction": "in"
-                }
-            ]
+          "bindings": [
+            {
+              "authLevel": "anonymous",
+              "type": "httpTrigger",
+              "direction": "in",
+              "name": "req"
+            },
+            {
+              "type": "http",
+              "direction": "out",
+              "name": "res"
+            },
+            {
+              "type": "webPubSubConnection",
+              "name": "connection",
+              "hub": "notification",
+              "direction": "in"
+            }
+          ]
         }
         ```
    - Update `negotiate/index.js` and copy following codes.
@@ -211,32 +273,68 @@ In this tutorial, you learn how to:
         ```c#
         using Microsoft.Azure.WebJobs.Extensions.WebPubSub;
         ```
+    # [Python](#tab/python)
+   - Update `negotiate/function.json` and copy following json codes.
+        ```json
+        {
+          "scriptFile": "__init__.py",
+          "bindings": [
+            {
+              "authLevel": "anonymous",
+              "type": "httpTrigger",
+              "direction": "in",
+              "name": "req"
+            },
+            {
+              "type": "http",
+              "direction": "out",
+              "name": "$return"
+            },
+            {
+              "type": "webPubSubConnection",
+              "name": "connection",
+              "hub": "notification",
+              "direction": "in"
+            }
+          ]
+        }
+        ```
+   - Update `negotiate/__init__.py` and copy following codes.
+        ```py
+        import logging
+
+        import azure.functions as func
+
+
+        def main(req: func.HttpRequest, connection) -> func.HttpResponse:
+            return func.HttpResponse(connection)
+        ```
 
 5. Create a `notification` function to generate notifications with `TimerTrigger`.
-   ```bash
+    ```bash
     func new -n notification -t TimerTrigger
     ```
     # [JavaScript](#tab/javascript)
-   - Update `notification/function.json` and copy following json codes.
+    - Update `notification/function.json` and copy following json codes.
         ```json
         {
-            "bindings": [
-                {
-                "name": "myTimer",
-                "type": "timerTrigger",
-                "direction": "in",
-                "schedule": "*/10 * * * * *"
-                },
-                {
-                "type": "webPubSub",
-                "name": "actions",
-                "hub": "notification",
-                "direction": "out"
-                }
-            ]
+          "bindings": [
+            {
+              "name": "myTimer",
+              "type": "timerTrigger",
+              "direction": "in",
+              "schedule": "*/10 * * * * *"
+            },
+            {
+              "type": "webPubSub",
+              "name": "actions",
+              "hub": "notification",
+              "direction": "out"
+            }
+          ]
         }
         ```
-   - Update `notification/index.js` and copy following codes.
+    - Update `notification/index.js` and copy following codes.
         ```js
         module.exports = function (context, myTimer) {
             context.bindings.actions = {
@@ -251,8 +349,8 @@ In this tutorial, you learn how to:
             return (baseNum + 2 * floatNum * (Math.random() - 0.5)).toFixed(3);
         }
         ```
-   # [C#](#tab/csharp)
-   - Update `notification.cs` and replace `Run` function with following codes.
+    # [C#](#tab/csharp)
+    - Update `notification.cs` and replace `Run` function with following codes.
         ```c#
         [FunctionName("notification")]
         public static async Task Run([TimerTrigger("*/10 * * * * *")]TimerInfo myTimer, ILogger log,
@@ -272,11 +370,48 @@ In this tutorial, you learn how to:
             return value.ToString("0.000");
         }
         ``` 
-   - Add below `using` statements in header to resolve required dependencies.
+    - Add below `using` statements in header to resolve required dependencies.
         ```c#
         using Microsoft.Azure.WebJobs.Extensions.WebPubSub;
         using Microsoft.Azure.WebPubSub.Common;
         ```
+    # [Python](#tab/python)
+    - Update `notification/function.json` and copy following json codes.
+        ```json
+        {
+          "scriptFile": "__init__.py",
+          "bindings": [
+            {
+              "name": "myTimer",
+              "type": "timerTrigger",
+              "direction": "in",
+              "schedule": "*/10 * * * * *"
+            },
+            {
+              "type": "webPubSub",
+              "name": "actions",
+              "hub": "notification",
+              "direction": "out"
+            }
+          ]
+        }
+        ```
+    - Update `notification/__init__.py` and copy following codes.
+        ```py
+        import datetime
+        import random
+        import json
+
+        import azure.functions as func
+
+        def main(myTimer: func.TimerRequest, actions: func.Out[str]) -> None:
+            time = datetime.datetime.now().strftime("%A %d-%b-%Y %H:%M:%S")
+            actions.set(json.dumps({
+                'actionName': 'sendToAll',
+                'data': '\x5B DateTime: {0} \x5D Temperature: {1:.3f} \xB0C, Humidity: {2:.3f} \x25'.format(time, 22 + 2 * (random.random() - 0.5), 44 + 4 * (random.random() - 0.5)),
+                'dataType': 'text'
+            }))
+        ```
 
 6. Add the client single page `index.html` in the project root folder and copy content as below.
     ```html
@@ -302,7 +437,7 @@ In this tutorial, you learn how to:
         </body>
     </html>
     ```
-
+    
     # [JavaScript](#tab/javascript)
 
     # [C#](#tab/csharp)
@@ -314,6 +449,8 @@ In this tutorial, you learn how to:
         </None>
     </ItemGroup>
     ```
+    
+    # [Python](#tab/python)
 
 7. Configure and run the Azure Function app
 
@@ -337,7 +474,7 @@ In this tutorial, you learn how to:
     func start
     ```
 
-    And checking the running logs, you can visit your local host static page by visiting: `https://localhost:7071/api/index`.
+    And checking the running logs, you can visit your local host static page by visiting: `http://localhost:7071/api/index`.
 
 ## Deploy Function App to Azure
 
@@ -382,6 +519,12 @@ Use the following commands to create these item.
     az functionapp create --resource-group WebPubSubFunction --consumption-plan-location <REGION> --runtime dotnet --functions-version 3 --name <FUNCIONAPP_NAME> --storage-account <STORAGE_NAME>
     ```
 
+    # [Python](#tab/python)
+
+    ```azurecli
+    az functionapp create --resource-group WebPubSubFunction --consumption-plan-location <REGION> --runtime python --runtime-version 3.9 --functions-version 3 --name <FUNCIONAPP_NAME> --os-type linux --storage-account <STORAGE_NAME>
+    ```
+
 1. Deploy the function project to Azure:
 
     After you've successfully created your function app in Azure, you're now ready to deploy your local functions project by using the [func azure functionapp publish](../azure-functions/functions-run-local.md) command.