WEB COM FARINHA

Git: Juntando vários Commits em um só usando SQUASH

Matheus — Sun, 20 Jan 2013 18:26:10 +0000

Hoje, deixo aqui uma dica bastante legal a ser utilizada no versionamento de seus códigos utilizando Git.

Situação

Você está com o código de seu projeto organizado e versionado com Git. Para desenvolvimento de novas funcionalidades, você adota a boa prática do uso de branches, assim como para correções de erros também – bugfixes.

Adotando o fluxo recomendado em um versionamento Git, teríamos um ambiente semelhante a figura abaixo:

http://git-scm.com/images/about/branches@2x.png

Seu código em produção, funcional, testado, aprovado, estaria no branch master. Para desenvolvimento, sempre teríamos um branch específico (neste caso chamado develop), do qual criaríamos branches para cada funcionalidade, correção de bugs ou códigos adicionais. Assim, sempre ao término do desenvolvimento de um branch, faríamos um merge com o develop, resolveríamos os conflitos, faríamos testes e posteriormente jogaríamos o código pronto e funcional no branch principal (master).

No fluxo normal de seu trabalho na correção de um bug no código vc seguirá (geralmente) as seguintes etapas:

criação de um branch bugfix a partir do branch develop.
desenvolvimento no branch bugfix de seu código para corrigir o erro.
merge/rebase dos branches develop e bugfix
rebase/merge no branch master com o branch develop

Problema

Como convenção de versionamento adotada na sua equipe na correção de bugs, o código retificado (com a solução do problema) deve ir para produção (branch master) em um único commit. Contudo, você como bom desenvolvedor e versionador Git, adota também a máxima “Commit all the time” para proteger seu código garantindo bom versionamento.

Como Fazer?

Em seu desenvolvimento, não tenha medo ou preguiça de commitar. Em nosso caso, suponhamos que em seu branch bugfix vc realizou os seguintes commits:

Commit #1: inserindo novos testes para correção do bug;
Commit #2: implementando lógica para que os testes funcionem;
Commit #3: mais implementações para que os testes funcionem

Você consegue resolver o bug apresentado em seu código. Quando olha o status de seu branch percebe que ele possui 03 commits. Mas, para o merge com o branch develop, precisa ir tudo em um commit único. Como fazer? Simples:

$ git checkout develop

$ git merge — squash bugfix

Veja o status de seu branch develop. Perceba que o Git trouxe para você todos os commits realizados em seu branch bugfix, mas não realizou ainda o commit no develop. Ele pega todos os arquivos, aplica o merge, porém deixa-os na staging area preparados para commit. Assim, basta você agora realizar um:

$ git commit -m “adicionando correcao do bug foo bla”

que todos os commits do branch bugfix virarão um único commit no branch develop.

O squash é muito útil, pois o desenvolvedor precisa commitar o tempo todo em seu ambiente de desenvolvimento garantindo a segurança de seu código e para manter o branch master mais clean e fácil de visualização, pois neste caso, toda a correção do bug estaria representado na linha do tempo por um único commit.

Palestra: Git: Primeiras Impressões e Primeiros Passos

Matheus — Fri, 11 Jan 2013 00:28:45 +0000

Realizei no último dia 09 deste mês de Janeiro uma mini-palestra sobre o sistema de controle de versão distribuído mais conhecido e utilizado do momento: Git. A apresentação fez parte do primeiro encontro (de muitos que virão) do CPDx: Ciclo de Palestras para Desenvolvedores.

O CPDx é uma iniciativa de servidores do Centro de Processamento de Dados da Universidade Federal da Bahia (da qual faço parte desde Outubro/2012) para promover a discussão de tecnologias de desenvolvimento de software e tópicos relacionados. O formato dos encontros semanais são palestras com duração de 20 a 30 minutos, seguidos de 20 minutos de discussão.

E aproveitando a “vibe”, o blog estará de volta com novos posts inclusive uma série de artigos sobre versionamento de código com Git.

Deixo abaixo, link para os slides da palestra:

https://speakerdeck.com/matheuslao/git-primeiras-impressoes

Introdução às Metodologias Ágeis

Matheus — Sat, 06 Nov 2010 21:03:20 +0000

