Adicionando elementos gráficos a scripts com Dialog e Xdialog

Transcrição

1 Dialog PROGRAMAÇÃO Adicionando elementos gráficos a scripts com Dialog e Xdialog Não é necessário se afundar em livros de programação gráfica para adicionar simples elementos gráficos a scripts. por Ankur Kumar Sharma Na era dos coloridos e convenientes aplicativos dotados de interfaces gráficas, os velhos programas de linha de comando ficam parecendo meio monótonos e pouco amigáveis. Não seria interessante acrescentar recursos gráficos a seus scripts sem precisar da chateação da programação gráfica? Duas ferramentas chamadas Dialog [1] e Xdialog [2] adicionam widgets de desktop em estilo gráfico a seus programas. É possível usar Dialog e Xdialog com C, C++, Python, Ruby, Perl e Bash. Figura 1 Ajuda do Dialog e do Xdialog. Figura 2 Um simples widget de informação. 68

2 Dialog PROGRAMAÇÃO O Dialog emprega as bibliotecas curses/ncurses [3] para criar controles ou widgets interativos. Como mostra este artigo, é possível adicionar esses widgets a aplicativos de linha de comando sem grandes esforços de programação. O Xdialog é um parceiro do Dialog que produz vários widgets em um ambiente X Window. O Xdialog usa a biblioteca Gtk+, por isso, interage facilmente com o ambiente desktop Gnome. Mais adiante, este artigo descreverá algumas ferramentas alternativas para adicionar widgets a scripts, tais como Gtkdialog [4], Whiptail e Zenity. Caso você utilize o KDE, é possível considerar o Kdialog [5], que funciona da mesma maneira nesse ambiente desktop. Começo O Dialog e o Xdialog já vêm pré instalados em diversas distribuições. Para montar o Dialog a partir do códigofonte, é necessário, primeiramente, compilar a biblioteca ncurses, pois o Dialog precisa dos seus cabeçalhos. Instalar o Xdialog é um pouco mais trabalhoso. Para a instalação a partir do código-fonte, baixe e instale os seguintes pacotes.deb nesta ordem: libgtk1.2-common_ _all.deb libglib1.2_ build1_ amd64.deb libgtk1.2_ _amd64.deb libglib1.2-dev_ build1_ amd64.deb libgtk1.2-dev_ _amd64.deb Note que o Xdialog precisa da série 1.2 da biblioteca Gtk. Após instalar os pacotes de dependências mencionados, baixe o último código-fonte no site do Xdialog [2], descompacte o arquivo tar e entre no diretório dos fontes: tar -jxvf Xdialog tar.bz2 cd Xdialog Para finalmente completar a instalação do Xdialog, basta usar os comandos tradicionais:./configure make sudo make install Agora, quando você digitar Xdialog na linha de comando, aparecerá um widget Xdialog com informações de ajuda, como mostrado na figura 1. Como usar Pense no Dialog como um comando de shell. O comando seleciona um widget do Dialog e especifica algumas opções. A forma seria: dialog <opções comuns> widget \ <opções do widget> As opções comuns são configurações opcionais que modificam a aparência e o comportamento dos widgets. As widget optionssão uma combinação de configurações mínimas e opcionais para criar widgets. Nas páginas do manual, as opções do widget são chamadas de box options. O comando man dialog exibe a tela de ajuda mostrada na figura 1. Algumas das opções mais importantes são: Quadro 1: Widgets do Dialog backtitle título: a tela de fundo da janela de diálogo dos widgets normalmente não contém nenhum texto, mas esta opção permite mostrar algum texto na tela de fundo; title título: adicionar um título em formato de texto ao widget; stdout: alguns dos elementos que retornam algo escrevem na tela por padrão. Se quiser consultar essa saída sem escrever na tela, use esta opção; begin posição_y posição_x: Por padrão, todos os widgets são posicionados no centro da janela O Dialog permite acrescentar um tempero aos seus scripts com qualquer um dos seguintes widgets: Calendar checklist dselect editbox form fselect gauge infobox inputbox menu mixedform mixedgauge msgbox passwordbox passwordform pause progressbox radiolist tailbox tailboxbg textbox timebox yesno Figura 3 Widget msgbox com título e opção title. Figura 4 Widget de pausa com a opção color. Linux Magazine #67 Junho de

