@typespec/http-client-python 0.19.0 → 0.19.2

package/generator/test/azure/requirements.txt

@@ -30,6 +30,7 @@ azure-mgmt-core==1.6.0
 -e ./generated/azure-resource-manager-operation-templates
 -e ./generated/azure-resource-manager-resources
 -e ./generated/azure-resource-manager-method-subscription-id
+-e ./generated/azure-versioning-previewversion
 -e ./generated/client-namespace
 -e ./generated/azure-payload-pageable
 -e ./generated/client-naming

package/generator/test/azure/tox.ini

@@ -1,5 +1,5 @@
 [tox]
-envlist=base, lint, mypy, pyright, apiview
+envlist=base, lint, mypy, pyright, apiview, sphinx
 skipsdist=True
 
 [testenv:ci]
@@ -7,21 +7,22 @@ deps=
     -r requirements.txt
 commands =
     # pytest
-    pytest mock_api_tests ../generic_mock_api_tests
+    {[testenv:test]commands}
 
     # pylint
-    pip install azure-pylint-guidelines-checker==0.5.2 --index-url="https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-python/pypi/simple/"
-    python ../../../eng/scripts/ci/run_pylint.py -t azure -s "generated" {posargs}
+    {[testenv:lint]commands}
 
     # mypy
-    python ../../../eng/scripts/ci/run_mypy.py -t azure -s "generated" {posargs}
+    {[testenv:mypy]commands}
 
     # pyright
-    python ../../../eng/scripts/ci/run_pyright.py -t azure -s "generated" {posargs}
+    {[testenv:pyright]commands}
 
     # apiview
-    pip install apiview-stub-generator==0.3.19 --index-url="https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-python/pypi/simple/"
-    python ../../../eng/scripts/ci/run_apiview.py -t azure -s "generated" {posargs}
+    {[testenv:apiview]commands}
+
+    # sphinx docstring validation
+    {[testenv:sphinx]commands}
 
 [testenv:test]
 deps=
@@ -54,3 +55,10 @@ deps=
 commands =
     pip install apiview-stub-generator==0.3.19 --index-url="https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-python/pypi/simple/"
     python ../../../eng/scripts/ci/run_apiview.py -t azure -s "generated" {posargs}
+
+[testenv:sphinx]
+basepython = python3.10
+deps=
+    -r requirements.txt
+commands =
+    python ../../../eng/scripts/ci/run_sphinx_build.py -t azure -s "generated" {posargs}

package/generator/test/dev_requirements.txt

@@ -2,3 +2,7 @@
 aiohttp
 pytest-asyncio==0.14.0
 requests==2.32.2
+sphinx==8.2.0
+sphinx_rtd_theme==3.0.2
+myst_parser==4.0.1
+sphinxcontrib-jquery==4.1

package/generator/test/generic_mock_api_tests/asynctests/test_encode_bytes_async.py

@@ -124,5 +124,4 @@ async def test_response_body(client: BytesClient, png_data: bytes):
     assert expected == await client.response_body.base64()
     assert b"".join([d async for d in (await client.response_body.octet_stream())]) == png_data
     assert b"".join([d async for d in (await client.response_body.custom_content_type())]) == png_data
-    # will reopen after TCGC release a fix version for https://github.com/Azure/typespec-azure/pull/2411
-    # assert expected == await client.response_body.base64_url()
+    assert expected == await client.response_body.base64_url()

package/generator/test/generic_mock_api_tests/asynctests/test_payload_pageable_async.py

@@ -111,5 +111,5 @@ async def test_request_header_nested_response_body(client: PageableClient):
 
 @pytest.mark.asyncio
 async def test_list_without_continuation(client: PageableClient):
-    result = [p async for p in client.list_without_continuation()]
+    result = [p async for p in client.page_size.list_without_continuation()]
     assert_result(result)

package/generator/test/generic_mock_api_tests/asynctests/test_versioning_removed_async.py

@@ -5,7 +5,7 @@
 # --------------------------------------------------------------------------
 import pytest
 from versioning.removed.aio import RemovedClient
-from versioning.removed.models import ModelV2, EnumV2
+from versioning.removed.models import ModelV2, EnumV2, ModelV3, EnumV3
 
 
 @pytest.fixture
@@ -22,7 +22,18 @@ async def test_v2(client: RemovedClient):
 
 
 @pytest.mark.asyncio
-async def test_model_v3(client: RemovedClient):
-    result = await client.model_v3({"id": "123", "enumProp": "enumMemberV1"})
-    assert result.id == "123"
-    assert result.enum_prop == "enumMemberV1"
+async def test_model_v3():
+    async with RemovedClient(endpoint="http://localhost:3000", version="v1") as client1:
+        model1 = ModelV3(id="123", enum_prop=EnumV3.ENUM_MEMBER_V1)
+        result = await client1.model_v3(model1)
+        assert result == model1
+
+    async with RemovedClient(endpoint="http://localhost:3000", version="v2preview") as client2:
+        model2 = ModelV3(id="123")
+        result = await client2.model_v3(model2)
+        assert result == model2
+
+    async with RemovedClient(endpoint="http://localhost:3000", version="v2") as client3:
+        model3 = ModelV3(id="123", enum_prop=EnumV3.ENUM_MEMBER_V1)
+        result = await client3.model_v3(model3)
+        assert result == model3

