Merge pull request #230186 from vrdmr/vameru/updating-linespacing-examples

Updating PyStein examples in docs

Author: prmerger-automator[bot]

articles/azure-functions/functions-reference-python.md

@@ -80,7 +80,6 @@ You can also explicitly declare the attribute types and return type in the funct
 ```python
 import azure.functions
 
-
 def main(req: azure.functions.HttpRequest) -> str:
     user = req.params.get('user')
     return f'Hello, {user}!'
@@ -97,7 +96,6 @@ Triggers and bindings can be declared and used in a function in a decorator base
 ```python
 @app.function_name(name="HttpTrigger1")
 @app.route(route="req")
-
 def main(req):
     user = req.params.get('user')
     return f'Hello, {user}!'
@@ -108,9 +106,10 @@ You can also explicitly declare the attribute types and return type in the funct
 ```python
 import azure.functions
 
+app = func.FunctionApp()
+
 @app.function_name(name="HttpTrigger1")
 @app.route(route="req")
-
 def main(req: azure.functions.HttpRequest) -> str:
     user = req.params.get('user')
     return f'Hello, {user}!'
@@ -335,7 +334,7 @@ For example, the following code demonstrates the difference between the two inpu
       "direction": "in",
       "type": "blob",
       "path": "samples/{id}",
-      "connection": "AzureWebJobsStorage"
+      "connection": "STORAGE_CONNECTION_STRING"
     }
   ]
 }
@@ -347,6 +346,7 @@ For example, the following code demonstrates the difference between the two inpu
   "IsEncrypted": false,
   "Values": {
     "FUNCTIONS_WORKER_RUNTIME": "python",
+    "STORAGE_CONNECTION_STRING": "<AZURE_STORAGE_CONNECTION_STRING>",
     "AzureWebJobsStorage": "<azure-storage-connection-string>"
   }
 }
@@ -357,14 +357,11 @@ For example, the following code demonstrates the difference between the two inpu
 import azure.functions as func
 import logging
 
-
-def main(req: func.HttpRequest,
-         obj: func.InputStream):
-
+def main(req: func.HttpRequest, obj: func.InputStream):
     logging.info(f'Python HTTP-triggered function processed: {obj.read()}')
 ```
 
-When the function is invoked, the HTTP request is passed to the function as `req`. An entry will be retrieved from the Azure Blob Storage account based on the _ID_ in the route URL and made available as `obj` in the function body.  Here, the specified storage account is the connection string that's found in the `AzureWebJobsStorage` app setting, which is the same storage account that's used by the function app.
+When the function is invoked, the HTTP request is passed to the function as `req`. An entry will be retrieved from the Azure Blob Storage account based on the _ID_ in the route URL and made available as `obj` in the function body.  Here, the specified storage account is the connection string that's found in the `CONNECTION_STRING` app setting.
 ::: zone-end
 ::: zone pivot="python-mode-decorators" 
 Inputs are divided into two categories in Azure Functions: trigger input and other input. Although they're defined using different decorators, their usage is similar in Python code. Connection strings or secrets for trigger and input sources map to values in the *local.settings.json* file when they're running locally, and they map to the application settings when they're running in Azure.
@@ -377,6 +374,7 @@ As an example, the following code demonstrates how to define a Blob Storage inpu
   "IsEncrypted": false,
   "Values": {
     "FUNCTIONS_WORKER_RUNTIME": "python",
+    "STORAGE_CONNECTION_STRING": "<AZURE_STORAGE_CONNECTION_STRING>",
     "AzureWebJobsStorage": "<azure-storage-connection-string>",
     "AzureWebJobsFeatureFlags": "EnableWorkerIndexing"
   }
@@ -391,14 +389,13 @@ import logging
 app = func.FunctionApp()
 
 @app.route(route="req")