3 PROGRAMAÇÃO Dialog Figura 5 Widget de calendário com um botão extra. Texto de teste infobox Como mostra a figura 2, foi criado um widget de informação. Após criar o widget infobox, o Dialog retorna imediatamente ao prompt de comando, que é o comportamento padrão desse tipo de widget. O único propósito do widget é mostrar um texto informativo. O comando anterior inclui dois zeropara a altura e a largura do widget. Se os parâmetros forem zeros, o Dialog define a altura e a largura. Portanto, 0 e 0 são valores seguros na maioria das vezes. O widget infobox foi criado sem nenhum título ou tela de fundo. Para criar esses dois, acrescente: dialog --backtitle Mensagem \ --title msgbox --msgbox \ Sou um widget msgbox. 0 0 Agora, é possível ver um título de fundo e um título de widget no widget msgbox(figura 3). Além disso, ao usar as teclas [Esc]e [Enter] (ou clicar em OK), a caixa de diálogo retorna. Até agora, foram apresentadas apenas as cores padrão para diferentes textos de widgets de diálogo. Para alterar esses atributos passados ao Dialog, basta embutir sequências \Z nos diferentes textos que são passados ao Dialog, juntamente com a opção --colors, da seguinte maneira: dialog --colors --backtitle \ \Zr\Z1Pausa\Zn --title \ \Zu\Z5pausa\Zn --pause \ Figura 6 Widget de entrada com as opções begin e noshadow. do terminal, mas é possível alterar esse comportamento usando essa opção para especificar as distâncias xe ydo canto superior esquerdo; timeout segundos: especifica o intervalo, em segundos, em que o widget retornará; sleep segundos: inclui um intervalo com a duração dos segundos especificados; no-shadow: por padrão, e exibida uma sombra à direita e abaixo do widget para criar a ilusão de profundidade. É possível desabilitar isso com esta opção; colors: muda os atributos de vídeo no texto do título. A última versão do Dialog oferece uma grande coleção de widgets (veja o quadro 1). Para uasr o widget infoboxdo Dialog, digite a seguinte linha: dialog --infobox \ Figura 7 Vários widgets de diálogo. Listagem 1: Uso de and-widget 01 dialog backtitle Várias caixas de diálogo begin 4 4 title msgbox1 msgbox Primeira 0 0 \ 02 and widget begin title msgbox2 msgbox Segunda 0 0 \ 03 and widget begin title msgbox3 msgbox Terceira 0 0 \ 04 and widget - begin title infobox1 infobox Há múltiplos widgets. 0 0 \ 05 and widget - begin tile infobox2 infobox Também estou aqui

4 Dialog PROGRAMAÇÃO \ --extra-label Passo extra \ --ok-label Ok computador \ --exit-label Tchau \ --calendar Escolha uma data 0 0 widgets de diálogo que devolvem algum valor. Isso pode ser modificado usando a opção --stdout. Também é possível especificar a localização do widget e desligar sua sombra: Figura 8 Widget de menu mostrado por um script shell. \Zb\Z6Sou um widget de pausa \ Agora já é possível ver o texto colorido no widget pause mostrado na figura 4. O widget pause mostra uma barra que vai diminuindo a cada segundo. Caso a tecla [Esc] não seja pressionada, nem os botões OK ou Cancel, durante os segundos restantes, o widget pause retorna ao fim do tempo estipulado. Os atributos de texto e os valores de cores de sequências \Z nas strings de texto são os seguintes: A figura 5 contém a imagem desse widget. É possível movimentarse entre as diferentes subjanelas do widget calendarusando a tecla [Tab]. Caso o usuário selecione, aperte ou clique qualquer botão com exceção da tecla [Esc] ou do botão Cancel, verá que a data selecionada é impressa no próprio widget. Esse é o comportamento padrão de todos os dialog --no-shadow --begin 4 4 \ --backtitle Caixa de texto \ --title entrada --inputbox \ Digite alguma coisa 0 0 \ dialog é demais... O widget resultante (figura 6) é exibido no local especificado com a opção --begin e sem sombras (como manda a opção --no-shadow). O wid- r : reverso b : negrito (bold) u : sublinhado (underline) n : restaura o padrão (restore normal settings) 0 : preto 1 : vermelho 2 : verde 3 : amarelo 4 : azul 5 : magenta 6 : ciano 7 : branco Figura 9 Widget de texto mostrando o conteúdo de um arquivo selecionado. Também é possível alterar os títulos padrão dos botões OK e Cancel ou mostrar um botão extra com texto adicional. Use o seguinte comando para conferir estes recursos em ação: dialog --backtitle Calendário \ title calendar -extra-button Figura 10 Alguns widgets extras do Xdialog.juda do Dialog e do Xdialog. Linux Magazine #67 Junho de

