freyia 0.5.3 → 0.6.0

data/lib/freyia/automations/file_manipulation.rb

@@ -7,24 +7,19 @@ module Freyia
     # Copies the file from the relative source to the relative destination. If
     # the destination is not given it's assumed to be equal to the source.
     #
-    # ==== Parameters
-    # source<String>:: the relative path to the source root.
-    # destination<String>:: the relative path to the destination root.
-    # config<Hash>:: give :verbose => false to not log the status, and
-    #                :mode => :preserve, to preserve the file mode from the source.
-    #
-    # ==== Examples
+    # @param source [String] the relative path to the source root.
+    # @param destination [String] the relative path to the destination root.
+    # @param config [Hash] give `verbose: false` to not log the status, and
+    #   `mode: :preserve`, to preserve the file mode from the source.
     #
+    # @example Copy a file to a new destination
     #   copy_file "README", "doc/README"
-    #
+    # @example Copy a file straight from source to destination
     #   copy_file "doc/README"
-    #
-    def copy_file(source, *args, &block)
-      config = args.last.is_a?(Hash) ? args.pop : {}
-      destination = args.first || source
+    def copy_file(source, destination = source, **config, &block)
       source = File.expand_path(find_in_source_paths(source.to_s))
 
-      resulting_destination = create_file destination, nil, config do
+      resulting_destination = create_file destination, nil, **config do
         content = File.binread(source)
         content = yield(content) if block
         content
@@ -32,58 +27,46 @@ module Freyia
       return unless config[:mode] == :preserve
 
       mode = File.stat(source).mode
-      chmod(resulting_destination, mode, config)
+      chmod(resulting_destination, mode, **config)
     end
 
     # Links the file from the relative source to the relative destination. If
     # the destination is not given it's assumed to be equal to the source.
     #
-    # ==== Parameters
-    # source<String>:: the relative path to the source root.
-    # destination<String>:: the relative path to the destination root.
-    # config<Hash>:: give :verbose => false to not log the status.
-    #
-    # ==== Examples
+    # @param source [String] the relative path to the source root.
+    # @param destination [String] the relative path to the destination root.
+    # @param config [Hash] give :verbose => false to not log the status.
     #
+    # @example Link a file to a new destination
     #   link_file "README", "doc/README"
-    #
+    # @example Link a file straight from source to destination
     #   link_file "doc/README"
-    #
-    def link_file(source, *args)
-      config = args.last.is_a?(Hash) ? args.pop : {}
-      destination = args.first || source
+    def link_file(source, destination = source, **config)
       source = File.expand_path(find_in_source_paths(source.to_s))
 
-      create_link destination, source, config
+      create_link destination, source, **config
     end
 
     # Gets the content at the given address and places it at the given relative
     # destination. If a block is given instead of destination, the content of
     # the url is yielded and used as location.
     #
-    # +get+ relies on open-uri, so passing application user input would provide
+    # `get` relies on open-uri, so passing application user input would provide
     # a command injection attack vector.
     #
-    # ==== Parameters
-    # source<String>:: the address of the given content.
-    # destination<String>:: the relative path to the destination root.
-    # config<Hash>:: give :verbose => false to not log the status, and
-    #                :http_headers => <Hash> to add headers to an http request.
-    #
-    # ==== Examples
-    #
+    # @param source [String] the address of the given content.
+    # @param destination [String] the relative path to the destination root.
+    # @param config [Hash] give `verbose: false` to not log the status, and
+    #   `http_headers: <Hash>` to add headers to an http request.
+    # @example Create files from remote URLs
     #   get "http://gist.github.com/103208", "doc/README"
     #
     #   get "http://gist.github.com/103208", "doc/README", :http_headers => {"Content-Type" => "application/json"}
-    #
+    # @example Use a block to modify the remote content
     #   get "http://gist.github.com/103208" do |content|
     #     content.split("\n").first
     #   end
