revisão automática - Online na nuvem

PROGRAMA:

NOME

autorevision - extrai metadados de revisão atual de repositórios de controle de versão

SINOPSE

autorevisão {-t | -s } [-o [-f]] [-U] [-V]

DESCRIÇÃO

Extrai metadados sobre a revisão principal de seu repositório.

Este programa deve ser usado por sistemas de construção de projetos para extrair propriedades que podem
ser usado em strings de versão de software. Ele pode emitir arquivos de origem contendo variáveis ​​e
definições de macro adequadas para uso com C, C ++, Java, sh, Python, Perl, Mac info.plist e
outros tipos de arquivos (veja abaixo a lista completa).

A fonte gerada é gravada na saída padrão.

Este programa pode normalmente ser chamado de qualquer lugar dentro de uma cópia do repositório. Sob o bzr o
a cópia deve ser de um branch, não de um repositório multibranch completo. No Subversion deve ser
chamado em uma verificação do repositório, não no repositório em si.

Se você especificar um arquivo de cache, quando autorevisão é executado onde nenhum repositório pode ser
reconhecido, os valores do arquivo de cache serão usados. Se um repositório pode ser
reconhecido, o cache é reescrito. Este recurso possibilita que sua construção seja executada
de um tarball descompactado que inclui o arquivo de cache.

Válido Repositório Tipos
Git: Uma versão superior a 1.7.2.3 é recomendada.

mercurial: Uma versão superior a 1.6 é recomendada.

Subversão: Qualquer versão de produção.

Bazar: Qualquer versão de produção.

Válido saída Tipos
Clojure
Um arquivo de origem do clojure que define as variáveis ​​do clojure.

h
Um arquivo de cabeçalho adequado para C / C ++.

HP
Arquivo de cabeçalho C ++ alternativo com namespace. O namespace é atribuído a partir de VCS_BASENAME.

ini
Um arquivo de origem ini definindo variáveis ​​ini.

Java
Propriedades de classe de configuração de um arquivo de origem Java.

javaprop
Um arquivo de propriedades Java (como ini); útil quando META-INF é legível em Java.

js
Um arquivo de origem javascript configurando variáveis ​​javascript.

json
Um arquivo de formato JSON.

tomar
Um arquivo de origem lua que define variáveis ​​lua.

m4
Um arquivo de origem m4 que define macros m4.

Matlab
Saída Matlab.

oitava
Saída de oitava.

php
Um arquivo de origem PHP que define variáveis ​​PHP.

pl
Um arquivo de origem Perl configurando variáveis ​​Perl (perl é um sinônimo aceitável).

py
Um arquivo de origem Python que define variáveis ​​Python (python é um sinônimo aceitável).

rpm
Um formato de arquivo de especificação RPM definindo macros de arquivo de especificação.

esquema
Um arquivo de origem de esquema definindo variáveis ​​de esquema.

sh
Um arquivo de texto adequado para inclusão de um script bash. Funcionará com Ruby.

rápido
Um arquivo de origem do Swift que define constantes globais do Swift.

A menos que definido VCS_EXTRA e todos os símbolos que estão faltando por causa do repositório
o suporte é definido como nulo.

tex
Um arquivo fonte TeX que define macros TeX. Observe que os símbolos recebem nomes diferentes
já que o sublinhado tem um significado especial em TeX. Por exemplo, VCS_SHORT_HASH é
renomeado para \ vcsShortHash.

xcode
Um cabeçalho como a saída para uso com xcode para preencher strings info.plist.

Válido Símbolo Names
VCS_TYPE
O tipo de repositório - "git", "hg", "bzr" ou "svn".

VCS_BASENAME
O nome de base da raiz do diretório. Para a maioria dos VCSes, este será simplesmente o nome de base do
o diretório raiz do repositório. Para Subversion, autorevisão vai navegar para cima embora
diretórios de tronco, ramos e tags para encontrar a raiz real.

VCS_NUM
Uma contagem de revisões entre a atual e a inicial; útil para relatórios
construir números.

VCS_UUID
Um identificador universalmente exclusivo, gerado a partir do commit do root em git e hg; para svn
ele usa o UUID fornecido.

Para git, escolhemos o commit mais antigo se houver mais de um.

Atualmente não implementado para bzr.

VCS_DATE
A data da confirmação mais recente no verdadeiro formato ISO-8601 / RFC3339, incluindo segundos.

VCS_BRANCH
O nome da ramificação do gráfico de confirmação que foi selecionado quando a conversão automática foi executada.

No git, este será normalmente o apelido do branch atual (o asterisco
linha na saída de "git branch"), exceto que quando o branch não tem um
shortname será um refspec completo.

Em hg, o recurso que é chamado ramos é na verdade uma espécie de coloração de gráfico
(várias cabeças podem ter o mesmo nome de ramificação), portanto, este símbolo é preenchido com o
marcador atual, se existir, com o nome do branch atual como substituto.

No Subversion, isso normalmente será tronco ou o nome de base de algum branch ou
subdiretório de tag, dependendo de onde autoversão foi executado.

No bzr, este é o apelido do branch em que você está.

VCS_TAG
O nome da tag ancestral mais recente do commit atual.

Vazio no Subversion.

VCS_TICK
Uma contagem de commits desde o ancestral da tag mais recente até o commit atual ou um alias
of VCS_NUM se não houver tags anteriores.

Vazio no Subversion.

VCS_EXTRA
Um símbolo reservado especificamente para ser definido pelo usuário através do ambiente ou via
scripts.

VCS_FULL_HASH
Um identificador exclusivo completo para a revisão atual.

VCS_SHORT_HASH
Uma versão abreviada de VCS_FULL_HASH, mas VCS_FULL_HASH se não puder ser encurtado.

VCS_WC_MODIFIED
Defina como 1 se o diretório de trabalho atual foi modificado e 0 se não. Se o
a linguagem de saída tem literais booleanos nativos, verdadeiro significará modificado e falso
não modificado. A saída C / C ++ é deixada como numérica para que o pré-processador possa testá-la.
Não rastreado arquivos e guarante que os mesmos estão não ignorado; veja -U for Detalhes.

OPÇÕES

-t
Define o tipo de saída. É necessário, a menos que -s é especificado; Ambas -t e -s não pode ser
usado na mesma invocação.

-s
Altera o comportamento do relatório; em vez de emitir um arquivo de símbolo para stdout, apenas o
valor desse símbolo individual será relatado. É necessário, a menos que -t is
Especificadas; Ambas -t e -s não pode ser usado na mesma invocação.

-o
Define o nome do arquivo de cache.

-f
Força o uso de dados de cache, mesmo quando em um repo; útil para acelerar subsequente
é executado se mais de um formato de saída for necessário.

-U
Faz com que os arquivos não rastreados sejam verificados ao determinar se a cópia de trabalho foi modificada
for Subversão só. Embora este seja o comportamento padrão para todos os outros repositórios
tipos, ele está desativado por padrão para o Subversion por causa de questões de velocidade.

-V
Emite a versão de revisão automática e sai.

Use a revisão automática online usando os serviços onworks.net