Crie um slug de URL a partir de uma branch Git

A capacidade reconhece o primeiro segmento do caminho como o tipo da branch, mantém tudo o que vem depois como parte descritiva e normaliza esse conteúdo em palavras minúsculas separadas por hífens. O processo é determinístico, dispensa acesso à rede e informa um erro claro quando existe um prefixo, mas não há uma descrição aproveitável.

Separe os metadados do fluxo da descrição útil

Equipes que usam Git normalmente iniciam nomes de branches com um tipo de fluxo, como feature, fix, chore, release ou docs. Esse primeiro segmento ajuda pessoas e automações a entender por que a branch existe, mas em geral é ruído em uma URL pública. Esta capacidade considera o texto antes da primeira barra como o prefixo de tipo e deriva o slug somente do conteúdo posterior. Por exemplo, feature/add-user-login vira add-user-login, enquanto fix/checkout/payment-timeout resulta em checkout-payment-timeout. Caminhos descritivos aninhados são preservados como palavras, em vez de descartados, permitindo que sua equipe mantenha escopos relevantes sem expor barras na URL final. Um prefixo opcional refs/heads/, frequentemente retornado por ferramentas Git e sistemas de integração contínua, é removido antes da interpretação. A operação não mantém uma lista fechada de tipos aceitos. Qualquer primeiro segmento não vazio pode ser o prefixo, portanto a mesma regra funciona com convenções locais como spike, experiment, maintenance ou um fluxo de chamados definido pela sua organização.

Entenda exatamente como o slug é normalizado

Depois de selecionar a parte descritiva, o algoritmo aplica uma sequência estável de transformações. Ele remove espaços das extremidades, normaliza caracteres latinos acentuados, converte letras em minúsculas, troca cada sequência que não seja formada por letras ASCII ou dígitos por um hífen e elimina hífens no início e no fim. Barras, espaços, sublinhados, pontuação e separadores repetidos passam, assim, à mesma forma segura para URL. Uma branch como feature/Account Settings_v2 se torna account-settings-v2. O resultado é intencionalmente previsível: não há modelo de linguagem, dicionário, consulta de rede, valor aleatório, horário nem estado do repositório. A função não inventa palavras nem tenta interpretar identificadores de chamados. Números existentes na descrição continuam presentes, o que ajuda em nomes como fix/PROJ-482-login-loop. Como a normalização pode remover símbolos e sistemas de escrita não compatíveis, a capacidade ainda verifica se resta ao menos uma letra ou um número utilizável. Se a descrição contiver apenas pontuação ou caracteres incapazes de formar o slug ASCII aceito, será retornado um erro de entrada em vez de um valor vazio silencioso.

Use o resultado com segurança em publicações e automações

O objeto retornado contém um único campo, slug, e pode alimentar diretamente uma prévia de documentação, uma URL de ambiente efêmero, um caminho de notas de versão, uma página de alterações ou um fluxo de publicação de pull requests. Valide o resultado antes de reservar uma rota caso seu destino imponha regras adicionais, como comprimento máximo, caminhos protegidos ou exigência de exclusividade. Esta capacidade não consulta seu roteador, provedor de hospedagem, serviço Git ou banco de conteúdo, portanto não sabe se o slug já está ocupado. Ela também não verifica se a string fornecida corresponde a uma branch existente; apenas aplica a convenção documentada. Branches sem barra, nomes que terminam logo após o prefixo e descrições normalizadas como slug vazio são rejeitados. Essa falha rigorosa é útil em automações porque uma origem malformada não publica acidentalmente em uma rota vazia ou genérica. Em automações via API, cada solicitação usa o preço-base publicado de US$ 0,002. A mesma transformação determinística pode ser executada no navegador para conversões individuais rápidas.