DSL para Winamp

A alguns dias atras li alguns artigos (esse, e esse outro) sobre DSL em ruby e fiquei altamente instigado para fazer uma DSL.

Não quero entrar em detalhes do que é ou não é uma DSL pois esse assunto é muito subjetivo. Ideial par se levar para mesa de um bar. (dependendo da compainha logico!) =)

O que você tem que saber é que se estou escrevendo essa linguagem para um fim e se você a usa com essa finalidade isso é uma DSL. Agora se você consegue usar, usando alguma esperteza, para outros fins isso não é uma DSL para você.

Vamos escrever uma DSL para meu irmão (pudim, o pelidiozinho! hehehe) fazer programas para controlar o winamp com as musicas dele (swinguera da bahia!). Já fiz algo parecido em java (aqui) mas concerteza vai ficar muito dificil para ele usar. Então vamos fazer uma DSL para ele =)

Primeiro precisamos escrever como seria uma DSL facil para ele usar. Pensei em algo do tipo:
com o winmap faca<br /> play<br /> …<br /> stop</p> <p>

Bem acho que meu irmão consegue entender isso! Mas perai… temos um problema! Precisamos fazer isso ficar com a cara de ruby do jeito que tá a sintaxe não encaixa. Vamos ajeitar para:
com_winamp do<br /> play<br /> …<br /> stop<br /> end</p> <p>

Bem agora isso ta com cara de ruby! Então vamos colocar isso em um arquivo para que nossa DSL possa parsear isso.

winamp.scr
com_winamp do<br /> play<br /> stop<br /> end</p> <p>

Agora vamos começar a fazer nossa DSL. Vamos pirmeiro nos preucupar com o parse e criar metodos burros que apenas imprimem o que irão fazer.

dsl.rb
def com_winamp(&proc)<br /> puts “vou rodar os comandos de proc: #{proc}”<br /> end</p> <p>load ‘winamp.src’</p> <p>

Ao rodar isso vamos ter como saida:

vou rodar os comandos de proc: #<Proc:0×027f59fc@./winamp.src:1>

Agora vamos implementar a classe que vai se comunicar com o winamp:

dsl.rb
require ‘Win32API’</p> <p>#O winamp tem que esta aberto!<br /> class Winamp<br /> <br /> def initialize<br /> #faz uma chamada a api do windows para procurar pelo winamp aberto<br /> findWindow = Win32API.new(‘user32’,‘FindWindow’, ‘PI’, ‘I’)<br /> <br /> #guarda a referencia do winamp aberto<br /> <code>handle = findWindow.call('Winamp v1.x', 0) end def play if @handle #faz uma chamada a api do windows para enviar uma mensagem ao winamp sendMessage = Win32API.new("user32", "SendMessage", ['L'] * 4, 'L') #envia a mensagem com os codigos para da play no winamp #esses codigos podem ser conseguidos na pagina do Winamp na area de desenvolvimento (SDK) sendMessage.call(</code>handle, 0×0111, 40045, 0)<br /> end<br /> end<br /> <br /> def stop<br /> if <code>handle #faz uma chamada a api do windows para enviar uma mensagem ao winamp sendMessage = Win32API.new("user32", "SendMessage", ['L'] * 4, 'L') #envia a mensagem com os codigos para da play no winamp #esses codigos podem ser conseguidos na pagina do Winamp na area de desenvolvimento (SDK) sendMessage.call(</code>handle, 0×0111, 40047, 0)<br /> end<br /> end <br /> end</p> <p>def com_winamp(&proc)<br /> #roda os comandos na instancia do objeto<br /> Winamp.new.instance_eval &proc<br /> end</p> <p>load ‘winamp.src’</p> <p>

Agora fazemos no prompt de comando:
ruby dsl.rb

Opa! já vemos nossa DSL em acão!

Agora vamos ser um pouco DRY e refatorar um pouco. Você deve ter percebido que repitimos muito essas chamdas de api do windows. Vamos enxugar isso e criar metodos privados para realizar essas chamadas.

dsl.rb
require ‘Win32API’</p> <p>#O winamp tem que esta aberto!<br /> class Winamp<br /> <br /> def initialize<br /> #guarda a referencia do winamp aberto<br /> <code>handle = find_window('Winamp v1.x', 0) end def play if @handle send_message(</code>handle, 0×0111, 40045, 0)<br /> end<br /> end<br /> <br /> def stop<br /> if <code>handle send_message(</code>handle, 0×0111, 40047, 0)<br /> end<br /> end<br /> <br /> private<br /> #faz uma chamada a api do windows para enviar mensagens ao winamp<br /> def send_message(<strong>args)<br /> #envia a mensagem com os codigos para da play no winamp<br /> #esses codigos podem ser conseguidos na pagina do Winamp na area de desenvolvimento (<span class='caps'>SDK</span>) <br /> Win32API.new(“user32”, “SendMessage”, [‘L’] * 4, ‘L’).call *args<br /> end<br /> <br /> #faz uma chamada a api do windows para procurar pelo winamp aberto<br /> def find_window(</strong>args)<br /> Win32API.new(‘user32’,‘FindWindow’, ‘PI’, ‘I’).call *args<br /> end <br /> end</p> <p>def com_winamp(&proc)<br /> #roda os comandos na instancia do objeto<br /> Winamp.new.instance_eval &proc<br /> end</p> <p>load ‘winamp.src’</p> <p>

