Sync from typespec main (2026-05-19) (1f144e1)

.chronus/changes/fix-ci-readme-regeneration-2026-5-14.md

@@ -0,0 +1,8 @@
+---
+changeKind: internal
+packages:
+  - "@autorest/python"
+  - "@azure-tools/typespec-python"
+---
+
+Fix CI on main by deleting README.md files during baseline reset so regeneration recreates them; extend unit test to assert README.md exists for every generated SDK package (azure & unbranded).

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

packages/typespec-python/package.json

@@ -65,7 +65,7 @@
     "@typespec/xml": ">=0.82.0 <1.0.0"
   },
   "dependencies": {
-    "@typespec/http-client-python": "https://artprodcus3.artifacts.visualstudio.com/A0fb41ef4-5012-48a9-bf39-4ee3de03ee35/29ec6040-b234-4e31-b139-33dc4287b756/_apis/artifact/cGlwZWxpbmVhcnRpZmFjdDovL2F6dXJlLXNkay9wcm9qZWN0SWQvMjllYzYwNDAtYjIzNC00ZTMxLWIxMzktMzNkYzQyODdiNzU2L2J1aWxkSWQvNjI4OTI1Ni9hcnRpZmFjdE5hbWUvYnVpbGRfYXJ0aWZhY3RzX3B5dGhvbg2/content?format=file&subPath=%2Fpackages%2Ftypespec-http-client-python-0.29.1.tgz",
+    "@typespec/http-client-python": "https://artprodcus3.artifacts.visualstudio.com/A0fb41ef4-5012-48a9-bf39-4ee3de03ee35/29ec6040-b234-4e31-b139-33dc4287b756/_apis/artifact/cGlwZWxpbmVhcnRpZmFjdDovL2F6dXJlLXNkay9wcm9qZWN0SWQvMjllYzYwNDAtYjIzNC00ZTMxLWIxMzktMzNkYzQyODdiNzU2L2J1aWxkSWQvNjI5Nzg2Mi9hcnRpZmFjdE5hbWUvYnVpbGRfYXJ0aWZhY3RzX3B5dGhvbg2/content?format=file&subPath=%2Fpackages%2Ftypespec-http-client-python-0.29.1.tgz",
     "fs-extra": "~11.2.0",
     "js-yaml": "~4.1.0",
     "semver": "~7.6.2",

packages/typespec-python/tests/mock_api/shared/unittests/test_readme.py

@@ -0,0 +1,46 @@
+from pathlib import Path
+
+import pytest
+
+GENERATED_DIR = Path(__file__).parent / "../../../generated"
+FLAVORS = ("azure", "unbranded")
+
+# Folders that exist in the azure-sdk-for-python baseline checkout but are not
+# regenerated by the emitter, so their README.md is never (re)written. Skip
+# them to keep this test focused on real generated packages.
+#   - "azure/service-multiple-services": listed in SKIP_SPECS in
+#     eng/scripts/ci/regenerate-common.ts (no emitter run for this spec).
+#   - "azure/azure-client-generator-core-client-initialization": orphan parent
+#     folder; only its sub-specs (.../default, .../individually,
+#     .../individuallyParent) are actually emitted as packages.
+SKIP_PACKAGES = {
+    ("azure", "service-multiple-services"),
+    ("azure", "azure-client-generator-core-client-initialization"),
+}
+
+
+def _package_dirs():
+    base = GENERATED_DIR.resolve()
+    dirs = []
+    for flavor in FLAVORS:
+        flavor_dir = base / flavor
+        if not flavor_dir.is_dir():
+            continue
+        for p in sorted(flavor_dir.iterdir()):
+            if not p.is_dir():
+                continue
+            if (flavor, p.name) in SKIP_PACKAGES:
+                continue
+            dirs.append(p)
+    return dirs
+
+
+@pytest.mark.parametrize(
+    "package_dir",
+    _package_dirs(),
+    ids=lambda p: f"{p.parent.name}/{p.name}",
+)
+def test_readme_exists(package_dir: Path):
+    """Each generated SDK package folder (azure & unbranded) must contain a README.md."""
+    readme_path = package_dir / "README.md"
+    assert readme_path.is_file(), f"README.md not found at {readme_path}"