-    #
-    def get(source, *args, &block) # rubocop:todo Metrics
-      config = args.last.is_a?(Hash) ? args.pop : {}
-      destination = args.first
-
+    def get(source, destination = nil, **config, &block)
       render = if %r{^https?://}.match?(source)
                  require "open-uri"
                  URI.send(:open, source, config.fetch(:http_headers, {})) do |input|
@@ -100,54 +83,67 @@ module Freyia
                         File.basename(source)
                       end
 
-      create_file destination, render, config
+      create_file destination, render, **config
     end
 
     # Gets an ERB template at the relative source, executes it and makes a copy
     # at the relative destination. If the destination is not given it's assumed
-    # to be equal to the source removing .tt from the filename.
-    #
-    # ==== Parameters
-    # source<String>:: the relative path to the source root.
-    # destination<String>:: the relative path to the destination root.
-    # config<Hash>:: give :verbose => false to not log the status.
+    # to be equal to the source removing `.tmpl` from the filename.
     #
-    # ==== Examples
+    # @param source [String] the relative path to the source root.
+    # @param destination [String] the relative path to the destination root.
+    # @param context [Binding] if you want access to local variables from the caller
+    # @param type [Symbol] to use a template type that differs from the default,
+    #   specify here (`:erb` or `:serbea`)
+    # @param config [Hash] give `verbose: false` to not log the status.
     #
+    # @example Process `README.tmpl` and save to a new destination
     #   template "README", "doc/README"
-    #
+    # @example Process from source and save to destination
     #   template "doc/README"
-    #
-    def template(source, *args, &block)
-      config = args.last.is_a?(Hash) ? args.pop : {}
-      destination = args.first || source.sub(%r{#{TEMPLATE_EXTNAME}$}o, "")
-
-      source  = File.expand_path(find_in_source_paths(source.to_s))
-      context = config.delete(:context) || instance_eval("binding", __FILE__, __LINE__)
-
-      create_file destination, nil, config do
-        capturable_erb = CapturableERB.new(::File.binread(source), trim_mode: "-",
-                                                                   eoutvar: "@output_buffer")
-        content = capturable_erb.tap do |erb|
-          erb.filename = source
-        end.result(context)
-        content = yield(content) if block
-        content
+    def template(source, destination = nil, context: nil, type: nil, **config, &block) # rubocop:todo Metrics
+      destination ||= source.sub(%r{#{TEMPLATE_EXTNAME}$}o, "")
+      source = File.expand_path(find_in_source_paths(source.to_s))
+      type ||= self.class.template_type
+
+      create_file destination, nil, **config do
+        if type == :serbea
+          unless @_included_serbea
+            require "serbea"
+            singleton_class.include Serbea::Helpers
+            @_included_serbea = true
+          end
+
+          variables = if context
+                        context.local_variables.to_h { [_1, context.local_variable_get(_1)] }
+                      else
+                        {}
+                      end
+          tmpl = Tilt::SerbeaTemplate.new(source, strip_front_matter: false) { ::File.binread(source) }
+          tmpl.render(self, variables)
+        elsif type == :erb
+          context ||= instance_eval("binding", __FILE__, __LINE__)
+          capturable_erb = CapturableERB.new(
+            ::File.binread(source), trim_mode: "-", eoutvar: "@output_buffer"
+          )
+          content = capturable_erb.tap do |erb|
+            erb.filename = source
+          end.result(context)
+          content = yield(content) if block
+          content
+        end
       end
     end
 
     # Changes the mode of the given file or directory.
     #
-    # ==== Parameters
-    # mode<Integer>:: the file mode
-    # path<String>:: the name of the file to change mode
-    # config<Hash>:: give :verbose => false to not log the status.
-    #
-    # ==== Example
+    # @param mode [Integer] the file mode
+    # @param path [String] the name of the file to change mode
+    # @param config [Hash] give `verbose: false` to not log the status.
     #
+    # @example Update mode of the destination file `script/server`
     #   chmod "script/server", 0755
-    #
-    def chmod(path, mode, config = {})
+    def chmod(path, mode, **config)
       path = File.expand_path(path, destination_root)
       say_status :chmod, relative_to_original_destination_root(path), config.fetch(:verbose, true)
       return if options[:pretend]
@@ -156,151 +152,117 @@ module Freyia
       FileUtils.chmod_R(mode, path)
     end
 
-    # Prepend text to a file. Since it depends on insert_into_file, it's reversible.
+    # Prepend text to a file.
     #
-    # ==== Parameters
-    # path<String>:: path of the file to be changed
-    # data<String>:: the data to prepend to the file, can be also given as a block.
-    # config<Hash>:: give :verbose => false to not log the status.
-    #
-    # ==== Example
+    # @param path [String] path of the file to be changed
+    # @param data [String] the data to prepend to the file, can be also given as a block.
+    # @param config [Hash] give `verbose: false` to not log the status.
     #
+    # @example Prepend destination file with a string
     #   prepend_to_file 'config/environments/test.rb', 'config.gem "rspec"'
-    #
+    # @example Prepend destination file with results of block
     #   prepend_to_file 'config/environments/test.rb' do
     #     'config.gem "rspec"'
     #   end
-    #
-    def prepend_to_file(path, *args, &)
-      config = args.last.is_a?(Hash) ? args.pop : {}
+    def prepend_to_file(path, *, **config, &)
       config[:after] = %r{\A}
-      insert_into_file(path, *(args << config), &)
+      insert_into_file(path, *, **config, &)
     end
     alias_method :prepend_file, :prepend_to_file
 
-    # Append text to a file. Since it depends on insert_into_file, it's reversible.
+    # Append text to a file.
     #
-    # ==== Parameters
-    # path<String>:: path of the file to be changed
-    # data<String>:: the data to append to the file, can be also given as a block.
-    # config<Hash>:: give :verbose => false to not log the status.
-    #
-    # ==== Example
+    # @param path [String] path of the file to be changed
+    # @param data [String] the data to append to the file, can be also given as a block.
+    # @param config [Hash] give `verbose: false` to not log the status.
     #
+    # @example Prepend destination file with a string
     #   append_to_file 'config/environments/test.rb', 'config.gem "rspec"'
-    #
+    # @example Prepend destination file with results of block
     #   append_to_file 'config/environments/test.rb' do
     #     'config.gem "rspec"'
     #   end
-    #
-    def append_to_file(path, *args, &)
-      config = args.last.is_a?(Hash) ? args.pop : {}
+    def append_to_file(path, *, **config, &)
       config[:before] = %r{\z}
-      insert_into_file(path, *(args << config), &)
+      insert_into_file(path, *, **config, &)
     end
     alias_method :append_file, :append_to_file
 
-    # Injects text right after the class definition. Since it depends on
-    # insert_into_file, it's reversible.
+    # Injects text right after the class definition.
     #
-    # ==== Parameters
-    # path<String>:: path of the file to be changed
-    # klass<String|Class>:: the class to be manipulated
-    # data<String>:: the data to append to the class, can be also given as a block.
-    # config<Hash>:: give :verbose => false to not log the status.
-    #
-    # ==== Examples
+    # @param path [String] path of the file to be changed
+    # @param klass [String|Class] the class to be manipulated
+    # @param data [String] the data to append to the class, can be also given as a block.
+    # @param config [Hash] give `verbose: false` to not log the status.
     #
+    # @example Inject class using provided string
     #   inject_into_class "app/controllers/application_controller.rb",
     #                     "ApplicationController",
     #                     "  filter_parameter :password\n"
     #
+    # @example Inject class using result from block
     #   inject_into_class "app/controllers/application_controller.rb", "ApplicationController" do
     #     "  filter_parameter :password\n"
     #   end
-    #
-    def inject_into_class(path, klass, *args, &)
-      config = args.last.is_a?(Hash) ? args.pop : {}
+    def inject_into_class(path, klass, *, **config, &)
       config[:after] = %r{class #{klass}\n|class #{klass} .*\n}
-      insert_into_file(path, *(args << config), &)
+      insert_into_file(path, *, **config, &)
     end
 
-    # Injects text right after the module definition. Since it depends on
-    # insert_into_file, it's reversible.
-    #
-    # ==== Parameters
-    # path<String>:: path of the file to be changed
-    # module_name<String|Class>:: the module to be manipulated
-    # data<String>:: the data to append to the class, can be also given as a block.
-    # config<Hash>:: give :verbose => false to not log the status.
+    # Injects text right after the module definition.
     #
-    # ==== Examples
+    # @param path [String] path of the file to be changed
+    # @param module_name [String|Class] the module to be manipulated
+    # @param data [String] the data to append to the class, can be also given as a block.
+    # @param config [Hash] give :verbose => false to not log the status.
     #
+    # @example Inject module using provided string
     #   inject_into_module "app/helpers/application_helper.rb",
     #                      "ApplicationHelper",
     #                      "  def help; 'help'; end\n"
     #
+    # @example Inject module using result from block
     #   inject_into_module "app/helpers/application_helper.rb", "ApplicationHelper" do
     #     "  def help; 'help'; end\n"
     #   end
-    #
-    def inject_into_module(path, module_name, *args, &)
-      config = args.last.is_a?(Hash) ? args.pop : {}
+    def inject_into_module(path, module_name, *, **config, &)
       config[:after] = %r{module #{module_name}\n|module #{module_name} .*\n}
-      insert_into_file(path, *(args << config), &)
+      insert_into_file(path, *, **config, &)
     end
 
     # Run a regular expression replacement on a file, raising an error if the
     # contents of the file are not changed.
     #
-    # ==== Parameters
-    # path<String>:: path of the file to be changed
-    # flag<Regexp|String>:: the regexp or string to be replaced
-    # replacement<String>:: the replacement, can be also given as a block
-    # config<Hash>:: give :verbose => false to not log the status, and
-    #                :force => true, to force the replacement regardless of runner behavior.
-    #
-    # ==== Example
+    # @param path [String] path of the file to be changed
+    # @param flag [Regexp|String] the regexp or string to be replaced
+    # @param replacement [String] the replacement, can be also given as a block
+    # @param config [Hash] give `verbose: false` to not log the status, and
+    #                           `force: true`, to force the replacement regardless of behavior.
     #
+    # @example Modify destination file
     #   gsub_file! 'app/controllers/application_controller.rb',
     #              /#\s*(filter_parameter_logging :password)/, '\1'
-    #
-    #   gsub_file! 'README', /rake/, :green do |match|
-    #     match << " no more. Use freyia!"
-    #   end
-    #
-    def gsub_file!(path, flag, *args, &)
-      config = args.last.is_a?(Hash) ? args.pop : {}
-
+    def gsub_file!(path, flag, *args, verbose: true, &)
       path = File.expand_path(path, destination_root)
-      say_status :gsub, relative_to_original_destination_root(path), config.fetch(:verbose, true)
+      say_status :gsub, relative_to_original_destination_root(path), verbose
 
       actually_gsub_file(path, flag, args, true, &) unless options[:pretend]
     end
 
     # Run a regular expression replacement on a file.
     #
-    # ==== Parameters
-    # path<String>:: path of the file to be changed
-    # flag<Regexp|String>:: the regexp or string to be replaced
-    # replacement<String>:: the replacement, can be also given as a block
-    # config<Hash>:: give :verbose => false to not log the status, and
-    #                :force => true, to force the replacement regardless of runner behavior.
-    #
-    # ==== Example
+    # @param path [String] path of the file to be changed
+    # @param flag [Regexp|String] the regexp or string to be replaced
+    # @param replacement [String] the replacement, can be also given as a block
+    # @param config [Hash] give `verbose: false` to not log the status, and
+    #                           `force: true`, to force the replacement regardless of behavior.
     #
+    # @example Modify destination file
     #   gsub_file 'app/controllers/application_controller.rb',
     #             /#\s*(filter_parameter_logging :password)/, '\1'
-    #
-    #   gsub_file 'README', /rake/, :green do |match|
-    #     match << " no more. Use freyia!"
-    #   end
-    #
-    def gsub_file(path, flag, *args, &)
-      config = args.last.is_a?(Hash) ? args.pop : {}
-
+    def gsub_file(path, flag, *args, verbose: true, &)
       path = File.expand_path(path, destination_root)
-      say_status :gsub, relative_to_original_destination_root(path), config.fetch(:verbose, true)
+      say_status :gsub, relative_to_original_destination_root(path), verbose
 
       actually_gsub_file(path, flag, args, false, &) unless options[:pretend]
     end
@@ -308,57 +270,46 @@ module Freyia
     # Uncomment all lines matching a given regex. Preserves indentation before
     # the comment hash and removes the hash and any immediate following space.
     #
-    # ==== Parameters
-    # path<String>:: path of the file to be changed
-    # flag<Regexp|String>:: the regexp or string used to decide which lines to uncomment
-    # config<Hash>:: give :verbose => false to not log the status.
-    #
-    # ==== Example
+    # @param path [String] path of the file to be changed
+    # @param flag [Regexp|String] the regexp or string used to decide which lines to uncomment
     #
+    # @example Uncomment the lines which match the pattern
     #   uncomment_lines 'config/initializers/session_store.rb', /active_record/
-    #
-    def uncomment_lines(path, flag, *)
+    def uncomment_lines(path, flag)
       flag = flag.source if flag.respond_to?(:source)
 
-      gsub_file(path, %r{^(\s*)#[[:blank:]]?(.*#{flag})}, '\1\2', *)
+      gsub_file(path, %r{^(\s*)#[[:blank:]]?(.*#{flag})}, '\1\2')
     end
 
     # Comment all lines matching a given regex.  It will leave the space
     # which existed before the beginning of the line in tact and will insert
     # a single space after the comment hash.
     #
-    # ==== Parameters
-    # path<String>:: path of the file to be changed
-    # flag<Regexp|String>:: the regexp or string used to decide which lines to comment
-    # config<Hash>:: give :verbose => false to not log the status.
-    #
-    # ==== Example
+    # @param path [String] path of the file to be changed
+    # @param flag [Regexp|String] the regexp or string used to decide which lines to comment
     #
+    # @example Comment lines which match the pattern
     #   comment_lines 'config/initializers/session_store.rb', /cookie_store/
-    #
-    def comment_lines(path, flag, *)
+    def comment_lines(path, flag)
       flag = flag.source if flag.respond_to?(:source)
 
-      gsub_file(path, %r{^(\s*)([^#\n]*#{flag})}, '\1# \2', *)
+      gsub_file(path, %r{^(\s*)([^#\n]*#{flag})}, '\1# \2')
     end
 
     # Removes a file at the given location.
     #
-    # ==== Parameters
-    # path<String>:: path of the file to be changed
-    # config<Hash>:: give :verbose => false to not log the status.
-    #
-    # ==== Example
+    # @param path [String] path of the file to be changed
+    # @param config [Hash] give `verbose: false` to not log the status.
     #
+    # @example Removing files
     #   remove_file 'README'
     #   remove_file 'app/controllers/application_controller.rb'
-    #
-    def remove_file(path, config = {})
+    def remove_file(path, verbose: true)
       return unless behavior == :invoke
 
       path = File.expand_path(path, destination_root)
 
-      say_status :remove, relative_to_original_destination_root(path), config.fetch(:verbose, true)
+      say_status :remove, relative_to_original_destination_root(path), verbose
       return unless !options[:pretend] && (File.exist?(path) || File.symlink?(path))
 
       require "fileutils"
@@ -379,7 +330,7 @@ module Freyia
       with_output_buffer { yield(*args) }
     end
 
-    def with_output_buffer(buf = +"") #:nodoc:
+    def with_output_buffer(buf = +"")
       raise ArgumentError, "Buffer cannot be a frozen object" if buf.frozen?
 
       old_buffer = output_buffer

data/lib/freyia/automations/inject_into_file.rb

@@ -10,71 +10,63 @@ module Freyia
     }.freeze
 
     # Injects the given content into a file, raising an error if the contents of
-    # the file are not changed. Different from gsub_file, this method is reversible.
+    # the file are not changed.
     #
-    # ==== Parameters
-    # destination<String>:: Relative path to the destination root
-    # data<String>:: Data to add to the file. Can be given as a block.
-    # config<Hash>:: give :verbose => false to not log the status and the flag
-    #                for injection (:after or :before) or :force => true for
-    #                insert two or more times the same content.
+    # @param destination [String] Relative path to the destination root
+    # @param data [String] Data to add to the file. Can be given as a block.
+    # @param config [Hash] give `verbose: false` to not log the status and the flag
+    #   for injection (`after:` or `before:`) or `force: true` for
+    #   inserting the same content multiple times.
     #
-    # ==== Examples
+    # @example Inserting text after a match
+    #   insert_into_file! "config/environment.rb", "config.gem :freyia",
+    #                     after: "Rails::Initializer.run do |config|\n"
     #
-    #   insert_into_file "config/environment.rb", "config.gem :freyia",
-    #                    after: "Rails::Initializer.run do |config|\n"
-    #
-    #   insert_into_file "config/environment.rb", after: "Rails::Initializer.run do |config|\n" do
+    # @example Inserting text based on input within a block
+    #   insert_into_file! "config/environment.rb", after: "Rails::Initializer.run do |config|\n" do
     #     gems = ask "Which gems would you like to add?"
     #     gems.split(" ").map{ |gem| "  config.gem :#{gem}" }.join("\n")
     #   end
-    #
-    def insert_into_file!(destination, *args, &block)
+    def insert_into_file!(destination, *args, **config, &block)
       data = block_given? ? block : args.shift
 
-      config = args.shift || {}
       config[:after] = %r{\z} unless config.key?(:before) || config.key?(:after)
-      config = config.merge({ error_on_no_change: true })
 
-      InjectIntoFile.new(self, destination, data, config).()
+      InjectIntoFile.new(self, destination, data, error_on_no_change: true, **config).()
     end
     alias_method :inject_into_file!, :insert_into_file!
 
-    # Injects the given content into a file. Different from gsub_file, this
-    # method is reversible.
-    #
-    # ==== Parameters
-    # destination<String>:: Relative path to the destination root
-    # data<String>:: Data to add to the file. Can be given as a block.
-    # config<Hash>:: give :verbose => false to not log the status and the flag
-    #                for injection (:after or :before) or :force => true for
-    #                insert two or more times the same content.
+    # Injects the given content into a file.
     #
-    # ==== Examples
+    # @param destination [String] Relative path to the destination root
+    # @param data [String] Data to add to the file. Can be given as a block.
+    # @param config [Hash] give `verbose: false` to not log the status and the flag
+    #   for injection (`after:` or `before:`) or `force: true` for
+    #   inserting the same content multiple times.
     #
+    # @example Inserting text after a match
     #   insert_into_file "config/environment.rb", "config.gem :freyia",
     #                    after: "Rails::Initializer.run do |config|\n"
     #
+    # @example Inserting text based on input within a block
     #   insert_into_file "config/environment.rb", after: "Rails::Initializer.run do |config|\n" do
     #     gems = ask "Which gems would you like to add?"
     #     gems.split(" ").map{ |gem| "  config.gem :#{gem}" }.join("\n")
     #   end
-    #
-    def insert_into_file(destination, *args, &block)
+    def insert_into_file(destination, *args, **config, &block)
       data = block_given? ? block : args.shift
 
-      config = args.shift || {}
       config[:after] = %r{\z} unless config.key?(:before) || config.key?(:after)
 
-      InjectIntoFile.new(self, destination, data, config).()
+      InjectIntoFile.new(self, destination, data, **config).()
     end
     alias_method :inject_into_file, :insert_into_file
 
-    class InjectIntoFile < EmptyDirectory #:nodoc:
+    class InjectIntoFile < EmptyDirectory
       attr_reader :replacement, :flag, :behavior
 
-      def initialize(base, destination, data, config)
-        super(base, destination, { verbose: true }.merge(config))
+      def initialize(base, destination, data, **config)
+        super(base, destination, verbose: true, **config)
 
         @behavior, @flag = if @config.key?(:after)
                              [:after, @config.delete(:after)]
@@ -109,20 +101,6 @@ module Freyia
         end
       end
 
-      def revoke!
-        say_status :revoke
-
-        regexp = if @behavior == :after
-                   content = '\1\2'
-                   %r{(#{flag})(.*)(#{Regexp.escape(replacement)})}m
-                 else
-                   content = '\2\3'
-                   %r{(#{Regexp.escape(replacement)})(.*)(#{flag})}m
-                 end
-
-        replace!(regexp, content, true)
-      end
-
       protected
 
       def say_status(behavior, warning: nil, color: nil) # rubocop:todo Metrics
@@ -154,7 +132,6 @@ module Freyia
       end
 
       # Adds the content to the file.
-      #
       def replace!(regexp, string, force)
         return unless force || !replacement_present?
 

data/lib/freyia/automations.rb

@@ -85,8 +85,7 @@ module Freyia
     # dir<String>:: the directory to move to.
     # config<Hash>:: give :verbose => true to log and use padding.
     #
-    def inside(dir = "", config = {}, &block) # rubocop:todo Metrics
-      verbose = config.fetch(:verbose, false)
+    def inside(dir = "", verbose: false, &block) # rubocop:todo Metrics
       pretend = options[:pretend]
 
       say_status :inside, dir, verbose
@@ -133,8 +132,7 @@ module Freyia
     #
     #   apply "recipes/jquery.rb"
     #
-    def apply(path, config = {})
-      verbose = config.fetch(:verbose, true)
+    def apply(path, verbose: true)
       is_uri  = path =~ %r{^https?://}
       path    = find_in_source_paths(path) unless is_uri
 
@@ -165,7 +163,7 @@ module Freyia
     #     run('ln -s ~/edge rails')
     #   end
     #
-    def run(command, config = {}) # rubocop:todo Metrics
+    def run(command, **config) # rubocop:todo Metrics
       destination = relative_to_original_destination_root(destination_root, remove_dot: false)
       desc = "#{command} from #{destination.inspect}"
 

data/lib/freyia/line_editor.rb

@@ -5,7 +5,7 @@ require_relative "line_editor/readline"
 
 module Freyia
   module LineEditor
-    def self.readline(prompt, options = {})
+    def self.readline(prompt, **options)
       best_available.new(prompt, options).readline
     end