ATENÇÃO — MUDAMOS PARA O GITHUB

Endereço novo: https://github.com/oreio/funcoeszz

Estas são instruções de como adicionar uma função nova ao repositório SVN.

Obs.: Se você quer editar/atualizar uma função que já está no repositório, veja o tópico EditarFuncao.

Para os exemplos seguintes, vou usar a função zzchaves. Mas é claro, use o nome da sua função.

1. Baixe/Atualize o repositório

Se você ainda não fez, o primeiro passo é baixar o repositório das funções para a sua máquina. Para isso, siga as instruções do tópico BaixarRepositorioSVN.

Se você já baixou o repositório, é importante atualizá-lo antes de editar qualquer coisa. Vai que alguém mudou alguma coisa desde então? Basta executar o comando seguinte para o repositório local ser atualizado:

cd funcoeszz-svn
svn up

Nota: Você deve estar dentro do diretório funcoeszz-svn para executar este comando.

2. Copie a sua função para o repositório local

Você já fez sua função, certo? Caso ainda não, há um guia completo.

Copie o arquivo com a sua função para o diretório zz dentro do funcoeszz-svn:

cp /tmp/zzchaves ~/funcoeszz-svn/zz/

• O nome do arquivo deve ser zznomedafuncao, como por exemplo zzchaves.
• Dentro do arquivo deve haver somente a função e seu cabeçalho.
• Veja uma descrição do formato correto para a função e seu cabeçalho aqui.
• Na dúvida veja os outros arquivos do mesmo diretório para comparar com o seu.
• TESTE BASTANTE a sua função para ver se está tudo ok
• funcoeszz zzchaves --help funciona?
• Rode o script util/nanny que ele avisa se tiver problemas.

3. Adicione sua função ao repositório local

Somente copiar o arquivo para o diretório funcoeszz-svn não o inclui no repositório. É preciso fazer isso com o seguinte comando:

cd funcoeszz-svn/zz
svn add zzchaves

Obs.: Lembre-se de trocar zzchaves pelo nome da sua função

4. Envie sua função ao repositório remoto

Agora a submeta para o repositório oficial das funções, com o seguinte comando:

cd funcoeszz-svn/zz
svn commit -m "Função nova zzchaves - Repete a fala do Chaves" zzchaves

Use a opção -m para escrever a mensagem de log, no formato descrito do exemplo:

Função nova NOME_DA_FUNCAO - DESCRICAO_DA_FUNCAO

Pronto! Sua função já está disponível para todos a utilizarem.

5. Confira pela web

Confira pelo navegador que a sua função foi de fato adicionada ao repositório oficial.

• Lista de alterações do projeto: http://code.google.com/p/funcoeszz/source/list (Source → Changes)

• Lista de funções: http://code.google.com/p/funcoeszz/source/browse/#svn/trunk/zz (Source → Browse → trunk → zz)

6. Testes Automáticos

Agora que sua função está ativa, seria bom você adicioná-la na bateira de testes automáticos das funções, para ficar fácil saber se ela continua funcionando. Leia TestesAutomaticos.