Processos ágeis de desenvolvimento de software. Assunto bom de estudar, discutir! Aqui no blog ainda não escrevi post nenhum, porém venho ao longo do ano lendo, conhecendo mais sobre esta nova maneira de enxergar o desenvolvimento de software e o trabalho em equipe.

Iniciei na metade do ano de 2010 uma Pós Graduação em Qualidade em Tecnologia da Informação (falarei posteriormente em outros posts, sobre minhas expectativas e críticas) e de cara, em minha segunda matéria com o tema de Processos de Software, preciso fazer um trabalho sobre Processos Ágeis.

Bacana, não? Matei 2 coelhos de uma vez só! Estudo o que gosto para a pós e para meus projetos/satisfação pessoal!

Pois bem, então para estrear, segue abaixo o resultado da matéria: um pequeno artigo que escrevi com Alexsandro Oliveira e Vinicius Correa resumindo um pouco sobre o que são estas metodologias ágeis, assim como um slidecast (sim, resolvi me arriscar a fazer) sobre o tema.

Clique aqui para assistir o vídeo inserido.

Codificação do Banco de Dados com Ruby on Rails

Matheus — Thu, 30 Sep 2010 23:55:31 +0000

Saudações!

Desenvolvendo um aplicativo exemplo com Ruby on Rails deparei-me com a seguinte situação: Criei um model para representar os estados brasileiros e decidi em sua migration, além de criar a tabela com os atributos necessários, aproveitar e popular o banco com os estados brasileiros.

Meu arquivo ficou assim:

class CreateStates < ActiveRecord::Migration
def self.up
create_table :states do |t|
t.string :name, :nil => false, :limit => 255
t.string :acronym, :nil => false, :limit => 2
t.timestamps
end

State.create(:name => "Amazonas", :acronym => "AM")
State.create(:name => "Amapá", :acronym => "AP")
State.create(:name => "Bahia", :acronym => "BA")
State.create(:name => "São Paulo", :acronym => "SP")
State.create(:name => "Rio de Janeiro", :acronym => "RJ")
State.create(:name => "Espírito Santo", :acronym => "ES")
State.create(:name => "Minas Gerais", :acronym => "MG")
State.create(:name => "Sergipe", :acronym => "SE")
State.create(:name => "Alagoas", :acronym => "AL")
State.create(:name => "Pernambuco", :acronym => "PE")
State.create(:name => "Paraíba", :acronym => "PB")
State.create(:name => "Rio Grande do Norte", :acronym => "RN")
State.create(:name => "Maranhão", :acronym => "MA")
State.create(:name => "Ceará", :acronym => "CE")
State.create(:name => "Piauí", :acronym => "PI")
State.create(:name => "Pará", :acronym => "PA")
State.create(:name => "Roraima", :acronym => "RR")
State.create(:name => "Rondonia", :acronym => "RO")
State.create(:name => "Mato Grosso do Sul", :acronym => "MS")
State.create(:name => "Mato Grosso", :acronym => "MT")
State.create(:name => "Goiás", :acronym => "GO")
State.create(:name => "Paraná", :acronym => "PR")
State.create(:name => "Santa Catarina", :acronym => "SC")
State.create(:name => "Rio Grande do Sul", :acronym => "RS")
State.create(:name => "Acre", :acronym => "AC")
end

def self.down
drop_table :states
end
end

Somente que, quando executei meu rake db:migrate fui apresentado ao seguinte erro:

db/migrate/20100930232925_create_states.rb:10: invalid multibyte char (US-ASCII)

Neste meu exemplo, utilizei o SQLite. Como a própria descrição do erro mostra (mensagens de erros com RoR são autoexplicativas em sua maior parte), há um erro na codificação do caracter que não está sendo interpretado corretamente pelo banco de dados.

Como solucionar?

Simples, basta no início do arquivo passarmos um comentário mágico (magic comment) que diz qual o tipo de codificação, que no nosso caso é o utf-8:

# coding: utf-8
class CreateStates < ActiveRecord::Migration
def self.up
create_table :states do |t|

LinguÁgil: Misturando Linguagens e Agilidade

