Compila cap06.Rmd em markdown para visualização no GitLab

cap06.md

@@ -5,46 +5,283 @@ PET Estatística UFPR
 
 ## Ferramentas gráficas ##
 
-Definir *GUI's (Graphical User Interfaces)*. Particularizar e motivar,
-com situações exemplo, a utilização de interfaces gráficas no fluxo de
-trabalho de um projeto com versionamento **GIT**.
+No GIT, como vimos até agora, todo o gerenciamento do projeto é
+realizado via *CLI (Command line interface)*, linhas de comando
+interpretadas, geralmente pelo *bash*. Isso confere um maior controle e
+segurança nas ações realizadas, mas em muitas situações os comandos e
+*outpus* GIT não se apresentam de forma tão amigável seja pela difícil
+memorização ou pela interatividade limitada.
+
+Os comandos mais usuais como `git add`, `git commit` se tornam simples,
+pois, mesmo para um usuário iniciante eles fazem parte do cotidiano em
+um projeto sob versionamento GIT. Mas algumas situações que não ocorrem
+com frequência, como por exemplo voltar a versão de um arquivo ou do
+repositório, requerem comandos que são pouco utilizados e, não raramente
+para realizá-las é necessário a consulta de algum material sobre
+GIT. Outra situação onde a utilização dos comandos é dificultada, ocorre
+para projetos maiores, onde muitos arquivos são alterados
+simultaneamente e o procedimento de *commit* se torna trabalhoso, pois
+é necessário listar todos os arquivos que fazem parte de um *commit*
+no commando `git add`. Uma última situação exemplo em que o uso de *CLI*
+não parece satisfatório é na comparação de arquivos, já usamos o comando
+`git diff` na capítulo 3 e o *output* deste comando foi de simples
+visualização, mas em arquivos maiores (com muitas linhas) a navegação
+para verificar as alterações do arquivo não é tão amigável. Para
+facilitar essas e outras situações surgem as *GUI's (Graphical User
+Interfaces)*, interfaces gráficas para o usuário que incorporam comandos
+GIT em *widgets*(botões, caixas de texto etc.) dispostos em um janela
+gráfica de seu sistema operacional.
+
+Neste capítulo apresentamos as principais *GUI's* para GIT em diferentes
+plataformas sistemas UNIX, Mac OS X e Windows. Detalhes de download,
+instalação e exemplos da utilização destas interfaces no fluxo de
+trabalho de um projeto com versionamento **GIT** são descritos.
 
 ## Interfaces GIT ##
 
