Aller au contenu

#Commandes

Le CLI s’aiguille par groupe. Cette page couvre le groupe theme, qui transporte les fichiers d’un thème ; le groupe site, qui regarde le site lui-même, a sa propre page.

webcosa theme <commande> [options]

Chaque commande a un alias anglais, certaines en ont deux. La casse est ignorée : Pousser et PUSH désignent la même chose.

CommandeAliasCe qu’elle faitPortée exigée
connexionloginenregistre une clé d’API sur cette machine—
listerlistles thèmes du sitelecture
infosinfol’état du thème visélecture
nouveaunew, initun dossier de thème prêt à éditer—
recupererpull, récupérerécrit un thème distant dans un dossier locallecture
pousserpushenvoie les fichiers qui ont changéthemes
suivredev, watchpousse chaque fichier à la sauvegardethemes
publierpublishmet un thème en lignethemes
dupliquerduplicate, copiercopie un thème distant en un thème neufthemes
renommerrenamechange le nom d’un thèmethemes
supprimerdelete, retirerretire un thème du sitethemes
empaqueterpackage, zipun .zip du dossier local—
verifiercheck, vérifiercontrôle le dossier local—
comparerdiffce qui changerait si vous poussiezlecture
pesersize, poidsle poids du thème, et où il part—
inutilisesunused, inutilisésle code que rien n’appelle—
diagnosticdoctorpourquoi ça ne marche paslecture
ouvriropenl’aperçu du thème dans le navigateurlecture
aidehelpce tableau, ou l’aide d’une commande—

Cinq commandes ne demandent aucune clé : nouveau, empaqueter, verifier, peser et inutilises. Elles ne lisent que le disque, ce qui les rend utilisables dans un crochet de commit ou dans une intégration continue qui n’a aucun secret à sa disposition.

Il n’y a aucun argument positionnel en dehors du groupe et du nom de la commande — et d’un sujet facultatif pour aide. Tout le reste passe par des options --nom=valeur.

Note

node scripts/theme.mjs pousser marche toujours, à l’identique. C’est la forme historique, et ce n’est pas une compatibilité de façade : les deux chemins passent par exactement le même code, avec les mêmes options et les mêmes messages. scripts/theme.mjs est à la fois un module que webcosa importe et un programme qu’on peut lancer seul.

La seule différence visible est le préfixe que les messages emploient pour citer une commande : webcosa theme publier quand vous êtes passé par la coquille, node scripts/theme.mjs publier quand vous avez appelé le script directement.

#Options globales

Elles valent pour toutes les commandes, et sont toujours prioritaires sur les fichiers de configuration. L’ordre complet est décrit dans Configuration.

--siteslug ou uuid

Le site visé. Défaut : le premier site accessible à la clé — un ordre qui change dès qu’un site s’ajoute au compte, d’où l’intérêt de le figer. L’option désigne le site, elle ne l’autorise pas : le serveur revalide toujours contre les sites du porteur, et refuse en site_interdit.

--urladressedéfaut : http://localhost:3000

L’adresse du CMS. En production, https://cms.webcosa.com. Les barres obliques finales sont retirées.

--themeuuid, préfixe ou nom

Le thème visé. Trois formes acceptées : l’identifiant complet, le préfixe de huit caractères qu’affiche lister, ou le nom exact. Sans cette option et avec un seul thème sur le site, c’est celui-là ; avec plusieurs, la commande refuse plutôt que de deviner.

--dossierchemin

Le dossier de travail, résolu depuis le dossier courant. Sans lui : le dossier qui contient le .webcosa.json trouvé, sinon themes/<nom-du-thème> sous le dossier courant.

--verbeuxdrapeaudéfaut : false

Détaille chaque appel HTTP sur la sortie d’erreur, liste les fichiers inchangés d’un pousser, et rend la trace technique d’une erreur inattendue.

--aidedrapeaudéfaut : false

Affiche l’aide de la commande et sort, sans contacter le serveur.

Danger

Il n’existe pas d’option --cle=. Une clé passée sur la ligne de commande entre dans l’historique du shell et dans la liste des processus, où n’importe quel autre compte de la machine peut la lire. La clé vient de ~/.webcosa/config.json ou de WEBCOSA_CLE, et de nulle part ailleurs.

#connexion

