Guillemets argument shell

Ce qu'est le guillemetage shell POSIX et ce que renvoie cet outil

La réponse JSON inclut toujours result pour la chaîne transformée, mode qui répète encode ou decode, encoding fixé à posix_shell, ainsi que input_length et output_length pour que les tests affirment les tailles. Encode signale aussi needs_quotes et apostrophes_escaped ; decode signale quote_segments pour confirmer combien de régions citées ont été consommées. Il n'y a pas d'omission silencieuse partielle pour un guillemet cassé : soit le mot est un guillemetage shell bien formé, soit la requête échoue avec invalid_input.

Comment text et mode sont lus et comment les résultats restent reproductibles

Encode classifie la chaîne : vide devient une paire de guillemets simples vides ; un jeton correspondant à l'ensemble nu sûr de lettres, chiffres et arobase pourcent plus égal deux-points virgule point barre soulignement tiret est renvoyé inchangé car il n'a pas besoin de protection ; tout autre caractère, y compris espace, guillemet ou métacaractère shell, force un enveloppement complet en guillemets simples avec l'empalmage d'apostrophe pour chaque guillemet simple interne. Comme l'enveloppement s'applique en une seule passe de gauche à droite, vous obtenez une forme de guillemetage cohérente alignée sur l'esprit de shlex.quote et les aides shell courantes. Decode parcourt les segments entre guillemets simples, les segments entre guillemets doubles avec l'ensemble limité d'échappements POSIX et les échappements barre oblique inverse hors guillemets qui protègent le caractère suivant ou poursuivent une ligne lorsque le suivant est une nouvelle ligne. Le champ payload préféré est text, avec les alias input, value, s, payload et arg afin que formulaires, chaînes de requête et clients SDK réutilisent le même contrat sans renommer les colonnes. Mode vaut encode par défaut et accepte decode explicitement ; les alias op, direction et action mappent le même interrupteur pour les scripts qui utilisent déjà ces noms, et quote ou unquote sont acceptés comme synonymes. Une barre oblique inverse finale incomplète, un guillemet simple ou double non fermé, ou un espace blanc hors guillemets qui commencerait un second mot argv lève invalid_input avec un message qui nomme le problème. Le plafond de longueur de cent mille caractères maintient la mémoire du Worker prévisible tout en couvrant longs chemins, valeurs d'environnement et la plupart des tampons de collage. Associez l'exécution gratuite dans le navigateur de cette page à l'API tarifée lorsque vous avez besoin du mappage identique dans un pipeline automatisé sans réimplémenter les tables de guillemetage shell. Les entrées invalides renvoient invalid_input et ne sont pas facturées, ce qui garde la validation bon marché tandis que les transformations réussies restent un prix fixe par item à $0.002.

Où le guillemetage d'arguments shell s'intègre dans les flux de développement

Les développeurs rencontrent le guillemetage d'arguments shell lorsqu'ils construisent des commandes distantes, rédigent des extraits d'installation, assemblent des listes d'arguments docker ou ssh, ou stockent des chemins de fichiers pouvant contenir espaces et apostrophes. Les équipes frontend et backend encodent les noms de fichiers fournis par l'utilisateur avant de les insérer dans un modèle shell afin qu'un seul espace ou guillemet ne casse pas la commande environnante ni n'injecte de jetons supplémentaires. Les ingénieurs qualité génèrent des paires encode et decode déterministes pour des tests de contrat, afin qu'un middleware qui revendique un guillemetage sûr ne bascule pas silencieusement vers une table non POSIX entre versions. Les éducateurs utilisent le même outil pour enseigner la différence entre guillemets simples, guillemets doubles, échappements barre oblique inverse, et pourquoi les arguments vides doivent encore apparaître comme une paire de guillemets plutôt que disparaître. Les relecteurs sécurité utilisent des contrôles de guillemets comme hygiène avant de coller des valeurs dans des scripts shell, en rappelant que guillemeter ne remplace pas l'évitement du shell lorsqu'une API de tableau argv directe est disponible. Sur cette page le travail s'exécute entièrement dans votre navigateur ; via l'API chaque consultation réussie coûte $0.002, la validation échouée n'est pas facturée et rien n'est stocké après la réponse. Ce partage — exploration interactive gratuite et API tarifée identique — s'aligne sur le reste du catalogue KIT niveau A et vous permet de passer d'une démo en classe à un pipeline automatisé sans changer le résultat guillemeté. Associez-le à l'échappement de chaînes JSON ou à l'encodage pourcentage d'URL lorsque vous avez besoin de transformations de texte plus larges, et à d'autres points d'extrémité d'encodage pour constituer un petit laboratoire d'outils gratuits et déterministes pour la CI et la documentation.