-@app.read_blob(arg_name="obj", path="samples/{id}", connection="AzureWebJobsStorage")
-
-def main(req: func.HttpRequest,
-         obj: func.InputStream):
+@app.read_blob(arg_name="obj", path="samples/{id}", 
+               connection="STORAGE_CONNECTION_STRING")
+def main(req: func.HttpRequest, obj: func.InputStream):
     logging.info(f'Python HTTP-triggered function processed: {obj.read()}')
 ```
 
-When the function is invoked, the HTTP request is passed to the function as `req`. An entry will be retrieved from the Azure Blob Storage account based on the _ID_ in the route URL and made available as `obj` in the function body.  Here, the specified storage account is the connection string that's found in the AzureWebJobsStorage app setting, which is the same storage account that's used by the function app.
+When the function is invoked, the HTTP request is passed to the function as `req`. An entry will be retrieved from the Azure Blob Storage account based on the _ID_ in the route URL and made available as `obj` in the function body.  Here, the specified storage account is the connection string that's found in the `STORAGE_CONNECTION_STRING` app setting.
 ::: zone-end
 
 For data intensive binding operations, you may want to use a separate storage account. For more information, see [Storage account guidance](storage-considerations.md#storage-account-guidance).
@@ -445,7 +442,7 @@ To produce multiple outputs, use the `set()` method provided by the [`azure.func
       "direction": "out",
       "type": "queue",
       "queueName": "outqueue",