package/generator/test/generic_mock_api_tests/test_encode_bytes.py

@@ -119,5 +119,4 @@ def test_response_body(client: BytesClient, png_data: bytes):
     assert expected == client.response_body.base64()
     assert b"".join(client.response_body.octet_stream()) == png_data
     assert b"".join(client.response_body.custom_content_type()) == png_data
-    # will reopen after TCGC release a fix version for https://github.com/Azure/typespec-azure/pull/2411
-    # assert expected == client.response_body.base64_url()
+    assert expected == client.response_body.base64_url()

package/generator/test/generic_mock_api_tests/test_payload_pageable.py

@@ -79,5 +79,5 @@ def test_request_header_nested_response_body(client: PageableClient):
 
 
 def test_list_without_continuation(client: PageableClient):
-    result = list(client.list_without_continuation())
+    result = list(client.page_size.list_without_continuation())
     assert_result(result)

package/generator/test/generic_mock_api_tests/test_typetest_scalar.py

@@ -51,3 +51,8 @@ def test_decimal128_verify(client: ScalarClient):
 def test_decimal_verify(client: ScalarClient):
     prepare = client.decimal_verify.prepare_verify()
     client.decimal_verify.verify(reduce(lambda x, y: x + y, prepare))
+
+
+# open this test case after adopt new version of http-specs for https://github.com/microsoft/typespec/pull/8807
+# def test_constant_query(client: ScalarClient):
+#     client.constant_query.post()

package/generator/test/generic_mock_api_tests/test_versioning_removed.py

@@ -5,7 +5,7 @@
 # --------------------------------------------------------------------------
 import pytest
 from versioning.removed import RemovedClient
-from versioning.removed.models import ModelV2, EnumV2
+from versioning.removed.models import ModelV2, EnumV2, ModelV3, EnumV3
 
 
 @pytest.fixture
@@ -20,7 +20,18 @@ def test_v2(client: RemovedClient):
     )
 
 
-def test_model_v3(client: RemovedClient):
-    result = client.model_v3({"id": "123", "enumProp": "enumMemberV1"})
-    assert result.id == "123"
-    assert result.enum_prop == "enumMemberV1"
+def test_model_v3():
+    client1 = RemovedClient(endpoint="http://localhost:3000", version="v1")
+    model1 = ModelV3(id="123", enum_prop=EnumV3.ENUM_MEMBER_V1)
+    result = client1.model_v3(model1)
+    assert result == model1
+
+    client2 = RemovedClient(endpoint="http://localhost:3000", version="v2preview")
+    model2 = ModelV3(id="123")
+    result = client2.model_v3(model2)
+    assert result == model2
+
+    client3 = RemovedClient(endpoint="http://localhost:3000", version="v2")
+    model3 = ModelV3(id="123", enum_prop=EnumV3.ENUM_MEMBER_V1)
+    result = client3.model_v3(model3)
+    assert result == model3

package/generator/test/unbranded/tox.ini

@@ -1,5 +1,5 @@
 [tox]
-envlist=base, lint, mypy, pyright, apiview
+envlist=base, lint, mypy, pyright, apiview, sphinx
 skipsdist=True
 
 [testenv:ci]
@@ -7,21 +7,22 @@ deps=
     -r requirements.txt
 commands =
     # pytest
-    pytest mock_api_tests ../generic_mock_api_tests
+    {[testenv:test]commands}
 
     # pylint
-    pip install azure-pylint-guidelines-checker==0.5.2 --index-url="https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-python/pypi/simple/"
-    python ../../../eng/scripts/ci/run_pylint.py -t unbranded -s "generated" {posargs}
+    {[testenv:lint]commands}
 
     # mypy
-    python ../../../eng/scripts/ci/run_mypy.py -t unbranded -s "generated" {posargs}
+    {[testenv:mypy]commands}
 
     # pyright
-    python ../../../eng/scripts/ci/run_pyright.py -t unbranded -s "generated" {posargs}
+    {[testenv:pyright]commands}
 
     # apiview
-    pip install apiview-stub-generator==0.3.19 --index-url="https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-python/pypi/simple/"
-    python ../../../eng/scripts/ci/run_apiview.py -t unbranded -s "generated" {posargs}
+    {[testenv:apiview]commands}
+
+    # sphinx docstring validation
+    {[testenv:sphinx]commands}
 
 [testenv:test]
 deps=
@@ -54,3 +55,10 @@ deps=
 commands =
     pip install apiview-stub-generator==0.3.19 --index-url="https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-python/pypi/simple/"
     python ../../../eng/scripts/ci/run_apiview.py -t unbranded -s "generated" {posargs}
