Merge pull request #214216 from ggailey777/shreya

[Functions] Pystein with pivots

Author: PMEds28

articles/azure-functions/TOC.yml

@@ -229,6 +229,8 @@
           href: functions-bindings-return-value.md
         - name: Handle binding errors
           href: functions-bindings-errors.md
+        - name: Binding definitions for Python v2
+          href: functions-bindings-triggers-python.md  
     - name: Frameworks
       items:
         - name: Express.js

articles/azure-functions/create-first-function-cli-python.md

@@ -5,17 +5,18 @@ ms.date: 06/15/2022
 ms.topic: quickstart
 ms.devlang: python
 ms.custom: devx-track-python, devx-track-azurecli, devx-track-azurepowershell, mode-api, devdivchpfy22
-adobe-target: true
-adobe-target-activity: DocsExp–386541–A/B–Enhanced-Readability-Quickstarts–2.19.2021
-adobe-target-experience: Experience B
-adobe-target-content: ./create-first-function-cli-python-uiex
+zone_pivot_groups: python-mode-functions
+
 ---
 
 # Quickstart: Create a Python function in Azure from the command line
 
-[!INCLUDE [functions-language-selector-quickstart-cli](../../includes/functions-language-selector-quickstart-cli.md)]
+In this article, you use command-line tools to create a Python function that responds to HTTP requests. After testing the code locally, you deploy it to the serverless environment of Azure Functions. 
+
+This article covers both Python programming models supported by Azure Functions. Use the selector at the top to choose your programming model.  
 
-In this article, you use command-line tools to create a Python function that responds to HTTP requests. After testing the code locally, you deploy it to the serverless environment of Azure Functions.
+>[!NOTE]
+>The Python v2 programming model for Functions is currently in Preview. To learn more about the Python v2 programming model, see the [Developer Reference Guide](functions-reference-python.md).
 
 Completing this quickstart incurs a small cost of a few USD cents or less in your Azure account.
 
@@ -27,24 +28,35 @@ Before you begin, you must have the following requirements in place:
 
 + An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio).
 
