Ligne de commande cee

cee est la ligne de commande de ceelab. Elle s’appelle depuis un terminal (bash, zsh, PowerShell, cmd) et s’intègre aux automatisations. Elle passe par le même moteur que l’application, sur la même base et la même configuration : mêmes contrôles, mêmes compteurs, mêmes fichiers, même historique.

cee print shipping-label
cee print shipping-label --copies 10
cee print shipping-label --set name="Jane Doe"
cee edit --last --set name="Jane Doe"

shipping-label est le nom court d’un type de document : sa clé, visible dans l’onglet Types de document (Réglages avancés › Clé du type). Les templates se conçoivent dans l’application ; la commande sert à les utiliser, jamais à les créer ni à les modifier.

Installation et appel

cee est livrée avec ceelab, dans le même installeur. Elle fonctionne dès que ceelab a été ouvert une première fois sur le poste. Réglez l’imprimante d’étiquettes et le dossier de sortie dans l’application avant d’imprimer.

Sous macOS, l’application s’installe par glisser-déposer, sans rien ajouter au PATH. Pour taper cee dans le Terminal, au choix :

# lien symbolique dans un dossier du PATH (droits administrateur)
sudo ln -s /Applications/ceelab.app/Contents/MacOS/cee /usr/local/bin/cee
# ou : dossier de l'application à la fin du PATH (~/.zprofile)
export PATH="$PATH:/Applications/ceelab.app/Contents/MacOS"

Commandes

Les verbes sont en anglais et identiques dans toutes les langues ; les messages suivent la langue de l’application. cee COMMANDE --help donne l’aide d’une commande ; cee print TYPE --help y ajoute les variables du type.

--dry-run fait tous les contrôles d’une vraie impression et montre ce qui serait produit, sans rien réserver, écrire ni imprimer.

cee edit --last sans valeur ne corrige rien : il affiche les variables du dernier document et leurs valeurs (code 2). Une correction est refusée (code 4) quand elle changerait une valeur dont dépend une formule, ou qu’un texte de template utilise dans un calcul ({upper(product)}) : générez alors un nouveau document.

Variables du type

Les options -- dépendent du type : chaque variable saisie (texte, nombre, date, liste de choix ou Oui/Non, demandée à l’opérateur) se donne par son nom ou avec --set :

cee print product_label --product "Vis inox" --reference VX-0620
cee print product_label --set product="Vis inox" --set reference=VX-0620

• Un nombre peut s’écrire avec une virgule (12,5) ; une date AAAA-MM-JJ ou JJ/MM/AAAA ; une liste de choix attend le texte exact d’une option ; un Oui/Non s’écrit true ou false.
• Une variable non donnée prend sa valeur par défaut. Un numéro, un assemblage ou une formule est calculé par ceelab : le donner est refusé.
• Une valeur avec des espaces se met entre guillemets. La forme --set "name=Jane Doe" convient à bash, zsh, PowerShell et cmd.

Garde-fous

Tous sont contrôlés avant de réserver le moindre numéro :

• Valeurs : obligatoires, nombres, dates, choix, Oui/Non, date pas dans le futur.
• Typst : le moteur de rendu doit se lancer.
• Imprimante d’étiquettes réglée dans ceelab, pour un type qui produit une étiquette.
• Dossier de sortie complet (/srv/etiquettes, D:\Etiquettes…) pour une commande qui écrit un PDF : le réglage de départ, ., est relatif et refusé.
• Contrôle de la première étiquette : tant qu’il n’a pas été fait dans l’application, la commande n’imprime qu’une étiquette à la fois.

Après la réservation, une sortie en échec est tracée dans l’historique avec son numéro, comme dans l’application ; cee reprint ID refait le document.

La commande et l’application peuvent travailler en même temps sur la même base : chaque écriture attend l’autre jusqu’à 5 secondes. Après une mise à jour de ceelab, ouvrez l’application une fois avant d’utiliser cee : c’est elle qui met la base à jour.

Réponse JSON

Avec --json, la commande écrit un seul objet JSON sur la sortie standard, y compris en cas d’erreur. Champs communs : schema (version du format), command, ok, code et, en cas d’échec, error (kind, message, details). Le JSON est en ASCII, lisible quelle que soit la page de code de la console.

# bash : valeurs enregistrées du document (numéros compris)
cee print shipping-label --set "name=Jane Doe" --json | jq '.documents[0].values'

# PowerShell
$r = cee print shipping-label --set "name=Jane Doe" --json | Out-String | ConvertFrom-Json
if ($LASTEXITCODE -ne 0) { throw $r.error.message }

Codes de retour

Stables d’une version à l’autre ; le nom entre parenthèses est error.kind en JSON.

Journal

Chaque appel ajoute une ligne au journal de l’application (onglet Logs), préfixée [cee] : commande, type ou document visé, noms des variables données (jamais leurs valeurs), code de retour et durée.