Merge branch 'main' into auto-python-multi-namespace

Author: msyyc

eng/dev_requirements.txt

@@ -1,7 +1,7 @@
 azure-pylint-guidelines-checker==0.0.8
 colorama==0.4.6
 debugpy==1.8.9
-pytest==8.3.3
+pytest==8.3.4
 tox==4.23.2
 coverage==7.6.9
 black==24.10.0

packages/autorest.python/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Release
 
+## 6.27.2
+
+### Bug Fixes
+
+- [#2973](https://github.com/Azure/autorest.python/pull/2973) `:code:` in docstring should always be preceded by `\`
+
+
 ## 6.27.1
 
 ### Bump dependencies

packages/autorest.python/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autorest/python",
-  "version": "6.27.1",
+  "version": "6.27.2",
   "description": "The Python extension for generators in AutoRest.",
   "scripts": {
     "start": "node ./scripts/run-python3.js ./scripts/start.py",
@@ -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/cGlwZWxpbmVhcnRpZmFjdDovL2F6dXJlLXNkay9wcm9qZWN0SWQvMjllYzYwNDAtYjIzNC00ZTMxLWIxMzktMzNkYzQyODdiNzU2L2J1aWxkSWQvNDQxMjc0Mi9hcnRpZmFjdE5hbWUvYnVpbGRfYXJ0aWZhY3RzX3B5dGhvbg2/content?format=file&subPath=%2Fpackages%2Ftypespec-http-client-python-0.4.3.tgz",
+    "@typespec/http-client-python": "~0.4.4",
     "@autorest/system-requirements": "~1.0.2",
     "fs-extra": "~11.2.0",
     "tsx": "~4.19.1"

packages/autorest.python/test/vanilla/legacy/Expected/AcceptanceTests/BodyString/bodystring/aio/operations/_string_operations.py

@@ -358,9 +358,9 @@ async def put_mbcs(self, **kwargs: Any) -> None:
 
     @distributed_trace_async
     async def get_whitespace(self, **kwargs: Any) -> str:
-        """Get string value with leading and trailing whitespace
-        ':code:`<tab>`:code:`<space>`:code:`<space>`Now is the time for all good men to come to the aid
-        of their country:code:`<tab>`:code:`<space>`:code:`<space>`'.
+        """Get string value with leading and trailing whitespace '\\ :code:`<tab>`\\ :code:`<space>`\\
+        :code:`<space>`Now is the time for all good men to come to the aid of their country\\
+        :code:`<tab>`\\ :code:`<space>`\\ :code:`<space>`'.
 
         :return: str or the result of cls(response)
         :rtype: str
@@ -406,9 +406,9 @@ async def get_whitespace(self, **kwargs: Any) -> str:
 
     @distributed_trace_async
     async def put_whitespace(self, **kwargs: Any) -> None:
-        """Set String value with leading and trailing whitespace
-        ':code:`<tab>`:code:`<space>`:code:`<space>`Now is the time for all good men to come to the aid
-        of their country:code:`<tab>`:code:`<space>`:code:`<space>`'.
+        """Set String value with leading and trailing whitespace '\\ :code:`<tab>`\\ :code:`<space>`\\
+        :code:`<space>`Now is the time for all good men to come to the aid of their country\\
+        :code:`<tab>`\\ :code:`<space>`\\ :code:`<space>`'.
 
         :return: None or the result of cls(response)
         :rtype: None

packages/autorest.python/test/vanilla/legacy/Expected/AcceptanceTests/BodyString/bodystring/operations/_string_operations.py

@@ -556,9 +556,9 @@ def put_mbcs(self, **kwargs: Any) -> None:  # pylint: disable=inconsistent-retur
 
     @distributed_trace
     def get_whitespace(self, **kwargs: Any) -> str:
-        """Get string value with leading and trailing whitespace
-        ':code:`<tab>`:code:`<space>`:code:`<space>`Now is the time for all good men to come to the aid
-        of their country:code:`<tab>`:code:`<space>`:code:`<space>`'.
+        """Get string value with leading and trailing whitespace '\\ :code:`<tab>`\\ :code:`<space>`\\
+        :code:`<space>`Now is the time for all good men to come to the aid of their country\\
+        :code:`<tab>`\\ :code:`<space>`\\ :code:`<space>`'.
 
         :return: str or the result of cls(response)
         :rtype: str
@@ -604,9 +604,9 @@ def get_whitespace(self, **kwargs: Any) -> str:
 
     @distributed_trace
     def put_whitespace(self, **kwargs: Any) -> None:  # pylint: disable=inconsistent-return-statements
-        """Set String value with leading and trailing whitespace
-        ':code:`<tab>`:code:`<space>`:code:`<space>`Now is the time for all good men to come to the aid
-        of their country:code:`<tab>`:code:`<space>`:code:`<space>`'.
+        """Set String value with leading and trailing whitespace '\\ :code:`<tab>`\\ :code:`<space>`\\
+        :code:`<space>`Now is the time for all good men to come to the aid of their country\\
+        :code:`<tab>`\\ :code:`<space>`\\ :code:`<space>`'.
 
         :return: None or the result of cls(response)
         :rtype: None

packages/autorest.python/test/vanilla/version-tolerant/Expected/AcceptanceTests/BodyStringVersionTolerant/bodystringversiontolerant/aio/operations/_operations.py

@@ -367,9 +367,9 @@ async def put_mbcs(self, **kwargs: Any) -> None:
 
     @distributed_trace_async
     async def get_whitespace(self, **kwargs: Any) -> str:
-        """Get string value with leading and trailing whitespace
-        ':code:`<tab>`:code:`<space>`:code:`<space>`Now is the time for all good men to come to the aid
-        of their country:code:`<tab>`:code:`<space>`:code:`<space>`'.
+        """Get string value with leading and trailing whitespace '\\ :code:`<tab>`\\ :code:`<space>`\\
+        :code:`<space>`Now is the time for all good men to come to the aid of their country\\
+        :code:`<tab>`\\ :code:`<space>`\\ :code:`<space>`'.
 
         :return: str
         :rtype: str
@@ -417,9 +417,9 @@ async def get_whitespace(self, **kwargs: Any) -> str:
 
     @distributed_trace_async
     async def put_whitespace(self, **kwargs: Any) -> None:
-        """Set String value with leading and trailing whitespace
-        ':code:`<tab>`:code:`<space>`:code:`<space>`Now is the time for all good men to come to the aid
-        of their country:code:`<tab>`:code:`<space>`:code:`<space>`'.
+        """Set String value with leading and trailing whitespace '\\ :code:`<tab>`\\ :code:`<space>`\\
+        :code:`<space>`Now is the time for all good men to come to the aid of their country\\
+        :code:`<tab>`\\ :code:`<space>`\\ :code:`<space>`'.
 
         :return: None
         :rtype: None

packages/autorest.python/test/vanilla/version-tolerant/Expected/AcceptanceTests/BodyStringVersionTolerant/bodystringversiontolerant/operations/_operations.py

@@ -654,9 +654,9 @@ def put_mbcs(self, **kwargs: Any) -> None:  # pylint: disable=inconsistent-retur
 
     @distributed_trace
     def get_whitespace(self, **kwargs: Any) -> str:
-        """Get string value with leading and trailing whitespace
-        ':code:`<tab>`:code:`<space>`:code:`<space>`Now is the time for all good men to come to the aid
-        of their country:code:`<tab>`:code:`<space>`:code:`<space>`'.
+        """Get string value with leading and trailing whitespace '\\ :code:`<tab>`\\ :code:`<space>`\\
+        :code:`<space>`Now is the time for all good men to come to the aid of their country\\
+        :code:`<tab>`\\ :code:`<space>`\\ :code:`<space>`'.
 
         :return: str
         :rtype: str
@@ -704,9 +704,9 @@ def get_whitespace(self, **kwargs: Any) -> str:
 
     @distributed_trace
     def put_whitespace(self, **kwargs: Any) -> None:  # pylint: disable=inconsistent-return-statements
-        """Set String value with leading and trailing whitespace
-        ':code:`<tab>`:code:`<space>`:code:`<space>`Now is the time for all good men to come to the aid
-        of their country:code:`<tab>`:code:`<space>`:code:`<space>`'.
+        """Set String value with leading and trailing whitespace '\\ :code:`<tab>`\\ :code:`<space>`\\
+        :code:`<space>`Now is the time for all good men to come to the aid of their country\\
+        :code:`<tab>`\\ :code:`<space>`\\ :code:`<space>`'.
 
         :return: None
         :rtype: None

packages/typespec-python/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Release
 
+## 0.37.2
+
+### Bug Fixes
+
+- [#2973](https://github.com/Azure/autorest.python/pull/2973) `:code:` in docstring should always be preceded by `\`
+
+
 ## 0.37.1
 
 ### Bump dependencies

packages/typespec-python/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-tools/typespec-python",
-  "version": "0.37.1",
+  "version": "0.37.2",
   "author": "Microsoft Corporation",
   "description": "TypeSpec emitter for Python SDKs",
   "homepage": "https://github.com/Azure/autorest.python",
@@ -60,7 +60,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/cGlwZWxpbmVhcnRpZmFjdDovL2F6dXJlLXNkay9wcm9qZWN0SWQvMjllYzYwNDAtYjIzNC00ZTMxLWIxMzktMzNkYzQyODdiNzU2L2J1aWxkSWQvNDQxMjc0Mi9hcnRpZmFjdE5hbWUvYnVpbGRfYXJ0aWZhY3RzX3B5dGhvbg2/content?format=file&subPath=%2Fpackages%2Ftypespec-http-client-python-0.4.3.tgz",
+    "@typespec/http-client-python": "~0.4.4",
     "fs-extra": "~11.2.0"
   },
   "devDependencies": {

packages/typespec-python/test/azure/generated/typetest-property-additionalproperties/typetest/property/additionalproperties/models/_models.py

@@ -19,7 +19,7 @@
 
 
 class DifferentSpreadFloatRecord(_model_base.Model):
-    """The model spread Record:code:`<float32>` with the different known property type.
+    """The model spread Record\\ :code:`<float32>` with the different known property type.
 
 
     :ivar name: The id property. Required.
@@ -48,7 +48,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class DifferentSpreadFloatDerived(DifferentSpreadFloatRecord):
-    """The model extends from a model that spread Record:code:`<float32>` with the different known
+    """The model extends from a model that spread Record\\ :code:`<float32>` with the different known
     property type.
 
 
@@ -143,7 +143,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class DifferentSpreadModelRecord(_model_base.Model):
-    """The model spread Record:code:`<ModelForRecord>` with the different known property type.
+    """The model spread Record\\ :code:`<ModelForRecord>` with the different known property type.
 
 
     :ivar known_prop: Required.
@@ -172,7 +172,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class DifferentSpreadModelDerived(DifferentSpreadModelRecord):
-    """The model extends from a model that spread Record:code:`<ModelForRecord>` with the different
+    """The model extends from a model that spread Record\\ :code:`<ModelForRecord>` with the different
     known property type.
 
 
@@ -205,7 +205,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class DifferentSpreadStringRecord(_model_base.Model):
-    """The model spread Record:code:`<string>` with the different known property type.
+    """The model spread Record\\ :code:`<string>` with the different known property type.
 
 
     :ivar id: The name property. Required.
@@ -234,7 +234,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class DifferentSpreadStringDerived(DifferentSpreadStringRecord):
-    """The model extends from a model that spread Record:code:`<string>` with the different known
+    """The model extends from a model that spread Record\\ :code:`<string>` with the different known
     property type.
 
 
@@ -267,7 +267,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class ExtendsFloatAdditionalProperties(_model_base.Model):
-    """The model extends from Record:code:`<float32>` type.
+    """The model extends from Record\\ :code:`<float32>` type.
 
 
     :ivar id: The id property. Required.
@@ -296,7 +296,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class ExtendsModelAdditionalProperties(_model_base.Model):
-    """The model extends from Record:code:`<ModelForRecord>` type.
+    """The model extends from Record\\ :code:`<ModelForRecord>` type.
 
 
     :ivar known_prop: Required.
@@ -354,7 +354,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class ExtendsStringAdditionalProperties(_model_base.Model):
-    """The model extends from Record:code:`<string>` type.
+    """The model extends from Record\\ :code:`<string>` type.
 
 
     :ivar name: The name property. Required.
@@ -383,7 +383,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class ExtendsUnknownAdditionalProperties(_model_base.Model):
-    """The model extends from Record:code:`<unknown>` type.
+    """The model extends from Record\\ :code:`<unknown>` type.
 
 
     :ivar name: The name property. Required.
@@ -412,7 +412,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class ExtendsUnknownAdditionalPropertiesDerived(ExtendsUnknownAdditionalProperties):  # pylint: disable=name-too-long
-    """The model extends from a type that extends from Record:code:`<unknown>`.
+    """The model extends from a type that extends from Record\\ :code:`<unknown>`.
 
 
     :ivar name: The name property. Required.
@@ -449,7 +449,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class ExtendsUnknownAdditionalPropertiesDiscriminated(_model_base.Model):  # pylint: disable=name-too-long
-    """The model extends from Record:code:`<unknown>` with a discriminator.
+    """The model extends from Record\\ :code:`<unknown>` with a discriminator.
 
     You probably want to use the sub-classes and not this class directly. Known sub-classes are:
     ExtendsUnknownAdditionalPropertiesDiscriminatedDerived
@@ -530,7 +530,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class IsFloatAdditionalProperties(_model_base.Model):
-    """The model is from Record:code:`<float32>` type.
+    """The model is from Record\\ :code:`<float32>` type.
 
 
     :ivar id: The id property. Required.
@@ -559,7 +559,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class IsModelAdditionalProperties(_model_base.Model):
-    """The model is from Record:code:`<ModelForRecord>` type.
+    """The model is from Record\\ :code:`<ModelForRecord>` type.
 
 
     :ivar known_prop: Required.
@@ -617,7 +617,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class IsStringAdditionalProperties(_model_base.Model):
-    """The model is from Record:code:`<string>` type.
+    """The model is from Record\\ :code:`<string>` type.
 
 
     :ivar name: The name property. Required.
@@ -646,7 +646,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class IsUnknownAdditionalProperties(_model_base.Model):
-    """The model is from Record:code:`<unknown>` type.
+    """The model is from Record\\ :code:`<unknown>` type.
 
 
     :ivar name: The name property. Required.
@@ -675,7 +675,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class IsUnknownAdditionalPropertiesDerived(IsUnknownAdditionalProperties):
-    """The model extends from a type that is Record:code:`<unknown>` type.
+    """The model extends from a type that is Record\\ :code:`<unknown>` type.
 
 
     :ivar name: The name property. Required.
@@ -712,7 +712,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class IsUnknownAdditionalPropertiesDiscriminated(_model_base.Model):  # pylint: disable=name-too-long
-    """The model is Record:code:`<unknown>` with a discriminator.
+    """The model is Record\\ :code:`<unknown>` with a discriminator.
 
     You probably want to use the sub-classes and not this class directly. Known sub-classes are:
     IsUnknownAdditionalPropertiesDiscriminatedDerived
@@ -822,7 +822,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class MultipleSpreadRecord(_model_base.Model):
-    """The model spread Record:code:`<string>` and Record:code:`<float32>`.
+    """The model spread Record\\ :code:`<string>` and Record\\ :code:`<float32>`.
 
 
     :ivar flag: The name property. Required.
@@ -851,7 +851,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class SpreadFloatRecord(_model_base.Model):
-    """The model spread Record:code:`<float32>` with the same known property type.
+    """The model spread Record\\ :code:`<float32>` with the same known property type.
 
 
     :ivar id: The id property. Required.
@@ -909,7 +909,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class SpreadModelRecord(_model_base.Model):
-    """The model spread Record:code:`<ModelForRecord>` with the same known property type.
+    """The model spread Record\\ :code:`<ModelForRecord>` with the same known property type.
 
 
     :ivar known_prop: Required.
@@ -938,7 +938,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class SpreadRecordForDiscriminatedUnion(_model_base.Model):
-    """The model spread Record:code:`<WidgetData>`.
+    """The model spread Record\\ :code:`<WidgetData>`.
 
 
     :ivar name: The name property. Required.
@@ -1083,7 +1083,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
 
 
 class SpreadStringRecord(_model_base.Model):
-    """The model spread Record:code:`<string>` with the same known property type.
+    """The model spread Record\\ :code:`<string>` with the same known property type.
 
 
     :ivar name: The name property. Required.