+
+[testenv:sphinx]
+basepython = python3.10
+deps=
+    -r requirements.txt
+commands =
+    python ../../../eng/scripts/ci/run_sphinx_build.py -t unbranded -s "generated" {posargs}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typespec/http-client-python",
-  "version": "0.19.0",
+  "version": "0.19.2",
   "author": "Microsoft Corporation",
   "description": "TypeSpec emitter for Python SDKs",
   "homepage": "https://typespec.io",
@@ -54,20 +54,20 @@
     "emitter"
   ],
   "peerDependencies": {
-    "@azure-tools/typespec-autorest": ">=0.60.0 <1.0.0",
-    "@azure-tools/typespec-azure-core": ">=0.60.0 <1.0.0",
-    "@azure-tools/typespec-azure-resource-manager": ">=0.60.0 <1.0.0",
-    "@azure-tools/typespec-azure-rulesets": ">=0.60.0 <1.0.0",
-    "@azure-tools/typespec-client-generator-core": ">=0.60.2 <1.0.0",
-    "@typespec/compiler": "^1.4.0",
-    "@typespec/http": "^1.4.0",
-    "@typespec/openapi": "^1.4.0",
-    "@typespec/rest": ">=0.74.0 <1.0.0",
-    "@typespec/versioning": ">=0.74.0 <1.0.0",
-    "@typespec/events": ">=0.74.0 <1.0.0",
-    "@typespec/sse": ">=0.74.0 <1.0.0",
-    "@typespec/streams": ">=0.74.0 <1.0.0",
-    "@typespec/xml": ">=0.74.0 <1.0.0"
+    "@azure-tools/typespec-autorest": ">=0.61.0 <1.0.0",
+    "@azure-tools/typespec-azure-core": ">=0.61.0 <1.0.0",
+    "@azure-tools/typespec-azure-resource-manager": ">=0.61.0 <1.0.0",
+    "@azure-tools/typespec-azure-rulesets": ">=0.61.0 <1.0.0",
+    "@azure-tools/typespec-client-generator-core": ">=0.61.0 <1.0.0",
+    "@typespec/compiler": "^1.5.0",
+    "@typespec/http": "^1.5.0",
+    "@typespec/openapi": "^1.5.0",
+    "@typespec/rest": ">=0.75.0 <1.0.0",
+    "@typespec/versioning": ">=0.75.0 <1.0.0",
+    "@typespec/events": ">=0.75.0 <1.0.0",
+    "@typespec/sse": ">=0.75.0 <1.0.0",
+    "@typespec/streams": ">=0.75.0 <1.0.0",
+    "@typespec/xml": ">=0.75.0 <1.0.0"
   },
   "dependencies": {
     "js-yaml": "~4.1.0",
@@ -77,24 +77,24 @@
     "tsx": "~4.19.1"
   },
   "devDependencies": {
-    "@azure-tools/typespec-autorest": "~0.60.0",
-    "@azure-tools/typespec-azure-core": "~0.60.0",
-    "@azure-tools/typespec-azure-resource-manager": "~0.60.0",
-    "@azure-tools/typespec-azure-rulesets": "~0.60.0",
-    "@azure-tools/typespec-client-generator-core": "~0.60.2",
-    "@azure-tools/azure-http-specs": "0.1.0-alpha.30-dev.6",
-    "@typespec/compiler": "^1.4.0",
-    "@typespec/http": "^1.4.0",
-    "@typespec/openapi": "^1.4.0",
-    "@typespec/rest": "~0.74.0",
-    "@typespec/versioning": "~0.74.0",
-    "@typespec/events": "~0.74.0",
-    "@typespec/spector": "0.1.0-alpha.18",
+    "@azure-tools/typespec-autorest": "~0.61.0",
+    "@azure-tools/typespec-azure-core": "~0.61.0",
+    "@azure-tools/typespec-azure-resource-manager": "~0.61.0",
+    "@azure-tools/typespec-azure-rulesets": "~0.61.0",
+    "@azure-tools/typespec-client-generator-core": "~0.61.0",
+    "@azure-tools/azure-http-specs": "0.1.0-alpha.31",
+    "@typespec/compiler": "^1.5.0",
+    "@typespec/http": "^1.5.0",
+    "@typespec/openapi": "^1.5.0",
+    "@typespec/rest": "~0.75.0",
+    "@typespec/versioning": "~0.75.0",
+    "@typespec/events": "~0.75.0",
+    "@typespec/spector": "0.1.0-alpha.19",
     "@typespec/spec-api": "0.1.0-alpha.9",
-    "@typespec/sse": "~0.74.0",
-    "@typespec/streams": "~0.74.0",
-    "@typespec/xml": "~0.74.0",
-    "@typespec/http-specs": "0.1.0-alpha.26",
+    "@typespec/sse": "~0.75.0",
+    "@typespec/streams": "~0.75.0",
+    "@typespec/xml": "~0.75.0",
+    "@typespec/http-specs": "0.1.0-alpha.27",
     "@types/js-yaml": "~4.0.5",
     "@types/node": "~24.1.0",
     "@types/semver": "7.5.8",