Le module « truc » fournit deux exécutables, « thing » et « stuff », permettant d'interragir avec les trucs en ligne de commande. La commande « thing » prend comme premier argument le chemin identifiant un truc, et reconnait ensuite les arguments suivants :
-i
ou --interactive
ouvre un interpréteur python dans lequel la variable « thing » correspond au truc sélectionné.-r
ou --read
affiche sur la sortie standard le contenu du truc sélectionné.-w
ou --write
tente d'écrire dans le truc le contenu lu sur l'entrée standard.-l
ou --list
affiche sur la sortie standard les différentes clefs présentes dans le truc et la valeur qui leur correspond.-s
ou --states
affiche sur la sortie standard les différents états du truc sélectionné.-qREQUETE
ou --query=REQUETE
demande au truc d'exécuter la requête REQUETE.-sCLEF
ou --show=CLEF
affiche sur la sortie standard la valeur correspondant à la clef concernée, s'il y en a une.-iTAILLE
ou --icon=TAILLE
, où TAILLE est un entier, affiche le chemin décrivant l'icône du truc pour la taille concernée et pour son état actuel.La commande « stuff » fonctionne de la même manière, à ceci près que puisqu'elle peut sélectionner plusieurs trucs, les différentes options reconnues changent légèrement :
-i
ou --interactive
ouvre un interpréteur python dans lequel la variable « stuff » correspond au stuff sélectionné.-l
ou --list
affiche sur la sortie standard les chemins d'accès des différents trucs sélectionnés.-qREQUETE
ou --query=REQUETE
demande à tous les trucs sélectionner d'exécuter la requête REQUETE.-sCLEF
ou --show=CLEF
affiche sur la sortie standard la valeur correspondant à la clef concernée, s'il y en a une, pour chacun des trucs sélectionnés.-iTAILLE
ou --icon=TAILLE
, où TAILLE est un entier, affiche le chemin décrivant l'icône de chacun des trucs sélectionnés pour la taille concernée et pour leur état actuel.Quels que soient les arguments fournis (hors cas d'une fermeture depuis l'interpréteur de commande), la commande « thing » renvoie 0 si le truc sélectionné existe, 1 sinon. La commande « stuff » renvoie 0 s'il y a au moins un truc sélectionné, 1 sinon.
TODO : les différentes options indiquées ci-dessus sons suceptibles de changer plus ou moins légèrement quand j'aurai refait un parseur d'arguments digne de ce nom.