[python] Add test for client-doc spector scenario (Azure typespec-azure #4268)

[Copilot]

Adds python SDK mock_api coverage for the spector cases introduced in Azure/typespec-azure#4268. Of the two new scenarios under azure/client-generator-core/, only client-doc is generatable by the python emitter (response-as-bool is already in SKIP_SPECS).

Changes

• Tests — sync + async tests for the @clientDoc scenario:
  • harvest POST round-trip against the mock server.
  • @clientDoc append mode: Plant model docstring retains base doc and appends client-specific text.
  • @clientDoc replace mode: harvest operation docstring fully overrides the base doc.
  • Docstring assertions compare the whole docstring exactly (==) rather than substrings.
• Changelog — internal chronus entry for @typespec/http-client-python.

response-as-bool is intentionally skipped in the emitter regeneration config, so no client is generated and no test is added for it.

def test_harvest(client: ClientDocClient):
    body = models.Plant(name="Rose", species="Rosa")
    assert client.documentation.harvest(body) == body

def test_model_doc_appended():
    # @clientDoc in append mode keeps the base @doc and appends the client-specific text.
    assert models.Plant.__doc__ == (
        "A plant in the garden. This model is used to represent a plant in the client SDK.\n"
        "\n"
        "    :ivar name: The name of the plant. Required.\n"
        "    :vartype name: str\n"
        "    :ivar species: The species of the plant. Required.\n"
        "    :vartype species: str\n"
        "    "
    )

[msyyc]

Instead of check sub string, we should compare whole docstring with for all the test cases @copilot

[Copilot]

Updated all the docstring assertions to compare the whole docstring with == instead of substring checks, for both sync and async tests. add5d5e

[msyyc]

@copilot resolve the merge conflicts in this pull request

[Copilot]

@copilot resolve the merge conflicts in this pull request

Resolved the merge conflicts with main. The only conflict was the version bump in packages/http-client-python/package-lock.json, which I aligned to 0.31.0 to match package.json. Merged in commit 3e6e6b8.