From 56947152b9675bb944d48a8aeb68b0c0370e89dc Mon Sep 17 00:00:00 2001 From: Victoria Hall Date: Mon, 31 Aug 2026 13:43:01 -0500 Subject: [PATCH 1/2] docs: clean up links & samples --- README.md | 20 +++++---- .../README.md | 14 +++---- .../samples/README.md | 8 ++-- .../README.md | 36 ++++++++-------- .../samples/README.md | 19 +++++---- .../function_app.py | 2 +- .../README.md | 42 +++++++++++-------- .../samples/README.md | 13 +++--- .../function_app.py | 10 ++--- .../README.md | 12 +++--- .../samples/README.md | 10 ++--- .../README.md | 18 ++++---- .../samples/README.md | 2 +- .../README.md | 8 ++-- .../samples/README.md | 6 +-- .../official/jobs/publish-release.yml | 1 + 16 files changed, 118 insertions(+), 103 deletions(-) diff --git a/README.md b/README.md index 698f964..6c901d2 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ This repository is for the active development of the Azure Functions extensions for the Python worker. For consumers of these extensions we recommend -visiting our [public developer docs](https://docs.microsoft.com/python/azure/). +visiting the [Python developer reference for Azure Functions](https://learn.microsoft.com/azure/azure-functions/functions-reference-python). ## Getting started @@ -12,15 +12,21 @@ in the library's project folder. ### Prerequisites -The libraries are supported on Function Apps using Python 3.9 or later. For more details, please read our page on -[Python Functions version support policy](https://learn.microsoft.com/en-us/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +A supported Python version is required - see +[Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages) for more information. -## SDK Support -* Azure Storage Blob +## Available extensions +* [Base extension](azurefunctions-extensions-base/README.md) +* [Azure Blob Storage bindings](azurefunctions-extensions-bindings-blob/README.md) +* [Azure Cosmos DB bindings](azurefunctions-extensions-bindings-cosmosdb/README.md) +* [Azure Event Hubs bindings](azurefunctions-extensions-bindings-eventhub/README.md) +* [Azure Service Bus bindings](azurefunctions-extensions-bindings-servicebus/README.md) +* [Connector bindings](azurefunctions-extensions-connectors/README.md) +* [FastAPI HTTP streaming](azurefunctions-extensions-http-fastapi/README.md) ## Need help? -* For detailed documentation visit our [Azure Functions Extensions for Python documentation]() +* Read the [Python developer reference for Azure Functions](https://learn.microsoft.com/azure/azure-functions/functions-reference-python) * File an issue via [GitHub Issues](https://github.com/Azure/azure-functions-python-extensions/issues) * Check [previous questions](https://stackoverflow.com/questions/tagged/azure+python) or ask new ones on StackOverflow using `azure` and `python` tags. @@ -46,6 +52,6 @@ contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additio This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow -[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general). +[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/legal/intellectualproperty/trademarks/usage/general). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies. diff --git a/azurefunctions-extensions-bindings-blob/README.md b/azurefunctions-extensions-bindings-blob/README.md index eb40c8b..ea5fc0f 100644 --- a/azurefunctions-extensions-bindings-blob/README.md +++ b/azurefunctions-extensions-bindings-blob/README.md @@ -17,10 +17,10 @@ Blob client types can be generated from: ## Getting started ### Prerequisites -* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/en-us/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). * You must have an [Azure subscription](https://azure.microsoft.com/free/) and an -[Azure storage account](https://docs.microsoft.com/azure/storage/common/storage-account-overview) to use this package. +[Azure storage account](https://learn.microsoft.com/azure/storage/common/storage-account-overview) to use this package. ### Install the package Install the Azure Functions Extensions Bindings Blob library for Python with pip: @@ -31,9 +31,9 @@ pip install azurefunctions-extensions-bindings-blob ### Create a storage account If you wish to create a new storage account, you can use the -[Azure Portal](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-portal), -[Azure PowerShell](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-powershell), -or [Azure CLI](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-cli): +[Azure portal](https://learn.microsoft.com/azure/storage/common/storage-account-create?tabs=azure-portal), +[Azure PowerShell](https://learn.microsoft.com/azure/storage/common/storage-account-create?tabs=azure-powershell), +or [Azure CLI](https://learn.microsoft.com/azure/storage/common/storage-account-create?tabs=azure-cli): ```bash # Create a new resource group to hold the storage account - @@ -104,11 +104,11 @@ Several samples are available in this GitHub repository. These samples provide e * From BlobInput ### Additional documentation -For more information on the Azure Storage Blob SDK, see the [Azure Blob storage documentation](https://docs.microsoft.com/azure/storage/blobs/) on docs.microsoft.com +For more information on the Azure Storage Blob SDK, see the [Azure Blob storage documentation](https://learn.microsoft.com/azure/storage/blobs/) and the [Azure Storage Blobs README](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob). ## Contributing -This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com. +This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com. When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA. diff --git a/azurefunctions-extensions-bindings-blob/samples/README.md b/azurefunctions-extensions-bindings-blob/samples/README.md index 96e0743..f4f271c 100644 --- a/azurefunctions-extensions-bindings-blob/samples/README.md +++ b/azurefunctions-extensions-bindings-blob/samples/README.md @@ -30,13 +30,13 @@ examples on how to use the Azure Storage Blob client library, please see [Azure * From BlobInput ## Prerequisites -* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/en-us/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). * You must have an [Azure subscription](https://azure.microsoft.com/free/) and an -[Azure storage account](https://docs.microsoft.com/azure/storage/common/storage-account-overview) to use this package. +[Azure storage account](https://learn.microsoft.com/azure/storage/common/storage-account-overview) to use this package. ## Setup -1. Install [Core Tools](https://learn.microsoft.com/en-us/azure/azure-functions/functions-run-local?tabs=windows%2Cisolated-process%2Cnode-v4%2Cpython-v2%2Chttp-trigger%2Ccontainer-apps&pivots=programming-language-python) +1. Install [Core Tools](https://learn.microsoft.com/azure/azure-functions/functions-run-local?tabs=windows%2Cisolated-process%2Cnode-v4%2Cpython-v2%2Chttp-trigger%2Ccontainer-apps&pivots=programming-language-python) 2. Install the Azure Functions Extension Blob library for Python with [pip](https://pypi.org/project/pip/): ```bash @@ -63,6 +63,6 @@ based on the type of function you wish to execute. ## Next steps -Visit the [SDK-type bindings in Python reference documentation](https://learn.microsoft.com/en-us/azure/azure-functions/functions-reference-python?tabs=get-started%2Casgi%2Capplication-level&pivots=python-mode-decorators#sdk-type-bindings-preview) to learn more about how to use SDK-type bindings in a Python Function App and the +Visit the [SDK-type bindings in Python reference documentation](https://learn.microsoft.com/azure/azure-functions/functions-reference-python?pivots=python-mode-decorators#sdk-type-bindings) to learn more about how to use SDK-type bindings in a Python Function App and the [API reference documentation](https://aka.ms/azsdk-python-storage-blob-ref) to learn more about what you can do with the Azure Storage Blob client library. \ No newline at end of file diff --git a/azurefunctions-extensions-bindings-cosmosdb/README.md b/azurefunctions-extensions-bindings-cosmosdb/README.md index 176292d..9edaae3 100644 --- a/azurefunctions-extensions-bindings-cosmosdb/README.md +++ b/azurefunctions-extensions-bindings-cosmosdb/README.md @@ -14,10 +14,10 @@ Cosmos DB client types can be generated from: ## Getting started ### Prerequisites -* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/en-us/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). * You must have an [Azure subscription](https://azure.microsoft.com/free/) and an -[Azure storage account](https://docs.microsoft.com/azure/storage/common/storage-account-overview) to use this package. +[Azure Cosmos DB for NoSQL account](https://learn.microsoft.com/azure/cosmos-db/nosql/quickstart-portal) to use this package. ### Install the package Install the Azure Functions Extensions Bindings Cosmos DB library for Python with pip: @@ -26,26 +26,28 @@ Install the Azure Functions Extensions Bindings Cosmos DB library for Python wit pip install azurefunctions-extensions-bindings-cosmosdb ``` -### Create a storage account -If you wish to create a new storage account, you can use the -[Azure Portal](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-portal), -[Azure PowerShell](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-powershell), -or [Azure CLI](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-cli): +### Create a Cosmos DB account +If you wish to create a new Azure Cosmos DB for NoSQL account, you can use the +[Azure portal](https://learn.microsoft.com/azure/cosmos-db/nosql/quickstart-portal) +or [Azure CLI](https://learn.microsoft.com/cli/azure/cosmosdb?view=azure-cli-latest): ```bash -# Create a new resource group to hold the storage account - +# Create a new resource group to hold the Cosmos DB account - # if using an existing resource group, skip this step -az group create --name my-resource-group --location westus2 +resourceGroupName="my-resource-group" +accountName="my-unique-cosmos-account" -# Create the storage account -az storage account create -n my-storage-account-name -g my-resource-group +az group create --name $resourceGroupName --location westus2 + +# Create the Cosmos DB for NoSQL account +az cosmosdb create --resource-group $resourceGroupName --name $accountName --locations regionName=westus2 ``` ### Bind to the SDK-type The Azure Functions Extensions Bindings Cosmos DB library for Python allows you to create a function app with Cosmos DB Input and define the type as a CosmosClient, DatabaseProxy, or ContainerProxy. Instead of receiving a DocumentList, when the function is executed, the type returned will be the defined SDK-type and have all of the -properties and methods available as seen in the Azure Storage Cosmos DB library for Python. +properties and methods available as seen in the Azure Cosmos DB library for Python. ```python @@ -56,7 +58,7 @@ import azurefunctions.extensions.bindings.cosmosdb as cosmos app = func.FunctionApp(http_auth_level=func.AuthLevel.FUNCTION) @app.route(route="cosmos") -@app.cosmos_db_input(arg_name="container", +@app.cosmos_db_input(arg_name="client", connection="CosmosDBConnection", database_name="db_name", container_name="container_name") @@ -82,21 +84,21 @@ Get started with our [Cosmos DB samples](https://github.com/Azure/azure-function Several samples are available in this GitHub repository. These samples provide example code for additional scenarios commonly encountered while working with Cosmos DB: -* [cosmosdb_samples_cosmosclient](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-binding-cosmosdb/samples/cosmosdb_samples_cosmosclient) - Examples for using the CosmosClient type: +* [cosmosdb_samples_cosmosclient](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-bindings-cosmosdb/samples/cosmosdb_samples_cosmosclient) - Examples for using the CosmosClient type: * From CosmosDBInput * [cosmosdb_samples_databaseproxy](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-bindings-cosmosdb/samples/cosmosdb_samples_databaseproxy) - Examples for using the DatabaseProxy type: * From CosmosDBInput -* [cosmosdb_samples_containerclient](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-bindings-cosmosdb/samples/cosmosdb_samples_containerproxy) - Examples for using the ContainerProxy type: +* [cosmosdb_samples_containerproxy](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-bindings-cosmosdb/samples/cosmosdb_samples_containerproxy) - Examples for using the ContainerProxy type: * From CosmosDBInput ### Additional documentation -For more information on the Azure Cosmos DB SDK, see the [Azure Cosmos DB documentation](https://learn.microsoft.com/en-us/azure/cosmos-db/) on learn.microsoft.com +For more information on the Azure Cosmos DB SDK, see the [Azure Cosmos DB documentation](https://learn.microsoft.com/azure/cosmos-db/) on learn.microsoft.com and the [Azure Cosmos DB README](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/cosmos/azure-cosmos). ## Contributing -This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com. +This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com. When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA. diff --git a/azurefunctions-extensions-bindings-cosmosdb/samples/README.md b/azurefunctions-extensions-bindings-cosmosdb/samples/README.md index dec6d4e..37f3e9c 100644 --- a/azurefunctions-extensions-bindings-cosmosdb/samples/README.md +++ b/azurefunctions-extensions-bindings-cosmosdb/samples/README.md @@ -14,26 +14,27 @@ urlFragment: extension-cosmosdb-samples These are code samples that show common scenario operations with the Azure Functions Extension Cosmos DB library. -These samples relate to the Azure Storage Cosmos DB client library being used as part of a Python Function App. For -examples on how to use the Azure Storage Cosmos DB client library, please see [Azure Cosmos samples](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/cosmos/azure-cosmos/samples) +These samples relate to the Azure Cosmos DB client library being used as part of a Python Function App. For +examples on how to use the Azure Cosmos DB client library, please see [Azure Cosmos samples](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/cosmos/azure-cosmos/samples) -* [cosmosdb_samples_cosmosclient](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-binding-cosmosdb/samples/cosmosdb_samples_cosmosclient) - Examples for using the CosmosClient type: +* [cosmosdb_samples_cosmosclient](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-bindings-cosmosdb/samples/cosmosdb_samples_cosmosclient) - Examples for using the CosmosClient type: * From CosmosDBInput * [cosmosdb_samples_databaseproxy](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-bindings-cosmosdb/samples/cosmosdb_samples_databaseproxy) - Examples for using the DatabaseProxy type: * From CosmosDBInput -* [cosmosdb_samples_containerclient](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-bindings-cosmosdb/samples/cosmosdb_samples_containerproxy) - Examples for using the ContainerProxy type: +* [cosmosdb_samples_containerproxy](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-bindings-cosmosdb/samples/cosmosdb_samples_containerproxy) - Examples for using the ContainerProxy type: * From CosmosDBInput ## Prerequisites -* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/en-us/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). * You must have an [Azure subscription](https://azure.microsoft.com/free/) and an -[Azure storage account](https://docs.microsoft.com/azure/storage/common/storage-account-overview) to use this package. +[Azure Cosmos DB for NoSQL account](https://learn.microsoft.com/azure/cosmos-db/nosql/quickstart-portal) to use these samples. +* You must run [Azurite](https://learn.microsoft.com/azure/storage/common/storage-use-azurite) or configure an Azure storage account for the Functions host. ## Setup -1. Install [Core Tools](https://learn.microsoft.com/en-us/azure/azure-functions/functions-run-local?tabs=windows%2Cisolated-process%2Cnode-v4%2Cpython-v2%2Chttp-trigger%2Ccontainer-apps&pivots=programming-language-python) +1. Install [Core Tools](https://learn.microsoft.com/azure/azure-functions/functions-run-local?tabs=windows%2Cisolated-process%2Cnode-v4%2Cpython-v2%2Chttp-trigger%2Ccontainer-apps&pivots=programming-language-python) 2. Install the Azure Functions Extension Cosmos DB library for Python with [pip](https://pypi.org/project/pip/): ```bash @@ -60,6 +61,6 @@ based on the type of function you wish to execute. ## Next steps -Visit the [SDK-type bindings in Python reference documentation](https://learn.microsoft.com/en-us/azure/azure-functions/functions-reference-python?tabs=get-started%2Casgi%2Capplication-level&pivots=python-mode-decorators#sdk-type-bindings-preview) to learn more about how to use SDK-type bindings in a Python Function App and the -[API reference documentation](https://learn.microsoft.com/en-us/python/api/azure-cosmos/azure.cosmos?view=azure-python) to learn more about +Visit the [SDK-type bindings in Python reference documentation](https://learn.microsoft.com/azure/azure-functions/functions-reference-python?pivots=python-mode-decorators#sdk-type-bindings) to learn more about how to use SDK-type bindings in a Python Function App and the +[API reference documentation](https://learn.microsoft.com/python/api/azure-cosmos/azure.cosmos?view=azure-python) to learn more about what you can do with the Azure Cosmos DB client library. \ No newline at end of file diff --git a/azurefunctions-extensions-bindings-cosmosdb/samples/cosmosdb_samples_databaseproxy/function_app.py b/azurefunctions-extensions-bindings-cosmosdb/samples/cosmosdb_samples_databaseproxy/function_app.py index e81148b..7eae8de 100644 --- a/azurefunctions-extensions-bindings-cosmosdb/samples/cosmosdb_samples_databaseproxy/function_app.py +++ b/azurefunctions-extensions-bindings-cosmosdb/samples/cosmosdb_samples_databaseproxy/function_app.py @@ -22,7 +22,7 @@ @app.route(route="database") -@app.cosmos_db_input(arg_name="container", +@app.cosmos_db_input(arg_name="database", connection="CosmosDBConnection", database_name="db_name", container_name=None) diff --git a/azurefunctions-extensions-bindings-eventhub/README.md b/azurefunctions-extensions-bindings-eventhub/README.md index 6221d2f..0f711f8 100644 --- a/azurefunctions-extensions-bindings-eventhub/README.md +++ b/azurefunctions-extensions-bindings-eventhub/README.md @@ -18,10 +18,10 @@ The supported EventHub SDK types include: ## Getting started ### Prerequisites -* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/en-us/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). -* You must have an [Azure subscription](https://azure.microsoft.com/free/) and an -[Azure storage account](https://docs.microsoft.com/azure/storage/common/storage-account-overview) to use this package. +* You must have an [Azure subscription](https://azure.microsoft.com/free/), an +[Azure Event Hubs namespace, and an event hub](https://learn.microsoft.com/azure/event-hubs/event-hubs-create) to use this package. ### Install the package Install the Azure Functions Extensions Bindings EventHub library for Python with pip: @@ -30,19 +30,23 @@ Install the Azure Functions Extensions Bindings EventHub library for Python with pip install azurefunctions-extensions-bindings-eventhub ``` -### Create a storage account -If you wish to create a new storage account, you can use the -[Azure Portal](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-portal), -[Azure PowerShell](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-powershell), -or [Azure CLI](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-cli): +### Create Event Hubs resources +If you wish to create a new Event Hubs namespace and event hub, you can use the +[Azure portal](https://learn.microsoft.com/azure/event-hubs/event-hubs-create) +or [Azure CLI](https://learn.microsoft.com/cli/azure/eventhubs?view=azure-cli-latest): ```bash -# Create a new resource group to hold the storage account - +resourceGroupName="my-resource-group" +eventHubNamespaceName="my-unique-event-hubs-namespace" +eventHubName="my-event-hub" + +# Create a new resource group to hold the Event Hubs namespace - # if using an existing resource group, skip this step -az group create --name my-resource-group --location westus2 +az group create --name $resourceGroupName --location westus2 -# Create the storage account -az storage account create -n my-storage-account-name -g my-resource-group +# Create the Event Hubs namespace and event hub +az eventhubs namespace create --resource-group $resourceGroupName --name $eventHubNamespaceName +az eventhubs eventhub create --resource-group $resourceGroupName --namespace-name $eventHubNamespaceName --name $eventHubName ``` ### Bind to the SDK-type @@ -52,15 +56,17 @@ and define the type as an EventData. Instead of receiving an EventHubEvent, when ```python import logging +from typing import List + import azure.functions as func import azurefunctions.extensions.bindings.eventhub as eh app = func.FunctionApp(http_auth_level=func.AuthLevel.FUNCTION) @app.event_hub_message_trigger( - arg_name="event", event_hub_name="EVENTHUB_NAME", connection="AzureWebJobsStorage" + arg_name="event", event_hub_name="EVENTHUB_NAME", connection="EventHubConnection" ) -def eventhub_trigger(event: eh.EventData): +def eventhub_trigger_single(event: eh.EventData): logging.info( "Python EventHub trigger processed an event %s", event.body_as_str() @@ -68,9 +74,9 @@ def eventhub_trigger(event: eh.EventData): @app.event_hub_message_trigger( - arg_name="events", event_hub_name="EVENTHUB_NAME", connection="AzureWebJobsStorage", cardinality="many" + arg_name="events", event_hub_name="EVENTHUB_NAME", connection="EventHubConnection", cardinality="many" ) -def eventhub_trigger(events: List[eh.EventData]): +def eventhub_trigger_batch(events: List[eh.EventData]): for event in events: logging.info( "Python EventHub trigger processed an event %s", @@ -96,11 +102,11 @@ Several samples are available in this GitHub repository. These samples provide e * From EventHubTrigger ### Additional documentation -For more information on the Azure EventHub SDK, see the [Azure EventHub documentation](https://learn.microsoft.com/en-us/azure/event-hubs/) on learn.microsoft.com +For more information on the Azure EventHub SDK, see the [Azure EventHub documentation](https://learn.microsoft.com/azure/event-hubs/) on learn.microsoft.com and the [Azure EventHub README](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/eventhub/azure-eventhub/README.md). ## Contributing -This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com. +This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com. When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA. diff --git a/azurefunctions-extensions-bindings-eventhub/samples/README.md b/azurefunctions-extensions-bindings-eventhub/samples/README.md index b543a24..bf8d2b1 100644 --- a/azurefunctions-extensions-bindings-eventhub/samples/README.md +++ b/azurefunctions-extensions-bindings-eventhub/samples/README.md @@ -21,13 +21,14 @@ examples on how to use the Azure EventHub library, please see [Azure EventHub sa * From EventHubTrigger ## Prerequisites -* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/en-us/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). -* You must have an [Azure subscription](https://azure.microsoft.com/free/) and an -[Azure storage account](https://docs.microsoft.com/azure/storage/common/storage-account-overview) to use this package. +* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* You must have an [Azure subscription](https://azure.microsoft.com/free/), an +[Azure Event Hubs namespace, and an event hub](https://learn.microsoft.com/azure/event-hubs/event-hubs-create) to use these samples. +* You must run [Azurite](https://learn.microsoft.com/azure/storage/common/storage-use-azurite) or configure an Azure storage account for the Functions host. ## Setup -1. Install [Core Tools](https://learn.microsoft.com/en-us/azure/azure-functions/functions-run-local?tabs=windows%2Cisolated-process%2Cnode-v4%2Cpython-v2%2Chttp-trigger%2Ccontainer-apps&pivots=programming-language-python) +1. Install [Core Tools](https://learn.microsoft.com/azure/azure-functions/functions-run-local?tabs=windows%2Cisolated-process%2Cnode-v4%2Cpython-v2%2Chttp-trigger%2Ccontainer-apps&pivots=programming-language-python) 2. Install the Azure Functions Extension EventHub library for Python with [pip](https://pypi.org/project/pip/): ```bash @@ -53,6 +54,6 @@ func start ## Next steps -Visit the [SDK-type bindings in Python reference documentation](https://learn.microsoft.com/en-us/azure/azure-functions/functions-reference-python?tabs=get-started%2Casgi%2Capplication-level&pivots=python-mode-decorators#sdk-type-bindings-preview) to learn more about how to use SDK-type bindings in a Python Function App and the -[API reference documentation](https://learn.microsoft.com/en-us/python/api/azure-eventhub/azure.eventhub?view=azure-python) to learn more about +Visit the [SDK-type bindings in Python reference documentation](https://learn.microsoft.com/azure/azure-functions/functions-reference-python?pivots=python-mode-decorators#sdk-type-bindings) to learn more about how to use SDK-type bindings in a Python Function App and the +[API reference documentation](https://learn.microsoft.com/python/api/azure-eventhub/azure.eventhub?view=azure-python) to learn more about what you can do with the Azure EventHub library. diff --git a/azurefunctions-extensions-bindings-eventhub/samples/eventhub_samples_eventdata/function_app.py b/azurefunctions-extensions-bindings-eventhub/samples/eventhub_samples_eventdata/function_app.py index dc5da6b..7098b4d 100644 --- a/azurefunctions-extensions-bindings-eventhub/samples/eventhub_samples_eventdata/function_app.py +++ b/azurefunctions-extensions-bindings-eventhub/samples/eventhub_samples_eventdata/function_app.py @@ -18,21 +18,21 @@ These samples demonstrate how to obtain EventData from an EventHub Trigger. USAGE: There are different ways to connect to an EventHub via the connection property and - envionrment variables specifiied in local.settings.json - + environment variables specified in local.settings.json + The connection property can be: - The name of an application setting containing a connection string - The name of a shared prefix for multiple application settings, together defining an identity-based connection For more information, see: - https://learn.microsoft.com/en-us/azure/azure-functions/functions-bindings-event-hubs-trigger?tabs=python-v2%2Cisolated-process%2Cnodejs-v4%2Cfunctionsv2%2Cextensionv5&pivots=programming-language-python + https://learn.microsoft.com/azure/azure-functions/functions-bindings-event-hubs-trigger?tabs=python-v2%2Cisolated-process%2Cnodejs-v4%2Cfunctionsv2%2Cextensionv5&pivots=programming-language-python """ @app.event_hub_message_trigger( arg_name="event", event_hub_name="EVENTHUB_NAME", connection="EventHubConnection" ) -def eventhub_trigger(event: eh.EventData): +def eventhub_trigger_single(event: eh.EventData): logging.info( "Python EventHub trigger processed an event %s", event.body_as_str() @@ -42,7 +42,7 @@ def eventhub_trigger(event: eh.EventData): @app.event_hub_message_trigger( arg_name="events", event_hub_name="EVENTHUB_NAME", connection="EventHubConnection", cardinality="many" ) -def eventhub_trigger(events: List[eh.EventData]): +def eventhub_trigger_batch(events: List[eh.EventData]): for event in events: logging.info( "Python EventHub trigger processed an event %s", diff --git a/azurefunctions-extensions-bindings-servicebus/README.md b/azurefunctions-extensions-bindings-servicebus/README.md index 0326d87..806a930 100644 --- a/azurefunctions-extensions-bindings-servicebus/README.md +++ b/azurefunctions-extensions-bindings-servicebus/README.md @@ -19,10 +19,10 @@ The supported ServiceBus SDK types include: ## Getting started ### Prerequisites -* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/en-us/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* Python 3.9 through 3.13 is required to use this package. Python 3.14 is not currently supported because `uamqp` does not publish Python 3.14 wheels. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). * You must have an [Azure subscription](https://azure.microsoft.com/free/) and a -[ServiceBus Resource](https://learn.microsoft.com/en-us/azure/azure-functions/functions-bindings-service-bus?tabs=isolated-process%2Cextensionv5%2Cextensionv3&pivots=programming-language-python) to use this package. +[ServiceBus Resource](https://learn.microsoft.com/azure/azure-functions/functions-bindings-service-bus?tabs=isolated-process%2Cextensionv5%2Cextensionv3&pivots=programming-language-python) to use this package. ### Install the package Install the Azure Functions Extensions Bindings ServiceBus library for Python with pip: @@ -85,17 +85,17 @@ Several samples are available in this GitHub repository. These samples provide e * From ServiceBus Queue Trigger (Single Message) * From ServiceBus Topic Trigger (Single Message) -* [servicebus_samples_batch](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-bindings-servicebus/samples/service_samples_batch) - Examples for interacting with batches: +* [servicebus_samples_batch](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-bindings-servicebus/samples/servicebus_samples_batch) - Examples for interacting with batches: * From ServiceBus Queue Trigger (Batch) * From ServiceBus Topic Trigger (Batch) ### Additional documentation -For more information on the Azure ServiceBus SDK, see the [Azure ServiceBus SDK documentation](https://learn.microsoft.com/en-us/python/api/overview/azure/servicebus-readme?view=azure-python) on docs.microsoft.com -and the [Azure ServiceBus README](https://github.com/Azure/azure-sdk-for-python/blob/azure-servicebus_7.14.1/sdk/servicebus/azure-servicebus/README.md). +For more information on the Azure ServiceBus SDK, see the [Azure ServiceBus SDK documentation](https://learn.microsoft.com/python/api/overview/azure/servicebus-readme?view=azure-python) on Microsoft Learn +and the [Azure ServiceBus README](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/servicebus/azure-servicebus/README.md). ## Contributing -This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com. +This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com. When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA. diff --git a/azurefunctions-extensions-bindings-servicebus/samples/README.md b/azurefunctions-extensions-bindings-servicebus/samples/README.md index 6e9fec8..88d2bc7 100644 --- a/azurefunctions-extensions-bindings-servicebus/samples/README.md +++ b/azurefunctions-extensions-bindings-servicebus/samples/README.md @@ -15,7 +15,7 @@ urlFragment: extension-servicebus-samples These are code samples that show common scenario operations with the Azure Functions Extension ServiceBus library. These samples relate to the Azure ServiceBus client library being used as part of a Python Function App. For -examples on how to use the Azure ServiceBus client library, please see [Azure ServiceBus samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.14.1/sdk/servicebus/azure-servicebus/samples) +examples on how to use the Azure ServiceBus client library, please see [Azure ServiceBus samples](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/servicebus/azure-servicebus/samples) * [servicebus_samples_single](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-bindings-servicebus/samples/servicebus_samples_single) - Examples for using the ServiceBusReceivedMessage type: * From ServiceBus Queue Trigger (Single Message) @@ -26,11 +26,11 @@ examples on how to use the Azure ServiceBus client library, please see [Azure Se ## Prerequisites -* Python 3.9 through 3.13 is required to use these samples. Python 3.14 is not currently supported because `uamqp` does not publish Python 3.14 wheels. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/en-us/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* Python 3.9 through 3.13 is required to use these samples. Python 3.14 is not currently supported because `uamqp` does not publish Python 3.14 wheels. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). ## Setup -1. Install [Core Tools](https://learn.microsoft.com/en-us/azure/azure-functions/functions-run-local?tabs=windows%2Cisolated-process%2Cnode-v4%2Cpython-v2%2Chttp-trigger%2Ccontainer-apps&pivots=programming-language-python) +1. Install [Core Tools](https://learn.microsoft.com/azure/azure-functions/functions-run-local?tabs=windows%2Cisolated-process%2Cnode-v4%2Cpython-v2%2Chttp-trigger%2Ccontainer-apps&pivots=programming-language-python) 2. Install the Azure Functions Extension ServiceBus library for Python with [pip](https://pypi.org/project/pip/): ```bash @@ -56,6 +56,6 @@ func start ## Next steps -Visit the [SDK-type bindings in Python reference documentation](https://learn.microsoft.com/en-us/azure/azure-functions/functions-reference-python?tabs=get-started%2Casgi%2Capplication-level&pivots=python-mode-decorators#sdk-type-bindings-preview) to learn more about how to use SDK-type bindings in a Python Function App and the -[API reference documentation](https://learn.microsoft.com/en-us/python/api/overview/azure/service-bus?view=azure-python) to learn more about +Visit the [SDK-type bindings in Python reference documentation](https://learn.microsoft.com/azure/azure-functions/functions-reference-python?pivots=python-mode-decorators#sdk-type-bindings) to learn more about how to use SDK-type bindings in a Python Function App and the +[API reference documentation](https://learn.microsoft.com/python/api/overview/azure/service-bus?view=azure-python) to learn more about what you can do with the Azure ServiceBus client library. \ No newline at end of file diff --git a/azurefunctions-extensions-connectors/README.md b/azurefunctions-extensions-connectors/README.md index c28cc32..caf8a42 100644 --- a/azurefunctions-extensions-connectors/README.md +++ b/azurefunctions-extensions-connectors/README.md @@ -1,4 +1,4 @@ -# Azure Functions Extensions Connectors Office365 library for Python +# Azure Functions Extensions Connectors library for Python This library allows Office365 Connector Triggers in Python Function Apps to recognize and bind to client types from the Azure Connectors SDK. @@ -6,17 +6,15 @@ Office365 client types can be generated from: * Office365 Connector Triggers -[Source code](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-connectors-office365) -| [Package (PyPi)](https://pypi.org/project/azurefunctions-extensions-connectors-office365/) -| API reference documentation -| Product documentation -| [Samples](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-connectors-office365/samples) +[Source code](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-connectors) +| [Package (PyPI)](https://pypi.org/project/azurefunctions-extensions-connectors/) +| [Samples](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-connectors/samples) ## Getting started ### Prerequisites -* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/en-us/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* Python 3.10 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). * You must have an [Azure subscription](https://azure.microsoft.com/free/) and an Office365 account to use this package. @@ -24,7 +22,7 @@ Office365 client types can be generated from: Install the Azure Functions Extensions Connectors Office365 library for Python with pip: ```bash -pip install azurefunctions-extensions-connectors-office365 +pip install azurefunctions-extensions-connectors ``` ### Bind to the SDK-type @@ -92,10 +90,10 @@ logging.basicConfig(level=logging.INFO) ## Next steps ### More sample code -Get started with our [Office365 Connector samples](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-connectors-office365/samples). +Get started with our [Office365 Connector samples](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-connectors/samples). ## Contributing -This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com. +This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com. When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA. diff --git a/azurefunctions-extensions-connectors/samples/README.md b/azurefunctions-extensions-connectors/samples/README.md index f02a209..55c92c5 100644 --- a/azurefunctions-extensions-connectors/samples/README.md +++ b/azurefunctions-extensions-connectors/samples/README.md @@ -43,5 +43,5 @@ Demonstrates how to handle calendar event creation and modification actions. The ## Prerequisites -- Python 3.13 or later +- Python 3.10 or later - Azure Functions Core Tools diff --git a/azurefunctions-extensions-http-fastapi/README.md b/azurefunctions-extensions-http-fastapi/README.md index 640cc90..bbb11f3 100644 --- a/azurefunctions-extensions-http-fastapi/README.md +++ b/azurefunctions-extensions-http-fastapi/README.md @@ -3,18 +3,18 @@ This library contains HttpV2 extensions for FastApi Request/Response types to us [Source code](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-http-fastapi) | [Package (PyPi)](https://pypi.org/project/azurefunctions-extensions-http-fastapi/) -| [Developer Reference](https://learn.microsoft.com/en-us/azure/azure-functions/functions-reference-python?tabs=get-started%2Casgi%2Capplication-level&pivots=python-mode-decorators#http-streams-preview) +| [Developer Reference](https://learn.microsoft.com/azure/azure-functions/functions-bindings-http-webhook-trigger?tabs=python-v2&pivots=programming-language-python#http-streams-1) | [Samples](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-http-fastapi/samples) ## Getting started ### Prerequisites -* Python 3.8 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/en-us/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* Python 3.8 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). ### Instructions -1. Follow the guide to [create an app](https://learn.microsoft.com/en-us/azure/azure-functions/create-first-function-cli-python?tabs=windows%2Cbash%2Cazure-cli%2Cbrowser). If you're testing the function locally, make sure to update to the latest version of Core Tools. +1. Follow the guide to [create an app](https://learn.microsoft.com/azure/azure-functions/create-first-function-cli-python?tabs=windows%2Cbash%2Cazure-cli%2Cbrowser). If you're testing the function locally, make sure to update to the latest version of Core Tools. 2. Ensure your app is using programming model v2 and contains an HttpTrigger function. 3. Add ```azurefunctions-extensions-http-fastapi``` to your requirements.txt 4. Import Request and different types of responses from ```azurefunctions.extensions.http.fastapi``` in your HttpTrigger functions. @@ -70,7 +70,7 @@ Several samples are available in this GitHub repository. These samples provide e * [fastapi_samples_streaming_download](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-http-fastapi/samples/fastapi_samples_streaming_download) - An example on how to send your HTTP response via streaming to the caller. ## Contributing -This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com. +This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com. When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA. diff --git a/azurefunctions-extensions-http-fastapi/samples/README.md b/azurefunctions-extensions-http-fastapi/samples/README.md index c0f9d53..21f0af9 100644 --- a/azurefunctions-extensions-http-fastapi/samples/README.md +++ b/azurefunctions-extensions-http-fastapi/samples/README.md @@ -22,11 +22,11 @@ information on FastAPI, please see the [FastApi documentation](https://fastapi.t * [fastapi_samples_streaming_download](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-http-fastapi/samples/fastapi_samples_streaming_download) - An example on how to send your HTTP response via streaming to the caller. ## Prerequisites -* Python 3.8 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/en-us/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* Python 3.8 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). ## Setup -1. Install [Core Tools](https://learn.microsoft.com/en-us/azure/azure-functions/functions-run-local?tabs=windows%2Cisolated-process%2Cnode-v4%2Cpython-v2%2Chttp-trigger%2Ccontainer-apps&pivots=programming-language-python) +1. Install [Core Tools](https://learn.microsoft.com/azure/azure-functions/functions-run-local?tabs=windows%2Cisolated-process%2Cnode-v4%2Cpython-v2%2Chttp-trigger%2Ccontainer-apps&pivots=programming-language-python) 2. Install the Azure Functions Extension FastAPI library for Python with [pip](https://pypi.org/project/pip/): ```bash @@ -51,6 +51,6 @@ func start ## Next steps -Visit the [HTTP Streams in Python reference documentation](https://learn.microsoft.com/en-us/azure/azure-functions/functions-reference-python?tabs=get-started%2Casgi%2Capplication-level&pivots=python-mode-decorators#http-streams-preview) to learn more about how to use HTTP Streams in a Python Function App and the +Visit the [HTTP Streams in Python reference documentation](https://learn.microsoft.com/azure/azure-functions/functions-bindings-http-webhook-trigger?tabs=python-v2&pivots=programming-language-python#http-streams-1) to learn more about how to use HTTP Streams in a Python Function App and the [FastApi documentation](https://fastapi.tiangolo.com/reference/responses/?h=custom) to learn more about what you can do with FastAPI. \ No newline at end of file diff --git a/eng/templates/official/jobs/publish-release.yml b/eng/templates/official/jobs/publish-release.yml index 13fa5ba..2e0905b 100644 --- a/eng/templates/official/jobs/publish-release.yml +++ b/eng/templates/official/jobs/publish-release.yml @@ -130,6 +130,7 @@ jobs: - job: "CreateWorkerPR" dependsOn: ['CheckGitHubRelease'] displayName: 'Create PR in Worker Repo' + continueOnError: true steps: - pwsh: | $githubUser = "$(GithubUser)" From 1eeb7f01a008631e427554e7b5cfcffb8e437bf8 Mon Sep 17 00:00:00 2001 From: Victoria Hall Date: Mon, 31 Aug 2026 14:06:56 -0500 Subject: [PATCH 2/2] don't hard code supported python version limits --- azurefunctions-extensions-bindings-blob/README.md | 2 +- azurefunctions-extensions-bindings-blob/samples/README.md | 2 +- azurefunctions-extensions-bindings-cosmosdb/README.md | 2 +- azurefunctions-extensions-bindings-cosmosdb/samples/README.md | 2 +- azurefunctions-extensions-bindings-eventhub/README.md | 2 +- azurefunctions-extensions-bindings-eventhub/samples/README.md | 2 +- azurefunctions-extensions-connectors/README.md | 2 +- azurefunctions-extensions-http-fastapi/README.md | 2 +- azurefunctions-extensions-http-fastapi/samples/README.md | 2 +- 9 files changed, 9 insertions(+), 9 deletions(-) diff --git a/azurefunctions-extensions-bindings-blob/README.md b/azurefunctions-extensions-bindings-blob/README.md index ea5fc0f..f15eb95 100644 --- a/azurefunctions-extensions-bindings-blob/README.md +++ b/azurefunctions-extensions-bindings-blob/README.md @@ -17,7 +17,7 @@ Blob client types can be generated from: ## Getting started ### Prerequisites -* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* A supported Python version is required. For more details, see the [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). * You must have an [Azure subscription](https://azure.microsoft.com/free/) and an [Azure storage account](https://learn.microsoft.com/azure/storage/common/storage-account-overview) to use this package. diff --git a/azurefunctions-extensions-bindings-blob/samples/README.md b/azurefunctions-extensions-bindings-blob/samples/README.md index f4f271c..2b1f746 100644 --- a/azurefunctions-extensions-bindings-blob/samples/README.md +++ b/azurefunctions-extensions-bindings-blob/samples/README.md @@ -30,7 +30,7 @@ examples on how to use the Azure Storage Blob client library, please see [Azure * From BlobInput ## Prerequisites -* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* A supported Python version is required. For more details, see the [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). * You must have an [Azure subscription](https://azure.microsoft.com/free/) and an [Azure storage account](https://learn.microsoft.com/azure/storage/common/storage-account-overview) to use this package. diff --git a/azurefunctions-extensions-bindings-cosmosdb/README.md b/azurefunctions-extensions-bindings-cosmosdb/README.md index 9edaae3..0dd6958 100644 --- a/azurefunctions-extensions-bindings-cosmosdb/README.md +++ b/azurefunctions-extensions-bindings-cosmosdb/README.md @@ -14,7 +14,7 @@ Cosmos DB client types can be generated from: ## Getting started ### Prerequisites -* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* A supported Python version is required. For more details, see the [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). * You must have an [Azure subscription](https://azure.microsoft.com/free/) and an [Azure Cosmos DB for NoSQL account](https://learn.microsoft.com/azure/cosmos-db/nosql/quickstart-portal) to use this package. diff --git a/azurefunctions-extensions-bindings-cosmosdb/samples/README.md b/azurefunctions-extensions-bindings-cosmosdb/samples/README.md index 37f3e9c..eae3ece 100644 --- a/azurefunctions-extensions-bindings-cosmosdb/samples/README.md +++ b/azurefunctions-extensions-bindings-cosmosdb/samples/README.md @@ -27,7 +27,7 @@ examples on how to use the Azure Cosmos DB client library, please see [Azure Cos * From CosmosDBInput ## Prerequisites -* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* A supported Python version is required. For more details, see the [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). * You must have an [Azure subscription](https://azure.microsoft.com/free/) and an [Azure Cosmos DB for NoSQL account](https://learn.microsoft.com/azure/cosmos-db/nosql/quickstart-portal) to use these samples. * You must run [Azurite](https://learn.microsoft.com/azure/storage/common/storage-use-azurite) or configure an Azure storage account for the Functions host. diff --git a/azurefunctions-extensions-bindings-eventhub/README.md b/azurefunctions-extensions-bindings-eventhub/README.md index 0f711f8..2f53e35 100644 --- a/azurefunctions-extensions-bindings-eventhub/README.md +++ b/azurefunctions-extensions-bindings-eventhub/README.md @@ -18,7 +18,7 @@ The supported EventHub SDK types include: ## Getting started ### Prerequisites -* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* A supported Python version is required. For more details, see the [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). * You must have an [Azure subscription](https://azure.microsoft.com/free/), an [Azure Event Hubs namespace, and an event hub](https://learn.microsoft.com/azure/event-hubs/event-hubs-create) to use this package. diff --git a/azurefunctions-extensions-bindings-eventhub/samples/README.md b/azurefunctions-extensions-bindings-eventhub/samples/README.md index bf8d2b1..ca46b03 100644 --- a/azurefunctions-extensions-bindings-eventhub/samples/README.md +++ b/azurefunctions-extensions-bindings-eventhub/samples/README.md @@ -21,7 +21,7 @@ examples on how to use the Azure EventHub library, please see [Azure EventHub sa * From EventHubTrigger ## Prerequisites -* Python 3.9 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* A supported Python version is required. For more details, see the [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). * You must have an [Azure subscription](https://azure.microsoft.com/free/), an [Azure Event Hubs namespace, and an event hub](https://learn.microsoft.com/azure/event-hubs/event-hubs-create) to use these samples. * You must run [Azurite](https://learn.microsoft.com/azure/storage/common/storage-use-azurite) or configure an Azure storage account for the Functions host. diff --git a/azurefunctions-extensions-connectors/README.md b/azurefunctions-extensions-connectors/README.md index caf8a42..2c6df9f 100644 --- a/azurefunctions-extensions-connectors/README.md +++ b/azurefunctions-extensions-connectors/README.md @@ -14,7 +14,7 @@ Office365 client types can be generated from: ## Getting started ### Prerequisites -* Python 3.10 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* A supported Python version is required. For more details, see the [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). * You must have an [Azure subscription](https://azure.microsoft.com/free/) and an Office365 account to use this package. diff --git a/azurefunctions-extensions-http-fastapi/README.md b/azurefunctions-extensions-http-fastapi/README.md index bbb11f3..f7cf320 100644 --- a/azurefunctions-extensions-http-fastapi/README.md +++ b/azurefunctions-extensions-http-fastapi/README.md @@ -10,7 +10,7 @@ This library contains HttpV2 extensions for FastApi Request/Response types to us ## Getting started ### Prerequisites -* Python 3.8 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* A supported Python version is required. For more details, see the [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). ### Instructions diff --git a/azurefunctions-extensions-http-fastapi/samples/README.md b/azurefunctions-extensions-http-fastapi/samples/README.md index 21f0af9..313f123 100644 --- a/azurefunctions-extensions-http-fastapi/samples/README.md +++ b/azurefunctions-extensions-http-fastapi/samples/README.md @@ -22,7 +22,7 @@ information on FastAPI, please see the [FastApi documentation](https://fastapi.t * [fastapi_samples_streaming_download](https://github.com/Azure/azure-functions-python-extensions/tree/dev/azurefunctions-extensions-http-fastapi/samples/fastapi_samples_streaming_download) - An example on how to send your HTTP response via streaming to the caller. ## Prerequisites -* Python 3.8 or later is required to use this package. For more details, please read our page on [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). +* A supported Python version is required. For more details, see the [Python Functions version support policy](https://learn.microsoft.com/azure/azure-functions/functions-versions?tabs=isolated-process%2Cv4&pivots=programming-language-python#languages). ## Setup