Matheus — Thu, 09 Sep 2010 21:52:04 +0000

Próxima semana acontecerá aqui em Salvador um evento muito bacana: o LinguAgil 2010.

Tive a oportunidade de participar do evento no ano passado no dia das palestras e fiquei muito contente com o conteúdo apresentado, as pessoas que estavam organizando o evento e o clima cujo lema o evento prega: ‘Misturando Linguagens e Agilidade’.

Foi em 2009 que conheci o movimento Agile, comecei a ler sobre SCRUM, XP, conheci o Ruby e o Rails, e as palestras apresentadas no encontro cairam como uma luva e me fizeram ter certeza que o caminho que queria seguir/estudar era este. Curti todas as palestras, destacando em particular as apresentações do Alexandre Gomes com a participação do Serge Rehem sobre o Manifesto 2.0 e a palestra do Daniel Lopes sobre Ruby on Rails, pois era o que eu estava conhecendo na época(e ainda estou).

Um ponto negativo que observei não foi o evento em si, mas a quantidade de pessoas que estavam presentes no dia das palestras: muito pouca. E olha que ano passado as palestras foram gratuitas! Não recordo se faltou uma divulgação considerável ou se realmente as pessoas aqui em Salvador são pouco interessadas em participar de eventos, encontros, mini-cursos na área de TI. Atenta-se também que em 2009 foi a primeira edição do LinguÁgil, portanto o networking ainda estava nascendo.

Edição de 2010

Este ano, a organização do LinguÁgil em minha opnião “botou pra lenhar”, como dizem por aqui na Bahia. Trazer para palestrar e/ou ministrar cursos Fábio Akita, Guilherme Chapiewski, Alexandre Gomes, e muitos outros exímios desenvolvedores assim como excelentes profissionais daqui da terrinha é sem dúvida, programação insubstituível para o próximo fim de semana (praia, clube ou outro evento que me desculpem).

Fica aê minha dica:

Se você gosta de desenvolver/programar seja em qualquer linguagem;
Se gosta de metodologias de desenvolvimento seja ela qual for, e se de preferência, for uma metodologia que evangeliza agilidade;
Se você curte conhecer novas pessoas, aumentar sua rede de relacionamentos, conhecer outros projetos, ideias;

Então,

Não deixe de participar do LinguÁgil 2010. Confira o site do Evento:

http://www.linguagil.com.br/

calendar_date_select: Calendário Javascript no Rails

Matheus — Tue, 31 Aug 2010 04:02:05 +0000

Continuando minha jornada no aprendizado do Rails, deparei-me com a tarefa de preencher um formulário com datas. A opção de disponibilizar ao usuário a visualização de um calendário para escolha de uma data é bastante aplicada hoje em dia devido a facilidade e beleza disponibilizada.

Com o Rails, dei uma olhada na gem calendar_date_select e este atendeu às necessidades além de ser muito fácil configurar e inserir em seu código.

Instalando

Bem, utilizei para exemplo Rails 2.3.8.

Caso você deseje apenas instalar em um projeto, escolha:

$ cd my_app

$ script/plugin install http://calendardateselect.googlecode.com/svn/tags/calendar_date_select

Isto instalará o plugin dentro do diretório my_app/vendor/plugins

Você também pode optar por instalar a gem em seu ambiente

$ gem install calendar_date_select

sendo a versão mais atual até a confecção deste post a 1.6.1 e adicionar ao arquivo environment.rb a dependência de sua aplicação com a gem:

config.gem "calendar_date_select"

Utilizando

De forma simples e resumida, primeiramente, devemos adicionar em nosso layout, a chamada para os arquivos javascripts do Rails:

<%= javascript_include_tag :defaults %>

em seguida a chamada aos arquivos javascript e css do calendário:

<%= calendar_date_select_includes "silver"%>

O calendar_date_select proporciona diversas maneiras de utilização. Você pode conferir diversas formas de integração com o seu projeto no site demo. No caso mais simples, para a inserção de uma data em um formulário, apenas adicionamos na view do formulário:

<%= calendar_date_select_tag "minha_data" %>

No meu caso, como a data é um atributo de meu modelo Edição do Evento, associei-o:

