shopify-cli 2.24.0 → 2.26.0

data/lib/project_types/script/messages/messages.rb

@@ -4,264 +4,7 @@ module Script
   module Messages
     MESSAGES = {
       script: {
-        help: <<~HELP,
-          Suite of commands for developing script applications. Run {{command:%1$s script <command> --help}} for usage of each command.
-            Usage: {{command:%1$s script [ %2$s ]}}
-        HELP
-
-        error: {
-          deprecated_ep: "This script won't run in a store because "\
-                         "it uses a deprecated Script API (%s).",
-          deprecated_ep_cause: "Recreate this script using a supported Script API.",
-          generic: "{{red:{{x}} Error}}",
-          eacces_cause: "You don't have permission to write to this directory.",
-          eacces_help: "Get permission for this directory or choose a different one.",
-
-          enospc_cause: "You don't have enough disk space to do this action.",
-          enospc_help: "Free up more space.",
-
-          oauth_cause: "Something went wrong while authenticating your account with the Partner Dashboard.",
-          oauth_help: "Wait a few minutes and try again.",
-
-          invalid_context_cause: "Your .shopify-cli.yml is formatted incorrectly. It's missing values for "\
-                                 "extension_point_type, title, app_bridge_create_path or app_bridge_details_path.",
-          invalid_context_help: "Add these values.",
-
-          invalid_script_title_cause: "Script title contains unsupported characters.",
-          invalid_script_title_help: "Use only numbers, letters, hyphens, or underscores.",
-
-          no_existing_apps_cause: "Your script can't be pushed to an app because your Partner account "\
-                                  "doesn't have any apps.",
-          no_existing_apps_help: "Create an app.",
-
-          no_existing_orgs_cause: "Your account doesn't belong to a Partner Organization.",
-          no_existing_orgs_help: "Visit https://partners.shopify.com/ to create an account.",
-
-          project_exists_cause: "A directory with this same title already exists.",
-          project_exists_help: "Choose a different title for your script.",
-
-          invalid_extension_cause: "The name of the Script API is incorrect: %s.",
-          invalid_extension_help: "Choose a supported API: %s.",
-
-          invalid_language_cause: "The language is not supported: %s.",
-          invalid_language_help: "Choose a supported language: %s.",
-
-          missing_script_config_field_cause: "The %{filename} file is missing the required %{field} field.",
-          missing_script_config_field_help: "Add the field.",
-
-          script_config_parse_error_cause: "The %{filename} file contains incorrect %{serialization_format}.",
-          script_config_parse_error_help: "Correct the errors.",
-
-          no_script_config_file_cause: "The %{filename} file is missing.",
-          no_script_config_file_help: "Create this file.",
-
-          app_not_connected_cause: "The script is not connected to an app.",
-          app_not_connected_help: "Run {{command:%{tool_name} script connect}}.",
-
-          configuration_definition_error_cause: "In %{filename} there is a problem with the "\
-                                                "configuration. %{message}",
-          configuration_definition_error_help: "Fix the error.",
-
-          configuration_definition_errors_cause: "In %{filename}, there are %{error_count} problems with "\
-                                                 "the configuration:\n%{concatenated_messages}\n",
-          configuration_definition_errors_help: "Correct the errors.",
-
-          configuration_syntax_error_cause: "The %{filename} is not formatted correctly.",
-          configuration_syntax_error_help: "Fix the errors.",
-
-          configuration_missing_keys_error_cause: "The %{filename} is missing required keys: "\
-                                              "%{missing_keys}.",
-          configuration_missing_keys_error_help: "Add the keys.",
-
-          configuration_invalid_value_error_cause: "The %{filename} configuration accepts "\
-                                                   "one of the following types(s): %{valid_input_modes}.",
-          configuration_invalid_value_error_help: "Change the value of the type.",
-
-          configuration_schema_field_missing_keys_error_cause: "A configuration entry in the %{filename} file "\
-                                                     "is missing required keys: %{missing_keys}.",
-          configuration_definition_schema_field_missing_keys_error_help: "Add the keys.",
-
-          configuration_schema_field_invalid_value_error_cause: "The configuration entries in the "\
-                                                     "%{filename} file accept one of the following "\
-                                                     "type(s): %{valid_types}.",
-          configuration_schema_field_invalid_value_error_help: "Change the value of the type.",
-
-          input_query_error_cause: "Input query is invalid:\n%{messages}\n\n",
-          input_query_error_help: "Fix the query in the `%{input_query_path}` file.",
-
-          script_not_found_cause: "Can't find script %s for Script API %s",
-
-          system_call_failure_cause: "Something went wrong while running: {{command:%{cmd}}}.",
-          system_call_failure_help: "Correct the error.\n{{red:%{out}}}",
-
-          metadata_validation_cause: "The Script API metadata is incorrect.",
-          metadata_validation_help: "The 'schemaVersions.major' field contains an unsupported version.",
-
-          metadata_schema_versions_missing: "Invalid Script metadata:" \
-                                            " 'schemaVersions' field is missing",
-          metadata_schema_versions_single_key: "Invalid Script API metadata:" \
-                                               " 'schemaVersions' can have only one Script API name.",
-          metadata_schema_versions_missing_major: "Invalid Script API metadata:" \
-                                                  " 'schemaVersions' is missing the 'major' field",
-          metadata_schema_versions_missing_minor: "Invalid Script API metadata:" \
-                                                  " 'schemaVersions' is missing the 'minor' field",
-
-          metadata_not_found_cause: "Can't find the script version file (%{filename}).",
-          metadata_not_found_help: "Make sure your project is up-to-date and a script metadata file " \
-                                   "is accessible at %{filename}.",
-
-          build_error_cause: "Something went wrong while building the script.",
-          build_error_help: "Correct the errors.",
-
-          dependency_install_cause: "Something went wrong while installing the needed dependencies.",
-          dependency_install_help: "Correct the errors.",
-
-          invalid_environment_cause: "Your environment %{tool} version, %{env_version}, "\
-                                     "is too low. It must be at least %{minimum_version}.",
-          invalid_environment_help: "Update %{tool}.",
-
-          failed_api_request_cause: "Something went wrong while communicating with Shopify.",
-          failed_api_request_help: "Try again.",
-
-          forbidden_error_cause: "You don't have permission to do this action.",
-
-          graphql_error_cause: "An error was returned: %s.",
-          graphql_error_help: "\nCorrect the error.",
-
-          script_repush_cause: "Can’t push the script because a version of this script already exists on the app.",
-          script_repush_help: "Use {{cyan:--force}} to replace the existing script.",
-
-          build_script_not_found: "The root package.json is missing the build command that " \
-                                  "is needed to compile your script to Wasm.",
-          # rubocop:disable Layout/LineLength
-          build_script_suggestion: "\n\nFor example, your package.json needs the following command:" \
-            "\nbuild: npx shopify-scripts-toolchain-as build --src src/shopify_main.ts --binary build/<script_name>.wasm --metadata build/metadata.json -- --lib node_modules --optimize --use Date=",
-
-          web_assembly_binary_not_found: "Wasm binary not found.",
-          web_assembly_binary_not_found_suggestion: "Check that a valid Wasm binary is present. " \
-          "The Wasm binary's filepath must be 'build/index.wasm'.",
-
-          project_config_not_found: "Internal error - Script can't be created because the project's config file is missing from the repository.",
-
-          invalid_project_config: "Internal error - Script can't be created because the project's config file is invalid in the repository.",
-
-          script_upload_cause: "Something went wrong and your script couldn't be pushed.",
-          script_upload_help: "Try again.",
-
-          script_too_large_cause: "The size of your Wasm binary file is too large.",
-          script_too_large_help: "It must be less than %{max_size}.",
-
-          api_library_not_found_cause: "Script can't be created because API library %{library_name} is missing from the dependencies",
-          api_library_not_found_help: "This can occur because the API library was removed from your system or there is a problem with dependencies in the repository.",
-
-          language_library_for_api_not_found_cause: "Script can’t be pushed because the %{language} library for API %{api} is missing.",
-          language_library_for_api_not_found_help: "Make sure extension_point.yml contains the correct API library.",
-          no_scripts_found_in_app: "The selected apps have no scripts. Please, create them first on the partners' dashboard.",
-          missing_push_options_ci: "The following are missing: %s. ",
-          missing_push_options_ci_solution: "To add them to a CI environment:\n\t1. Run a connect command " \
-          "({{command:%1$s script connect}})\n\t2. Navigate to the .env file at the root of your project\n\t" \
-          "3. Copy the missing values and pass them through as arguments in {{command:%1$s script push}}",
-          missing_env_file_variables: "The following are missing in the .env file: %s. ",
-          missing_env_file_variables_solution: "To add it, connect your script with " \
-          "{{command:%1$s script connect}} ",
-
-          invalid_app_bridge_path_cause: "The script couldn't be pushed because the App Bridge path is incorrect in .shopify-cli.yml.",
-          invalid_app_bridge_path_help: "The %{path_key} needs to be set to a path that starts with {{command:/}}.",
-        },
-
-        create: {
-          help: <<~HELP,
-            {{command:%1$s script create}}: Creates a script project.
-              Usage: {{command:%1$s script create}}
-              Options:
-                {{command:--title=TITLE}} Script project title.
-                {{command:--api=TYPE}} Script API name. Supported values: %2$s.
-                {{command:--language=LANGUAGE}} Programming language. Defaults to wasm. Supported values: %3$s.
-          HELP
-
-          error: {
-            operation_failed: "Something went wrong and the script wasn't created.",
-          },
-
-          change_directory_notice: "{{*}} Change directories to {{green:%s}} to run script commands.",
-          creating: "Creating script.",
-          created: "Created script.",
-          preparing_project: "Preparing script project structure.",
-          creating_wasm: "Creating configuration files.",
-          created_wasm: "Configuration files created.",
-        },
-
-        push: {
-          help: <<~HELP,
-            Build the script, upload it to Shopify, and register it to an app.
-              Usage: {{command:%s script push}}
-              Options:
-                {{command:[--force]}} Replace the existing script with this version.
-                {{command:[--api-key=API_KEY]}} The API key used to register an app with the script. This can be found on the app page on Partners Dashboard. Overrides the value in the .env file, if present.
-                {{command:[--api-secret=API_SECRET]}} The API secret of the app the script is registered with. Overrides the value in the .env file, if present.
-                {{command:[--uuid=UUID]}} The uuid of the script. Overrides the value in the .env file, if present.
-          HELP
-
-          error: {
-            operation_failed: "Couldn't push script to app.",
-          },
-
-          script_pushed: "{{v}} Script pushed to app (API key: %{api_key}).",
-        },
-        connect: {
-          connected: "Connected! Your project is now connected to {{green:%s}}",
-          help: <<~HELP,
-            {{command:%s script connect}}: Connects an existing script to an app.
-              Usage: {{command:%s script connect}}
-          HELP
-          error: {
-            operation_failed: "Couldn't connect script to app.",
-          },
-        },
-        javy: {
-          help: <<~HELP,
-            Compile the JavaScript code into Wasm.
-              Usage: {{command:%s script javy}}
-              Options:
-                {{command:--in}} The name of the JavaScript file that will be compiled.
-                {{command:--out}} The name of the file that the Wasm should be written to.
-          HELP
-          errors: {
-            invalid_arguments: "Javy was run with invalid arguments. Run {{command: %s script javy --help}}.",
-          },
-        },
-
-        project_deps: {
-          none_required: "{{v}} Dependencies are up to date.",
-          checking: "Checking dependencies.",
-          installing: "Installing dependencies.",
-          installed: "Installed missing dependencies.",
-        },
-
-        forms: {
-          create: {
-            select_extension_point: "Which Script API do you want to use?",
-            script_title: "What do you want to title your script?",
-          },
-        },
-
-        application: {
-          building: "Building",
-          building_script: "Building script",
-          built: "Built",
-          pushing: "Pushing",
-          pushing_script: "Pushing script",
-          pushed: "Pushed",
-          ensure_env: {
-            organization: "Partner organization {{green:%s (%s)}}.",
-            organization_select: "Which partner organization do you want to use?",
-            app: "Push script to app {{green:%s}}.",
-            app_select: "Which app do you want to push this script to?",
-            ask_connect_to_existing_script: "This app contains scripts. Do you want to replace an "\
-              "existing script on the app with this script?",
-            ask_which_script_to_connect_to: "Which script do you want to replace?",
-          },
-        },
+        deprecated: "Script projects are no longer supported in CLI 2.0. Please upgrade to CLI 3.0.",
       },
     }.freeze
   end

