Revert "python update versions pylint/mypy"

.chronus/changes/python-add-ai-link-readme-2026-4-15.md

@@ -0,0 +1,9 @@
+---
+# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking
+changeKind: feature
+packages:
+  - "@autorest/python"
+  - "@azure-tools/typespec-python"
+---
+
+Add "Use with AI tools" section to Azure packages README template

.chronus/changes/python-refine-api-version-doc-2026-4-15.md

@@ -0,0 +1,8 @@
+---
+changeKind: fix
+packages:
+  - "@autorest/python"
+  - "@azure-tools/typespec-python"
+---
+
+Refine `api_version` argument doc to show `None` as default value and include note about operation's default API version being used when not set

packages/autorest.python/package.json

@@ -29,7 +29,7 @@
   },
   "homepage": "https://github.com/Azure/autorest.python/blob/main/README.md",
   "dependencies": {
-    "@typespec/http-client-python": "https://artprodcus3.artifacts.visualstudio.com/A0fb41ef4-5012-48a9-bf39-4ee3de03ee35/29ec6040-b234-4e31-b139-33dc4287b756/_apis/artifact/cGlwZWxpbmVhcnRpZmFjdDovL2F6dXJlLXNkay9wcm9qZWN0SWQvMjllYzYwNDAtYjIzNC00ZTMxLWIxMzktMzNkYzQyODdiNzU2L2J1aWxkSWQvNjE1ODIzMi9hcnRpZmFjdE5hbWUvYnVpbGRfYXJ0aWZhY3RzX3B5dGhvbg2/content?format=file&subPath=%2Fpackages%2Ftypespec-http-client-python-0.28.3.tgz",
+    "@typespec/http-client-python": "https://artprodcus3.artifacts.visualstudio.com/A0fb41ef4-5012-48a9-bf39-4ee3de03ee35/29ec6040-b234-4e31-b139-33dc4287b756/_apis/artifact/cGlwZWxpbmVhcnRpZmFjdDovL2F6dXJlLXNkay9wcm9qZWN0SWQvMjllYzYwNDAtYjIzNC00ZTMxLWIxMzktMzNkYzQyODdiNzU2L2J1aWxkSWQvNjE2MzI1OS9hcnRpZmFjdE5hbWUvYnVpbGRfYXJ0aWZhY3RzX3B5dGhvbg2/content?format=file&subPath=%2Fpackages%2Ftypespec-http-client-python-0.28.3.tgz",
     "@autorest/system-requirements": "~1.0.2",
     "fs-extra": "~11.2.0",
     "tsx": "^4.21.0"

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/AzureSpecials/azurespecialproperties/_auto_rest_azure_special_parameters_test_client.py

@@ -68,8 +68,9 @@ class AutoRestAzureSpecialParametersTestClient:  # pylint: disable=too-many-inst
     :keyword cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :paramtype cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "2015-07-01-preview". Note that overriding
-     this default value may result in unsupported behavior.
+    :keyword api_version: Api Version. Known values are "2015-07-01-preview" and None. Default
+     value is None. If not set, the operation's default API version will be used. Note that
+     overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/AzureSpecials/azurespecialproperties/_configuration.py

@@ -33,8 +33,9 @@ class AutoRestAzureSpecialParametersTestClientConfiguration:  # pylint: disable=
     :param cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :type cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "2015-07-01-preview". Note that overriding
-     this default value may result in unsupported behavior.
+    :keyword api_version: Api Version. Known values are "2015-07-01-preview" and None. Default
+     value is None. If not set, the operation's default API version will be used. Note that
+     overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/AzureSpecials/azurespecialproperties/aio/_auto_rest_azure_special_parameters_test_client.py

@@ -69,8 +69,9 @@ class AutoRestAzureSpecialParametersTestClient:  # pylint: disable=too-many-inst
     :keyword cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :paramtype cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "2015-07-01-preview". Note that overriding
-     this default value may result in unsupported behavior.
+    :keyword api_version: Api Version. Known values are "2015-07-01-preview" and None. Default
+     value is None. If not set, the operation's default API version will be used. Note that
+     overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/AzureSpecials/azurespecialproperties/aio/_configuration.py

@@ -33,8 +33,9 @@ class AutoRestAzureSpecialParametersTestClientConfiguration:  # pylint: disable=
     :param cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :type cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "2015-07-01-preview". Note that overriding
-     this default value may result in unsupported behavior.
+    :keyword api_version: Api Version. Known values are "2015-07-01-preview" and None. Default
+     value is None. If not set, the operation's default API version will be used. Note that
+     overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/CustomPollerPager/custompollerpager/_auto_rest_paging_test_service.py

@@ -39,7 +39,8 @@ class AutoRestPagingTestService:
     :keyword cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :paramtype cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "1.0.0". Note that overriding this default
+    :keyword api_version: Api Version. Known values are "1.0.0" and None. Default value is None. If
+     not set, the operation's default API version will be used. Note that overriding this default
      value may result in unsupported behavior.
     :paramtype api_version: str
     :keyword int polling_interval: Default waiting time between two polls for LRO operations if no

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/CustomPollerPager/custompollerpager/_configuration.py

@@ -29,7 +29,8 @@ class AutoRestPagingTestServiceConfiguration:  # pylint: disable=too-many-instan
     :param cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :type cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "1.0.0". Note that overriding this default
+    :keyword api_version: Api Version. Known values are "1.0.0" and None. Default value is None. If
+     not set, the operation's default API version will be used. Note that overriding this default
      value may result in unsupported behavior.
     :paramtype api_version: str
     """

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/CustomPollerPager/custompollerpager/aio/_auto_rest_paging_test_service.py

@@ -39,7 +39,8 @@ class AutoRestPagingTestService:
     :keyword cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :paramtype cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "1.0.0". Note that overriding this default
+    :keyword api_version: Api Version. Known values are "1.0.0" and None. Default value is None. If
+     not set, the operation's default API version will be used. Note that overriding this default
      value may result in unsupported behavior.
     :paramtype api_version: str
     :keyword int polling_interval: Default waiting time between two polls for LRO operations if no

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/CustomPollerPager/custompollerpager/aio/_configuration.py

@@ -29,7 +29,8 @@ class AutoRestPagingTestServiceConfiguration:  # pylint: disable=too-many-instan
     :param cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :type cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "1.0.0". Note that overriding this default
+    :keyword api_version: Api Version. Known values are "1.0.0" and None. Default value is None. If
+     not set, the operation's default API version will be used. Note that overriding this default
      value may result in unsupported behavior.
     :paramtype api_version: str
     """

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/PackageModeBatch/azure/packagemode/batch/paging/_configuration.py

@@ -29,7 +29,8 @@ class PagingClientConfiguration:  # pylint: disable=too-many-instance-attributes
     :param cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :type cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "1.0.0". Note that overriding this default
+    :keyword api_version: Api Version. Known values are "1.0.0" and None. Default value is None. If
+     not set, the operation's default API version will be used. Note that overriding this default
      value may result in unsupported behavior.
     :paramtype api_version: str
     """

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/PackageModeBatch/azure/packagemode/batch/paging/_paging_client.py

@@ -39,7 +39,8 @@ class PagingClient:
     :keyword cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :paramtype cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "1.0.0". Note that overriding this default
+    :keyword api_version: Api Version. Known values are "1.0.0" and None. Default value is None. If
+     not set, the operation's default API version will be used. Note that overriding this default
      value may result in unsupported behavior.
     :paramtype api_version: str
     :keyword int polling_interval: Default waiting time between two polls for LRO operations if no

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/PackageModeBatch/azure/packagemode/batch/paging/aio/_configuration.py

@@ -29,7 +29,8 @@ class PagingClientConfiguration:  # pylint: disable=too-many-instance-attributes
     :param cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :type cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "1.0.0". Note that overriding this default
+    :keyword api_version: Api Version. Known values are "1.0.0" and None. Default value is None. If
+     not set, the operation's default API version will be used. Note that overriding this default
      value may result in unsupported behavior.
     :paramtype api_version: str
     """

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/PackageModeBatch/azure/packagemode/batch/paging/aio/_paging_client.py

@@ -39,7 +39,8 @@ class PagingClient:
     :keyword cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :paramtype cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "1.0.0". Note that overriding this default
+    :keyword api_version: Api Version. Known values are "1.0.0" and None. Default value is None. If
+     not set, the operation's default API version will be used. Note that overriding this default
      value may result in unsupported behavior.
     :paramtype api_version: str
     :keyword int polling_interval: Default waiting time between two polls for LRO operations if no

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/Paging/paging/_auto_rest_paging_test_service.py

@@ -27,7 +27,8 @@ class AutoRestPagingTestService:
     :vartype paging: paging.operations.PagingOperations
     :param base_url: Service URL. Default value is "http://localhost:3000".
     :type base_url: str
-    :keyword api_version: Api Version. Default value is "1.0.0". Note that overriding this default
+    :keyword api_version: Api Version. Known values are "1.0.0" and None. Default value is None. If
+     not set, the operation's default API version will be used. Note that overriding this default
      value may result in unsupported behavior.
     :paramtype api_version: str
     :keyword int polling_interval: Default waiting time between two polls for LRO operations if no

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/Paging/paging/_configuration.py

@@ -19,7 +19,8 @@ class AutoRestPagingTestServiceConfiguration:  # pylint: disable=too-many-instan
     Note that all parameters used to create this instance are saved as instance
     attributes.
 
-    :keyword api_version: Api Version. Default value is "1.0.0". Note that overriding this default
+    :keyword api_version: Api Version. Known values are "1.0.0" and None. Default value is None. If
+     not set, the operation's default API version will be used. Note that overriding this default
      value may result in unsupported behavior.
     :paramtype api_version: str
     """

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/Paging/paging/aio/_auto_rest_paging_test_service.py

@@ -27,7 +27,8 @@ class AutoRestPagingTestService:
     :vartype paging: paging.aio.operations.PagingOperations
     :param base_url: Service URL. Default value is "http://localhost:3000".
     :type base_url: str
-    :keyword api_version: Api Version. Default value is "1.0.0". Note that overriding this default
+    :keyword api_version: Api Version. Known values are "1.0.0" and None. Default value is None. If
+     not set, the operation's default API version will be used. Note that overriding this default
      value may result in unsupported behavior.
     :paramtype api_version: str
     :keyword int polling_interval: Default waiting time between two polls for LRO operations if no

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/Paging/paging/aio/_configuration.py

@@ -19,7 +19,8 @@ class AutoRestPagingTestServiceConfiguration:  # pylint: disable=too-many-instan
     Note that all parameters used to create this instance are saved as instance
     attributes.
 
-    :keyword api_version: Api Version. Default value is "1.0.0". Note that overriding this default
+    :keyword api_version: Api Version. Known values are "1.0.0" and None. Default value is None. If
+     not set, the operation's default API version will be used. Note that overriding this default
      value may result in unsupported behavior.
     :paramtype api_version: str
     """

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/StorageManagementClient/storage/_configuration.py

@@ -32,8 +32,9 @@ class StorageManagementClientConfiguration:  # pylint: disable=too-many-instance
     :param cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :type cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "2015-05-01-preview". Note that overriding
-     this default value may result in unsupported behavior.
+    :keyword api_version: Api Version. Known values are "2015-05-01-preview" and None. Default
+     value is None. If not set, the operation's default API version will be used. Note that
+     overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/StorageManagementClient/storage/_storage_management_client.py

@@ -44,8 +44,9 @@ class StorageManagementClient:
     :keyword cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :paramtype cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "2015-05-01-preview". Note that overriding
-     this default value may result in unsupported behavior.
+    :keyword api_version: Api Version. Known values are "2015-05-01-preview" and None. Default
+     value is None. If not set, the operation's default API version will be used. Note that
+     overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     :keyword int polling_interval: Default waiting time between two polls for LRO operations if no
      Retry-After header is present.

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/StorageManagementClient/storage/aio/_configuration.py

@@ -32,8 +32,9 @@ class StorageManagementClientConfiguration:  # pylint: disable=too-many-instance
     :param cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :type cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "2015-05-01-preview". Note that overriding
-     this default value may result in unsupported behavior.
+    :keyword api_version: Api Version. Known values are "2015-05-01-preview" and None. Default
+     value is None. If not set, the operation's default API version will be used. Note that
+     overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/StorageManagementClient/storage/aio/_storage_management_client.py

@@ -44,8 +44,9 @@ class StorageManagementClient:
     :keyword cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :paramtype cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "2015-05-01-preview". Note that overriding
-     this default value may result in unsupported behavior.
+    :keyword api_version: Api Version. Known values are "2015-05-01-preview" and None. Default
+     value is None. If not set, the operation's default API version will be used. Note that
+     overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     :keyword int polling_interval: Default waiting time between two polls for LRO operations if no
      Retry-After header is present.

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/SubscriptionIdApiVersion/subscriptionidapiversion/_configuration.py

@@ -31,8 +31,9 @@ class MicrosoftAzureTestUrlConfiguration:  # pylint: disable=too-many-instance-a
     :param cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :type cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "2014-04-01-preview". Note that overriding
-     this default value may result in unsupported behavior.
+    :keyword api_version: Api Version. Known values are "2014-04-01-preview" and None. Default
+     value is None. If not set, the operation's default API version will be used. Note that
+     overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/SubscriptionIdApiVersion/subscriptionidapiversion/_microsoft_azure_test_url.py

@@ -41,8 +41,9 @@ class MicrosoftAzureTestUrl:
     :keyword cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :paramtype cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "2014-04-01-preview". Note that overriding
-     this default value may result in unsupported behavior.
+    :keyword api_version: Api Version. Known values are "2014-04-01-preview" and None. Default
+     value is None. If not set, the operation's default API version will be used. Note that
+     overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/SubscriptionIdApiVersion/subscriptionidapiversion/aio/_configuration.py

@@ -31,8 +31,9 @@ class MicrosoftAzureTestUrlConfiguration:  # pylint: disable=too-many-instance-a
     :param cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :type cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "2014-04-01-preview". Note that overriding
-     this default value may result in unsupported behavior.
+    :keyword api_version: Api Version. Known values are "2014-04-01-preview" and None. Default
+     value is None. If not set, the operation's default API version will be used. Note that
+     overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 

packages/autorest.python/test/azure/legacy/Expected/AcceptanceTests/SubscriptionIdApiVersion/subscriptionidapiversion/aio/_microsoft_azure_test_url.py

@@ -41,8 +41,9 @@ class MicrosoftAzureTestUrl:
     :keyword cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :paramtype cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "2014-04-01-preview". Note that overriding
-     this default value may result in unsupported behavior.
+    :keyword api_version: Api Version. Known values are "2014-04-01-preview" and None. Default
+     value is None. If not set, the operation's default API version will be used. Note that
+     overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 

packages/autorest.python/test/azure/version-tolerant/Expected/AcceptanceTests/AzureSpecialsVersionTolerant/azurespecialpropertiesversiontolerant/_client.py

@@ -70,8 +70,9 @@ class AutoRestAzureSpecialParametersTestClient:  # pylint: disable=too-many-inst
     :keyword cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :paramtype cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "2015-07-01-preview". Note that overriding
-     this default value may result in unsupported behavior.
+    :keyword api_version: Api Version. Known values are "2015-07-01-preview" and None. Default
+     value is None. If not set, the operation's default API version will be used. Note that
+     overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 

packages/autorest.python/test/azure/version-tolerant/Expected/AcceptanceTests/AzureSpecialsVersionTolerant/azurespecialpropertiesversiontolerant/_configuration.py

@@ -33,8 +33,9 @@ class AutoRestAzureSpecialParametersTestClientConfiguration:  # pylint: disable=
     :param cloud_setting: The cloud setting for which to get the ARM endpoint. Default value is
      None.
     :type cloud_setting: ~azure.core.AzureClouds
-    :keyword api_version: Api Version. Default value is "2015-07-01-preview". Note that overriding
-     this default value may result in unsupported behavior.
+    :keyword api_version: Api Version. Known values are "2015-07-01-preview" and None. Default
+     value is None. If not set, the operation's default API version will be used. Note that
+     overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     """