[python] Support customized http method to call next link for paging operation

.chronus/changes/auto-microsoft-python-post-paging-2025-10-28-7-34-49.md

@@ -0,0 +1,8 @@
+---
+changeKind: feature
+packages:
+  - "@autorest/python"
+  - "@azure-tools/typespec-python"
+---
+
+Support customized http method to call next link for paging operation

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/cGlwZWxpbmVhcnRpZmFjdDovL2F6dXJlLXNkay9wcm9qZWN0SWQvMjllYzYwNDAtYjIzNC00ZTMxLWIxMzktMzNkYzQyODdiNzU2L2J1aWxkSWQvNTYxODM5OC9hcnRpZmFjdE5hbWUvYnVpbGRfYXJ0aWZhY3RzX3B5dGhvbg2/content?format=file&subPath=%2Fpackages%2Ftypespec-http-client-python-0.20.3.tgz",
+    "@typespec/http-client-python": "https://artprodcus3.artifacts.visualstudio.com/A0fb41ef4-5012-48a9-bf39-4ee3de03ee35/29ec6040-b234-4e31-b139-33dc4287b756/_apis/artifact/cGlwZWxpbmVhcnRpZmFjdDovL2F6dXJlLXNkay9wcm9qZWN0SWQvMjllYzYwNDAtYjIzNC00ZTMxLWIxMzktMzNkYzQyODdiNzU2L2J1aWxkSWQvNTYxODk4MC9hcnRpZmFjdE5hbWUvYnVpbGRfYXJ0aWZhY3RzX3B5dGhvbg2/content?format=file&subPath=%2Fpackages%2Ftypespec-http-client-python-0.20.3.tgz",
     "@autorest/system-requirements": "~1.0.2",
     "fs-extra": "~11.2.0",
     "tsx": "~4.19.1"

packages/typespec-python/package.json

@@ -67,7 +67,7 @@
     "js-yaml": "~4.1.0",
     "semver": "~7.6.2",
     "tsx": "~4.19.1",
-    "@typespec/http-client-python": "https://artprodcus3.artifacts.visualstudio.com/A0fb41ef4-5012-48a9-bf39-4ee3de03ee35/29ec6040-b234-4e31-b139-33dc4287b756/_apis/artifact/cGlwZWxpbmVhcnRpZmFjdDovL2F6dXJlLXNkay9wcm9qZWN0SWQvMjllYzYwNDAtYjIzNC00ZTMxLWIxMzktMzNkYzQyODdiNzU2L2J1aWxkSWQvNTYxODM5OC9hcnRpZmFjdE5hbWUvYnVpbGRfYXJ0aWZhY3RzX3B5dGhvbg2/content?format=file&subPath=%2Fpackages%2Ftypespec-http-client-python-0.20.3.tgz",
+    "@typespec/http-client-python": "https://artprodcus3.artifacts.visualstudio.com/A0fb41ef4-5012-48a9-bf39-4ee3de03ee35/29ec6040-b234-4e31-b139-33dc4287b756/_apis/artifact/cGlwZWxpbmVhcnRpZmFjdDovL2F6dXJlLXNkay9wcm9qZWN0SWQvMjllYzYwNDAtYjIzNC00ZTMxLWIxMzktMzNkYzQyODdiNzU2L2J1aWxkSWQvNTYxODk4MC9hcnRpZmFjdE5hbWUvYnVpbGRfYXJ0aWZhY3RzX3B5dGhvbg2/content?format=file&subPath=%2Fpackages%2Ftypespec-http-client-python-0.20.3.tgz",
     "fs-extra": "~11.2.0"
   },
   "devDependencies": {

packages/typespec-python/test/azure/generated/azure-client-generator-core-next-link-verb/specs/azure/clientgenerator/core/nextlinkverb/_operations/_operations.py

@@ -91,7 +91,7 @@ def prepare_request(next_link=None):
                 _request.url = self._client.format_url(_request.url, **path_format_arguments)
 
             else:
-                _request = HttpRequest("GET", next_link)
+                _request = HttpRequest("POST", next_link)
                 path_format_arguments = {
                     "endpoint": self._serialize.url(
                         "self._config.endpoint", self._config.endpoint, "str", skip_quote=True

packages/typespec-python/test/azure/generated/azure-client-generator-core-next-link-verb/specs/azure/clientgenerator/core/nextlinkverb/aio/_operations/_operations.py

@@ -74,7 +74,7 @@ def prepare_request(next_link=None):
                 _request.url = self._client.format_url(_request.url, **path_format_arguments)
 
             else:
-                _request = HttpRequest("GET", next_link)
+                _request = HttpRequest("POST", next_link)
                 path_format_arguments = {
                     "endpoint": self._serialize.url(
                         "self._config.endpoint", self._config.endpoint, "str", skip_quote=True

packages/typespec-python/test/azure/mock_api_tests/asynctests/test_azure_client_generator_core_next_link_verb_async.py

@@ -0,0 +1,28 @@
+# -------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for
+# license information.
+# --------------------------------------------------------------------------
+import pytest
+
+from specs.azure.clientgenerator.core.nextlinkverb.aio import NextLinkVerbClient
+
+
+@pytest.fixture
+async def client():
+    async with NextLinkVerbClient(endpoint="http://localhost:3000") as client:
+        yield client
+
+
+def assert_items(items):
+    assert len(items) == 2
+    assert items[0].id == "test1"
+    assert items[1].id == "test2"
+
+
+@pytest.mark.asyncio
+async def test_list_items_next_link_verb(client: NextLinkVerbClient):
+    # The operation uses POST for nextLink per @nextLinkVerb
+    pager = client.list_items()
+    items = [item async for item in pager]
+    assert_items(items)

packages/typespec-python/test/azure/mock_api_tests/test_azure_client_generator_core_next_link_verb.py

@@ -0,0 +1,27 @@
+# -------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for
+# license information.
+# --------------------------------------------------------------------------
+import pytest
+
+from specs.azure.clientgenerator.core.nextlinkverb import NextLinkVerbClient
+
+
+@pytest.fixture
+def client():
+    with NextLinkVerbClient(endpoint="http://localhost:3000") as client:
+        yield client
+
+
+def assert_items(items):
+    items = list(items)
+    assert len(items) == 2
+    assert items[0].id == "test1"
+    assert items[1].id == "test2"
+
+
+def test_list_items_next_link_verb(client: NextLinkVerbClient):
+    # The operation uses POST for nextLink per @nextLinkVerb
+    pager = client.list_items()
+    assert_items(pager)

packages/typespec-python/test/azure/requirements.txt

@@ -22,6 +22,7 @@ azure-mgmt-core==1.6.0
 -e ./generated/azure-core-model
 -e ./generated/azure-core-traits
 -e ./generated/azure-core-page
+-e ./generated/azure-client-generator-core-next-link-verb
 -e ./generated/azure-encode-duration
 -e ./generated/azure-special-headers-client-request-id/
 -e ./generated/azure-example-basic