Aí está uma das novas funcionalidades do Rails 2.1 que provavelmente você nunca usará. Digo “talvez”, porque pode ser que em algum caso muito especifico seja interessante obter o número da versão do plugin, por exemplo.
Para testar isto, precisamos criar um novo arquivo chamado about.yml no diretório do plugin, algo mais ou menos assim:
author: Carlos Brando
version: 1.2.0
description: Uma descrição qualquer sobre o plugin
url: http://www.nomedojogo.com
Depois podemos recuperar estas informações via código, assim:
plugin = Rails::Plugin.new(diretorio_do_meu_plugin)
plugin.about["author"] # => "Carlos Brando"
plugin.about["url"] # => "http://www.nomedojogo.com"
Se alguém encontrar algum uso para isto e quiser compartilhar comigo, talvez eu mude de idéia quanto à sua real necessidade.
Acredito que esta idéia tenha vindo do Grails, onde isto é padrão desde sempre …
É utilizado para criar uma página de dependências da aplicação que nunca vi usarem para nada, ou então para o comando:
grails plugin-info
antes de instalar o plugin :D
Pode ser, mas ainda não vi uso prático para isso, mas…
Agora, apenas para documentar, se o arquivo não existir o método terá um Hash vazio.