Orientações para Desenvolvedores (Git Hooks)

Versionamento das distribuições em desenvolvimento

Considerando o alto dinamismo do código das versões em desenvolvimento, foi proposto a adição do último commit realizado à tag de versão das distribuições dev (e.g. 4.0-dev_40e7fbadcf4fb92229c281122b64b276d5c0ab94), de modo a facilitar a identificação de bugs e acompanhamento dos issues abertos.

Para isso, considerou-se:

toda e qualquer informação de versão é lida/registrada no arquivo de metadados exigido pelo QGIS (metadata.txt);
recuperação do último commit por meio do uso de Git Hooks;
o registro e atualização dos hooks serem utilizados deve ser parte do repositório da aplicação, uma vez que toda e qualquer mudança deve ser replicável para os demais desenvolvedores.

Procedimentos

Para o correto funcionamento dos hooks criados para o funcionamento do DSGTools, executar os passos:

clonar o repositório do DSGTools;

git clone https://github.com/dsgoficial/DsgTools

ir ao diretório base do DSGTools;

cd DsgTools

configurar a variável referente ao diretório de hooks do git para a pasta com os hooks do DSGTools;

git config core.hooksPath hooks/

Informações Complementares

Vale destacar alguns pontos:

o nome do arquivo dentro da pasta hook define o "instante" de execução do script durante o processo de funcionamento do git;
o arquivo deve ser executável (chmod +x file);
não há restrição de linguagem, mas há de se observar o que consta no item anterior. A adição de shebangs (#!/usr/bin/python) no começo do arquivo é importante para a definição de qual executável irá "usar" o script;
como a modificação de qualquer arquivo no repositório altera a hash do commit, a hash associada às versões dev são referentes ao commit anterior ao mais recente (logo, o último commit que já foi realizado); e
versões estáveis não possuem um commit associado à sua tag.