Expose fullyCompatible parameter of converter

tools/tsp-client/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release
 
+## 2024-10-25 - 0.13.3
+
+- Expose `fullyCompatible` argument for `@autorest/openapi-to-typespec`
+- Bumped `@autorest/openapi-to-typespec` version to `0.10.3`.
+
 ## 2024-10-21 - 0.13.2
 
 - Bumped `@autorest/openapi-to-typespec` version to `0.10.2`.

tools/tsp-client/README.md

@@ -52,7 +52,7 @@ Generate a client library from a TypeSpec project. The `generate` command should
 
 ### convert
 
-Convert an existing swagger specification to a TypeSpec project. This command should only be run once to get started working on a TypeSpec project. TypeSpec projects will need to be optimized manually and fully reviewed after conversion. When using this command a path or url to a swagger README file is required through the `--swagger-readme` flag.
+Convert an existing swagger specification to a TypeSpec project. This command should only be run once to get started working on a TypeSpec project. TypeSpec projects will need to be optimized manually and fully reviewed after conversion. When using this command a path or url to a swagger README file is required through the `--swagger-readme` flag. Highly suggested to leverage TypeSpec built-in libraries with standarded patterns and templates, which will cause discrepancy between the generated TypeSpec and original swagger. If you really don't want this intended discrepancy, add `--fully-compatible` flag.
 
 ### compare
 

tools/tsp-client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-tools/typespec-client-generator-cli",
-  "version": "0.13.2",
+  "version": "0.13.3",
   "description": "A tool to generate Azure SDKs from TypeSpec",
   "main": "dist/index.js",
   "homepage": "https://github.com/Azure/azure-sdk-tools/tree/main/tools/tsp-client#readme",
@@ -52,7 +52,7 @@
   },
   "dependencies": {
     "@autorest/core": "^3.10.2",
-    "@autorest/openapi-to-typespec": "0.10.2",
+    "@autorest/openapi-to-typespec": "0.10.3",
     "@azure-tools/typespec-autorest": ">=0.44.0 <1.0.0",
     "@azure/core-rest-pipeline": "^1.12.0",
     "@azure-tools/rest-api-diff": ">=0.1.0 <1.0.0",

tools/tsp-client/src/commands.ts

@@ -333,6 +333,7 @@ export async function convertCommand(argv: any): Promise<void> {
   const outputDir = argv["output-dir"];
   const swaggerReadme = argv["swagger-readme"];
   const arm = argv["arm"];
+  const fullyCompatible = argv["fully-compatible"];
   let rootUrl = resolvePath(outputDir);
 
   Logger.info("Converting swagger to typespec...");
@@ -368,6 +369,10 @@ export async function convertCommand(argv: any): Promise<void> {
   if (arm) {
     args.push("--isArm");
   }
+
+  if (fullyCompatible) {
+    args.push("--isFullCompatible");
+  }
   await nodeCommand(outputDir, args);
 
   if (arm) {

tools/tsp-client/src/index.ts

@@ -199,6 +199,10 @@ const parser = yargs(hideBin(process.argv))
         .option("arm", {
           type: "boolean",
           description: "Convert swagger to ARM TypeSpec",
+        })
+        .option("fully-compatible", {
+          type: "boolean",
+          description: "Convert swagger to fully compatible TypeSpec",
         });
     },
     async (argv: any) => {