fix(wrangler): Display correct global flags in wrangler pages --help

`wrangler pages --help` currently displays a list of global
flags that are not all supported by Pages, such as `--env`,
`--config`, and `--experimental-json-config`.

This commit ensure that only flags that apply to Pages are
listed when running `--help`.

Fixes #5725

.changeset/quiet-wolves-camp.md

@@ -0,0 +1,19 @@
+---
+"wrangler": minor
+---
+
+fix: Display correct global flags in `wrangler pages --help`
+
+Running `wrangler pages --help` will list, amongst others, the following global flags:
+
+```
+-j, --experimental-json-config
+-c, --config
+-e, --env
+-h, --help
+-v, --version
+```
+
+This is not accurate, since flags such as `--config`, `--experimental-json-config`, or `env` are not supported by Pages.
+
+This commit ensures we display the correct global flags that apply to Pages.

packages/wrangler/src/__tests__/pages/deploy.test.ts

@@ -58,10 +58,8 @@ describe("pages deploy", () => {
 		  directory  The directory of static files to upload  [string]
 
 		Flags:
-		  -j, --experimental-json-config  Experimental: Support wrangler.json  [boolean]
-		  -e, --env                       Environment to use for operations and .env files  [string]
-		  -h, --help                      Show help  [boolean]
-		  -v, --version                   Show version number  [boolean]
+		  -h, --help     Show help  [boolean]
+		  -v, --version  Show version number  [boolean]
 
 		Options:
 		      --project-name    The name of the project you want to deploy to  [string]
@@ -74,22 +72,46 @@ describe("pages deploy", () => {
 	`);
 	});
 
-	it("should throw an error if no `[<directory>]` arg is specified in the `pages deploy` command", async () => {
+	it("should error if no `[<directory>]` arg is specified in the `pages deploy` command", async () => {
 		await expect(
 			runWrangler("pages deploy")
 		).rejects.toThrowErrorMatchingInlineSnapshot(
 			`"Must specify a directory of assets to deploy. Please specify the [<directory>] argument in the \`pages deploy\` command, or configure \`pages_build_output_dir\` in your \`wrangler.toml\` configuration file."`
 		);
 	});
 
-	it("should throw an error if no `[--project-name]` is specified", async () => {
+	it("should error if no `[--project-name]` is specified", async () => {
 		await expect(
 			runWrangler("pages deploy public")
 		).rejects.toThrowErrorMatchingInlineSnapshot(
 			`"Must specify a project name."`
 		);
 	});
 
+	it("should error if the [--config] command line arg was specififed", async () => {
+		await expect(
+			runWrangler("pages deploy public --config=/path/to/wrangler.toml")
+		).rejects.toThrowErrorMatchingInlineSnapshot(
+			`"Pages does not support custom paths for the \`wrangler.toml\` configuration file"`
+		);
+	});
+
+	it("should error if the [--experimental-json-config] command line arg was specififed", async () => {
+		await expect(
+			runWrangler("pages deploy public --experimental-json-config")
+		).rejects.toThrowErrorMatchingInlineSnapshot(
+			`"Pages does not support \`wrangler.json\`"`
+		);
+	});
+
+	it("should error if the [--env] command line arg was specififed", async () => {
+		await expect(
+			runWrangler("pages deploy public --env=production")
+		).rejects.toThrowErrorMatchingInlineSnapshot(
+			`"Pages does not support imperatively targeting a particular environment"`
+		);
+	});
+
 	it("should upload a directory of files", async () => {
 		writeFileSync("logo.png", "foobar");
 		mockGetUploadTokenRequest(

packages/wrangler/src/__tests__/pages/dev.test.ts

@@ -31,4 +31,20 @@ describe("pages dev", () => {
 			`"Pages does not support custom paths for the \`wrangler.toml\` configuration file"`
 		);
 	});
+
+	it("should error if the [--experimental-json-config] command line arg was specififed", async () => {
+		await expect(
+			runWrangler("pages dev public --experimental-json-config")
+		).rejects.toThrowErrorMatchingInlineSnapshot(
+			`"Pages does not support \`wrangler.json\`"`
+		);
+	});
+
+	it("should error if the [--env] command line arg was specififed", async () => {
+		await expect(
+			runWrangler("pages dev public --env=production")
+		).rejects.toThrowErrorMatchingInlineSnapshot(
+			`"Pages does not support imperatively targeting a particular environment"`
+		);
+	});
 });

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

@@ -31,11 +31,8 @@ describe("pages", () => {
 		  wrangler pages download                        ⚡️ Download settings from your project
 
 		Flags:
-		  -j, --experimental-json-config  Experimental: Support wrangler.json  [boolean]
-		  -c, --config                    Path to .toml configuration file  [string]
-		  -e, --env                       Environment to use for operations and .env files  [string]
-		  -h, --help                      Show help  [boolean]
-		  -v, --version                   Show version number  [boolean]"
+		  -h, --help     Show help  [boolean]
+		  -v, --version  Show version number  [boolean]"
 	`);
 	});
 

packages/wrangler/src/index.ts

@@ -430,6 +430,10 @@ export function createCLIParser(argv: string[]) {
 
 	// pages
 	wrangler.command("pages", "⚡️ Configure Cloudflare Pages", (pagesYargs) => {
+		// Pages does not support the `--config`, `--experimental-json-config`,
+		// and `--env` flags, therefore hiding them from the global flags list.
+		pagesYargs.hide("config").hide("env").hide("experimental-json-config");
+
 		return pages(pagesYargs, subHelp);
 	});
 

packages/wrangler/src/pages/deploy.tsx

@@ -93,6 +93,17 @@ export const Handler = async (args: PagesDeployArgs) => {
 		);
 	}
 
+	if (args.experimentalJsonConfig) {
+		throw new FatalError("Pages does not support `wrangler.json`", 1);
+	}
+
+	if (args.env) {
+		throw new FatalError(
+			"Pages does not support imperatively targeting a particular environment",
+			1
+		);
+	}
+
 	let config: Config | undefined;
 	const configPath = findWranglerToml(process.cwd(), false);
 

packages/wrangler/src/pages/dev.ts

@@ -263,6 +263,17 @@ export const Handler = async (args: PagesDevArguments) => {
 		);
 	}
 
+	if (args.experimentalJsonConfig) {
+		throw new FatalError("Pages does not support `wrangler.json`", 1);
+	}
+
+	if (args.env) {
+		throw new FatalError(
+			"Pages does not support imperatively targeting a particular environment",
+			1
+		);
+	}
+
 	if (args.scriptPath !== undefined) {
 		logger.warn(
 			`\`--script-path\` is deprecated and will be removed in a future version of Wrangler.\nThe Worker script should be named \`_worker.js\` and located in the build output directory of your project (specified with \`wrangler pages dev <directory>\`).`