5 PROGRAMAÇÃO Dialog Listagem 2: Widget no seu script 01 #! /usr/bin/env bash # variáveis com o comando e opções comuns. 04 dlg=dialog 05 stdo=--stdout 06 titl=--title 07 titlbg=--backtitle # função para tratar a escolha do arquivo a abrir. 10 fileselect() { file=$($dlg $stdo $titlbg A escolha do menu foi o diálogo de seleção de arquivo $titl Selecione um arquivo \ 13 --fselect ~ ) if [ $? -eq 0 ] 17 then 18 $dlg $titlbg Conteúdo do arquivo selecionado $titl $file -textbox $file fi } # função para tratar a escolha de diretório. 24 dirselect() { directory=$($dlg $stdo $titlbg A escolha do menu foi o diálogo de seleção de diretório $titl Selecione um diretório \ 27 --dselect ~ ) if [ $? -eq 0 ] 31 then 32 $dlg $titlbg Informações do diretório selecionado $titl Informações do diretório \ 33 --infobox O diretório escolhido foi: $directory fi } # função para tratar a escolha de timebox. 39 timebox() { ti me=$($dlg $stdo $titlbg A escolha do menu foi Time Box. $titl Hora escolhida \ 42 --timebox Escolha sua hora preferida ) 44 get inputbox mostra uma string padrão oferecida pelo comando, mas é possível alterar essa string usando as teclas [Del] ou [Backspace]e digitando o texto desejado. Em vez de digitar os comandos completos na linha de comando, é possível especificar uma opção para ler parâmetros do Dialog a partir de um arquivo. A opção --file especifica o nome do arquivo: dialog --file arquivo onde arquivo contém outros parâmetros do dialog. Também é possível unir vários widgets usando a opção --and-widget. Os comandos da listagem 1 produzem o widget mostrado na figura 7. Dialog com shell Para incorporar widgets do Dialog a scripts de shell, basta adicionar comandos do Dialog a seus scripts. O widget devolve um valor para futuro processamento, além de um status que permite determinar a ação do teclado ou do mouse a ser executada no widget. Para obter o valor retornado pelo widget, adicione a opção --stdout ao comando dialog e use o mecanismo de substituição de comandos do shell. Para determinar o tipo de ação a ser executada em um widget, é necessário examinar a variável $?do shell, que devolve o status de saída do comando anterior. O script na listagem 2 combina esses conceitos para incorporar alguns widgets do Dialog. O script apresenta um menu com várias opções, e as informações são apresentadas com base na opção escolhida. Veja as figuras 8 e 9 com as imagens dos widgets referenciados na listagem 2. Os widgets do Dialog transformaram o antes entediante shell script baseado em texto em um belo script com interface gráfica, 72

6 Dialog PROGRAMAÇÃO sem nenhuma programação especificamente gráfica. Xdialog O Xdialog oferece uma ampla variedade de opções gráficas e se integra facilmente ao ambiente desktop Gnome. O Xdialog e o Dialog são muito semelhantes, e é possível aplicar o conhecimento de um ao outro. O formato básico de um comando do Xdialog é: Xdialog \ <opções comuns> \ <opções transientes> \ widget <opções do widget> Nesse comando, opções transientes refere-se a algumas opções do Dialog, além de algumas opções adicionais associadas ao Xdialog. Se o Xdialog estiver instalado em seu sistema, é possível explorar alguns de seus widgets com o seguinte comando: Xdialog --backtitle colorsel --title Widget de cor --colorsel Sua cor preferida Xdialog --backtitle fontsel --title Font Selection Widget --fontsel times Xdialog --backtitle caixa com 3 --title Widget para seleção de 3 itens --3rangesbox Escolha Listagem 2: Continuação 45 if [ $? -eq 0 ] 46 then 47 $dlg $titlbg Selecionou informações de hora $titl Informações de hora \ 48 --infobox Sua hora preferida é : $time fi } # widget de menu para mostrar várias escolhas. 54 choice=$($dlg $stdo $titlbg Uso do Dialog em scripts de shell $titl Menu de ações \ 55 --menu Escolha uma opção para continuar \ 56 1 Abrir arquivo \ 57 2 Escolher diretório \ 58 3 Exibir timebox \ 59 ) # só estamos interessados no evento de botão OK. 62 If [ $? -eq 0] 63 then # agora trate a opção escolhida. 66 if [ $choice = 1 ] 67 then 68 fileselect 69 elif [ $choice = 2 ] 70 then 71 dirselect 72 elif [ $choice = 3 ] 73 then 74 timebox 75 fi <fim do código do script de shell> Figura 11 Widgets de caixa de senha do Dialog e de caixa de digitação do Xdialog em um script Python. Figura 12 Widgets de tempo do Dialog e de mensagem do Xdialog em um script Python. Linux Magazine #67 Junho de