-      "connection": "AzureWebJobsStorage"
+      "connection": "STORAGE_CONNECTION_STRING"
     },
     {
       "name": "$return",
@@ -459,7 +456,6 @@ To produce multiple outputs, use the `set()` method provided by the [`azure.func
 ```python
 import azure.functions as func
 
-
 def main(req: func.HttpRequest,
          msg: func.Out[func.QueueMessage]) -> str:
 
@@ -478,10 +474,10 @@ To produce multiple outputs, use the `set()` method provided by the [`azure.func
 # function_app.py
 import azure.functions as func
 
+app = func.FunctionApp()
 
 @app.write_blob(arg_name="msg", path="output-container/{name}",
-                connection="AzureWebJobsStorage")
-                
+                connection="CONNECTION_STRING")
 def test_function(req: func.HttpRequest,
                   msg: func.Out[str]) -> str:
 
@@ -500,7 +496,6 @@ The following example logs an info message when the function is invoked via an H
 ```python
 import logging
 
-
 def main(req):
     logging.info('Python HTTP trigger function processed a request.')
 ```
@@ -639,7 +634,6 @@ The following example is from the HTTP trigger template for the Python v2 progra
 ```python
 @app.function_name(name="HttpTrigger1")
 @app.route(route="hello")
-
 def test_function(req: func.HttpRequest) -> func.HttpResponse:
      logging.info('Python HTTP trigger function processed a request.')
 
@@ -909,13 +903,13 @@ The following example uses `os.environ["myAppSetting"]` to get the [application
 ```python
 import logging
 import os
+
 import azure.functions as func
 
 def main(req: func.HttpRequest) -> func.HttpResponse:
-
-    # Get the setting named 'myAppSetting'
-    my_app_setting_value = os.environ["myAppSetting"]
-    logging.info(f'My app setting value:{my_app_setting_value}')
+  # Get the setting named 'myAppSetting'
+  my_app_setting_value = os.environ["myAppSetting"]
+  logging.info(f'My app setting value:{my_app_setting_value}')
 ```
 
 For local development, application settings are [maintained in the *local.settings.json* file](functions-develop-local.md#local-settings-file).
@@ -936,17 +930,17 @@ The following example uses `os.environ["myAppSetting"]` to get the [application
 ```python
 import logging
 import os
+
 import azure.functions as func
 
+app = func.FunctionApp()
+
 @app.function_name(name="HttpTrigger1")
 @app.route(route="req")
-
 def main(req: func.HttpRequest) -> func.HttpResponse:
-
-
-    # Get the setting named 'myAppSetting'
-    my_app_setting_value = os.environ["myAppSetting"]
-    logging.info(f'My app setting value:{my_app_setting_value}')
+  # Get the setting named 'myAppSetting'
+  my_app_setting_value = os.environ["myAppSetting"]
+  logging.info(f'My app setting value:{my_app_setting_value}')
 ```
 
 For local development, application settings are [maintained in the *local.settings.json* file](functions-develop-local.md#local-settings-file).
@@ -1112,14 +1106,14 @@ from shared_code import my_second_helper_function
 # Define an HTTP trigger that accepts the ?value=<int> query parameter
 # Double the value and return the result in HttpResponse
 def main(req: func.HttpRequest) -> func.HttpResponse:
-    logging.info('Executing my_second_function.')
+  logging.info('Executing my_second_function.')
 
-    initial_value: int = int(req.params.get('value'))
-    doubled_value: int = my_second_helper_function.double(initial_value)
+  initial_value: int = int(req.params.get('value'))
+  doubled_value: int = my_second_helper_function.double(initial_value)
 
-    return func.HttpResponse(
-      body=f"{initial_value} * 2 = {doubled_value}",
-      status_code=200
+  return func.HttpResponse(
+    body=f"{initial_value} * 2 = {doubled_value}",
+    status_code=200
     )
 ```
 
@@ -1145,22 +1139,17 @@ import azure.functions as func
 from my_second_function import main
 
 class TestFunction(unittest.TestCase):
-    def test_my_second_function(self):
-        # Construct a mock HTTP request.
-        req = func.HttpRequest(
-            method='GET',
-            body=None,
-            url='/api/my_second_function',
-            params={'value': '21'})
-
-        # Call the function.
-        resp = main(req)
-
-        # Check the output.
-        self.assertEqual(
-            resp.get_body(),
-            b'21 * 2 = 42',
-        )
+  def test_my_second_function(self):
+    # Construct a mock HTTP request.
+    req = func.HttpRequest(method='GET',
+                           body=None,
+                           url='/api/my_second_function',
+                           params={'value': '21'})
+    # Call the function.
+    resp = main(req)
+
+    # Check the output.
+    self.assertEqual(resp.get_body(), b'21 * 2 = 42',)
 ```
 
 Inside your *.venv* Python virtual environment folder, install your favorite Python test framework, such as `pip install pytest`. Then run `pytest tests` to check the test result.
@@ -1180,7 +1169,6 @@ from shared_code import my_second_helper_function
 
 app = func.FunctionApp()
 
-
 # Define the HTTP trigger that accepts the ?value=<int> query parameter
 # Double the value and return the result in HttpResponse
 @app.function_name(name="my_second_function")
@@ -1215,27 +1203,24 @@ You can start writing test cases for your HTTP trigger.
 # <project_root>/tests/test_my_second_function.py
 import unittest
 import azure.functions as func
-from function_app import main
 
+from function_app import main
 
 class TestFunction(unittest.TestCase):
-    def test_my_second_function(self):
-        # Construct a mock HTTP request.
-        req = func.HttpRequest(
-            method='GET',
-            body=None,
-            url='/api/my_second_function',
-            params={'value': '21'})
-
-        # Call the function.
-        func_call = main.build().get_user_function()
-        resp = func_call(req)
-
-        # Check the output.
-        self.assertEqual(
-            resp.get_body(),
-            b'21 * 2 = 42',
-        )
+  def test_my_second_function(self):
+    # Construct a mock HTTP request.
+    req = func.HttpRequest(method='GET',
+                           body=None,
+                           url='/api/my_second_function',
+                           params={'value': '21'})
+    # Call the function.
+    func_call = main.build().get_user_function()
+    resp = func_call(req)
+    # Check the output.
+    self.assertEqual(
+        resp.get_body(),
+        b'21 * 2 = 42',
+    )
 ```
 
 Inside your *.venv* Python virtual environment folder, install your favorite Python test framework, such as `pip install pytest`. Then run `pytest tests` to check the test result.
@@ -1255,6 +1240,7 @@ The following example creates a named temporary file in the temporary directory
 import logging
 import azure.functions as func
 import tempfile
+
 from os import listdir
 
 #---