-Interfaces para gestão de um repositório **GIT**. Estas facilitam a
-utilização das principais instruções **GIT** (`git add`, `git commit`,
-`git push`) e a visualização dos arquivos e alterações no repositório.
+Neste material chamaremos de **Interfaces GIT** as *GUI's* para gestão de um
+repositório **GIT**. Estas facilitam a utilização das principais
+instruções **GIT** (`git add`, `git commit`, `git push`, `git pull`) e a
+visualização dos arquivos e alterações no repositório.
+
+Desde o surgimento do GIT diversas *GUI's* foram propostas. Este
+capítulo ter por objetivo apresentar as mais usuais interfaces dos
+sistemas operacionais UNIX, Mac OS X e Windowns.
+
+### git-gui ###
+
+Baseada em *Tcl/Tk* a *GUI* chamada `git gui` é mantida como projeto
+independente do GIT, mas as versões estáveis são distribuídas junto com
+o programa principal. Portanto não é necessário o download e
+instalação. A interface é voltada para realizar alterações no
+repositório. `git gui` permite a realização de diversas modificações,
+desde as mais simples como *commitar* arquivos até as mais específicas
+como voltar estágios ou reescrever o último *commit* (muito útil quando
+notamos erros de gramática logo após a submissão). Nesta seção
+abordaremos apenas as alterações mais comuns no repositório.
+
+`git gui`, no Windows, pode ser aberto pelo menu iniciar. Nesta
+plataforma, ao instalar o GIT (conforme visto no capítulo 2) duas
+aplicações ficam disponíveis **git BASH** e **git GUI**. Em sistemas
+LINUX podemos criar um *alias* (criar e editando adequadamente um
+arquivo em */usr/share/applications*) para que `git gui` fique listada
+junto as aplicações do sistema. --Descobrir no MAC se `git gui` fica no
+lançador automaticamente. Porém, de forma geral, independente da
+plataforma de trabalho `git gui` pode ser iniciada a partir de um
+terminal `bash`, com o comando:
+
+```sh
+git gui
+```
+
+Para exemplificar a utilização desta interface vamos alterar alguns
+arquivos do repositório `meu1repo`, criado no capítulo 2.
+
+
+
+
+```bash
+cd meu1repo/
+
+echo $(tr '[[:lower:][:upper:]]' '[[:upper:][:lower:]]' < README) > README
+
+echo "Lista de afazeres:
+-------------------------------------------
+* tarefa 1
+* tarefa 2
+* tarefa 3
+* tarefa 4
+* tarefa 5
+* tarefa 6" > TODO.txt
+
+echo "
+Mais um arquivo criado" > OTHER.txt
+```
+
+Após as alterações a interface gráfica é chamada.
+
+![](./images/git-gui1.png)  
+FIGURA: Inteface `git gui`
+
+A interface `git gui` se apresenta de forma bem simples, o que facilita
+sua utilização. Na figura ?? detacamos as quatro áreas que compreendem a
+interface. Na primeira porção temos listados os arquivos presentes no
+*working directory*, os arquivos criados aparecem com ícone em branco e
+os modificados com linhas em azul. E aqui a interface implementa
+interativamente o comando `git add`, pois ao clicar no ícone de um
+arquivo ele é automaticamente adicionado à *staging area*. Na segunda
+parte são listados os arquivos na *staging area* com ícone de *check
+mark*. Na terceira parte destacada temos a implementação do comando
+`git diff` para qualquer arquivo selecionado. Com destaque de cores a
+interface apresenta em vermelho as deleções e verde as adições. Por fim
+temos no canto inferior direito a área para escrever *commits* com
+botões para submissão de ação. Um detalhe importante do `git gui` é que
+o idioma do sistema operacional é verificado para sua construção, ou
+seja, os botões da interface na figura ?? são *push*, *commit*, *sign
+off*, etc pois o idioma do sistema operacional em que essa interface foi
+executado é o inglês. Para português (Brasil) as mensagem ficam .....
+
+Além das quatro áreas principais da interface, que facilitam
+interativamente atividades como `git status`, `git diff`, `git add`,
+`git commit` e `git push`, temos mais implementações no menu da
+interface para procedimentos não cotidianos. Essas implementações podem
+ser acessadas com um simples clique, e são bem auto-explicativas.
 
-Conteúdo de cada interface:
+### gitk ###
 
-* *Scrennshots* 
-* Intruções para *download* e instalação
-* Facilidades e limitações
+Pioneira dentre as interfaces gráficas para GIT, `gitk` foi a primeira
+*GUI* implementada pra GIT. Também implementada em *Tcl/Tk* esta *GUI*
+tem como objetivo a apresentação do histórico de um projeto GIT. `gitk`
+é incorporado ao principal repositório do GIT, portanto nas instalações
+completas do GIT esta interface já fica disponível sem ser necessário
+download e instalação. Nesta seção apresentamos a `gitk` detalhando a
+disposição dos elementos nesta interface que se mostra muito útil na
+visualização de projetos GIT.
 
-### git-gui (Nativo) ###
+`gitk` trabalha em conjunto com a `git gui`. Em `git gui` podemos fazer
+alterações de forma rápida e visual nos arquivos que estão na *staging
+area* e *working directory*, porém para visualizar o histórico completo
+de *commits*, com ramificações, marcações e demais detalhes, recorremos
+à `gitk`. Essa interface se mostra muito útil também como ferramenta de
+aprendizagem GIT, uma vez que visualizar de forma gráfica as alterações
+que os comandos realizados causam no projeto, torna mais fácil a
+compreensão dos mesmos.
 