7 PROGRAMAÇÃO Dialog Listagem 3: Widgets em Python 01 <início do código Python> #! /usr/bin/env python from subprocess import Popen, PIPE, STDOUT # dicionário com vários comandos dialog e Xdialog. 08 dwdgtsatrb = { 09 dlgpswd : dialog --stdout --insecure -- backtitle PasswordBoxWidget --title passwordbox -- passwordbox Digite a chave 0 0, 10 xdlgnme : Xdialog --title Xinputbox --inputbox Digite seu nome 0 0, 11 xdlgdob : Xdialog --title Xcalendar --calendar Digite seu DOB 0 0, 12 dlgtme : dialog --stdout --backtitle TimeBoxWidget -- title timebox --timebox Selecione a sua data de nascimento 0 0, 13 xmsg : Xdialog --title XmsgBox --msgbox message 0 0, 14 } def execute(scommand): Rotina para executar um comando e retornar (saída, erro, status) do comando l = scommand.split( ) 23 p = Popen(l, stdout=pipe, stderr=stdout) 24 toe = p.communicate() return (toe[0], toe[1], p.returncode) def main(): Rotina do driver de aplicativo tpswd = execute(dwdgtsatrb[ dlgpswd ]) tnme = () 35 tdob = () 36 ttme = () if lpmrockz == tpswd[0].strip(): if not tpswd[2]: 41 tnme = execute(dwdgtsatrb[ xdlgnme ]) if not tnme[2]: seus valores 0 0 primeiro segundo terceiro Alguns widgets novos oferecidos pelo Xdialog são mostrados na figura 10. Note que esses widgets são mais parecidos com o verdadeiro elemento gráfico encontrado nos ambientes desktop. Além do shell Caso você esteja usando alguma linguagem de programação com suporte à chamada de executáveis externos, é possível usar o Dialog e o Xdialog. Isso significa que é possível utilizar seus widgets com C, C++, Python, Perl, Ruby e outras linguagens. Ao usar o Dialog e o Xdialog com essas linguagens, é possível evitar a complicada e trabalhosa programação gráfica associada à manutenção de versões em texto e gráfica do programa. É possível usá-los também para rapidamente projetar um aplicativo gráfico. O script em Python na listagem 3 usa vários widgets do Dialog e do Xdialog. Primeiro, ele pede a senha (lpmrockz, neste caso) e, após solicitar outras informações, retorna uma mensagem no final. Repare que, no dicionário de comandos do Dialog e do Xdialog, os vários parâmetros são separados pelo caractere pipe ( ) para permitir espaços nas várias strings passadas. Copie e cole esse código Python em um arquivo e execute-o com o comando python arquivo.py. Também é possível executar o arquivo digitando./ arquivo.pyapós transformar o arquivo em executável com o comando chmod u+x arquivo.py. O resultado exibido após a execução do código da listagem 3 é mostrado nas figuras 11 e 12. Repare a coexistência de widgets do Dialog e do Xdialog nas imagens. 74

