Aspas argumento shell

O que é citação shell POSIX e o que esta ferramenta devolve

A resposta JSON sempre inclui result para a string transformada, mode ecoando encode ou decode, encoding fixo em posix_shell, e input_length mais output_length para testes afirmarem tamanhos. Encode também reporta needs_quotes e apostrophes_escaped; decode reporta quote_segments para confirmar quantas regiões citadas foram consumidas. Não há omissão silenciosa parcial para aspas quebradas: ou a palavra é citação shell bem formada ou a solicitação falha com invalid_input.

Como text e mode são lidos e como os resultados permanecem reproduzíveis

Encode classifica a string: vazia vira um par de aspas simples vazias; um token que corresponde ao conjunto seguro nu de letras, dígitos e arroba porcento mais igual dois-pontos vírgula ponto barra sublinhado hífen é devolvido inalterado porque não precisa de proteção; qualquer outro caractere, incluindo espaço, aspas ou metacaractere shell, força um envoltório completo em aspas simples com a emenda de apóstrofo para cada aspas simples interna. Como o envoltório é aplicado em uma única passagem da esquerda para a direita, você obtém uma forma de citação consistente alinhada ao espírito de shlex.quote e ajudantes shell comuns. Decode examina segmentos com aspas simples, segmentos com aspas duplas com o conjunto limitado de escapes POSIX e escapes de barra invertida sem aspas que protegem o próximo caractere ou continuam uma linha quando o próximo é uma nova linha. O campo preferido do payload é text, com aliases input, value, s, payload e arg para formulários, query strings e clientes SDK reutilizarem o mesmo contrato sem renomear colunas. Mode tem padrão encode e aceita decode explicitamente; aliases op, direction e action mapeiam para o mesmo interruptor em scripts que já usam esses nomes, e quote ou unquote são aceitos como sinônimos. Uma barra invertida final incompleta, aspas simples ou duplas não fechadas, ou espaço em branco sem aspas que iniciaria uma segunda palavra argv eleva invalid_input com uma mensagem que nomeia o problema. O teto de comprimento de cem mil caracteres mantém a memória do Worker previsível e ainda cobre caminhos longos, valores de ambiente e a maioria dos buffers de colagem. Combine a execução gratuita no navegador desta página com a API cobrada quando precisar do mapeamento idêntico dentro de um pipeline automatizado sem reimplementar tabelas de citação shell. Entradas inválidas devolvem invalid_input e não são cobradas, o que mantém a validação barata enquanto transformações bem-sucedidas permanecem um preço fixo por item em US$ 0,002.

Onde a citação de argumentos shell se encaixa em fluxos de desenvolvimento

Desenvolvedores encontram citação de argumentos shell ao montar comandos remotos, escrever trechos de instalação, montar listas de argumentos docker ou ssh, ou armazenar caminhos de arquivo que podem conter espaços e apóstrofos. Equipes frontend e backend codificam nomes de arquivo fornecidos pelo usuário antes de embuti-los em um template shell para que um único espaço ou aspas não quebre o comando ao redor nem injete tokens extras. Engenheiros de qualidade geram pares deterministas de encode e decode para testes de contrato, de modo que um middleware que afirma citação segura não possa mudar silenciosamente para uma tabela não POSIX entre releases. Educadores usam a mesma ferramenta ao ensinar a diferença entre aspas simples, aspas duplas, escapes de barra invertida e por que argumentos vazios ainda devem aparecer como um par de aspas em vez de sumir. Revisores de segurança usam checagens de aspas como higiene antes de colar valores em scripts shell, lembrando que citar não substitui evitar o shell quando uma API de array argv direta está disponível. Nesta página o trabalho roda inteiramente no seu navegador; pela API cada consulta bem-sucedida custa US$ 0,002, validação falha não é cobrada e nada é armazenado após a resposta. Essa divisão — exploração interativa gratuita e uma API cobrada idêntica — combina com o restante do catálogo KIT nível A e permite passar de uma demo em sala a um pipeline automatizado sem mudar o resultado citado. Combine com escape de string JSON ou codificação percentual de URL quando precisar de transformações de texto mais amplas, e com outros endpoints de codificação ao montar um pequeno laboratório de ferramentas gratuitas e deterministas para CI e documentação.