Allow theme commands to take glob pattern for environments

graygilmore · graygilmore · commit 322d2efbd154 · 2025-10-07T15:24:32.000-04:00
diff --git a/.changeset/wet-bats-glow.md b/.changeset/wet-bats-glow.md
@@ -0,0 +1,14 @@
+---
+'@shopify/cli-kit': patch
+'@shopify/theme': patch
+'@shopify/app': patch
+---
+
+Updated the environment flag to support glob patterns
+
+For commands that support multiple environments you can now use glob patterns
+to specify the environments, e.g. `--environment "*-production"`. It's important
+to wrap any glob patterns in quotes to ensure your shell does not expand the
+value before passing it to the CLI.
+
+This comes with a side effect that environments will be deduplicated.
diff --git a/docs-shopify.dev/commands/interfaces/theme-check.interface.ts b/docs-shopify.dev/commands/interfaces/theme-check.interface.ts
@@ -16,7 +16,7 @@ export interface themecheck {
   '-C, --config <value>'?: string
 
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string
diff --git a/docs-shopify.dev/commands/interfaces/theme-console.interface.ts b/docs-shopify.dev/commands/interfaces/theme-console.interface.ts
@@ -1,7 +1,7 @@
 // This is an autogenerated file. Don't edit this file manually.
 export interface themeconsole {
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string
diff --git a/docs-shopify.dev/commands/interfaces/theme-delete.interface.ts b/docs-shopify.dev/commands/interfaces/theme-delete.interface.ts
@@ -7,7 +7,7 @@ export interface themedelete {
   '-d, --development'?: ''
 
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string
diff --git a/docs-shopify.dev/commands/interfaces/theme-dev.interface.ts b/docs-shopify.dev/commands/interfaces/theme-dev.interface.ts
@@ -1,7 +1,7 @@
 // This is an autogenerated file. Don't edit this file manually.
 export interface themedev {
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string
diff --git a/docs-shopify.dev/commands/interfaces/theme-duplicate.interface.ts b/docs-shopify.dev/commands/interfaces/theme-duplicate.interface.ts
@@ -1,7 +1,7 @@
 // This is an autogenerated file. Don't edit this file manually.
 export interface themeduplicate {
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string
diff --git a/docs-shopify.dev/commands/interfaces/theme-info.interface.ts b/docs-shopify.dev/commands/interfaces/theme-info.interface.ts
@@ -7,7 +7,7 @@ export interface themeinfo {
   '-d, --development'?: ''
 
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string
diff --git a/docs-shopify.dev/commands/interfaces/theme-list.interface.ts b/docs-shopify.dev/commands/interfaces/theme-list.interface.ts
@@ -1,7 +1,7 @@
 // This is an autogenerated file. Don't edit this file manually.
 export interface themelist {
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string
diff --git a/docs-shopify.dev/commands/interfaces/theme-metafields-pull.interface.ts b/docs-shopify.dev/commands/interfaces/theme-metafields-pull.interface.ts
@@ -1,7 +1,7 @@
 // This is an autogenerated file. Don't edit this file manually.
 export interface thememetafieldspull {
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string
diff --git a/docs-shopify.dev/commands/interfaces/theme-open.interface.ts b/docs-shopify.dev/commands/interfaces/theme-open.interface.ts
@@ -13,7 +13,7 @@ export interface themeopen {
   '-E, --editor'?: ''
 
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string
diff --git a/docs-shopify.dev/commands/interfaces/theme-profile.interface.ts b/docs-shopify.dev/commands/interfaces/theme-profile.interface.ts
@@ -1,7 +1,7 @@
 // This is an autogenerated file. Don't edit this file manually.
 export interface themeprofile {
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string
diff --git a/docs-shopify.dev/commands/interfaces/theme-publish.interface.ts b/docs-shopify.dev/commands/interfaces/theme-publish.interface.ts
@@ -1,7 +1,7 @@
 // This is an autogenerated file. Don't edit this file manually.
 export interface themepublish {
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string
diff --git a/docs-shopify.dev/commands/interfaces/theme-pull.interface.ts b/docs-shopify.dev/commands/interfaces/theme-pull.interface.ts
@@ -7,7 +7,7 @@ export interface themepull {
   '-d, --development'?: ''
 
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string
diff --git a/docs-shopify.dev/commands/interfaces/theme-push.interface.ts b/docs-shopify.dev/commands/interfaces/theme-push.interface.ts
@@ -13,7 +13,7 @@ export interface themepush {
   '-d, --development'?: ''
 
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string
diff --git a/docs-shopify.dev/commands/interfaces/theme-rename.interface.ts b/docs-shopify.dev/commands/interfaces/theme-rename.interface.ts
@@ -7,7 +7,7 @@ export interface themerename {
   '-d, --development'?: ''
 
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string
diff --git a/docs-shopify.dev/commands/interfaces/theme-share.interface.ts b/docs-shopify.dev/commands/interfaces/theme-share.interface.ts
@@ -1,7 +1,7 @@
 // This is an autogenerated file. Don't edit this file manually.
 export interface themeshare {
   /**
-   * The environment to apply to the current command.
+   * The environment to apply to the current command. Wrap the value in double quotes if you're using wildcards.
    * @environment SHOPIFY_FLAG_ENVIRONMENT
    */
   '-e, --environment <value>'?: string
diff --git a/docs-shopify.dev/generated/generated_docs_data.json b/docs-shopify.dev/generated/generated_docs_data.json
diff --git a/packages/cli-kit/src/public/node/base-command.test.ts b/packages/cli-kit/src/public/node/base-command.test.ts
diff --git a/packages/cli-kit/src/public/node/base-command.ts b/packages/cli-kit/src/public/node/base-command.ts
diff --git a/packages/cli/README.md b/packages/cli/README.md
diff --git a/packages/cli/oclif.manifest.json b/packages/cli/oclif.manifest.json
diff --git a/packages/theme/src/cli/flags.ts b/packages/theme/src/cli/flags.ts
diff --git a/packages/theme/src/cli/utilities/theme-command.test.ts b/packages/theme/src/cli/utilities/theme-command.test.ts
diff --git a/packages/theme/src/cli/utilities/theme-command.ts b/packages/theme/src/cli/utilities/theme-command.ts
