Validador de nomes de branches git

Nomes vazios falham com invalid_input, assim como caracteres inseguros comuns em refs git, como espaços, pontos consecutivos e pontuação proibida.

Como o padrão de convenção funciona e o que é extraído

Se a branch não coincidir com o padrão inteiro, a tarefa falha com invalid_input e uma mensagem que cita a branch e a convenção para que os desenvolvedores corrijam o nome ou a política de um só olhar.

Contrato de entrada, checagens de segurança e formato da resposta

Caracteres de controle também são rejeitados. Chaves de saída opcionais são omitidas em vez de definidas como null. Validação falha não é cobrada. Combine a resposta com sua própria camada de política se precisar de uma lista permitida de valores de type como feature, fix, chore ou release; esta capacidade verifica a estrutura e extrai partes, não codifica o vocabulário de uma única organização. Envie por POST um corpo JSON com duas strings obrigatórias: branch, o nome candidato da branch git, e convention, o modelo de nomenclatura. Aliases são aceitos por conveniência—branch_name, name e ref para o campo da branch; pattern, format e template para o da convenção—mas os nomes canônicos aparecem na documentação e nos SDKs. Ambos os campos devem ser não vazios após rejeitar apenas espaços em branco; uma branch vazia é sempre invalid_input porque o git não pode criar uma ref de comprimento zero e a automação que esquece de passar o nome deve falhar de forma fechada. No sucesso o corpo inclui valid true, a branch e a convenção ecoadas, um objeto components mapeando cada nome de marcador ao valor capturado, component_names na ordem do modelo e component_count.

Onde um validador de nomes de branch entrega valor

Jobs de integração contínua usam um validador de convenção de nomes de branches git como primeiro passo do pipeline para que pull requests abertas com nomes ad hoc nunca cheguem a estágios caros de build. A automação de release extrai o componente ticket para abrir ou atualizar issues no tracker, e extrai o componente type para escolher seções do changelog sem gambiarras frágeis de substring. Sites de conteúdo que ranqueiam por validador de convenção de nomes de branch git se beneficiam de um formulário ao vivo cujo caminho gratuito coincide byte a byte com o caminho de automação paga. Equipes de plataforma que operam muitos repositórios publicam uma única string de convenção no portal de desenvolvedores e apontam cada modelo, bot e checklist para este endpoint, de modo que uma mudança de política seja uma única edição de string e não uma caça por scripts de shell. Como a implementação é pure parse de nível A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo e sem rede de saída.