Enregistrez une clé d’API sur cette machine. C’est la seule commande qui fonctionne sans clé — c’est elle qui en pose une. Le parcours complet, avec la création de la clé côté CMS, est sur Connexion.

webcosa theme connexion [--url=<adresse>] [--site=<slug>]webcosa theme connexion --depuis-stdin < cle.txt
--depuis-stdindrapeaudéfaut : false

Lit la clé sur l’entrée standard au lieu de la demander, et ne pose aucune question — l’adresse vient alors de --url, de WEBCOSA_URL ou du défaut. Pour les environnements sans terminal.

--siteslug ou uuid

Écrit aussi dans le fichier de configuration global, d’où il est relu en dernier recours. Voir l’encadré ci-dessous.

webcosa theme connexion --url=https://cms.webcosa.com✓ Clé enregistrée dans /Users/marc/.webcosa/config.json (0600) https://cms.webcosa.com — site Menuiserie Dubois (dubois), 2 thèmes visibles. Thème publié : Origo
Attention

connexion --site= inscrit le site dans ~/.webcosa/config.json, et le CLI l’y relit en dernier recours : le site est cherché dans --site, puis WEBCOSA_SITE, puis .webcosa.json, puis seulement là. Un .webcosa.json posé dans un dossier de thème décrit ce dossier-là : il l’emporte donc sur cette préférence de machine — et recuperer l’écrit tout seul.

#lister

Les thèmes du site, le publié en tête et en évidence.

webcosa theme lister [--site=<slug>]

Aucune option propre.

webcosa theme lister id nom version rôle modifié 11111111 Origo 1.0.0 publié il y a 3 min 22222222 Chantier 2.1.0 brouillon il y a 4 j

L’identifiant court des huit premiers caractères suffit partout où l’on attend un --theme=. Le nom exact aussi. Un site sans thème affiche Aucun thème sur ce site. et sort en succès — ce n’est pas une erreur.

#infos

L’état du thème visé. lister répond « quels thèmes » ; celle-ci répond « celui-là, il en est où ».

webcosa theme infos [--theme=<id|nom>]

Aucune option propre.

webcosa theme infosOrigo · PUBLIÉ identifiant 11111111-1111-4111-8111-111111111111 version 1.1.0 origine origo (thème du catalogue : il peut recevoir des mises à jour) fichiers 51 sur 300 au maximum poids 168.6 ko modifié il y a 3 min — par le CLI ou par le CMS, indifféremment en dernier sections/hero.liquid il y a 3 min site Menuiserie Dubois (dubois) Ce thème est celui que voient les visiteurs. Chaque poussée est en ligne.

Deux appels seulement : la liste des thèmes, qui porte le nom, le rôle, la version et la date, puis l’arborescence, qui porte les fichiers et leur poids. L’export complet donnerait la même chose en cent fois plus lourd.

Attention

« Modifié » n’est pas « poussé ». La colonne maj_le est réécrite par toute écriture : une poussée du CLI, mais aussi un enregistrement dans l’éditeur de code du CMS, ou un réglage changé dans l’éditeur visuel.

L’appeler « dernière poussée » ferait croire à un journal du CLI, et enverrait chercher côté CLI la cause d’une modification faite dans le navigateur. Il n’y a pas de journal : voir Ce qu’il n’y a pas, et pourquoi.

#nouveau

Un dossier de thème complet, prêt à éditer, à partir d’un thème d’origine.

webcosa theme nouveauwebcosa theme nouveau --depuis=<id> [--dossier=<chemin>] [--nom=<nom>] [--force]

Sans --depuis, la commande liste les thèmes d’origine disponibles :

webcosa theme nouveauThèmes d'origine — webcosa theme nouveau --depuis=<id> aplomb Aplomb 3.1.0 Le thème caméléon. Une seule structure — bandeau centré, prestations… origo Origo 1.1.0 Le thème de départ. Neutre, complet, prêt pour tous les métiers —… vela Vela 1.1.0 Clair et posé, pour les professions où la confiance précède tout.…
--depuisidentifiant de thème d’origine

origo, forge, vela, aplomb… Sans elle, la commande affiche la liste et s’arrête.

--dossierchemindéfaut : ./<nom-en-slug>

Où écrire. La commande refuse un dossier qui contient déjà des fichiers de thème, sauf avec --force.

--nomchaîne

