gistfile1.rb

class YARD::Handlers::RemoteHandler < YARD::Handlers::Base
  handles /\Aremote/
  
  def process
    name_token = statement.tokens[2]
    name = name_token.text.sub(/:/, '')
    
    o1 = MethodObject.new(namespace, name, :instance)
    o2 = MethodObject.new(namespace, "#{name}_cached", :instance)
    register(o1, o2)

    o1.visibiliy = :public
    o1.parameters = [["params", "{}"]]
    o1.docstring = [statement.comments, 
                   "@see RemoteCall#remote", 
                   "@return [String] Response"].join("\n")
    
    o2.visibility = :public
    o2.parameters = [["params", "{}"]]
    o2.docstring = ["Cached version of #{name}",
                   "@see #{namespace}##{name}",
                   "@param params as in Alien#response",
                   "@return [String] response"].join("\n")
  end
end