ClientInitialization/ParamAlias Implementation

[lmazuel]

No description provided.

[ArthurMa1978]

Discussion of this feature is here Azure/typespec-azure#914

[chunyu3]

We need to discuss if we allow to bump optional parameter to client-level. Azure/typespec-azure#1795

[chunyu3]

1. bump required parameter to client-level (AzureSDK generator supported.)

// main.tsp
namespace My.Service;

op upload(@header blobName: string): void;
op download(@header blobName: string): void;

// client.tsp
import "@azure-tools/typespec-client-generator-core";
using Azure.ClientGenerator.Core;

namespace My.Customizations;

model ClientInitOptions {
  blobName: string;
}
@@clientInitialization(MyService, ClientInitOptions)

Generated Code

public class MyServiceClient
{
  private string _blobName;
  
  public Response UploadAsync()
  public Response DownLoadAsync()
}

2. bump optional parameter to client-leveloptional parameter will be in the clientOptions

// main.tsp
namespace My.Service;

op upload(@header blobName?: string): void;
op download(@header blobName?: string): void;

// client.tsp
import "@azure-tools/typespec-client-generator-core";
using Azure.ClientGenerator.Core;

namespace My.Customizations;

model ClientInitOptions {
  blobName?: string;
}
@@clientInitialization(MyService, ClientInitOptions)

//Generated Code

public class MyServiceClient
{
  private string _blobName;
  
  public Response UploadAsync()
  public Response DownLoadAsync()
}

public class MyServiceClientOptions
{
  public MyServiceClientOptions(ServiceVersion version = LatestVersion, string? blobName=null)
  private string? blobName {get; set}
}

3. bump a parameter which is an alias (@ParamAlias) of clientinitialModel Property

// main.tsp
namespace My.Service;

op upload(@header blobName: string): void;
op download(@header blobName: string): void;
op theName(@header bName: string): void;

// client.tsp
import "@azure-tools/typespec-client-generator-core";
using Azure.ClientGenerator.Core;

namespace My.Customizations;

model ClientInitOptions {
  blobClientName: string;
}
@@clientInitialization(MyService, ClientInitOptions)
@@paramAlias(ClientInitOptions.blobClientName, "blobName");
@@paramAlias(ClientInitOptions.blobClientName, "bName")

Generated Code

public class MyServiceClient
{
  private string _blobClientName;
  
  public Response UploadAsync()
  public Response DownLoadAsync()
  public Response theName()

  public createUploadRequest()
  {
        ...
        request.Headers.Add("blobName", _blobClientName);
  }
  
  public createDownloadRequest()
  {
        ...
        request.Headers.Add("blobName", _blobClientName);
  }
  
  public createTheNameRequest()
  {
        ...
        request.Headers.Add("bName", _blobClientName);
  }
}

cc @m-nash