Le nom du thème, inscrit dans config/theme.json. C’est ce champ que lira pousser --nouveau pour nommer le thème créé sur le site — sans lui, un thème parti d’Origo s’appellerait « Origo » chez le client.

--forcedrapeaudéfaut : false

Écrit par-dessus un dossier qui contient déjà un thème. Elle ne fait pas le ménage : les fichiers de l’ancien que le nouveau ne remplace pas restent en place, ce qui donne un dossier qui mélange deux thèmes. La commande le dit, et inutilises nomme ceux qui ne servent plus.

Supprimer d’office serait pire : nouveau n’a aucune idée de ce que ces fichiers contiennent, et ils peuvent être du travail.

webcosa theme nouveau --depuis=origo --nom="Atelier Rivière" --dossier=~/themes/atelier-riviere✓ « Atelier Rivière » — 51 fichiers copiés depuis origo /Users/marc/themes/atelier-riviere Ensuite webcosa theme verifier --dossier=/Users/marc/themes/atelier-riviere webcosa theme pousser --nouveau --dossier=/Users/marc/themes/atelier-riviere

Aucune clé, aucun réseau. Le thème n’existe sur le site qu’après un pousser --nouveau, et il y arrive en brouillon.

Note

Le .webcosa.json posé ici ne nomme pas de thème, seulement l’adresse du CMS et, si elle est connue, le site. C’est volontaire : le thème n’existe pas encore côté serveur, et y inscrire un identifiant inventé ferait échouer la première commande sur Ce thème n'existe pas sur ce site. Le champ apparaîtra quand pousser --nouveau aura créé le thème.

Attention

nouveau lit les thèmes d’origine sur le disque, dans le themes/ du dépôt. Elle ne marche donc que là où ce dossier est présent : dans le dépôt, ou dans une installation faite par npm link.

Ce n’est pas un oubli. Aucune route d’API ne sert le contenu des thèmes du catalogue — POST /api/themes {action:"installer"} les installe sur un site, elle ne les rend pas. Passer par elle obligerait à installer un thème chez un client pour pouvoir le récupérer, c’est-à-dire exactement le détour que cette commande supprime.

Ailleurs, pars d’un thème du site avec recuperer.

#recuperer

Écrit un thème distant dans un dossier local, et y pose un .webcosa.json : les commandes suivantes n’ont plus besoin d’aucune option.

webcosa theme recuperer [--theme=<id|nom>] [--dossier=<chemin>] [--force]
--dossierchemin

Où écrire. Sans lui, themes/<nom-du-thème> sous le dossier courant — un défaut qui ne vaut qu’en dehors du dépôt : à la racine du dépôt, il viserait le dossier des thèmes d’origine, et le CLI vous en avertit.

--forcedrapeaudéfaut : false

Écrase sans poser de question les fichiers locaux qui diffèrent du distant.

webcosa theme recuperer --theme=Origo --dossier=~/themes/origo✓ 24 fichiers de « Origo » écrits dans /Users/marc/themes/origo .webcosa.json y a été posé : les prochaines commandes n'ont plus besoin d'options. Édite, puis : webcosa theme pousser --dossier=/Users/marc/themes/origo
Danger

recuperer écrase le disque. Les fichiers locaux qui diffèrent du distant sont d’abord listés, puis la commande demande confirmation :

bash
! 2 fichier(s) local(aux) diffèrent du distant et seraient écrasés :
    assets/theme.css
    sections/hero.liquid

Écraser ces fichiers ? [o/N]

Répondre non interrompt tout : Récupération annulée, rien n'a été écrit. --force passe outre sans rien demander.

Perdre du travail local non poussé est le pire échec possible d’un outil comme celui-ci : il n’y a pas d’annulation, pas de corbeille, et l’on ne saurait même pas ce qu’on a perdu. C’est le seul endroit où l’on préfère être bavard.

Note

Tous les chemins reçus du serveur sont validés avant la première écriture. Un serveur est de confiance, mais un outil qui écrit sur le disque de son utilisateur d’après une réponse réseau ne doit pas être celui qui découvre la traversée de chemin : ../../.ssh/authorized_keys reçu dans un JSON s’écrirait très bien sans ce contrôle. Un chemin douteux interrompt tout, et rien n’est écrit.

#pousser

Comparez les empreintes SHA-256 locales à celles du serveur et n’envoie que ce qui a changé.

