Merge pull request #178516 from gavin-aguiar/gaaguiar/update_func_python_docs

Updated python function docs to include retry context examples

Author: PRMerger17

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

@@ -302,6 +302,8 @@ def main(req, context):
         'ctx_invocation_id': context.invocation_id,
         'ctx_trace_context_Traceparent': context.trace_context.Traceparent,
         'ctx_trace_context_Tracestate': context.trace_context.Tracestate,
+        'ctx_retry_context_RetryCount': context.retry_context.retry_count,
+        'ctx_retry_context_MaxRetryCount': context.retry_context.max_retry_count,
     })
 ```
 
@@ -370,6 +372,12 @@ Name of the function.
 `invocation_id`
 ID of the current function invocation.
 
+`trace_context`
+Context for distributed tracing. Please refer to  [`Trace Context`](https://www.w3.org/TR/trace-context/) for more information..
+
+`retry_context`
+Context for retries to the function. Please refer to [`retry-policies`](./functions-bindings-errors.md#retry-policies-preview) for more information.
+
 ## Global variables
 
 It is not guaranteed that the state of your app will be preserved for future executions. However, the Azure Functions runtime often reuses the same process for multiple executions of the same app. In order to cache the results of an expensive computation, declare it as a global variable.

includes/functions-bindings-errors-retries.md

@@ -124,6 +124,23 @@ Here's the retry policy in the *function.json* file:
 }
 ```
 
+Here's a python sample to use retry context in a function:
+
+```Python
+import azure.functions
+import logging
+
+
+def main(req: azure.functions.HttpRequest, context: azure.functions.Context) -> None:
+    logging.log(f'Current retry count: {context.retry_context.retry_count}')
+    
+    if context.retry_context.retry_count == context.retry_context.max_retry_count:
+        logging.log(
+            f"Max retries of {context.retry_context.max_retry_count} for "
+            f"function {context.function_name} has been reached")
+   
+```
+
 # [Java](#tab/java)
 
 Here's the retry policy in the *function.json* file:
@@ -245,6 +262,23 @@ Here's the retry policy in the *function.json* file:
 }
 ```
 
+Here's a python sample to use retry context in a function:
+
+```Python
+import azure.functions
+import logging
+
+
+def main(req: azure.functions.HttpRequest, context: azure.functions.Context) -> None:
+    logging.log(f'Current retry count: {context.retry_context.retry_count}')
+    
+    if context.retry_context.retry_count == context.retry_context.max_retry_count:
+        logging.log(
+            f"Max retries of {context.retry_context.max_retry_count} for "
+            f"function {context.function_name} has been reached") 
+            
+```
+
 # [Java](#tab/java)
 
 Here's the retry policy in the *function.json* file: