用 Ruby 编写类似 Thor gem 的 DSL？

Question

我试图弄清楚 Thor gem 如何创建这样的 DSL（自述文件中的第一个示例）

class App < Thor                                                 # [1]
  map "-L" => :list                                              # [2]

  desc "install APP_NAME", "install one of the available apps"   # [3]
  method_options :force => :boolean, :alias => :string           # [4]
  def install(name)
    user_alias = options[:alias]
    if options.force?
      # do something
    end
    # other code
  end

  desc "list [SEARCH]", "list all of the available apps, limited by SEARCH"
  def list(search="")
    # list everything
  end
end

具体来说，它如何知道将 desc 和 method_options 调用映射到哪个方法？

Answer 1

desc 非常容易实现，诀窍是使用 Module.method_added：

class DescMethods
  def self.desc(m)
    @last_message = m
  end

  def self.method_added(m)
    puts "#{m} described as #{@last_message}"
  end
end

任何继承于 DescMethods 的类都会有一个 desc 方法如 Thor。对于每种方法，都会打印一条消息，其中包含方法名称和说明。例如：

class Test < DescMethods
  desc 'Hello world'
  def test
  end
end

当定义此类时，将打印字符串“test描述为Hello world”。