webcosa theme pousser [--theme=<id|nom>] [--dossier=<chemin>] [--supprimer] [--force] [--nouveau] [--nom=<nom>]
--supprimerdrapeaudéfaut : false

Retirez du thème distant les fichiers absents en local. Les liste et demande confirmation avant de les effacer.

--forcedrapeaudéfaut : false

Supprimez sans poser la question. N’a d’effet qu’avec --supprimer, et n’existe que pour l’intégration continue, qui n’a pas de terminal pour répondre.

--nouveaudrapeaudéfaut : false

Créez un thème neuf à partir du dossier, au lieu de mettre à jour l’existant. Le dossier visé est alors --dossier, le dossier du .webcosa.json trouvé, ou à défaut le dossier courant — pas themes/<nom>.

--nomchaîne

Le nom du thème créé par --nouveau, tronqué à 80 caractères. Par défaut, celui du champ nom de config/theme.json, sinon le nom du dossier.

webcosa theme pousserOrigo · /Users/marc/themes/origo ↑ modifié assets/theme.css + nouveau sections/temoignages.liquid ✓ 1 nouveau, 1 modifié, 22 inchangés

Les fichiers sont envoyés un par un et dans l’ordre, jamais en rafale : chaque écriture valide la syntaxe côté serveur, et quand l’une échoue on veut savoir exactement lesquelles étaient passées. Une erreur de syntaxe interrompt donc l’envoi, en nommant le fichier fautif :

Sortie du CLIbash
✗ sections/hero.liquid — tag "for" not closed, line:14, col:1 [syntaxe]

Quand rien n’a changé, la commande liste les fichiers inchangés plutôt que de n’afficher qu’une ligne — pour qu’on voie tout de suite qu’elle a bien regardé le bon dossier.

#Les fichiers orphelins

Un fichier présent à distance mais absent en local est signalé, pas supprimé :

Sortie du CLIbash
! 1 fichier(s) existent à distance mais pas en local — non touchés :
    sections/promo.liquid
    Ajoute `--supprimer` pour les retirer du thème distant.
Danger

--supprimer détruit du travail qui n’existe qu’en base. Pas de corbeille, pas d’historique, pas de version précédente. Le cas réel n’a rien d’exotique : un collègue ajoute une section depuis l’éditeur du CMS, vous poussez un dossier récupéré la veille, son travail disparaît.

D’où l’annonce avant l’action, et la question :

bash
! 1 fichier(s) vont être SUPPRIMÉS du thème distant « Origo » :
    sections/promo.liquid
    Ils n'existent qu'en base : la suppression est définitive.

Supprimer ces fichiers ? [o/N]

Répondre non n’annule pas les fichiers déjà poussés : Suppression annulée — les fichiers poussés ci-dessus, eux, sont bien enregistrés.

--force supprime sans question. Réservez-le à l’intégration continue, où confirmer() rendrait false faute de terminal et ferait échouer la commande.

#Créer un thème avec --nouveau

Le dossier est empaqueté en archive et envoyé à POST /api/themes/importer.

webcosa theme pousser --nouveau --nom="Atelier v2" --dossier=~/themes/atelier✓ Thème « Atelier v2 » créé — 24 fichiers identifiant : 33333333-3333-4333-8333-333333333333 Il arrive en BROUILLON : il ne remplace pas encore celui que voient les visiteurs. Pour le publier : webcosa theme publier --theme=33333333-3333-4333-8333-333333333333

L’archive doit contenir les trois fichiers indispensables — layout/theme.liquid, config/settings_schema.json, templates/index.json — sans quoi le serveur refuse l’import entier.

#suivre

Surveille le dossier et pousse chaque fichier à la sauvegarde, avec l’heure. Ctrl+C pour sortir.

webcosa theme suivre [--theme=<id|nom>] [--dossier=<chemin>] [--oui-je-sais]
--oui-je-saisdrapeaudéfaut : false

Acceptez de suivre le thème publié, sans proposer de le dupliquer. À taper en connaissance de cause.

webcosa theme suivreOrigo · brouillon /Users/marc/themes/origo — 24 fichiers suivis Aperçu : https://cms.webcosa.com/s/dubois Ce thème est un brouillon : il ne remplace pas celui que voient les visiteurs. Ctrl+C pour arrêter. 14:32:07 ↑ sections/hero.liquid 14:32:41 ↑ assets/theme.css