Legal! Mas ainda não é suficiente estamos repitindo muito o “if” que verifica se o handle não é nulo em cada metodo da classe. Vamos mudar isso tambem.

dsl.rb
require ‘Win32API’</p> <p>#O winamp tem que esta aberto!<br /> class Winamp<br /> <br /> class << self<br /> # cria um metodo na classe Winamp para definicao de metodos com verificação de handle<br /> def novo_metodo(metodo, &proc)<br /> define_method(metodo) { instance_eval &proc if <code>handle } end end def initialize #guarda a referencia do winamp aberto @handle = find_window('Winamp v1.x', 0) end novo_metodo :play do send_message(</code>handle, 0×0111, 40045, 0)<br /> end<br /> <br /> novo_metodo :stop do<br /> send_message(@handle, 0×0111, 40047, 0)<br /> end<br /> <br /> private<br /> #faz uma chamada a api do windows para enviar mensagens ao winamp<br /> def send_message(<strong>args)<br /> #envia a mensagem com os codigos para da play no winamp<br /> #esses codigos podem ser conseguidos na pagina do Winamp na area de desenvolvimento (<span class='caps'>SDK</span>) <br /> Win32API.new(“user32”, “SendMessage”, [‘L’] * 4, ‘L’).call *args<br /> end<br /> <br /> #faz uma chamada a api do windows para procurar pelo winamp aberto<br /> def find_window(</strong>args)<br /> Win32API.new(‘user32’,‘FindWindow’, ‘PI’, ‘I’).call *args<br /> end <br /> end</p> <p>def com_winamp(&proc)<br /> #roda os comandos na instancia do objeto<br /> Winamp.new.instance_eval &proc<br /> end</p> <p>load ‘winamp.src’</p> <p>

Agora podemos retirar aquela chamada estatica ao “winamp.src” e passar isso por paramentro na linha de comando tambem podemos colocar constantes nos codigos de mensagens do winamp.

E nosso resultado final é algo do tipo:

dsl.rb
require ‘Win32API’</p> <p>#O winamp tem que esta aberto!<br /> class Winamp<br /> <br /> WM_COMMAND = 0×0111<br /> WA_NOTHING = 0<br /> <br /> WA_PLAY = 40045<br /> WA_STOP = 40047;<br /> WA_PAUSE = 40046;<br /> WA_PREVTRACK = 40044;<br /> WA_NEXTTRACK = 40048;<br /> <br /> WA_PLAYLISTLEN = 124;<br /> WA_SETVOLUME = 122 ;<br /> WA_SETPLAYLISTPOS = 121;<br /> WA_CLEARPLAYLIST = 101;<br /> <br /> WA_RESTART = 135;<br /> WA_GETSTATUS = 104;<br /> WA_REFRESHPLCACHE = 247;<br /> WA_SETSHUFFLESTATUS = 252;<br /> WA_SETREPEATSTATUS = 253;<br /> WA_VOLUMEUP = 40058;<br /> WA_VOLUMEDOWN = 40059;<br /> <br /> class << self<br /> # cria um metodo na classe Winamp para definicao de metodos com verificação de handle<br /> def novo_metodo(metodo, &proc)<br /> define_method(metodo) { instance_eval &proc if <code>handle } end end def initialize #guarda a referencia do winamp aberto @handle = find_window('Winamp v1.x', 0) end novo_metodo :play do send_message(</code>handle, WM_COMMAND, WA_PLAY, WA_NOTHING)<br /> end<br /> <br /> novo_metodo :stop do<br /> send_message(@handle, WM_COMMAND, WA_STOP, WA_NOTHING)<br /> end</p> novo_metodo :pause do send_message(@handle, WM_COMMAND, WA_PAUSE, WA_NOTHING) end novo_metodo :faixa_anterior do send_message(@handle, WM_COMMAND, WA_PREVTRACK, WA_NOTHING) end novo_metodo :faixa_seguinte do send_message(@handle, WM_COMMAND, WA_NEXTTRACK, WA_NOTHING) end private #faz uma chamada a api do windows para enviar uma mensagem ao winamp def send_message(*args) #envia a mensagem com os codigos para da play no winamp #esses codigos podem ser conseguidos na pagina do Winamp na area de desenvolvimento (<span class='caps'>SDK</span>) Win32API.new(“user32”, “SendMessage”, [‘L’] * 4, ‘L’).call *args end #faz uma chamada a api do windows para procurar pelo winamp aberto def find_window(*args) Win32API.new(‘user32’,‘FindWindow’, ‘PI’, ‘I’).call *args end <p>end</p> <p>def com_winamp(&proc)<br /> #roda os comandos na instancia do objeto<br /> Winamp.new.instance_eval &proc<br /> end</p> <p>load <span class='caps'>ARGV</span>.shift</p> <p>

winamp.src
com_winamp do<br /> stop<br /> faixa_anterior<br /> play<br /> end</p> <p>

para funcionar:
ruby dls.rb winamp.src

ps: só lembrando o winamp tem que ta aberto =)

=*

DUCA!!!!

Tremendo material LEGAL!!!

(Nota mental: Fazer um esquema pra destacar tópicos desse tipo! Urgente!)

O Daniel pudia publicar isso como artigo!!!

Puts grila, Macacos me mordam…. Tá pintando uma galera fera por aqui heim ?

Parabéns Daniel!!!