Bump core from 9f5630b to eb24510 (#1246)

Bumps [core](https://github.com/microsoft/typespec) from `9f5630b` to `eb24510`. <details> <summary>Commits</summary> <ul> <li><a href="https://github.com/microsoft/typespec/commit/eb245109c05e98e10fdd75c48040d33c432a6a98"><code>eb24510</code></a> Add deprecation notice in ref docs (<a href="https://redirect.github.com/microsoft/typespec/issues/4025">#4025</a>)</li> <li><a href="https://github.com/microsoft/typespec/commit/3aa2f5c373f6eb8bfc8fb12ecb8722b0efd68b63"><code>3aa2f5c</code></a> fix the response does not deserialize issue (<a href="https://redirect.github.com/microsoft/typespec/issues/4029">#4029</a>)</li> <li><a href="https://github.com/microsoft/typespec/commit/f9317013867704ccd5dc171c9f4002a3d7d7a292"><code>f931701</code></a> Add PostVisit method (<a href="https://redirect.github.com/microsoft/typespec/issues/4026">#4026</a>)</li> <li><a href="https://github.com/microsoft/typespec/commit/e746179f66128de843e00d61ebb945f93487d8e0"><code>e746179</code></a> Cadl ranch test framework (<a href="https://redirect.github.com/microsoft/typespec/issues/3964">#3964</a>)</li> <li><a href="https://github.com/microsoft/typespec/commit/2fdb218b69b71360e8bc68b599649fe4939c4526"><code>2fdb218</code></a> exclude when cspell.yaml changed (<a href="https://redirect.github.com/microsoft/typespec/issues/4021">#4021</a>)</li> <li><a href="https://github.com/microsoft/typespec/commit/5f41741ef3476c518fe013fb9623b93e5e2b19c1"><code>5f41741</code></a> Bump braces from 3.0.2 to 3.0.3 in /packages/http-client-csharp (<a href="https://redirect.github.com/microsoft/typespec/issues/3606">#3606</a>)</li> <li><a href="https://github.com/microsoft/typespec/commit/3087671788840b3612f15c19b5b3f4e472565eff"><code>3087671</code></a> Add java emitter label (<a href="https://redirect.github.com/microsoft/typespec/issues/3963">#3963</a>)</li> <li>See full diff in <a href="https://github.com/microsoft/typespec/compare/9f5630b4303340ee40283a897094cad13487a239...eb245109c05e98e10fdd75c48040d33c432a6a98">compare view</a></li> </ul> </details> <br /> Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting `@dependabot rebase`. [//]: # (dependabot-automerge-start) [//]: # (dependabot-automerge-end) --- <details> <summary>Dependabot commands and options</summary> <br /> You can trigger Dependabot actions by commenting on this PR: - `@dependabot rebase` will rebase this PR - `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it - `@dependabot merge` will merge this PR after your CI passes on it - `@dependabot squash and merge` will squash and merge this PR after your CI passes on it - `@dependabot cancel merge` will cancel a previously requested merge and block automerging - `@dependabot reopen` will reopen this PR if it is closed - `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually - `@dependabot show <dependency name> ignore conditions` will show all of the ignore conditions of the specified dependency - `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) </details> --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Timothee Guerin <tiguerin@microsoft.com>
Azure · Jul 26, 2024 · 4434dc2 · 4434dc2
1 parent f6af1ee
commit 4434dc2
Show file tree

Hide file tree

Showing 6 changed files with 79 additions and 1 deletion.
diff --git a/core b/core
diff --git a/docs/libraries/azure-core/reference/interfaces.md b/docs/libraries/azure-core/reference/interfaces.md
@@ -338,6 +338,10 @@ op Azure.Core.LongRunningResourceCollectionAction(apiVersion: string): Azure.Cor
 
 ### `LongRunningResourceCreateOrReplace` {#Azure.Core.LongRunningResourceCreateOrReplace}
 
+:::warning
+**Deprecated**: Use `LongRunningResourceCreateOrReplace` from a `ResourceOperations` interface instance.
+:::
+
 DEPRECATED: Use `LongRunningResourceCreateOrReplace` from a `ResourceOperations` interface instance.
 This can be done by instantiating your own version with the traits you want `alias Operations = Azure.Core.ResourceOperations<ServiceTraits>;`.
 See https://azure.github.io/typespec-azure/docs/getstarted/azure-core/step05#defining-the-operation-interface for details on how to use.
@@ -357,6 +361,10 @@ op Azure.Core.LongRunningResourceCreateOrReplace(apiVersion: string, resource: R
 
 ### `LongRunningResourceCreateOrUpdate` {#Azure.Core.LongRunningResourceCreateOrUpdate}
 
+:::warning
+**Deprecated**: Use `LongRunningResourceCreateOrUpdate` from a `ResourceOperations` interface instance.
+:::
+
 DEPRECATED: Use `LongRunningResourceCreateOrUpdate` from a `ResourceOperations` interface instance.
 This can be done by instantiating your own version with the traits you want `alias Operations = Azure.Core.ResourceOperations<ServiceTraits>;`.
 See https://azure.github.io/typespec-azure/docs/getstarted/azure-core/step05#defining-the-operation-interface for details on how to use.
@@ -376,6 +384,10 @@ op Azure.Core.LongRunningResourceCreateOrUpdate(apiVersion: string, contentType:
 
 ### `LongRunningResourceCreateWithServiceProvidedName` {#Azure.Core.LongRunningResourceCreateWithServiceProvidedName}
 
+:::warning
+**Deprecated**: Use `LongRunningResourceCreateWithServiceProvidedName` from a `ResourceOperations` interface instance.
+:::
+
 DEPRECATED: Use `LongRunningResourceCreateWithServiceProvidedName` from a `ResourceOperations` interface instance.
 This can be done by instantiating your own version with the traits you want `alias Operations = Azure.Core.ResourceOperations<ServiceTraits>;`.
 See https://azure.github.io/typespec-azure/docs/getstarted/azure-core/step05#defining-the-operation-interface for details on how to use.
@@ -476,6 +488,10 @@ op Azure.Core.ResourceCollectionAction(apiVersion: string): {} | Azure.Core.Foun
 
 ### `ResourceCreateOrReplace` {#Azure.Core.ResourceCreateOrReplace}
 
+:::warning
+**Deprecated**: Use `ResourceCreateOrReplace` from a `ResourceOperations` interface instance.
+:::
+
 DEPRECATED: Use `ResourceCreateOrReplace` from a `ResourceOperations` interface instance.
 This can be done by instantiating your own version with the traits you want `alias Operations = Azure.Core.ResourceOperations<ServiceTraits>;`.
 See https://azure.github.io/typespec-azure/docs/getstarted/azure-core/step05#defining-the-operation-interface for details on how to use.
@@ -495,6 +511,10 @@ op Azure.Core.ResourceCreateOrReplace(apiVersion: string, resource: Resource): {
 
 ### `ResourceCreateOrUpdate` {#Azure.Core.ResourceCreateOrUpdate}
 
+:::warning
+**Deprecated**: Use `LongRunningResourceCreateOrReplace` from a `ResourceOperations` interface instance.
+:::
+
 DEPRECATED: Use `ResourceCreateOrUpdate` from a `ResourceOperations` interface instance.
 This can be done by instantiating your own version with the traits you want `alias Operations = Azure.Core.ResourceOperations<ServiceTraits>;`.
 See https://azure.github.io/typespec-azure/docs/getstarted/azure-core/step05#defining-the-operation-interface for details on how to use.
@@ -514,6 +534,10 @@ op Azure.Core.ResourceCreateOrUpdate(apiVersion: string, contentType: "applicati
 
 ### `ResourceCreateWithServiceProvidedName` {#Azure.Core.ResourceCreateWithServiceProvidedName}
 
+:::warning
+**Deprecated**: Use `ResourceCreateWithServiceProvidedName` from a `ResourceOperations` interface instance.
+:::
+
 DEPRECATED: Use `ResourceCreateWithServiceProvidedName` from a `ResourceOperations` interface instance.
 This can be done by instantiating your own version with the traits you want `alias Operations = Azure.Core.ResourceOperations<ServiceTraits>;`.
 See https://azure.github.io/typespec-azure/docs/getstarted/azure-core/step05#defining-the-operation-interface for details on how to use.
@@ -590,6 +614,10 @@ op Azure.Core.ResourceRead(apiVersion: string): {} | Azure.Core.Foundations.Erro
 
 ### `ResourceUpdate` {#Azure.Core.ResourceUpdate}
 
+:::warning
+**Deprecated**: Use `ResourceUpdate` from a `ResourceOperations` interface instance.
+:::
+
 DEPRECATED: Use `ResourceUpdate` from a `ResourceOperations` interface instance.
 This can be done by instantiating your own version with the traits you want `alias Operations = Azure.Core.ResourceOperations<ServiceTraits>;`.
 See https://azure.github.io/typespec-azure/docs/getstarted/azure-core/step05#defining-the-operation-interface for details on how to use.

diff --git a/docs/libraries/azure-resource-manager/reference/data-types.md b/docs/libraries/azure-resource-manager/reference/data-types.md
@@ -1694,6 +1694,10 @@ model Azure.ResourceManager.CommonTypes.TrackedResource
 
 ### `UserAssignedIdentities` {#Azure.ResourceManager.CommonTypes.UserAssignedIdentities}
 
+:::warning
+**Deprecated**: Do not use this model. Instead, use Record<UserAssignedIdentity | null> directly. Using this model will result in a different client SDK when generated from TypeSpec compared to the Swagger.
+:::
+
 The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests.
 
 ```typespec

diff --git a/docs/libraries/azure-resource-manager/reference/interfaces.md b/docs/libraries/azure-resource-manager/reference/interfaces.md
@@ -247,6 +247,10 @@ op Azure.ResourceManager.ResourceCreateSync.createOrUpdate(provider: "Microsoft.
 
 ### `ResourceDeleteAsync` {#Azure.ResourceManager.ResourceDeleteAsync}
 
+:::warning
+**Deprecated**: This should be deprecated in a future release
+:::
+
 ```typespec
 interface Azure.ResourceManager.ResourceDeleteAsync<Resource, BaseParameters>
 ```
@@ -390,6 +394,10 @@ op Azure.ResourceManager.ResourceListBySubscription.listBySubscription(apiVersio
 
 ### `ResourceOperations` {#Azure.ResourceManager.ResourceOperations}
 
+:::warning
+**Deprecated**: Use Azure.ResourceManager.TrackedResourceOperations instead
+:::
+
 ```typespec
 interface Azure.ResourceManager.ResourceOperations<Resource, Properties, BaseParameters>
 ```
@@ -845,6 +853,10 @@ op Azure.ResourceManager.ArmResourceCreateOrUpdateAsync(provider: "Microsoft.Thi
 
 ### `ArmResourceCreateOrUpdateSync` {#Azure.ResourceManager.ArmResourceCreateOrUpdateSync}
 
+:::warning
+**Deprecated**: Please use ArmResourceCreateOrReplaceSync instead
+:::
+
 DEPRECATED: Please use ArmResourceCreateOrReplaceSync instead
 
 ```typespec
@@ -863,6 +875,10 @@ op Azure.ResourceManager.ArmResourceCreateOrUpdateSync(provider: "Microsoft.This
 
 ### `ArmResourceDeleteAsync` {#Azure.ResourceManager.ArmResourceDeleteAsync}
 
+:::warning
+**Deprecated**: Use 'ArmResourceDeleteWithoutOkAsync' instead
+:::
+
 ```typespec
 op Azure.ResourceManager.ArmResourceDeleteAsync(provider: "Microsoft.ThisWillBeReplaced"): Response | Error
 ```

diff --git a/docs/libraries/typespec-client-generator-core/reference/decorators.md b/docs/libraries/typespec-client-generator-core/reference/decorators.md
@@ -201,6 +201,10 @@ interface MyInterface {}
 
 ### `@clientFormat` {#@Azure.ClientGenerator.Core.clientFormat}
 
+:::warning
+**Deprecated**: @clientFormat decorator is deprecated. Use `@encode` decorator in `@typespec/compiler` instead.
+:::
+
 DEPRECATED: Use `@encode` decorator in `@typespec/compiler` instead.
 
 Can be used to explain the client type that the current TYPESPEC
@@ -291,6 +295,10 @@ op test: void;
 
 ### `@exclude` {#@Azure.ClientGenerator.Core.exclude}
 
+:::warning
+**Deprecated**: @exclude decorator is deprecated. Use `@usage` and `@access` decorator instead.
+:::
+
 DEPRECATED: Use `@usage` and `@access` decorator instead.
 
 Whether to exclude a model from generation for specific languages. By default we generate
@@ -321,6 +329,10 @@ model ModelToExclude {
 
 ### `@flattenProperty` {#@Azure.ClientGenerator.Core.flattenProperty}
 
+:::warning
+**Deprecated**: @flattenProperty decorator is not recommended to use.
+:::
+
 Set whether a model property should be flattened or not.
 
 ```typespec
@@ -349,6 +361,10 @@ model Bar {}
 
 ### `@include` {#@Azure.ClientGenerator.Core.include}
 
+:::warning
+**Deprecated**: @include decorator is deprecated. Use `@usage` and `@access` decorator instead.
+:::
+
 DEPRECATED: Use `@usage` and `@access` decorator instead.
 
 Whether to include a model in generation for specific languages. By default we generate
@@ -379,6 +395,10 @@ model ModelToInclude {
 
 ### `@internal` {#@Azure.ClientGenerator.Core.internal}
 
+:::warning
+**Deprecated**: @internal decorator is deprecated. Use `@access` decorator instead.
+:::
+
 DEPRECATED: Use `@access` decorator instead.
 
 Whether to mark an operation as internal for specific languages,

diff --git a/packages/typespec-client-generator-core/README.md b/packages/typespec-client-generator-core/README.md
@@ -218,6 +218,8 @@ interface MyInterface {}
 
 #### `@clientFormat`
 
+_Deprecated: @clientFormat decorator is deprecated. Use `@encode` decorator in `@typespec/compiler` instead._
+
 DEPRECATED: Use `@encode` decorator in `@typespec/compiler` instead.
 
 Can be used to explain the client type that the current TYPESPEC
@@ -308,6 +310,8 @@ op test: void;
 
 #### `@exclude`
 
+_Deprecated: @exclude decorator is deprecated. Use `@usage` and `@access` decorator instead._
+
 DEPRECATED: Use `@usage` and `@access` decorator instead.
 
 Whether to exclude a model from generation for specific languages. By default we generate
@@ -338,6 +342,8 @@ model ModelToExclude {
 
 #### `@flattenProperty`
 
+_Deprecated: @flattenProperty decorator is not recommended to use._
+
 Set whether a model property should be flattened or not.
 
 ```typespec
@@ -366,6 +372,8 @@ model Bar {}
 
 #### `@include`
 
+_Deprecated: @include decorator is deprecated. Use `@usage` and `@access` decorator instead._
+
 DEPRECATED: Use `@usage` and `@access` decorator instead.
 
 Whether to include a model in generation for specific languages. By default we generate
@@ -396,6 +404,8 @@ model ModelToInclude {
 
 #### `@internal`
 
+_Deprecated: @internal decorator is deprecated. Use `@access` decorator instead._
+
 DEPRECATED: Use `@access` decorator instead.
 
 Whether to mark an operation as internal for specific languages,