markdown_exec 1.8.5 → 1.8.7

data/lib/markdown_exec/version.rb

@@ -7,5 +7,5 @@ module MarkdownExec
   BIN_NAME = 'mde'
   GEM_NAME = 'markdown_exec'
   TAP_DEBUG = 'MDE_DEBUG'
-  VERSION = '1.8.5'
+  VERSION = '1.8.7'
 end

data/lib/markdown_exec.rb

@@ -41,6 +41,8 @@ tap_config envvar: MarkdownExec::TAP_DEBUG
 $stderr.sync = true
 $stdout.sync = true
 
+ARGV_SEP = '--'
+
 # custom error: file specified is missing
 #
 class FileMissingError < StandardError; end
@@ -136,10 +138,11 @@ module MarkdownExec
       )
     end
 
-    # return arguments before `--`
+    # return arguments before ARGV_SEP
+    # arguments after ARGV_SEP are passed to the generatede script
     #
     def arguments_for_mde(argv = ARGV)
-      case ind = argv.find_index('--')
+      case ind = argv.find_index(ARGV_SEP)
       when nil
         argv
       when 0
@@ -205,14 +208,13 @@ module MarkdownExec
     # Reports and executes block logic
     def execute_block_logic(files)
       @options[:filename] = select_document_if_multiple(files)
-      @options.select_execute_bash_and_special_blocks
+      @options.document_menu_loop
     end
 
     ## Executes the block specified in the options
     #
     def execute_block_with_error_handling
       finalize_cli_argument_processing
-      @options[:input_cli_rest] = @rest
       execute_code_block_based_on_options(@options)
     rescue FileMissingError
       warn "File missing: #{$!}"
@@ -293,6 +295,7 @@ module MarkdownExec
       #
       block_name = rest.shift
       @options[:block_name] = block_name if block_name.present?
+      @options[:input_cli_rest] = @rest
     rescue FileMissingError
       warn_format('finalize_cli_argument_processing',
                   "File missing -- #{$!}", { abort: true })
@@ -346,10 +349,11 @@ module MarkdownExec
         ->(_) { exit }
       when 'find'
         ->(value) {
+          find_path = @options[:find_path].present? ? @options[:find_path] : @options[:path]
           @fout.fout 'Searching in: ' \
-                     "#{HashDelegator.new(@options).string_send_color(@options[:path],
+                     "#{HashDelegator.new(@options).string_send_color(find_path,
                                                                       :menu_chrome_color)}"
-          searcher = DirectorySearcher.new(value, [@options[:path]])
+          searcher = DirectorySearcher.new(value, [find_path])
 
           @fout.fout 'In file contents'
           hash = searcher.search_in_file_contents
@@ -546,7 +550,7 @@ module MarkdownExec
 
       saved_name_split filename
       @options[:save_executed_script] = false
-      @options.select_execute_bash_and_special_blocks
+      @options.document_menu_loop
     rescue StandardError
       error_handler('run_last_script')
     end
@@ -613,7 +617,7 @@ module MarkdownExec
 
       saved_name_split(filename)
 
-      @options.select_execute_bash_and_special_blocks ### ({ save_executed_script: false })
+      @options.document_menu_loop ### ({ save_executed_script: false })
     end
 
     public

data/lib/mdoc.rb

@@ -23,6 +23,7 @@ module MarkdownExec
     #
     def initialize(table = [])
       @table = table
+      # &bc '@table.count:',@table.count
     end
 
     def collect_block_code_cann(fcb)
@@ -69,20 +70,28 @@ module MarkdownExec
     # @param name [String] The name of the code block to start the retrieval from.
     # @return [Array<Hash>] An array of code blocks required by the specified code block.
     #
-    def collect_recursively_required_blocks(name)
+    def collect_block_dependencies(name)
       name_block = get_block_by_anyname(name)
       if name_block.nil? || name_block.keys.empty?
         raise "Named code block `#{name}` not found. (@#{__LINE__})"
       end
 
       dependencies = collect_dependencies(name_block[:oname])
+      # &bc 'dependencies.count:',dependencies.count
       all_dependency_names = collect_unique_names(dependencies).push(name_block[:oname]).uniq
-      unmet_dependencies = all_dependency_names.dup
+      # &bc 'all_dependency_names.count:',all_dependency_names.count
 