<% form_for([@event, @event_edition]) do |f| %>
<%= f.label :start_date %>

<%= calendar_date_select_tag "event_edition[start_date]", @event_edition.start_date %>
<% end %>

Retorno de Valor com o Operador IF

Matheus — Wed, 04 Aug 2010 19:19:16 +0000

Quando escrevemos métodos em Ruby, sabemos que a última linha lida/executada no método corresponde ao valor de retorno deste.

A dica rápida de hoje é que, apesar do operador IF “não ser um método”, ele também retorna uma resposta! Observe o exemplo:

ensolarado = true
local = if ensolarado
"praia"
else
"cinema"
end

Bem melhor do que atribuir o valor para a variável ‘local’ dentro dos blocos não é?

Autenticação no Ruby on Rails com Devise

Matheus — Mon, 02 Aug 2010 23:06:21 +0000

Resolvi utilizar o Devise para autenticação de usuários no rails. Existem outras alternativas como Authologic, Clearance, etc. Não sei responder qual destas é a melhor ou mais completa. Contudo, após uma pesquisa em fóruns e na comunidade ativa do rails, percebi que muitos adotam o Devise para autenticação e o CanCan para autorização (falarei mais adiante sobre ele) em projetos que necessitam destes recursos. Logo, cabe a você, desenvolvedor, escolher os recursos que mais lhe agradem e que resolvam as suas necessidades e problemas.

Um bom espaço para conhecer o Devise é no blog da empresa que desenvolveu a gem. Tanto no blog da PlataformaTec quanto no github do projeto, existem diversos documentos que fornecem uma excelente documentação para quem quer utilizar o Devise.

Neste primeiro post, vou mostrar procedimentos básicos, mas suficientes para integrar e configurar o Devise com seu projeto.

Condições Iniciais

Primeiramente, deixo aqui a configuração do ambiente que utilizei para este post:

Ubuntu 10.04
Ruby 1.8.7 MRI
Rubygems 1.3.7
Rails 2.3.8

Instalando a GEM

Para minha configuração, segundo a documentação do Devise até a data deste post, a versão da gem que preciso instalar é a 1.0.8. Se você já está utilizando Rails 3, consulte a página do Devise para saber qual a melhor versão indicada.

$ sudo gem install devise -v 1.0.8

Este comando, instalará o devise e o warden (necessário para o correto funcionamento).

Você pode verificar se as gems foram instaladas através de:

$ gem list

Configurando

Precisamos informar ao rails do nosso projeto que este dependerá da gem Devise. No arquivo enviroment.rb adicionamos a seguinte linha:

config.gem "devise", :version => "1.0.8"

A informação da versão é opcional, porém por questões de compatibilidade com o projeto, achei conveniente informar. Se você desejar vendorizar a gem para a sua aplicação (importar para /vendor/gems) execute:

rake gems:unpack

Isto importará a gem Devise, ou ainda

rake gems:unpack:dependencies

que vendorizará as gems necessárias e todas as suas dependências (neste caso Devise + warden). Depois rodamos o seguinte comando rake:

rake gems:build

Utilizando o Devise

Vamos criar uma aplicação em que existirá uma seção Eventos onde somente usuários cadastrados no site podem acessar a página. Utilizando o scaffold para agilizar esta parte:

$ script/generate scaffold Event name:string info:text

Feito isto, iniciamos o uso do Devise, onde precisamos rodar primeiramente a instalação do devise em nossa aplicação:

$ script/generate devise_install

Assim que voce rodar o comando acima, 3 passos da configuração deverão ser feitas manualmente:

1. Adicionar em config/enviroments/development.rb a seguinte linha:

config.action_mailer.default_url_options = { :host => ‘localhost:3000′ }

(caso o endereço do host de desenvolvimento seja este)

2. Verificar se no arquivo de rotas (config/routes.rb) existe a definição de uma url root como:

map.root :controller => ‘home’

3. Verificar se existe o arquivo de layout padrão (views/layouts) e a chamada de mensagens flash

<%= flash[:notice] %>

<%= flash[:alert] %>

Agora, podemos criar nosso model User com a autenticação:

$ script/generate devise User

