Como usar o Repositório do Interlegis

O repositório do Interlegis é baseado no Subversion que é um Sistema de Controle de Versões como o CVS mas com algumas melhorias e facilidades. Se você precisar de informações mais detalhadas sobre o uso do Subversion, leia  um excelente e didático artigo sobre o tema.

Para baixar o SAAL, por exemplo, diretamente do repositório pela primeira vez, abra um terminal shell do Linux, vá para o diretório 'Products' da sua instância de Zope e digite:

$ svn co http://repositorio.interlegis.gov.br/ILSAAL/trunk/ ILSAAL

Agora baixe cada módulo do SAAL que você deseja instalar:

$ svn co http://repositorio.interlegis.gov.br/ILSAALContabilidade/trunk/ ILSAALContabilidade
$ svn co http://repositorio.interlegis.gov.br/ILSAALFolhaPagamento/trunk/ ILSAALFolhaPagamento
$ svn co http://repositorio.interlegis.gov.br/ILSAALMaterial/trunk/ ILSAALMaterial
$ svn co http://repositorio.interlegis.gov.br/ILSAALOrcamento/trunk/ ILSAALOrcamento
$ svn co http://repositorio.interlegis.gov.br/ILSAALPatrimonio/trunk/ ILSAALPatrimonio
$ svn co http://repositorio.interlegis.gov.br/ILSAALRecursosHumanos/trunk/ ILSAALRecursosHumanos
$ svn co http://repositorio.interlegis.gov.br/ILSAALTesouraria/trunk/ ILSAALTesouraria

Ou para baixar todo o SAAL e suas dependências use o comando:

$ svn co http://repositorio.interlegis.gov.br/bundles/saal_trunk

Para atualizar os seus fontes com os últimos fontes do Repositório Interlegis, vá para o diretório 'Products' da sua instância de Zope, vá para o diretório do(s) módulo(s) do SAAL que você deseja atualizar e digite:

$ svn up

Documentos úteis para o Desenvolvimento

•  PEP 8 - Guia de Estilo Para Python
• Solucionar Conflitos no Desenvolvimento

Site oficial do Subversion

•  http://subversion.tigris.org/

Para baixar o Subversion

•  http://subversion.tigris.org/project_packages.html

Para aprender mais sobre o Subversion

•  http://svnbook.red-bean.com/
•  http://www.pronus.eng.br/artigos_tutoriais/gerencia_configuracao/subversion.php
•  http://www.pronus.eng.br/artigos_tutoriais/gerencia_configuracao/controle_versao.php

Interfaces gráficas para o Subversion

•  http://rapidsvn.tigris.org/
•  http://tortoisesvn.tigris.org/
•  http://jsvn.alternatecomputing.com/
•  http://esvn.umputun.com/trac.cgi/wiki

Demais projetos Subversion

•  http://scm.tigris.org/

Principais comandos do Subversion

Ajuda

$ svn help

ou

$ svn help comando

Obtenção dos arquivos da revisão atual

$ svn co http://nome.servidor/caminho/projeto nomeProjeto

ou de uma revisão específica:

$ svn co http://nome.servidor/caminho/projeto nomeProjeto -r 123

Atualização dos arquivos com a última revisão do repositório

$ svn up

Adicionar um novo arquivo

$ svn add arquivo.ext

Remover um arquivo

$ svn delete arquivo.ext

Copiar um arquivo

$ svn copy arquivo1.ext arquivo2.ext

Mover um arquivo

$ svn move arquivo1.ext arquivo2.ext

Obter informações sobre o estado da sua cópia de trabalho e a revisão atual

$ svn status

Comparar as alterações de sua cópia de trabalho e a revisão atual

$ svn diff arquivo.ext -r HEAD

Jogar fora todas as suas alterações locais em relação à revisão atual

$ svn revert

Fazer uma fusão entre as alterações da revisão atual e as alterações de sua cópia de trabalho

$ svn merge -r N:M FONTE

Marcar um conflito como resolvido em sua cópia de trabalho, após você ter resolvido esse conflito manualmente

$ svn resolved arquivo.ext

Verificar as anotações em cada modificação

$ svn log

Submeter todas as mudanças ao repositório (sempre depois de qualquer alteração)

$ svn commit -m 'Comentário sobre a mudança'

ou sobre um arquivo específico

$ svn commit arquivo.ext -m 'Comentário sobre a mudança'

Criação da base de dados

$ svnadmin create /local/repositorio

Importação inicial do projeto

$ svn import /local/projeto http://nome.seu.servidor/caminho/completo/repositorio -m "Importação inicial dos arquivos"

Palavras chave

HEAD

A última revisão no repositório

BASE

A revisão original de um item na cópia de trabalho

COMMITED

A última revisão em que um item mudou antes (ou em) BASE

PREV

A revisão exatamente anterior a última revisão na qual o item mudou

Desenho do repositório

trunk

Tronco principal de desenvolvimento do software

branches

Ramificações de versões ou alterações consideráveis no software que ainda estão em desenvolvimento ou processo de correção de bugs

tags

Imagens de versões do software que não sofrerão mais modificações (congeladas)

Estado do item

U - O arquivo foi atualizado

A - O arquivo foi adicionado

D - O arquivo foi deletado

R - O arquivo foi substituído

G - O arquivo recebeu novas alterações do repositório mas as suas alterações foram preservadas

C - O arquivo recebeu alterações conflitantes do repositório