Deprecate version command (#5069)

* deprecate `wrangler version` command

`wrangler --version` is already supported and recommended instead

.changeset/twelve-penguins-guess.md

@@ -0,0 +1,7 @@
+---
+"wrangler": patch
+---
+
+chore: deprecate `wrangler version` command
+
+`wrangler version` is an undocumented alias for `wrangler --version`. It is being deprecated in favour of the more conventional flag syntax to avoid confusion with a new (upcoming) `wrangler versions` command.

packages/wrangler/src/__tests__/version.test.ts

@@ -18,18 +18,32 @@ describe("version", () => {
 	// `);
 	// });
 
-	it("should output current version if !isTTY calling -v", async () => {
+	it("should output current version if !isTTY calling with `-v` flag", async () => {
 		setIsTTY(false);
 
 		await runWrangler("-v");
 		expect(std.out).toMatch(version);
+		expect(std.warn).toBe("");
 	});
 
 	// This run separately as command handling is different
-	it("should output current version if !isTTY calling --version", async () => {
+	it("should output current version if !isTTY calling with `--version` flag", async () => {
 		setIsTTY(false);
 
 		await runWrangler("--version");
 		expect(std.out).toMatch(version);
+		expect(std.warn).toBe("");
+	});
+
+	it("should output current version if !isTTY calling (deprecated) `version` command", async () => {
+		setIsTTY(false);
+
+		await runWrangler("version");
+		expect(std.out).toMatch(version);
+		expect(std.warn).toMatchInlineSnapshot(`
+		"▲ [WARNING] \`wrangler version\` is deprecated and will be removed in a future major version. Please use \`wrangler --version\` instead.
+
+		"
+	`);
 	});
 });

packages/wrangler/src/index.ts

@@ -703,7 +703,7 @@ export function createCLIParser(argv: string[]) {
 	// This set to false to allow overwrite of default behaviour
 	wrangler.version(false);
 
-	// version
+	// version (DEPRECATED)
 	wrangler.command(
 		"version",
 		false,
@@ -714,6 +714,10 @@ export function createCLIParser(argv: string[]) {
 			} else {
 				logger.log(wranglerVersion);
 			}
+
+			logger.warn(
+				"`wrangler version` is deprecated and will be removed in a future major version. Please use `wrangler --version` instead."
+			);
 		}
 	);