Add support for URI templates

[timotheeguerin]

fix #3736

[azure-sdk]

All changed packages have been documented.

• ✅ @typespec/compiler
• ✅ @typespec/http
• ✅ @typespec/openapi3
• ✅ @typespec/rest

Show changes

@typespec/http - feature ✏️

@route can now take a uri template as defined by RFC-6570,> ,> tsp,> @route("files{+path}") download(path: string): void;,>

@typespec/openapi3 - feature ✏️

Add support for URI templates in routes

@typespec/rest - feature ✏️

Add support for URI templates in routes

@typespec/http - deprecation ✏️

API deprecation: HttpOperation#pathSegments is deprecated. Use HttpOperation#uriTemplate instead.

@typespec/http - deprecation ✏️

Deprecated @query({format: }) option. Use @query(#{explode: true}) instead of form or multi format. Previously csv/simple is the default now.,> Decorator is also expecting an object value now instead of a model. A deprecation warning with a codefix will help migrating.,> ,> diff,> - @query({format: "form"}) select: string[];,> + @query(#{explode: true}) select: string[];,>

@typespec/compiler - feature ✏️

Add ArrayEncoding enum to define simple serialization of arrays

[azure-sdk]

You can try these changes here

🛝 Playground	🌐 Website	📚 Next docs

[weidongxu-microsoft]

Would there be pending update on e.g. typespec-azure-core lib on @query({format: "multi"}) -> @query(#{explode: true})?
https://github.com/Azure/typespec-azure/blob/main/packages/typespec-azure-core/lib/models.tsp#L93-L95

[timotheeguerin]

Would there be pending update on e.g. typespec-azure-core lib on @query({format: "multi"}) -> @query(#{explode: true})? https://github.com/Azure/typespec-azure/blob/main/packages/typespec-azure-core/lib/models.tsp#L93-L95

yes azure repo has its own pr taking the change Azure/typespec-azure#1247