Trois comportements à connaître, tous délibérés :

  • Une erreur n’arrête pas le suivi. Une accolade pas encore refermée pendant la frappe est un état normal du travail ; sortir obligerait à relancer la commande toutes les deux minutes. Le message s’affiche, le suivi continue.
  • Un fichier supprimé en local n’est pas supprimé à distance. Un éditeur qui remplace un fichier par un temporaire le fait disparaître une fraction de seconde, et ce clignotement ne doit rien effacer en base. La ligne ? disparu vous le rappelle, avec la commande à taper si c’est voulu.
  • Les sauvegardes sont dédoublonnées. Un éditeur émet deux à quatre événements pour un seul enregistrement ; un anti-rebond de 120 ms par fichier évite quatre écritures identiques en base.
Attention

Suivre un thème publié est refusé sans --oui-je-sais : ce serait modifier en direct le site que voient les clients à chaque Cmd+S, y compris pendant les vingt secondes où une balise n’est pas refermée.

bash
! « Origo » est le thème PUBLIÉ : chaque sauvegarde irait en ligne.

En dupliquer une copie brouillon et suivre la copie ? [o/N] o
✓ Copie créée : Origo (copie) 44444444-4444-4444-8444-444444444444

Accepter la copie met à jour le .webcosa.json du dossier au passage : sans cela, le pousser suivant repartirait sur le thème publié — exactement ce qu’on vient d’éviter. Refuser interrompt : Suivi annulé.

#publier

Met un thème en ligne, après confirmation. C’est le seul geste du CLI que voient les visiteurs du site.

webcosa theme publier [--theme=<id|nom>]

Aucune option propre.

webcosa theme publier --theme=22222222 Publier, c'est changer ce que voient les visiteurs du site. en ligne aujourd'hui : Origo remplacé par : Chantier 22222222 Confirmer la publication ? [o/N] o ✓ « Chantier » est en ligne.

Publier un thème déjà publié n’est pas une erreur : la commande affiche « Chantier » est déjà le thème publié. et s’arrête.

Attention

publier ne s’automatise pas. La confirmation n’a pas de drapeau de contournement, et confirmer() rend false sans terminal : lancée dans une intégration continue, la commande s’arrêtera toujours sur Publication annulée. C’est voulu — le déploiement d’un thème peut être automatique, sa mise en ligne reste une décision.

Le retour arrière consiste à republier l’ancien thème, qui n’a pas bougé : le brouillon et le publié coexistent. Voir Publier.

#Gérer les thèmes du site

Quatre commandes qui portent sur le thème en tant qu’objet, pas sur ses fichiers.

#dupliquer

webcosa theme dupliquer [--theme=<id|nom>] [--nom=<nom>]

C’est le geste de sécurité avant de toucher à un thème publié, et il existait déjà — mais seulement à l’intérieur de suivre, en réponse à un refus. Autrement dit : on ne pouvait dupliquer qu’en se faisant d’abord dire non.

webcosa theme dupliquer --theme=Origo✓ « Origo (copie) » créé à partir de « Origo » identifiant : 44444444-4444-4444-8444-444444444444 Il arrive en BROUILLON : le site public ne bouge pas. Pour travailler dessus : webcosa theme suivre --theme=44444444
--nomchaîne

Renommez la copie dans la foulée. Sans elle, le serveur l’appelle « <nom> (copie) ».

Note

La copie hérite des empreintes d’origine de sa source, et non de nouvelles empreintes calculées sur le contenu actuel. C’est ce qui permet à la mise à jour d’un thème de continuer à distinguer, dans la copie, un fichier resté d’origine d’un fichier retouché par le client. Voir Mettre à jour un thème.

#renommer

webcosa theme renommer --nom="Nouveau nom" [--theme=<id|nom>]

Sans --nom, la commande le demande. Le nom est tronqué à 80 caractères par le serveur ; le CLI refuse avant d’envoyer.

webcosa theme renommer --nom="Atelier v2"✓ « Origo » s'appelle désormais « Atelier v2 »

Un nom n’apparaît que dans le CMS et dans lister : renommer le thème publié ne change rien pour les visiteurs, et la commande le rappelle quand c’est le cas. Sans cette phrase, on hésite à le faire, et on perd du temps pour rien.

#supprimer

webcosa theme supprimer [--theme=<id|nom>] [--force]
Danger