Caso o model User já exista não tem problema, pois o Devise apenas adicionará todos os recursos necessários para a autenticação.

Repare agora que alguns arquivos foram criados como a migration para criação da tabela de usuários no banco de dados assim como o model user.rb. Vale a pena conferir a estrutura e o conteúdo destes arquivos para entender quais campos são criados e habilitar os recursos necessários para seu projeto.

Verifique também em seu arquivo config/routes.rb se foi adicionado a seguinte linha:

devise_for :users

Feito isto, atualizamos nosso banco de dados com:

$ rake db:migrate

Observe que a autenticação já funciona! No nosso caso, possuímos os seguintes endereços:

localhost:3000/users_sign_in : fazer login (iniciar sessão)
localhos:3000/users_sign_out :fazer logout (destruir sessão)
localhost:3000/users_sign_up : cadastrar novo usuário

No controller de Eventos, basta adicionar

before_filter :authenticate_user!

que habilitará a necessidade da autenticação de um usuário para todas as actions do Evento.

Conclusão

Em outros posts, falarei mais sobre algumas configurações que o Devise proporciona. Mas nada impede de olhar a documentação dele que é muito fácil e completa! Recomendo também fortemente assistir os episódios do RailsCasts sobre o Devise.

Valeu!

Exemplos e Demonstrações do HTML5

Matheus — Sat, 22 May 2010 12:18:40 +0000

HTML5…..

Assunto que está bombando no nosso meio. Confesso que ainda não iniciei meus estudos na nova versão da linguagem pois há ainda muito que aprender em outros tópicos. Porém, é fato que não se pode fechar os olhos e não acompanhar as novidades nas especificações além dos belos e eficientes exemplos que surgem a cada dia.

O HTML5 veio para ficar e junto com outras “evoluções” de outras linguagens, técnicas, vêem com o intuito de melhorar o modo como fazemos a web trazendo um pouco mais de semântica. Claro que tudo depende de quem está entre o monitor e a cadeira corcordam?

Venho neste post mostrar um site interessante: o HTML5 Demos. Um site que mostra alguns recursos e novidades da nova versão da linguagem como vídeo, áudio, canvas, geolocalização e muito mais. O bacana também é que o espaço fornece uma amostra de quais novos recursos são compatíveis com os principais navegadores. Vale a pena conferir:

http://html5demos.com/

Sites para Auxiliar o Desenvolvedor Web

Matheus — Thu, 20 May 2010 01:08:32 +0000

Existem centenas de sites na web que fornecem serviços que podem auxiliar o desenvolvedor em sua tarefa. Abaixo, seguem alguns sites que podem ajudar você na execução de seus projetos

MySql Format Date

Problemas em escrever ou executar queries no MySql com datas? Este site bem bacana fornece a opção de você configurar o formato de data que você deseja de retorno em sua query e ele gera para vocẽ o código para inserir em sua implementação. O site baseia-se na funçao MySQL DATE_FORMAT.

Visite o site: http://www.mysqlformatdate.com/

Script Src

Achei esta ideia bem bacana. O site fornece a opção de você copiar a script tag da última versão de várias bibliotecas Javascript. Não sabe qual a última versão do jQuery, Mootools, Prototype? Basta acessar o site e obter o código completo para inserir em seu projeto.

Por exemplo: Para o jQuery ele fornece-me o seguinte resultado:

Visite site: http://scriptsrc.net

EmChart

Para quem não gosta ou não tem muita familiaridade com tamanho de fontes na unidade de medida ‘em’, este site pode ajudar. É uma planilha com a relação entre as unidades em e pixel. Vale a pena dar uma olhada

Visite site: http://aloestudios.com/tools/emchart

Smush it

Serviço online oferecido pelo Yahoo com o intuito bem simples: reduzir o tamanho de suas imagens web sem perda de qualidade. Bacana os comparativos apresentados além da existência de um plugin para o WordPress que você encontra aqui.

Visite site: http://developer.yahoo.com/yslow/smushit/

Quer mais?

Se você deseja encontrar mais sites com serviços que auxiliam no desenvolvimento web não deixe de conferir o artigo original que possue mais algumas dicas.

Artigo original no CatsWhoCode