Merge branch 'main' of https://github.com/Azure/azure-sdk-for-python …

…into HEAD

.github/CODEOWNERS

@@ -28,8 +28,8 @@
 # PRLabel: %App Configuration
 /sdk/appconfiguration/                                               @xiangyan99 @seankane-msft
 
-/sdk/applicationinsights/azure-applicationinsights/                  @divya-jay @geneh @alongafni
-/sdk/loganalytics/azure-loganalytics/                                @divya-jay @geneh @alongafni
+/sdk/applicationinsights/azure-applicationinsights/                  @divyajay @geneh @alongafni
+/sdk/loganalytics/azure-loganalytics/                                @divyajay @geneh @alongafni
 
 /sdk/attestation/azure-security-attestation                          @larryosterman @anilba06 @Azure/azure-sdk-write-attestation
 
@@ -38,10 +38,10 @@
 /sdk/cognitiveservices/azure-cognitiveservices-vision-customvision/  @areddish
 
 # PRLabel: %Communication
-/sdk/communication/                                                  @turalf @ankitarorabit @memontic-ms @Azure/azure-sdk-communication-code-reviewers
+/sdk/communication/                                                  @acsdevx-msft
 
 # PRLabel: %KeyVault
-/sdk/keyvault/                                                       @schaabs @chlowell @mccoyp
+/sdk/keyvault/                                                       @schaabs @chlowell @mccoyp @YalinLi0312
 
 # PRLabel: %Monitor - LogAnalytics
 /sdk/loganalytics/                                                   @alexeldeib
@@ -89,7 +89,7 @@
 /sdk/schemaregistry/                                                 @yunhaoling
 
 # PRLabel: %Search
-/sdk/search/                                                         @xiangyan99
+/sdk/search/                                                         @tjprescott
 
 # PRLabel: %Service Fabric
 /sdk/servicefabric/                                                  @QingChenmsft @samedder
@@ -119,7 +119,7 @@
 /sdk/translation/                                                    @kristapratico @mohamedshabanofficial
 
 # PRLabel: %Tables
-/sdk/tables/                                                         @seankane-msft
+/sdk/tables/                                                         @annatisch @YalinLi0312
 
 # PRLabel: %Media
 /sdk/media/                                                          @naiteeks @bennage @giakas
@@ -137,6 +137,10 @@
 ###########
 # Eng Sys
 ###########
-/eng/           @weshaggard @scbedd @danieljurek
-/**/tests.yml   @benbp
-/**/ci.yml      @scbedd
+/eng/                                                                @weshaggard @scbedd @danieljurek
+/**/tests.yml                                                        @benbp
+/**/ci.yml                                                           @scbedd
+
+# Add owners for notifications for specific pipelines
+/eng/pipelines/templates/jobs/tests-nightly-python.yml               @lmazuel @mccoyp
+/eng/pipelines/aggregate-reports.yml                                 @lmazuel @mccoyp @YalinLi0312

.gitignore

@@ -114,3 +114,6 @@ sdk/cosmos/azure-cosmos/test/test_config.py
 
 # env vars
 .env
+
+# local SSL certificate folder
+.certificate

common/smoketest/requirements-release.txt

@@ -6,3 +6,5 @@ azure-keyvault-certificates>=0.0.0b1
 azure-keyvault-keys>=0.0.0b1
 azure-keyvault-secrets>=0.0.0b1
 azure-storage-blob>=0.0.0b1
+# Required for template release to trigger smoke tests
+azure-template>=0.0.0b1

common/smoketest/requirements_async.txt

@@ -1 +1 @@
-aiohttp==3.5.4
+aiohttp==3.7.4

doc/README.md

@@ -1,4 +1,6 @@
-This folder contains some documentations for this repository:
+# Documentation
+
+This folder contains documentation for the Azure SDK for Python repository:
 
 The folder structure is the following
 - [sphinx](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/sphinx) : contains the documentation source code for https://azure.github.io/azure-sdk-for-python/

doc/dev/README.md

@@ -1,11 +1,16 @@
-# Dev documentation
+# Developer Documentation
 
-This folder contains documentation for developers of SDK: internal teams at Microsoft, or advanced contributors.
+This folder contains documentation for developers of SDKs: internal teams at Microsoft, or advanced contributors.
 
 Overview of the documents:
-- [dev setup](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/dev_setup.md) : How to create a development environment for this repo
-- [release](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/release.md) : How to release a package when ready
-- [packaging.md](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/packaging.md) : How to organize packaging information for packages under `azure`
-- [engsys.md](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/eng_sys_checks.md): Options for PR validation checks, how to opt-in, and how to run them locally
+- [Developer Set-Up](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/dev_setup.md) : How to create a development environment for this repo
+- [Release](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/release.md) : How to release a package when ready
+- [Packaging](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/packaging.md) : How to organize packaging information for packages under `azure`
+- [Testing](./tests.md): How to write unit and functional tests for a library
+- [Docstrings and Type hints](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/docstring_typehint.md): How to document an SDK for compatability with internal tools (API View) and our documentation at [MS Docs][ms_docs] and the [azure.github.io][azure_github_io] site.
 
 The [mgmt](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/mgmt) folder contains information specific to management packages (i.e. packages prefixed by `azure-mgmt`)
+
+<!-- links -->
+[ms_docs]: https://docs.microsoft.com/python/api/overview/azure/appconfiguration-readme?view=azure-python
+[azure_github_io]: https://azure.github.io/azure-sdk-for-python/

doc/dev/debug_guide.md

@@ -0,0 +1,23 @@
+# Debug
+
+This guide is to help Python SDK users to get the process about how SDK call REST api
+
+(1) Copy the following code in your .py file
+```
+import sys
+import logging
+
+logger = logging.getLogger('')
+logger.setLevel(logging.DEBUG)
+handler = logging.StreamHandler(stream=sys.stdout, )
+logger.addHandler(handler)
+formatter = logging.Formatter(
+    '%(asctime)s - %(name)s - %(levelname)s - %(message)s')
+handler.setFormatter(formatter)
+```
+
+![Position example](./debug_guide_position.png "Position example")
+
+(2) Run your .py program and you could find the log info in screen. It is convenient to get the process about how SDK call REST api:
+
+![example](./debug_guide_example.png "example")