Como Trabalhar com Branches do Sandbox Utilizando Comandos SVN

Como descrito anteriormente, tickets que exijam grandes modificações devem ser implementados em branches separados, ao invés de utilizar diretamente o trunk.

O primeiro passo é criar um novo branch:

  svn copy https://svn.expressolivre.org/sandbox/workflow/trunk 
           https://svn.expressolivre.org/sandbox/workflow/branches/{nnnn} 
           -m "Ticket #{nnnn} - Criando novo branch para implementação do ticket."

O comando svn copy é utilizado para a criação de branches. Na forma que é mostrado acima, este comando não precisa ser executado a partir de um repositório svn, todo procedimento é realizado no servidor. O primeiro parâmetro é o branch de origem, de onde serão copiados os dados. Os branches criados para os tickets da versão experimental do Workflow devem sempre utilizar o repositório /sandbox/workflow/trunk como origem. O segundo parâmetro especifica o endereço do novo branch. O novo branch deve seguir o padrão /sandbox/workflow/branches/{nnnn}, onde {nnnn} corresponde ao número do ticket. Já o terceiro parâmetro, especificado pela opção -m, especifica a mensagem do commit que criará o novo branch. É importante notar que o commit inicial de criação do branch, será visível apenas ao novo branch, mas não através do branch de origem (trunk). Desta forma, a partir do repositório de origem, não é possível determinar o momento exato de criação dos branches.

Após criado, o branch pode ser acessado de duas formas:

  svn checkout https://svn.expressolivre.org/sandbox/workflow/branches/{nnnn}

  para criar uma nova cópia local do repositório já em seu novo branch

ou:

  svn switch https://svn.expressolivre.org/sandbox/workflow/branches/{nnnn}

  para mudar o branch de sua cópia local.

Se estiver trabalhando com mais de um branch e utilizar o svn switch para alternar entre eles, sempre verifique a qual branch sua cópia local está ligada, antes de alterar arquivos, ou realizar commits. Isso evitará atualizações indesejadas que depois ficam difíceis de reverter. Utilizar o comando svn info para mostrar a url do repositório.

Outros Comandos SVN Úteis

svn up	Atualiza a sua cópia local
svn st	Mostra os arquivos da sua cópia local pendentes de atualização no repositório
svn log	Lista as mensagens de commits já realizados
svn info	Mostra a url do repositório e a revisão em que está a sua cópia local
svn revert {arquivo}	Atualiza um arquivo local com a última revisão no repositório
svn ci -m "{mensagem}"	Realiza a transferência dos arquivos alterados na cópia local, para o repositório

Como Realizar o Merge de um Branch no Trunk

Depois que o branch estiver concluído e testado, chegou a hora de transferir as atualizações para o ramo trunk do sandbox. Primeiro obtenha uma cópia local do ramo trunk, com o comando:

  svn co https://svn.expressolivre.org/sandbox/workflow/trunk

Depois entre no diretório da sua cópia local do trunk e execute o comando:

  svn merge --dry-run -r{n1}:{n2} https://svn.expressolivre.org/sandbox/workflow/branches/{nnnn}

  onde {n1} corresponde a revisão inicial do branch e
  {n2} corresponde a revisão final do branch 

A opção --dry-run irá rodar o merge em modo simulação, sem que alterações sejam realizadas na sua cópia local do trunk. Será apresentada uma lista dos arquivos a serem atualizados. Observe o indicador no início de cada linha, ele informa o tipo de atualização que o arquivo sofrerá, podendo ser:

U - Arquivo da cópia local será atualizado

D - Arquivo da cópia local será excluído

A - Arquivo será incluído na cópia local

G - Arquivo da cópia local possui alterações conflitantes com o branch, mas o Svn fará o merge

C - Arquivo da cópia local possui alterações conflitantes com o branch, e será necessário intervenção manual para resolver o conflito.

Se quiser prosseguir com o merge, execute o comando novamente sem a opção --dry-run. Caso existam conflitos, o svn solicitará que sejam resolvidos neste momento.

Após o merge verifique se a sua cópia local continua integra, e proceda o commit no repositório:

  svn ci -m "Ticket #{nnnn} - Merged {n1}:{n2} /sandbox/workflow/branches/{nnnn} em /sandbox/workflow/trunk" 

Existe ainda mais um comando útil para verificar alterações (exemplo):

  svn diff -r{n1}:{n2} https://svn.expressolivre.org/trunk/workflow

Isso irá listar as modificações entre as revisões {n1} e {n2} do ramo indicado.

Como Gerar um Arquivo diff e Aplicar um patch

  diff -u arquivo.orig arquivo.atual > arquivo.diff

  patch -u arquivo.orig arquivo.diff