Uptake uri templates (#1247)

Core PR microsoft/typespec#3932

.chronus/changes/uptake-uri-templates-2024-6-26-21-7-49.md

@@ -0,0 +1,8 @@
+---
+# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking
+changeKind: internal
+packages:
+  - "@azure-tools/typespec-azure-core"
+---
+
+Call correct HTTP library API 

.chronus/changes/uptake-uri-templates-2024-7-6-9-38-18.md

@@ -0,0 +1,6 @@
+---
+changeKind: internal
+packages:
+  - "@azure-tools/typespec-client-generator-core"
+---
+

.chronus/changes/uptake-uri-templates-2024-7-6-9-38-7.md

@@ -0,0 +1,7 @@
+---
+changeKind: feature
+packages:
+  - "@azure-tools/typespec-autorest"
+---
+
+Add support for URI templates in routes

docs/libraries/azure-core/rules/no-query-explode.md

@@ -0,0 +1,35 @@
+---
+title: "no-query-explode"
+---
+
+```text title="Full name"
+@azure-tools/typespec-azure-core/no-query-explode
+```
+
+Azure services favor serializing query parameter of array type using the simple style(Where each values is joined by a `,`)
+Using the `*` uri template modifier or `explode: true` property specify that each individual value of the array should be sent as a separate query parameter.
+
+#### ❌ Incorrect
+
+```tsp
+op list(
+  @query(#{ explode: true })
+  select: string[],
+): Pet[];
+```
+
+#### ✅ Correct
+
+```tsp
+op list(
+  @query
+  select: string[],
+): Pet[];
+```
+
+```tsp
+op list(
+  @query(#{ explode: false })
+  select: string[],
+): Pet[];
+```

docs/release-notes/release-2023-04-11.md

@@ -59,9 +59,7 @@ op list(@collectionFormat("multi") @query select: string[]): Pet[];
 
 // Now
 op list(
-  @query({
-    format: "multi",
-  })
+  @query(#{ explode: true })
   select: string[],
 ): Pet[];
 ```

packages/e2e-tests/cadl-ranch-specs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@azure-tools/typespec-e2e-cadl-ranch-specs",
   "dependencies": {
-    "@azure-tools/cadl-ranch-specs": "0.34.10"
+    "@azure-tools/cadl-ranch-specs": "0.35.0"
   },
   "type": "module",
   "private": true

packages/samples/specs/misc/appconfig/keyvalues.tsp

@@ -44,9 +44,7 @@ namespace KeyValuesResource {
     After: plainDate,
 
     @doc("Used to select what fields are present in the returned resource(s).")
-    @query({
-      format: "multi",
-    })
+    @query(#{ explode: true })
     $Select?: KeyField[],
   ): {
     ...Response<200>;
@@ -70,9 +68,7 @@ namespace KeyValuesResource {
     After: plainDate,
 
     @doc("Used to select what fields are present in the returned resource(s).")
-    @query({
-      format: "multi",
-    })
+    @query(#{ explode: true })
     $Select?: KeyField[],
   ): {
     ...Response<200>;
@@ -88,9 +84,7 @@ namespace KeyValuesResource {
     ...KeyWithFilters,
 
     @doc("Used to select what fields are present in the returned resource(s).")
-    @query({
-      format: "multi",
-    })
+    @query(#{ explode: true })
     $Select?: KeyField[],
   ): {
     ...Response<200>;

packages/samples/specs/misc/appconfig/labels.tsp

@@ -34,9 +34,7 @@ namespace LabelsResource {
     @query name?: string,
     @query after?: string,
 
-    @query({
-      format: "multi",
-    })
+    @query(#{ explode: true })
     $Select?: LabelField[],
   ): {
     ...Response<200>;

packages/samples/specs/misc/appconfig/revisions.tsp

@@ -14,9 +14,7 @@ namespace RevisionsResource {
     ...AcceptDatetimeHeader,
 
     @doc("Used to select what fields are present in the returned resource(s).")
-    @query({
-      format: "multi",
-    })
+    @query(#{ explode: true })
     $Select?: KeyField[],
 
     @doc("A filter used to match labels")

packages/samples/test/output/azure/core/data-plane/api-path-parameter/@typespec/openapi3/openapi.2022-08-31.yaml

@@ -725,7 +725,6 @@ components:
         type: array
         items:
           type: string
-      style: form
       explode: true
     Azure.Core.SkipQueryParameter:
       name: skip

packages/samples/test/output/azure/core/data-plane/custom-error-type/@typespec/openapi3/openapi.2022-08-31.yaml

@@ -375,7 +375,6 @@ components:
         type: array
         items:
           type: string
-      style: form
       explode: true
     Azure.Core.SkipQueryParameter:
       name: skip

packages/samples/test/output/azure/core/data-plane/trait-versioning/@typespec/openapi3/openapi.2022-08-31.yaml

@@ -642,7 +642,6 @@ components:
         type: array
         items:
           type: string
-      style: form
       explode: true
     Azure.Core.SkipQueryParameter:
       name: skip

packages/samples/test/output/azure/core/data-plane/trait-versioning/@typespec/openapi3/openapi.2023-02-07.yaml

@@ -726,7 +726,6 @@ components:
         type: array
         items:
           type: string
-      style: form
       explode: true
     Azure.Core.SkipQueryParameter:
       name: skip

packages/samples/test/output/azure/core/data-plane/widget-manager/@typespec/openapi3/openapi.2022-08-31.yaml

@@ -1349,7 +1349,6 @@ components:
         type: array
         items:
           type: string
-      style: form
       explode: true
     Azure.Core.SkipQueryParameter:
       name: skip

packages/samples/test/output/azure/core/misc/appconfig/@typespec/openapi3/openapi.yaml

@@ -101,7 +101,6 @@ paths:
             type: array
             items:
               $ref: '#/components/schemas/KeyField'
-          style: form
           explode: true
       responses:
         '200':
@@ -147,7 +146,6 @@ paths:
             type: array
             items:
               $ref: '#/components/schemas/KeyField'
-          style: form
           explode: true
       responses:
         '200':
@@ -182,7 +180,6 @@ paths:
             type: array
             items:
               $ref: '#/components/schemas/KeyField'
-          style: form
           explode: true
       responses:
         '200':
@@ -464,7 +461,6 @@ paths:
             type: array
             items:
               $ref: '#/components/schemas/LabelField'
-          style: form
           explode: true
       responses:
         '200':
@@ -570,7 +566,6 @@ paths:
             type: array
             items:
               $ref: '#/components/schemas/KeyField'
-          style: form
           explode: true
         - name: label
           in: query