-      # in order of appearance in document (@table)
-      # insert function blocks
-      blocks = @table.select { |fcb| all_dependency_names.include? fcb[:oname] }
-                     .map do |fcb|
+      # select non-chrome blocks in order of appearance in source documents
+      #
+      blocks = @table.select do |fcb|
+        !fcb.fetch(:chrome, false) && all_dependency_names.include?(fcb.fetch(:oname))
+      end
+      # &bc 'blocks.count:',blocks.count
+
+      ## add cann key to blocks, calc unmet_dependencies
+      #
+      unmet_dependencies = all_dependency_names.dup
+      blocks = blocks.map do |fcb|
         unmet_dependencies.delete(fcb[:oname]) # may not exist if block name is duplicated
         if (call = fcb[:call])
           [get_block_by_oname("[#{call.match(/^%\((\S+) |\)/)[1]}]")
@@ -91,6 +100,7 @@ module MarkdownExec
           []
         end + [fcb]
       end.flatten(1)
+      # &bc 'unmet_dependencies.count:',unmet_dependencies.count
 
       { all_dependency_names: all_dependency_names,
         blocks: blocks,
@@ -103,11 +113,13 @@ module MarkdownExec
     # @param name [String] The name of the code block to start the collection from.
     # @return [Array<String>] An array of strings containing the collected code blocks.
     #
-    def collect_recursively_required_code(name, label_body: true, label_format_above: nil,
-                                          label_format_below: nil, block_source:)
-      block_search = collect_recursively_required_blocks(name)
+    def collect_recursively_required_code(name, block_source:, label_body: true, label_format_above: nil,
+                                          label_format_below: nil)
+      block_search = collect_block_dependencies(name)
       if block_search[:blocks]
         blocks = collect_wrapped_blocks(block_search[:blocks])
+        # &bc 'blocks.count:',blocks.count
+
         block_search.merge(
           { block_names: blocks.map { |block| block[:oname] },
             code: blocks.map do |fcb|
@@ -134,6 +146,8 @@ module MarkdownExec
       else
         block_search.merge({ block_names: [], code: [] })
       end
+    rescue StandardError
+      error_handler('collect_recursively_required_code')
     end
 
     def collect_unique_names(hash)
@@ -160,6 +174,13 @@ module MarkdownExec
       end.flatten(1).compact
     end
 
+    def error_handler(name = '', opts = {})
+      Exceptions.error_handler(
+        "MDoc.#{name} -- #{$!}",
+        opts
+      )
+    end
+
     # Retrieves code blocks based on the provided options.
     #
     # @param opts [Hash] The options used for filtering code blocks.
@@ -432,13 +453,13 @@ if $PROGRAM_NAME == __FILE__
       end
 
       ### broken test
-      def test_collect_recursively_required_blocks
-        result = @doc.collect_recursively_required_blocks('block3')[:blocks]
+      def test_collect_block_dependencies
+        result = @doc.collect_block_dependencies('block3')[:blocks]
         expected_result = [@table[0], @table[1], @table[2]]
         assert_equal expected_result, result
 
         assert_raises(RuntimeError) do
-          @doc.collect_recursively_required_blocks('missing_block')
+          @doc.collect_block_dependencies('missing_block')
         end
       end
 

data/lib/menu.src.yml

@@ -17,7 +17,7 @@
 
 - :arg_name: NAME
   :compreply: false
-  :description: Name of block
+  :description: Name of block to execute
   :env_var: MDE_BLOCK_NAME
   :long_name: block-name
   :opt_name: block_name
@@ -203,18 +203,20 @@
 ## match fenced code indented by spaces
 #
 - :default: "^(?<indent> *)`{3,}"
+  :description: Matches the start and end of a fenced code block
   :env_var: MDE_FENCED_START_AND_END_REGEX
   :opt_name: fenced_start_and_end_regex
   :procname: val_as_str
 
 - :default: "^(?<indent> *)`{3,}(?<shell>[^`\\s]*) *:?(?<name>[^\\s]*) *(?<rest>.*) *$"
+  :description: Match the start of a fenced block
   :env_var: MDE_FENCED_START_EXTENDED_REGEX
   :opt_name: fenced_start_extended_regex
   :procname: val_as_str
 
 - :arg_name: RELATIVE_PATH
   :compreply: "."
-  :description: Name of document
+  :description: Name of the document to load
   :env_var: MDE_FILENAME
   :long_name: filename
   :opt_name: filename
@@ -228,17 +230,25 @@
   :procname: find
   :short_name: "?"
 
-- :default: "^# *(?<name>[^#]*?) *$"
+- :arg_name: FIND_PATH
+  :default: ""
+  :description: Path for find (uses PATH if empty)
+  :env_var: MDE_FIND_PATH
+  :long_name: find-path
+  :opt_name: find_path
+  :procname: val_as_str
+
+- :default: "^# *(?<line>[^#]*?) *$"
   :env_var: MDE_HEADING1_MATCH
   :opt_name: heading1_match
   :procname: val_as_str
 
-- :default: "^## *(?<name>[^#]*?) *$"
+- :default: "^## *(?<line>[^#]*?) *$"
   :env_var: MDE_HEADING2_MATCH
   :opt_name: heading2_match
   :procname: val_as_str
 
-- :default: "^### *(?<name>.+?) *$"
+- :default: "^### *(?<line>.+?) *$"
   :env_var: MDE_HEADING3_MATCH
   :opt_name: heading3_match
   :procname: val_as_str
@@ -353,8 +363,8 @@
   :procname: val_as_bool
 
 - :arg_name: BOOL
-  :default: false
-  :description: Display headings (levels 1,2,3) in block selection menu
+  :default: true
+  :description: Controls whether headings(levels 1,2,3) are displayed in the block selection menu
   :env_var: MDE_MENU_BLOCKS_WITH_HEADINGS
   :opt_name: menu_blocks_with_headings
   :procname: val_as_bool
@@ -409,6 +419,42 @@
   :opt_name: menu_final_divider
   :procname: val_as_str
 
+- :default: fg_rgbh_80_80_c0
+  :description: Color for heading 1 in menu
+  :env_var: MDE_MENU_HEADING1_COLOR
+  :opt_name: menu_heading1_color
+  :procname: val_as_str
+
+- :default: "# %{line}"
+  :description: format for menu heading1 in menu
+  :env_var: MDE_MENU_HEADING1_FORMAT
+  :opt_name: menu_heading1_format
+  :procname: val_as_str
+
+- :default: fg_rgbh_60_60_c0
+  :description: Color for heading 2 in menu
+  :env_var: MDE_MENU_HEADING2_COLOR
+  :opt_name: menu_heading2_color
+  :procname: val_as_str
+
+- :default: "## %{line}"
+  :description: format for menu heading2 in menu
+  :env_var: MDE_MENU_HEADING2_FORMAT
+  :opt_name: menu_heading2_format
+  :procname: val_as_str
+
+- :default: fg_rgbh_40_40_c0
+  :description: Color for heading 3 in menu
+  :env_var: MDE_MENU_HEADING3_COLOR
+  :opt_name: menu_heading3_color
+  :procname: val_as_str
+
+- :default: "### %{line}"
+  :description: format for menu heading3 in menu
+  :env_var: MDE_MENU_HEADING3_FORMAT
+  :opt_name: menu_heading3_format
+  :procname: val_as_str
+
 - :default: "0"
   :description: Import levels for blocks to appear in menu. Empty is all.
   :env_var: MDE_MENU_IMPORT_LEVEL_MATCH
@@ -424,11 +470,31 @@
 
 - :arg_name: BOOL
   :default: false
-  :description: Include imported notes in menu
+  # :description: Include imported notes in menu
+  :description: Whether imported blocks should be included in the menu
   :env_var: MDE_MENU_INCLUDE_IMPORTED_NOTES
   :opt_name: menu_include_imported_notes
   :procname: val_as_bool
 
+- :arg_name: BOOL
+  :default: true
+  :description: Display inherited lines at top of menu (vs bottom)
+  :env_var: MDE_MENU_INHERITED_LINES_AT_TOP
+  :opt_name: menu_inherited_lines_at_top
+  :procname: val_as_bool
+
+- :default: fg_rgbh_94_00_D3
+  :description: Color of inherited lines in menu
+  :env_var: MDE_MENU_INHERITED_LINES_COLOR
+  :opt_name: menu_inherited_lines_color
+  :procname: val_as_str
+
+- :default: "%{line}"
+  :description: format for inherited lines in menu
+  :env_var: MDE_MENU_INHERITED_LINES_FORMAT
+  :opt_name: menu_inherited_lines_format
+  :procname: val_as_str
+
 - :default:
     :line: ""
   :description: opening demarcation for menu
@@ -500,6 +566,12 @@
   :opt_name: menu_opts_set_format
   :procname: val_as_str
 
+- :default: "."
+  :description: Block name to display menu
+  :env_var: MDE_MENU_PERSIST_BLOCK_NAME
+  :opt_name: menu_persist_block_name
+  :procname: val_as_str
+
 - :default: fg_rgbh_ff_ff_ff
   :description: Color of menu task
   :env_var: MDE_MENU_TASK_COLOR
@@ -556,6 +628,13 @@
   :opt_name: menu_with_exit
   :procname: val_as_bool
 
+- :arg_name: BOOL
+  :default: true
+  :description: Display inherited lines in menu
+  :env_var: MDE_MENU_WITH_INHERITED_LINES
+  :opt_name: menu_with_inherited_lines
+  :procname: val_as_bool
+
 - :arg_name: BOOL
   :default: false
   :description: Hide decorative menu entries
@@ -606,7 +685,7 @@
 
 - :arg_name: BOOL
   :default: true
-  :description: Display standard output from execution
+  :description: Whether standard output from execution is displayed
   :env_var: MDE_OUTPUT_STDOUT
   :long_name: output-stdout
   :opt_name: output_stdout
@@ -628,14 +707,14 @@
 
 - :arg_name: BOOL
   :default: true
-  :description: Pause afte executing a BASH block
-  :env_var: MDE_PAUSE_after_script_execution
+  :description: Wheter to pause after manually executing a block and the next menu
+  :env_var: MDE_PAUSE_AFTER_SCRIPT_EXECUTION
   :opt_name: pause_after_script_execution
   :procname: val_as_bool
 
 - :default: "\nContinue?"
-  :description: Prompt after script execution
-  :env_var: MDE_PROMPT_after_script_execution
+  :description: Prompt after manually executing a block and the next menu
+  :env_var: MDE_PROMPT_AFTER_SCRIPT_EXECUTION
   :opt_name: prompt_after_script_execution
   :procname: val_as_str
 
@@ -717,7 +796,7 @@
 
 - :arg_name: BOOL
   :default: false
-  :description: Save executed script
+  :description: Wheter to save an executed script`
   :env_var: MDE_SAVE_EXECUTED_SCRIPT
   :long_name: save-executed-script
   :opt_name: save_executed_script
@@ -759,7 +838,7 @@
 
 - :arg_name: RELATIVE_PATH
   :default: logs
-  :description: Saved script folder
+  :description: Folder where saved scripts are stored
   :env_var: MDE_SAVED_SCRIPT_FOLDER
   :long_name: saved-script-folder
   :opt_name: saved_script_folder
@@ -884,7 +963,7 @@
 
 - :arg_name: BOOL
   :default: true
-  :description: Pause for user to approve script
+  :description: Requires user approval before executing a script
   :env_var: MDE_USER_MUST_APPROVE
   :long_name: user-must-approve
   :opt_name: user_must_approve

data/lib/menu.yml

@@ -1,4 +1,4 @@
-# MDE - Markdown Executor (1.8.5)
+# MDE - Markdown Executor (1.8.7)
 ---
 - :description: Show current configuration values
   :procname: show_config
@@ -15,7 +15,7 @@
   :procname: val_as_str
 - :arg_name: NAME
   :compreply: false
-  :description: Name of block
+  :description: Name of block to execute
   :env_var: MDE_BLOCK_NAME
   :long_name: block-name
   :opt_name: block_name
@@ -174,17 +174,19 @@
   :procname: exit
   :short_name: x
 - :default: "^(?<indent> *)`{3,}"
+  :description: Matches the start and end of a fenced code block
   :env_var: MDE_FENCED_START_AND_END_REGEX
   :opt_name: fenced_start_and_end_regex
   :procname: val_as_str
 - :default: "^(?<indent> *)`{3,}(?<shell>[^`\\s]*) *:?(?<name>[^\\s]*) *(?<rest>.*)
     *$"
+  :description: Match the start of a fenced block
   :env_var: MDE_FENCED_START_EXTENDED_REGEX
   :opt_name: fenced_start_extended_regex
   :procname: val_as_str
 - :arg_name: RELATIVE_PATH
   :compreply: "."
-  :description: Name of document
+  :description: Name of the document to load
   :env_var: MDE_FILENAME
   :long_name: filename
   :opt_name: filename
@@ -196,15 +198,22 @@
   :long_name: find
   :procname: find
   :short_name: "?"
-- :default: "^# *(?<name>[^#]*?) *$"
+- :arg_name: FIND_PATH
+  :default: ''
+  :description: Path for find (uses PATH if empty)
+  :env_var: MDE_FIND_PATH
+  :long_name: find-path
+  :opt_name: find_path
+  :procname: val_as_str
+- :default: "^# *(?<line>[^#]*?) *$"
   :env_var: MDE_HEADING1_MATCH
   :opt_name: heading1_match
   :procname: val_as_str
-- :default: "^## *(?<name>[^#]*?) *$"
+- :default: "^## *(?<line>[^#]*?) *$"
   :env_var: MDE_HEADING2_MATCH
   :opt_name: heading2_match
   :procname: val_as_str
-- :default: "^### *(?<name>.+?) *$"
+- :default: "^### *(?<line>.+?) *$"
   :env_var: MDE_HEADING3_MATCH
   :opt_name: heading3_match
   :procname: val_as_str
@@ -299,8 +308,9 @@
   :opt_name: menu_blocks_with_docname
   :procname: val_as_bool
 - :arg_name: BOOL
-  :default: false
-  :description: Display headings (levels 1,2,3) in block selection menu
+  :default: true
+  :description: Controls whether headings(levels 1,2,3) are displayed in the block
+    selection menu
   :env_var: MDE_MENU_BLOCKS_WITH_HEADINGS
   :opt_name: menu_blocks_with_headings
   :procname: val_as_bool
@@ -346,6 +356,36 @@
   :env_var: MDE_MENU_FINAL_DIVIDER
   :opt_name: menu_final_divider
   :procname: val_as_str
+- :default: fg_rgbh_80_80_c0
+  :description: Color for heading 1 in menu
+  :env_var: MDE_MENU_HEADING1_COLOR
+  :opt_name: menu_heading1_color
+  :procname: val_as_str
+- :default: "# %{line}"
+  :description: format for menu heading1 in menu
+  :env_var: MDE_MENU_HEADING1_FORMAT
+  :opt_name: menu_heading1_format
+  :procname: val_as_str
+- :default: fg_rgbh_60_60_c0
+  :description: Color for heading 2 in menu
+  :env_var: MDE_MENU_HEADING2_COLOR
+  :opt_name: menu_heading2_color
+  :procname: val_as_str
+- :default: "## %{line}"
+  :description: format for menu heading2 in menu
+  :env_var: MDE_MENU_HEADING2_FORMAT
+  :opt_name: menu_heading2_format
+  :procname: val_as_str
+- :default: fg_rgbh_40_40_c0
+  :description: Color for heading 3 in menu
+  :env_var: MDE_MENU_HEADING3_COLOR
+  :opt_name: menu_heading3_color
+  :procname: val_as_str
+- :default: "### %{line}"
+  :description: format for menu heading3 in menu
+  :env_var: MDE_MENU_HEADING3_FORMAT
+  :opt_name: menu_heading3_format
+  :procname: val_as_str
 - :default: '0'
   :description: Import levels for blocks to appear in menu. Empty is all.
   :env_var: MDE_MENU_IMPORT_LEVEL_MATCH
@@ -359,10 +399,26 @@
   :procname: val_as_bool
 - :arg_name: BOOL
   :default: false
-  :description: Include imported notes in menu
+  :description: Whether imported blocks should be included in the menu
   :env_var: MDE_MENU_INCLUDE_IMPORTED_NOTES
   :opt_name: menu_include_imported_notes
   :procname: val_as_bool
+- :arg_name: BOOL
+  :default: true
+  :description: Display inherited lines at top of menu (vs bottom)
+  :env_var: MDE_MENU_INHERITED_LINES_AT_TOP
+  :opt_name: menu_inherited_lines_at_top
+  :procname: val_as_bool
+- :default: fg_rgbh_94_00_D3
+  :description: Color of inherited lines in menu
+  :env_var: MDE_MENU_INHERITED_LINES_COLOR
+  :opt_name: menu_inherited_lines_color
+  :procname: val_as_str
+- :default: "%{line}"
+  :description: format for inherited lines in menu
+  :env_var: MDE_MENU_INHERITED_LINES_FORMAT
+  :opt_name: menu_inherited_lines_format
+  :procname: val_as_str
 - :default:
     :line: ''
   :description: opening demarcation for menu
@@ -421,6 +477,11 @@
   :env_var: MDE_MENU_OPTS_SET_FORMAT
   :opt_name: menu_opts_set_format
   :procname: val_as_str
+- :default: "."
+  :description: Block name to display menu
+  :env_var: MDE_MENU_PERSIST_BLOCK_NAME
+  :opt_name: menu_persist_block_name
+  :procname: val_as_str
 - :default: fg_rgbh_ff_ff_ff
   :description: Color of menu task
   :env_var: MDE_MENU_TASK_COLOR
@@ -468,6 +529,12 @@
   :env_var: MDE_MENU_WITH_EXIT
   :opt_name: menu_with_exit
   :procname: val_as_bool
+- :arg_name: BOOL
+  :default: true
+  :description: Display inherited lines in menu
+  :env_var: MDE_MENU_WITH_INHERITED_LINES
+  :opt_name: menu_with_inherited_lines
+  :procname: val_as_bool
 - :arg_name: BOOL
   :default: false
   :description: Hide decorative menu entries
@@ -511,7 +578,7 @@
   :procname: val_as_bool
 - :arg_name: BOOL
   :default: true
-  :description: Display standard output from execution
+  :description: Whether standard output from execution is displayed
   :env_var: MDE_OUTPUT_STDOUT
   :long_name: output-stdout
   :opt_name: output_stdout
@@ -530,15 +597,15 @@
   :short_name: p
 - :arg_name: BOOL
   :default: true
-  :description: Pause afte executing a BASH block
-  :env_var: MDE_PAUSE_after_script_execution
+  :description: Wheter to pause after manually executing a block and the next menu
+  :env_var: MDE_PAUSE_AFTER_SCRIPT_EXECUTION
   :opt_name: pause_after_script_execution
   :procname: val_as_bool
 - :default: |2-
 
     Continue?
-  :description: Prompt after script execution
-  :env_var: MDE_PROMPT_after_script_execution
+  :description: Prompt after manually executing a block and the next menu
+  :env_var: MDE_PROMPT_AFTER_SCRIPT_EXECUTION
   :opt_name: prompt_after_script_execution
   :procname: val_as_str
 - :default: |2-
@@ -615,7 +682,7 @@
   :procname: val_as_int
 - :arg_name: BOOL
   :default: false
-  :description: Save executed script
+  :description: Wheter to save an executed script`
   :env_var: MDE_SAVE_EXECUTED_SCRIPT
   :long_name: save-executed-script
   :opt_name: save_executed_script
@@ -651,7 +718,7 @@
   :procname: val_as_str
 - :arg_name: RELATIVE_PATH
   :default: logs
-  :description: Saved script folder
+  :description: Folder where saved scripts are stored
   :env_var: MDE_SAVED_SCRIPT_FOLDER
   :long_name: saved-script-folder
   :opt_name: saved_script_folder
@@ -760,7 +827,7 @@
   :procname: val_as_bool
 - :arg_name: BOOL
   :default: true
-  :description: Pause for user to approve script
+  :description: Requires user approval before executing a script
   :env_var: MDE_USER_MUST_APPROVE
   :long_name: user-must-approve
   :opt_name: user_must_approve

data/lib/regexp_replacer.rb

@@ -0,0 +1,58 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# encoding=utf-8
+
+require 'find'
+
+class RegexpReplacer
+  # Constructor to initialize with file path
+  def initialize(file_path)
+    @file_path = file_path
+  end
+
+  # Perform the replacement based on the specified option
+  def perform_replacement(option)
+    content = File.read(@file_path)
+    modified_content = case option
+                       when 'v'
+                         verbose(content)
+                       when 'q'
+                         quiet(content)
+                       else
+                         raise "Invalid option. Please choose 'v' or 'q'."
+                       end
+    File.write(@file_path, modified_content)
+  end
+
+  private
+
+  # Replacement for pattern 'v'
+  def verbose(content)
+    regexp = /^( *)# (&\w+) ('.+)/
+    substitution = '\1;;pp [__LINE__,\3] #\2'
+    content.gsub(regexp, substitution)
+  end
+
+  # Replacement for pattern 'q'
+  def quiet(content)
+    regexp = /^( *);; ?pp \[__LINE__,(.+)\] #(&\w+)/
+    substitution = '\1# \3 \2'
+    content.gsub(regexp, substitution)
+  end
+end
+
+# Running the script with command line arguments
+if ARGV.length != 2
+  puts "Usage: ruby regexp_replacer.rb [file_path] [option ('v' or 'q')]"
+  exit
+end
+
+file_path, option = ARGV
+replacer = RegexpReplacer.new(file_path)
+begin
+  replacer.perform_replacement(option)
+  puts "Replacement performed successfully."
+rescue StandardError => e
+  puts "Error: #{e.message}"
+end