-### gitk (Tcl/Tk) / gitg (Gtk) / gitx (MacOS) ###
+`gitk`, assim como a `git gui` pode ser chamada atráves de linha de
+comando.
 
-### RabbitVCS (Linux/Unix) ###
+```sh
+gitk
+```
 
-### GitHub (MacOS e Windows) ###
+Para exemplificar a disposição dos elementos nesta interface, seguimos
+com as alterações feitas na seção anterior, lembrando que temos todas as
+alterações já realizadas no capítulo 2 e ainda duas modificações e uma
+inclusão de arquivos não *commitadas*. Visualizando a interface `gitk`
+chamada neste estado do repositório temos:
+
+![](./images/gitk1.png)  
+FIGURA: Inteface `gitk`
+
+Perceba na figura ?? que esta interface é bem mais completado que a `git
+gui`, no que diz respeito à informação. Divida em apenas duas partes a
+`gitk` apresenta na primeira todo o histórico do projeto, é uma
+implementação visual e agradável do comando `git log --graph`. No
+gráfico apresentado as bolinhas azuis representam *commits* passados, a
+amarelo indica o estado atual do repositório e em vermelho são as
+modificações no *working directory* ao lado estão os autores dos
+respectivos *commits* e o momento em que foram feitos. Na parte
+inferior da interface temos o detalhamento do *commit* selecionado
+na parte superior. As informações contidas aqui vão desde o
+identificador do *commit* (*SHA1 ID*), diferença das modificações
+referenciadas por este *commit* com relação ao estado anterior do
+repositório até a listagem dos arquivos atingidos pelo *commit*
+selecionado.
+
+Além da exelente apresentação visual do repositório GIT, `gitk` também
+permite algumas alterações. Clicando com o botão direito de seu *mouse*
+em qualquer *commit* listado podemos criar *tags*, reverte o repositório
+neste estado, criar um ramo a partir do *commit* dentre outras opções
+possíveis atráves da interface.
+
+`gitk` é uma implementação em *Tcl/Tk* para visualização de repositórios
+GIT. Com o mesmo objetivo outras interfaces gráficas foram
+implementadas.
+
+
+Podemos destacar duas delas pela grande similaridade à
+`gitk`, são elas `gitg` e `gitx`. Ambas 
+
+* https://git-scm.com/docs/gitk
+* https://lostechies.com/joshuaflanagan/2010/09/03/use-gitk-to-understand-git/
 
 ### Outras Interfaces ###
 
-Citar materiais de referência para instalação e utilização. 
-Interfaces a serem comentadas:
+#### gitg e gitx ####
+
+Estas duas interfaces tentam juntar em uma única as opções
+proporcionadas pela `git gui` e pela `gitk`. Os layouts são muito
+similares e as propostas também a diferença está na portabilidade.
+`gitg` é implementada em *GTk+* e está disponível para sistemas LINUX e
+`gitx` foi implementado para Mac OS seguindo o estilo de aplicativos
+deste sistema operacional. De forma geral não há detalhes a serem
+repassados sobre estas interfaces uma vez que as possibilidades já foram
+listadas nas seções sobre `git gui` e `gitk`
+
+![](./images/gitg.png)
+FIGURA: Interface `gitg`
+
+![](./images/gitx.png)
+FIGURA: Interface `gitx`
 
-* git-cola  
-* Smart-Git  
+#### RabbitVCS ####
 
-Escolhidas por serem multiplataforma (Windows, Linux/Unix e MacOS)
+*RabbitVCS* é uma coleção de ferramentas gráficas para navegadores de
+ arquivos dos sistemas LINUX que permitem o acesso simples e direto aos
+ sistemas de controle de versão, GIT e/ou Subversion. Não se caracteriza
+ como interface, porém altera a visualização no navegador de arquivos de
+ diretórios sob versionamento GIT além de dispor de ações implementadas
+ nas opções do menu quando pressionado o botão direito do mouse.
 