8 Dialog PROGRAMAÇÃO Whiptail, Zenity, X Message e Gtkdialog Vários outros aplicativos Linux oferecem recursos similares aos do Dialog e do Xdialog. O Ubuntu traz o utilitário chamado Whiptail, baseado na biblioteca Newt. Porém, o Whiptail é um tanto limitado com relação aos widgets e opções de configuração oferecidos. Mesmo oferecendo menos opções e widgets que o Dialog, os widgets disponíveis incluem caixas sim/não, de menu, de entrada, de mensagem, de informação, checklist, radiolist, de medida e de senha. Para ver o widget de senha do Whiptail, digite o seguinte comando: whiptail --fb --title \ Widget de senha \ --passwordbox \ Digite sua senha 10 0 O utilitário Zenity [6] também vem pré-instalado no Ubuntu. A ideia do Zenity é mostrar caixas de diálogo Gtk+ em linhas de comando e scripts shell. O Zenity oferece alguns widgets Gtk+ bem úteis. Os seguintes comandos mostram um pouco do Zenity em ação: zenity --info -text= Informação do Zenity. Listagem 3: Continuação 44 tdob = execute(dwdgtsatrb[ xdlgdob ]) if not tdob[2]: 47 ttme = execute(dwdgtsatrb[ dlgtme ]) if not ttme[2]: 50 smsg = ( Hi + tnme[0].strip() + \n + 51 Seu DOB é : + tdob[0].strip() + \n + 52 Dia do nascimento é : + ttme[0].strip() + \n + 53 A LM lhe deseja tudo de bom. ) 54 execute( dwdgtsatrb[ xmsg ].replace( message, smsg)) else: 57 smsg = Senha incorreta, boa sorte da próxima vez. 58 execute(dwdgtsatrb[ xmsg ].replace( message, smsg)) if main == name : main() <fim do código Python> zenity --warning -text= Alerta do Zenity. zenity --question -text= Pergunta do Zenity. Os widgets criados com o Whiptail e o Zenity são mostrados na figura 13. O número de widgets e opções de configuração oferecidos pelo Zenity é mais limitado que o do Xdialog, mas o Zenity é bem mais útil que o Whiptail. Outras ferramentas que oferecem recursos gráficos rápidos para scripts são o X Message e o Gtkdialog. Figura 13 Saída de comando do Whiptail e do Zenity. Figura 14 Saída de comando do Gtkdialog e do X Message. Linux Magazine #67 Junho de

9 PROGRAMAÇÃO Dialog Na verdade, o X Message é um comando que gera widgets gráficas bem limitadas, pois apenas apresenta mensagens com botões definidos pelo usuário. O seguinte comando mostra o X Message em ação: xmessage -file ~/.bashrc \ -buttons Ok:1, Cancela:2, \ Ajuda:3 -print -nearmouse A opção -file usada aqui lê uma mensagem de um arquivo especificado. Ao clicar no botão, o código de retorno correspondente é devolvido pelo comando xmessage. O Gtkdialog [4] é bem diferente dos outros utilitários vistos até agora. Esta ferramenta cria vários widgets com o uso de uma descrição do tipo XML, conhecida como linguagem de descrição de diálogo. Com essa linguagem de descrição, é possível criar várias caixas de diálogos complexas contendo outros widgets e caixas. O ponto fraco é que o Gtkdialog é bem mais trabalhoso que outros utilitários que criam widgets gráficos para desktop, mas, mesmo assim, é mais fácil do que a programação de interfaces gráficas. A listagem 4 mostra um exemplo de script com Gtkdialog. A saída desse script de shell com Gtkdialog (além do exemplo da ferramenta alternativa X Message) é mostrada na figura 14. Conclusão As ferramentas Dialog, Xdialog, Whiptail, Zenity, Gtkdialog e X Message podem transformar qualquer utilitário de linha de comando em um aplicativo amigável com interface gráfica. Sem nenhuma programação gráfica, é possível adicionar sofisticados recursos a seus aplicativos. n Listagem 4: Uso do Gtkdialog 01 <início do script shell> #! /usr/bin/env bash # descrição do diálogo atribuída a uma variável de ambiente. 06 Export MAIN_DIALOG= 07 <vbox> 08 <text wrap= true width-chars= 10 > 09 <label> O tempo passou, a festa acabou, achei que eu tivesse algo mais a dizer.</label> 10 </text> 11 <text use-markup= true > 12 <label> <b>o Software Livre é demais, meu amigo!!!</ b> </label> 13 </text> 14 <hbox> 15 <button ok></button> 16 <button cancel></button> 17 </hbox> 18 </vbox> gtkdialog3 --program=main_dialog <fim do script shell> Mais informações [1] Site do Dialog: [2] Site do Xdialog: [3] ncurses: [4] Site do Ggtkdialog: [5] Tutorial do Kdialog: Shell_Scripting_with_KDE_Dialogs#Introduction_and_Scope [6] Zenity: [7] X Message: Gostou do artigo? Queremos ouvir sua opinião. Fale conosco em cartas@linuxmagazine.com.br Este artigo no nosso site:

10