data/lib/project_types/theme/commands/common/shop_helper.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Theme
+  class Command
+    module Common
+      module ShopHelper
+        def shop
+          ShopifyCLI::AdminAPI.get_shop_or_abort(@ctx)
+        end
+      end
+    end
+  end
+end

data/lib/project_types/theme/commands/delete.rb

@@ -1,10 +1,13 @@
 # frozen_string_literal: true
 require "shopify_cli/theme/theme"
 require "shopify_cli/theme/development_theme"
+require "project_types/theme/commands/common/shop_helper"
 
 module Theme
   class Command
     class Delete < ShopifyCLI::Command::SubCommand
+      include Common::ShopHelper
+
       recommend_default_ruby_range
 
       options do |parser, flags|
@@ -22,7 +25,7 @@ module Theme
           form = Forms::Select.ask(
             @ctx,
             [],
-            title: @ctx.message("theme.delete.select"),
+            title: @ctx.message("theme.delete.select", shop),
             exclude_roles: ["live"],
             include_foreign_developments: options.flags[:show_all],
             cmd: :delete

data/lib/project_types/theme/commands/list.rb

@@ -2,10 +2,13 @@
 
 require "shopify_cli/theme/theme"
 require "project_types/theme/presenters/themes_presenter"
+require "project_types/theme/commands/common/shop_helper"
 
 module Theme
   class Command
     class List < ShopifyCLI::Command::SubCommand
+      include Common::ShopHelper
+
       recommend_default_ruby_range
 
       def call(_args, _name)
@@ -25,10 +28,6 @@ module Theme
       def themes_presenter
         Theme::Presenters::ThemesPresenter.new(@ctx, nil)
       end
-
-      def shop
-        ShopifyCLI::AdminAPI.get_shop_or_abort(@ctx)
-      end
     end
   end
 end

data/lib/project_types/theme/commands/open.rb

@@ -2,10 +2,13 @@
 
 require "shopify_cli/theme/theme"
 require "shopify_cli/theme/development_theme"
+require "project_types/theme/commands/common/shop_helper"
 
 module Theme
   class Command
     class Open < ShopifyCLI::Command::SubCommand
+      include Common::ShopHelper
+
       recommend_default_ruby_range
 
       options do |parser, flags|
@@ -60,7 +63,7 @@ module Theme
         form = Forms::Select.ask(
           @ctx,
           [],
-          title: @ctx.message("theme.open.select"),
+          title: @ctx.message("theme.open.select", shop),
           root: nil
         )
         form&.theme

data/lib/project_types/theme/commands/publish.rb

@@ -1,9 +1,12 @@
 # frozen_string_literal: true
 require "shopify_cli/theme/theme"
+require "project_types/theme/commands/common/shop_helper"
 
 module Theme
   class Command
     class Publish < ShopifyCLI::Command::SubCommand
+      include Common::ShopHelper
+
       recommend_default_ruby_range
 
       options do |parser, flags|
@@ -17,7 +20,7 @@ module Theme
           form = Forms::Select.ask(
             @ctx,
             [],
-            title: @ctx.message("theme.publish.select"),
+            title: @ctx.message("theme.publish.select", shop),
             exclude_roles: ["live", "development", "demo"],
             cmd: :publish
           )

data/lib/project_types/theme/commands/pull.rb

@@ -5,12 +5,14 @@ require "shopify_cli/theme/ignore_filter"
 require "shopify_cli/theme/include_filter"
 require "shopify_cli/theme/syncer"
 require "project_types/theme/commands/common/root_helper"
+require "project_types/theme/commands/common/shop_helper"
 require "project_types/theme/conversions/include_glob"
 require "project_types/theme/conversions/ignore_glob"
 
 module Theme
   class Command
     class Pull < ShopifyCLI::Command::SubCommand
+      include Common::ShopHelper
       include Common::RootHelper
 
       recommend_default_ruby_range
@@ -97,7 +99,7 @@ module Theme
         form = Forms::Select.ask(
           @ctx,
           [],
-          title: @ctx.message("theme.pull.select"),
+          title: @ctx.message("theme.pull.select", shop),
           root: root,
         )
         form&.theme

data/lib/project_types/theme/commands/push.rb

@@ -5,12 +5,14 @@ require "shopify_cli/theme/ignore_filter"
 require "shopify_cli/theme/include_filter"
 require "shopify_cli/theme/syncer"
 require "project_types/theme/commands/common/root_helper"
+require "project_types/theme/commands/common/shop_helper"
 require "project_types/theme/conversions/include_glob"
 require "project_types/theme/conversions/ignore_glob"
 
 module Theme
   class Command
     class Push < ShopifyCLI::Command::SubCommand
+      include Common::ShopHelper
       include Common::RootHelper
 
       recommend_default_ruby_range
@@ -134,7 +136,7 @@ module Theme
         form = Forms::Select.ask(
           @ctx,
           [],
-          title: @ctx.message("theme.push.select"),
+          title: @ctx.message("theme.push.select", shop),
           root: root,
         )
         form&.theme

data/lib/project_types/theme/commands/serve.rb

@@ -1,6 +1,10 @@
 # frozen_string_literal: true
 require "shopify_cli/theme/dev_server"
 require "project_types/theme/commands/common/root_helper"
+require "shopify_cli/theme/ignore_filter"
+require "shopify_cli/theme/include_filter"
+require "project_types/theme/conversions/include_glob"
+require "project_types/theme/conversions/ignore_glob"
 
 module Theme
   class Command
@@ -12,6 +16,9 @@ module Theme
       DEFAULT_HTTP_HOST = "127.0.0.1"
 
       options do |parser, flags|
+        Conversions::IncludeGlob.register(parser)
+        Conversions::IgnoreGlob.register(parser)
+
         parser.on("--host=HOST") { |host| flags[:host] = host.to_s }
         parser.on("--port=PORT") { |port| flags[:port] = port.to_i }
         parser.on("--poll") { flags[:poll] = true }
@@ -19,6 +26,14 @@ module Theme
         parser.on("--theme-editor-sync") { flags[:editor_sync] = true }
         parser.on("--stable") { flags[:stable] = true }
         parser.on("-t", "--theme=NAME_OR_ID") { |theme| flags[:theme] = theme }
+        parser.on("-o", "--only=PATTERN", Conversions::IncludeGlob) do |pattern|
+          flags[:includes] ||= []
+          flags[:includes] |= pattern
+        end
+        parser.on("-x", "--ignore=PATTERN", Conversions::IgnoreGlob) do |pattern|
+          flags[:ignores] ||= []
+          flags[:ignores] |= pattern
+        end
       end
 
       def call(_args, name)
@@ -31,9 +46,6 @@ module Theme
         ShopifyCLI::Theme::DevServer.start(@ctx, root, host: host, **flags) do |syncer|
           UI::SyncProgressBar.new(syncer).progress(:upload_theme!, delay_low_priority_files: true)
         end
-      rescue ShopifyCLI::Theme::DevServer::AddressBindingError
-        raise ShopifyCLI::Abort,
-          ShopifyCLI::Context.message("theme.serve.error.address_binding_error", ShopifyCLI::TOOL_NAME)
       end
 
       def self.as_reload_mode(mode)

data/lib/project_types/theme/messages/messages.rb

@@ -47,7 +47,7 @@ module Theme
           not_found: "Theme #%s does not exist",
           no_themes_error: "You don't have any theme to be published.",
           no_themes_resolution: "Try to create an unpublished theme with {{command:theme push -u -t <theme_name>}}.",
-          select: "Select theme to push to",
+          select: "Select theme to push to %s",
           confirm: "Are you sure you want to make %s the new live theme on %s?",
         },
         forms: {
@@ -87,7 +87,7 @@ module Theme
             pushing: "Pushing theme files to %s (#%s) on %s",
           },
           push: "Pushing theme files to Shopify",