La suppression est définitive. Les fichiers partent en cascade avec le thème : pas de corbeille, pas d’historique, pas de version antérieure.

La commande compte donc ce qui va disparaître avant de demander — « supprimer un thème » ne dit rien, « supprimer 34 fichiers » se refuse tout seul quand c’est le mauvais :

bash
! « Chantier v2 » et ses 34 fichiers vont être SUPPRIMÉS du site.
    Ils n'existent qu'en base : la suppression est définitive.
    Pour en garder une copie : webcosa theme recuperer --theme=22222222

Supprimer ce thème ? [o/N]

--force supprime sans question, pour l’intégration continue.

Le thème publié est refusé, ici et par le serveur (409 theme_publie) :

Sortie du CLIbash
✗ « Origo » est le thème PUBLIÉ : le retirer éteindrait l'apparence du site.
  Publie-en un autre d'abord : webcosa theme publier --theme=<id>

Les deux refus sont voulus. Celui du serveur est la garde ; celui du CLI épargne l’aller-retour, et surtout la question — on ne demande pas « voulez-vous éteindre votre site ? » à quelqu’un qui va répondre oui par réflexe.

#empaqueter

webcosa theme empaqueter [--dossier=<chemin>] [--sortie=<fichier.zip>]

Un .zip du dossier local, pour donner un thème : à un collègue, à un ticket, à une sauvegarde hors ligne.

webcosa theme empaqueter --dossier=~/themes/atelier-riviere✓ 51 fichiers empaquetés dans /Users/marc/themes/atelier-riviere.zip 55.3 ko — 67 % de moins que les 169.1 ko d'origine Le contenu se dézippe dans un dossier « atelier-riviere/ », pas en vrac.
--sortiechemindéfaut : ./<nom-du-thème>.zip

Le fichier à écrire. Le nom par défaut vient du champ nom de config/theme.json, sinon du nom du dossier.

Aucune clé, aucun réseau. Les fichiers hors format sont signalés et exclus, comme à la poussée : une archive qui contient un .js qu’on ne pourra jamais pousser est une archive qui ment sur ce qu’elle est.

Attention

Ce n’est pas un format d’import. pousser --nouveau prend un dossier, et POST /api/themes/importer prend l’archive JSON de /api/themes/:id/export. Le .zip sert à ce que ces deux-là ne savent pas faire : transporter un thème vers un humain.

Le zip est écrit en node:zlib, sans dépendance. Il est préféré au .tar.gz pour une raison qui n’est pas technique : un .zip se double-clique sur macOS et sur Windows, un .tar.gz demande la ligne de commande à qui n’y est pas déjà — c’est-à-dire à la moitié des gens à qui on envoie un thème.

#aide

webcosa theme aidewebcosa theme aide pousserwebcosa theme pousser --aide

Argument

commandenom ou alias

Le sujet de l’aide. Absent, la commande affiche le sommaire général, les options globales et l’ordre de priorité de la configuration. Un nom inconnu est ignoré et ramène au sommaire.

aide est aussi ce que fait le CLI quand on ne lui donne rien du tout, ou quand on lui donne help ou --help. Une commande inconnue, en revanche, est une erreur :

Sortie du CLIbash
✗ Commande inconnue : « puhser ».
  Voulais-tu dire `webcosa theme pousser` ?

La suggestion vient d’une distance de Levenshtein, avec un seuil d’un tiers de la longueur du mot tapé. Le seuil est ce qui compte : sans lui, webcosa theme zzz proposerait « peser » — parce qu’il faut bien que quelque chose soit le plus proche — et une suggestion absurde use la confiance qu’on accorde aux suivantes. Trop loin de tout, le CLI liste les commandes plutôt que d’inventer :

Sortie du CLIbash
✗ Commande inconnue : « zzzzz ».
  Connues : connexion, lister, infos, nouveau, recuperer, pousser, suivre,
  publier, dupliquer, renommer, supprimer, empaqueter, verifier, comparer,
  peser, inutilises, diagnostic, ouvrir. `aide` pour le détail.

Une commande tapée sans son groupe est reconnue et redirigée, plutôt que traitée comme un groupe inconnu :

Sortie du CLIbash
✗ « pousser » est une commande du groupe theme.
  Écris : webcosa theme pousser