+::: zone pivot="python-mode-configuration"  
 + The [Azure Functions Core Tools](functions-run-local.md#v2) version 4.x.
-
+::: zone-end
+::: zone pivot="python-mode-decorators"  
++ The [Azure Functions Core Tools](functions-run-local.md#v2) version 4.0.4785 or later.
+::: zone-end  
 + One of the following tools for creating Azure resources:
 
   + [Azure CLI](/cli/azure/install-azure-cli) version 2.4 or later.
 
   + The Azure [Az PowerShell module](/powershell/azure/install-az-ps) version 5.9.0 or later.
 
 + [Python versions that are supported by Azure Functions](supported-languages.md#languages-by-runtime-version).
+::: zone pivot="python-mode-decorators"  
++ The [Azurite storage emulator](../storage/common/storage-use-azurite.md?tabs=npm#install-azurite). While you can also use an actual Azure Storage account, the article assumes you're using this emulator.
+::: zone-end  
 
 ### Prerequisite check
 
 Verify your prerequisites, which depend on whether you're using Azure CLI or Azure PowerShell for creating Azure resources.
 
 # [Azure CLI](#tab/azure-cli)
 
+::: zone pivot="python-mode-configuration"
 + In a terminal or command window, run `func --version` to check that the Azure Functions Core Tools version is 4.x.
-
+::: zone-end
+::: zone pivot="python-mode-decorators"
++ In a terminal or command window, run `func --version` to check that the Azure Functions Core Tools version is 4.0.4785 or later.
+::: zone-end
 + Run `az --version` to check that the Azure CLI version is 2.4 or later.
 
 + Run `az login` to sign in to Azure and verify an active subscription.
@@ -111,6 +123,7 @@ You run all subsequent commands in this activated virtual environment.
 
 In Azure Functions, a function project is a container for one or more individual functions that each responds to a specific trigger. All functions in a project share the same local and hosting configurations. In this section, you create a function project that contains a single function.
 
+::: zone pivot="python-mode-configuration"
 1. Run the `func init` command as follows to create a functions project in a folder named *LocalFunctionProj* with the specified runtime.
 
     ```console
@@ -138,11 +151,41 @@ In Azure Functions, a function project is a container for one or more individual
     ```console
     func templates list -l python
     ```
+::: zone-end
+::: zone pivot="python-mode-decorators"
+1. Run the `func init` command as follows to create a functions project in a folder named *LocalFunctionProj* with the specified runtime and the specified programming model version.
+
+    ```console
+    func init LocalFunctionProj --python -m V2
+    ```
+
+1. Go to the project folder.
+
+    ```console
+    cd LocalFunctionProj
+    ```
+
+    This folder contains various files for the project, including configuration files named *[local.settings.json]*(functions-develop-local.md#local-settings-file) and *[host.json]*(functions-host-json.md). Because *local.settings.json* can contain secrets downloaded from Azure, the file is excluded from source control by default in the *.gitignore* file.
+
+1. The file `function_app.py` can include all functions within your project. To start with, there's already an HTTP function stored in the file.
+
+```python
+import azure.functions as func
+
+app = func.FunctionApp()
+
+@app.function_name(name="HttpTrigger1")
+@app.route(route="hello")
+def test_function(req: func.HttpRequest) -> func.HttpResponse:
+    return func.HttpResponse("HttpTrigger1 function processed a request!")%
+```
+::: zone-end
 
 ### (Optional) Examine the file contents
 
 If desired, you can skip to [Run the function locally](#run-the-function-locally) and examine the file contents later.
 
+::: zone pivot="python-mode-configuration"
 #### \_\_init\_\_.py
 
 *\_\_init\_\_.py* contains a `main()` Python function that's triggered according to the configuration in *function.json*.
@@ -160,6 +203,24 @@ If desired, you can change `scriptFile` to invoke a different Python file.
 :::code language="json" source="~/functions-quickstart-templates/Functions.Templates/Templates/HttpTrigger-Python/function.json":::
 
 Each binding requires a direction, a type, and a unique name. The HTTP trigger has an input binding of type [`httpTrigger`](functions-bindings-http-webhook-trigger.md) and output binding of type [`http`](functions-bindings-http-webhook-output.md).
+::: zone-end
+::: zone pivot="python-mode-decorators"
+`function_app.py` is the entry point to the function and where functions will be stored and/or referenced. This file will include configuration of triggers and bindings through decorators, and the function content itself. 
+
+For more information, see [Azure Functions HTTP triggers and bindings](./functions-bindings-http-webhook.md?tabs=python).
+
+## Start the storage emulator
+
+Before running the function locally, you must start the local Azurite storage emulator. You can skip this step if the `AzureWebJobsStorage` setting in the local.settings.json file is set to the connection string for an Azure Storage account.   
+
+Use the following command to start the Azurite storage emulator:
+
+```cmd
+azurite
+```
+
+For more information, see [Run Azurite](../storage/common/storage-use-azurite.md?tabs=npm#run-azurite)
+::: zone-end
 
 [!INCLUDE [functions-run-function-test-local-cli](../../includes/functions-run-function-test-local-cli.md)]
 
@@ -180,7 +241,7 @@ Use the following commands to create these items. Both Azure CLI and PowerShell
     az login
     ```
 
-    The [az login](/cli/azure/reference-index#az-login) command signs you into your Azure account.
+    The [`az login`](/cli/azure/reference-index#az-login) command signs you into your Azure account.
 
     # [Azure PowerShell](#tab/azure-powershell)
     ```azurepowershell
@@ -224,6 +285,10 @@ Use the following commands to create these items. Both Azure CLI and PowerShell
 
     ---
 
+    ::: zone pivot="python-mode-decorators" 
+    In the current v2 programming model preview, choose a region from one of the following locations: France Central, West Central US, North Europe, China East, East US, or North Central US.
+    ::: zone-end
+
     > [!NOTE]
     > You can't host Linux and Windows apps in the same resource group. If you have an existing resource group named `AzureFunctionsQuickstart-rg` with a Windows function app or web app, you must use a different resource group.
 
@@ -273,11 +338,35 @@ Use the following commands to create these items. Both Azure CLI and PowerShell
 
     In the previous example, replace `<APP_NAME>` with a globally unique name appropriate to you. The `<APP_NAME>` is also the default DNS domain for the function app.
 
-    This command creates a function app running in your specified language runtime under the [Azure Functions Consumption Plan](consumption-plan.md), which is free for the amount of usage you incur here. The command also provisions an associated Azure Application Insights instance in the same resource group, with which you can monitor your function app and view logs. For more information, see [Monitor Azure Functions](functions-monitoring.md). The instance incurs no costs until you activate it.
+    This command creates a function app running in your specified language runtime under the [Azure Functions Consumption Plan](consumption-plan.md), which is free for the amount of usage you incur here. The command also creates an associated Azure Application Insights instance in the same resource group, with which you can monitor your function app and view logs. For more information, see [Monitor Azure Functions](functions-monitoring.md). The instance incurs no costs until you activate it.
 
 [!INCLUDE [functions-publish-project-cli](../../includes/functions-publish-project-cli.md)]
 
-[!INCLUDE [functions-run-remote-azure-cli](../../includes/functions-run-remote-azure-cli.md)]
+::: zone pivot="python-mode-decorators"
+## Update app settings
+
+To use the Python v2 model in your function app, you need to add a new application setting in Azure named `AzureWebJobsFeatureFlags` with a value of `EnableWorkerIndexing`. This setting is already in your local.settings.json file. 
+
+Run the following command to add this setting to your new function app in Azure.
+
+# [Azure CLI](#tab/azure-cli)
+
+```azurecli 
+az functionapp config appsettings set --name <FUNCTION_APP_NAME> --resource-group <RESOURCE_GROUP_NAME> --settings AzureWebJobsFeatureFlags=EnableWorkerIndexing
+```
+
+# [Azure PowerShell](#tab/azure-powershell)
+
+```azurepowershell
+Update-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME> -AppSetting @{"AzureWebJobsFeatureFlags" = "EnableWorkerIndexing"}
+```
+
+---
+
+In the previous example, replace `<FUNCTION_APP_NAME>` and `<RESOURCE_GROUP_NAME>` with the name of your function app and resource group, respectively. This setting is already in your local.settings.json file.
+::: zone-end
+
+## Verify in Azure
 
 Run the following command to view near real-time [streaming logs](functions-run-local.md#enable-streaming-logs) in Application Insights in the Azure portal.
 
@@ -294,4 +383,7 @@ In a separate terminal window or in the browser, call the remote function again.
 > [!div class="nextstepaction"]
 > [Connect to an Azure Storage queue](functions-add-output-binding-storage-queue-cli.md?pivots=programming-language-python)
 
-[Having issues? Let us know.](https://aka.ms/python-functions-qs-survey)
+Having issues with this article? 
+
++ [Troubleshoot Python function apps in Azure Functions](recover-python-functions.md)
++ [Let us know](https://aka.ms/python-functions-qs-survey)