-          select: "Select theme to push to",
+          select: "Select theme to push to %s",
           live: "Are you sure you want to push to your live theme?",
           theme: "\n  Theme: {{blue:%s #%s}} {{green:[live]}}",
           deprecated_themeid: <<~WARN,
@@ -138,6 +138,8 @@ module Theme
           viewing_theme: "Viewing theme…",
           syncing_theme: "Syncing theme #%s on %s",
           open_fail: "Couldn't open the theme",
+          stop_signal: "Stop signal: \"%s\"",
+          stopping: "Stopping…",
           auth: {
             error_message: <<~ERROR_MESSAGE,
               It looks like you are using credentials that do not work with {{command:%s theme serve}}.
@@ -230,8 +232,6 @@ module Theme
             },
           },
           error: {
-            address_binding_error: "Couldn't bind to localhost."\
-              " To serve your theme, set a different address with {{command:%s theme serve --host=<address>}}",
             invalid_subdirectory: <<~MESSAGE,
               The presence of %s in the directory structure isn't supported.
 
@@ -262,6 +262,8 @@ module Theme
           ENSURE_USER
           address_already_in_use: "The address \"%s\" is already in use.",
           try_port_option: "Use the --port=PORT option to serve the theme in a different port.",
+          binding_error: "Couldn't bind to localhost." \
+            " To serve your theme, set a different address with {{command:%s theme serve --host=<address>}}",
         },
         check: {
           help: <<~HELP,
@@ -283,7 +285,7 @@ module Theme
 
             Run without options to select the theme to delete from a list.
           HELP
-          select: "Select theme to delete",
+          select: "Select theme to delete from %s",
           done: "%s theme(s) deleted",
           no_themes_error: "You don't have any theme to be deleted.",
           no_themes_resolution: "Try to create an unpublished theme with {{command:theme push -u -t <theme_name>}}.",
@@ -328,7 +330,7 @@ module Theme
 
             Run without options to select theme from a list.
           HELP
-          select: "Select a theme to pull from",
+          select: "Select a theme to pull from %s",
           pulling: "Pulling theme files from %s (#%s) on %s",
           done: "Theme pulled successfully.",
           done_with_errors: "{{warning:Your theme was pulled with errors.}}",
@@ -338,7 +340,7 @@ module Theme
           theme_not_found: "Theme \"%s\" doesn't exist",
         },
         open: {
-          select: "Select a theme to open",
+          select: "Select a theme to open in %s",
           theme_not_found: "Theme \"%s\" doesn't exist",
           details: <<~DETAILS,
             {{*}} {{bold:%s}}

data/lib/shopify_cli/commands/logout.rb

@@ -1,11 +1,14 @@
 require "shopify_cli"
 require "shopify_cli/theme/development_theme"
+require "shopify_cli/theme/extension/host_theme"
 
 module ShopifyCLI
   module Commands
     class Logout < ShopifyCLI::Command
       def call(*)
         try_delete_development_theme
+        try_delete_host_theme
+
         ShopifyCLI::IdentityAuth.delete_tokens_and_keys
         ShopifyCLI::DB.del(:shop) if has_shop?
         ShopifyCLI::DB.del(:organization_id) if has_organization_id?
@@ -31,8 +34,16 @@ module ShopifyCLI
         return unless has_shop?
 
         ShopifyCLI::Theme::DevelopmentTheme.delete(@ctx)
-      rescue ShopifyCLI::API::APIRequestError, ShopifyCLI::Abort, ShopifyCLI::AbortSilent
-        # Ignore since we can't delete it
+      rescue ShopifyCLI::API::APIRequestError, ShopifyCLI::Abort, ShopifyCLI::AbortSilent => e
+        @ctx.debug("[Logout Error]: #{e.message}")
+      end
+
+      def try_delete_host_theme
+        return unless has_shop?
+
+        ShopifyCLI::Theme::Extension::HostTheme.delete(@ctx)
+      rescue ShopifyCLI::API::APIRequestError, ShopifyCLI::Abort, ShopifyCLI::AbortSilent => e
+        @ctx.debug("[Logout Error]: #{e.message}")
       end
     end
   end

data/lib/shopify_cli/environment.rb

@@ -159,7 +159,7 @@ module ShopifyCLI
       env_variable_truthy?(
         Constants::EnvironmentVariables::MONORAIL_REAL_EVENTS,
         env_variables: env_variables
-      )
+      ) && !run_as_subprocess?(env_variables: env_variables)
     end
 
     def self.auth_token(env_variables: ENV)

data/lib/shopify_cli/file_system_listener.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+require "listen"
+require "observer"
+
+module ShopifyCLI
+  class FileSystemListener
+    include Observable
+
+    def initialize(root:, force_poll:, ignore_regex:)
+      @root = root
+      @force_poll = force_poll
+      @ignore_regex = ignore_regex
+
+      @listener = Listen.to(@root, force_polling: @force_poll, ignore: @ignore_regex) do |updated, added, removed|
+        changed
+        notify_observers(updated, added, removed)
+      end
+    end
+
+    def start
+      @listener.start
+    rescue ArgumentError
+      # Ignore errors during the transition of 'listen' events
+    end
+
+    def stop
+      @listener.stop
+    end
+  end
+end