#Ce qui vaut pour toutes les commandes

  • Aucune trace de pile ne sort du CLI. Une phrase, le geste à faire, et un code de sortie 1. --verbeux rend la trace technique quand l’erreur est inattendue.
  • Le format est vérifié en local avant l’envoi. Un fichier hors des six dossiers, une extension refusée, un fichier au-dessus de 512 Ko ou un thème de plus de 500 fichiers sont arrêtés sur la machine, ce qui évite un aller-retour réseau pour apprendre un refus prévisible. Les mêmes bornes sont revalidées côté serveur : voir Le bac à sable.
  • Seuls les six dossiers du format sont parcourus, sans descendre plus bas. .git, node_modules, .DS_Store, les captures d’écran et les fichiers cachés sont hors du champ par construction, sans liste d’exclusion à tenir à jour.

Chaque message d’échec est repris, avec sa cause, sur Erreurs.

#Ce qu’il n’y a pas, et pourquoi

Deux commandes manquent à l’appel, et leur absence est délibérée : le serveur ne garde pas ce qu’il faudrait pour les rendre honnêtes.

retourrepublier la version précédente d’un thème

Il n’existe aucun historique de versions. theme_fichiers porte un contenu et une date de dernière modification, rien d’autre : la version d’avant est écrasée à chaque écriture, et elle n’est nulle part. Une commande retour ne pourrait donc que republier un autre thème, ce qui est déjà ce que fait publier.

Le retour arrière réel consiste à garder un brouillon : le publié et le brouillon coexistent, et republier l’ancien le remet en ligne tel quel. Voir Publier. Avant une poussée risquée, dupliquer fabrique cette copie de sécurité en un appel.

journalqui a poussé quoi, et quand

L’API ne dit jamais qui. Aucune table ne consigne l’auteur d’une écriture de thème — ni le compte, ni la clé employée. La seule trace temporelle disponible est le maj_le de chaque fichier, que infos affiche déjà pour le plus récent.

Un « journal » qui listerait des dates sans auteurs ne serait pas un journal : il donnerait l’impression de répondre à « qui a cassé le site hier soir ? » sans jamais pouvoir le faire.

Note

Ces deux manques sont des manques du serveur, pas du CLI. Un CLI qui les simulerait — en gardant des copies locales, ou en devinant un auteur — serait pire qu’un CLI incomplet : il mentirait sur ce qu’il sait.

#Avant de pousser

Quatre commandes répondent à la question qu’on se pose juste avant d’envoyer — « qu’est-ce que je m’apprête à faire ? » — et à laquelle il fallait autrefois répondre en poussant, ce qui est tard quand le thème est publié.

#verifier

webcosa theme verifier [--dossier=<chemin>]

Coquille, schémas, gabarits, snippets appelés, assets cités. Tout est vérifié en local : aucune clé, aucun réseau. La commande sort en 1 s’il y a une erreur, jamais sur une simple alerte — un contrôle qui fait tout échouer finit désactivé, et avec lui les vrais défauts qu’il aurait trouvés ensuite.

Ce qui n’est pas vérifié ici : le type des réglages, les filtres et les objets Liquid. Ils dépendent du moteur, qui bouge avec le produit ; une copie de ses règles dans le CLI finirait par refuser un type valide. Le serveur tranche à la poussée.

#comparer

webcosa theme comparer [--theme=<id|nom>] [--dossier=<chemin>]

Les fichiers nouveaux, ceux qui écraseraient une version en ligne, ceux qui n’existent plus localement. Rien n’est envoyé. Sur un thème publié, la commande dit explicitement combien de fichiers en ligne seraient écrasés.

#peser

webcosa theme peser [--dossier=<chemin>]

Total, répartition par dossier, dix fichiers les plus lourds. La distinction qui compte : ce qui est dans assets/ est chargé par chaque visiteur, sur chaque page ; le reste est rendu sur le serveur et ne coûte que du temps de rendu.

#inutilises

webcosa theme inutilises [--dossier=<chemin>]

Deux listes, et la nuance entre elles est l’essentiel. Un snippet que rien n’appelle est du code mort certain : un snippet ne se rend que depuis du Liquid. Une section qu’aucun gabarit ne pose est seulement une candidate — un client a pu la poser depuis l’éditeur, dans son propre site.

#diagnostic

webcosa theme diagnostic

Adresse du CMS, clé, réponse du serveur, thème publié, état du dossier courant. La première commande à lancer quand quelque chose échoue sans qu’on sache d’où ça vient.