#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.
| Commande | Alias | Ce qu’elle fait | Portée exigée |
|---|---|---|---|
connexion | login | enregistre une clé d’API sur cette machine | — |
lister | list | les thèmes du site | lecture |
infos | info | l’état du thème visé | lecture |
nouveau | new, init | un dossier de thème prêt à éditer | — |
recuperer | pull, récupérer | écrit un thème distant dans un dossier local | lecture |
pousser | push | envoie les fichiers qui ont changé | themes |
suivre | dev, watch | pousse chaque fichier à la sauvegarde | themes |
publier | publish | met un thème en ligne | themes |
dupliquer | duplicate, copier | copie un thème distant en un thème neuf | themes |
renommer | rename | change le nom d’un thème | themes |
supprimer | delete, retirer | retire un thème du site | themes |
empaqueter | package, zip | un .zip du dossier local | — |
verifier | check, vérifier | contrôle le dossier local | — |
comparer | diff | ce qui changerait si vous poussiez | lecture |
peser | size, poids | le poids du thème, et où il part | — |
inutilises | unused, inutilisés | le code que rien n’appelle | — |
diagnostic | doctor | pourquoi ça ne marche pas | lecture |
ouvrir | open | l’aperçu du thème dans le navigateur | lecture |
aide | help | ce 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.
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 uuidLe 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:3000L’adresse du CMS. En production, https://cms.webcosa.com. Les barres obliques
finales sont retirées.
--themeuuid, préfixe ou nomLe 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.
--dossiercheminLe 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 : falseDé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 : falseAffiche l’aide de la commande et sort, sans contacter le serveur.
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 : falseLit 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é : Origoconnexion --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 jL’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.
« 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’origineorigo, 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îneLe 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-riviereAucune clé, aucun réseau. Le thème n’existe sur le site qu’après un
pousser --nouveau, et il y arrive en brouillon.
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.
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]--dossiercheminOù é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/origorecuperer écrase le disque. Les fichiers locaux qui diffèrent du distant
sont d’abord listés, puis la commande demande confirmation :
! 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.
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 : falseRetirez du thème distant les fichiers absents en local. Les liste et demande confirmation avant de les effacer.
--forcedrapeaudéfaut : falseSupprimez 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 : falseCré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îneLe 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ésLes 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 :
✗ 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é :
! 1 fichier(s) existent à distance mais pas en local — non touchés :
sections/promo.liquid
Ajoute `--supprimer` pour les retirer du thème distant.--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 :
! 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-333333333333L’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 : falseAcceptez 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.cssTrois 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
? disparuvous 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.
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.
! « 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-444444444444Accepter 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.
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îneRenommez la copie dans la foulée. Sans elle, le serveur l’appelle
« <nom> (copie) ».
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]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 :
! « 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) :
✗ « 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>.zipLe 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.
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 --aideArgument
commandenom ou aliasLe 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 :
✗ 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 :
✗ 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 :
✗ « 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.--verbeuxrend 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èmeIl 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 quandL’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.
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 diagnosticAdresse 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.