-Plugins e extensões, comentar a utilização do **GIT** em editores já
-utilizados pela comunidade estatística. 
+![](./images/rabbitvcs.png)
+FIGURA: Navegador *Nautilus* com uso do `RabbitVCS`
 
-* Emacs (`magit`)
-* RStudio
-* Gedit
+Na figura ?? temos o *screenshot* do repositório `meu1repo` no navegor
+de arquivos `nautilus` (padrão do sistema Ubuntu 14.04). Perceba que com
+essa interface os ícones de arquivos e pastas no navegador ganham
+destaque com um outro pequeno ícone na paste inferior. Estes pequenos
+ícones indicam o estado do arquivo sem precisar recorrerao terminal, ou
+seja, temos um `git status` no próprio navegador de arquivos. Além disso
+`RabbitVCS` complementa o menu de opções acessados com o botão direito
+do mouse. As opções implementadas neste menu são muito completas, vão
+desde simples *commits*, criação de *branchs* e *tags* até a ações de
+reverter o estado do repositório.
+ 
+#### git-cola ####
+
+Esta também é uma interface alternativa que se destaca por ser completa
+e pela portabilidade (disponível para sistema LINUX, Windows e
+Mac. Implementada em *python* `git-cola` é uma alternativa à `git gui`
+e contém praticamente os mesmo elementos para alterações no
+repositório. Como `git gui` se auxilia da `gitk` para visualização,
+`git-cola` também tem uma interface de apoio, chamada de `git-dag` que
+vem instalado junto ao `git-cola`.
+
+![](./images/git-cola.png)
+FIGURA: Interface `git-cola` e `git-dag`
+
+Perceba pela figura ?? que as opções das interfaces são muito similares
+as apresentadas em `git gui` e `gitk`. As interfaces `git-cola` e
+`git-dag` se destacam pela fácil manipulação do layout exibido, além de
+buscar deixar a interface o mais intuitiva possível. Como destaque em
+implementação de funcionalidade GIT, `git-cola` se sobresai com relação
+à `git gui` na possibilidade de execução do comando `git rebase` via
+interface. 
+
+#### Plugins e extensões para editores ####
+
+Muitas vezes é inconveniente trabalhar em códigos fonte em um editor e
+ter que abrir um terminal *bash* em outra janela do sistema operacional
+para verificar o sistema versionamento, realizar commits,
+etc. Felizmente alguns editores possuem um sistema **GIT** integrado,
+seja por meio de *plugins* adicionais instalados ou opção nativa do
+editor.
+
+Destacamos aqui três editores, comumente utilizados pela comunidade
+estatística, que possuem os comandos **GIT** intergrado à sua
+interface. São eles o `emacs`, onde temos as opções de *buffers* no
+editores onde podemos abrir uma isntância *shell* e executar os comandos
+**GIT** junto com o desenvolvimento do código fonte. Além disso uma
+extensão bastante poderosa está disponível e em desenvolvimento para o
+**GIT** no `emacs`, de nome `magit`[^magit] esta extensão proporciona
+opções de comandos e visualização em um *buffer* do editor que facilitam
+muito o trabalho de verisionamento. Outro editor também muito utilizado
+em Estatística, talvez o mais utilizado pela comunidade, é o RStudio que
+também implementa em sua interface vários comandos **GIT**, assim como
+as interfaces anterioremente descritas e de para tarefas não triviais
+uma chamada do terminal *Shell* é possível dentro do aplicativo. As
+diversas ferramentas do editor RStudio serão exploradas no capítulo ??,
+com exemplos e ilustrações voltadas para a comunidade estatística.
 
 ## Interfaces de comparação ##
 
@@ -75,3 +312,7 @@ grande valia.
 Citar materiais de referência para instalação e
 utilização.
 
+<!-- Exclui o repositório criado para exemplicação -->
+
+
+[^magit]: http://magit.vc/