Exécution en ligne de commande

GCstar peut réaliser certaines opérations depuis la ligne de commande sans lancer toute l’interface graphique. Ce peut être utile pour certaines tâches qui seront exécutées depuis des scripts ou à intervalles réguliers. Ces opérations sont l’importation, l’exportation et le téléchargement d’informations.

Options disponibles

Pour utiliser toutes ces fonctionnalités, il y a une option obligatoire, -x ou --execute. Ceci va dire à GCstar qu’il doit tourner en mode non-interactif.

Ensuite viennent les options listées ci-dessous. Certaines peuvent être utilisées sous deux formes : longue ou courte. Toutes ont un paramètre qui doit les accompagner. Si le paramètre pour une option contient des espaces, des guillemets doivent être utilisés (selon les conventions de votre shell).

Option disponible

Version courte Version longue Description
-c --collection Une de ces valeurs pour spécifier le type de collection à utiliser : GCfilms, GCgames, GCbooks ou le nom d’une collection définie par l’utilisateur.
-w --website Le nom d’un module d’accès à un site Internet tel qu’il apparaît dans GCstar. Ceux qui sont disponibles dépendent du type de collection.
-i --import Un des modules d’importation disponibles : “Ant Movie Catalog”, CSV, DVDProfiler, GCfilms, “Liste de noms”, .tar.gz, Tellico
-e --export Un des modules d’exportation disponibles : CVS, HTML, SQL, .tar.gz, XML. Si aucun n’est spécifié, le format natif GCstar est utilisé.
-f --fields Le chemin vers un fichier qui contient la liste des champs pour les modules d’importation et d’exportation. Ce fichier peut être généré depuis l’interface graphique de GCstar dans la fenêtre pour choisir les champs (par exemple avec l’exportation CSV).
--importprefs Certains modules d’importation ont des préférences réglables. La valeur pour cette option est une chaîne faite de “clé⇒valeur” séparés par des virgules.
--exportprefs Certains modules d’exportation ont des préférences réglables. La valeur pour cette option est une chaîne faite de “clé⇒valeur” séparés par des virgules.
--download Permet de spécifier le texte à rechercher sur le site indiqué par -w
-o --output Le comportement par défaut est d’afficher sur la sortie standard le résultat. Avec cette option il sera plutôt enregistré dans le fichier indiqué.

Après ces options, il y a un dernier paramètre : un nom de fichier. S’il n’y a pas d’option -i option, il sera considéré comme un fichier GCstar. Si un module d’importation est spécifié, le fichier sera importé en l’utilisant.

Si --download est présent, le fichier sera ignoré. Les données en entrée seront alors celles téléchargées depuis le site web. L’option -w devient alors obligatoire.

Exemples

Exporter une collection de livres en HTML avec le modèle Shelf et le titre “Mes livres”. La collection originale est livres.gcs et la page HTML créée sera livres.html.

gcstar -x -e HTML --exportprefs “template=>Shelf,title=>Mes livres” -o livres.html livres.gcs

Génère une page HTML (films.html) à partir d’une collection Ant Movie Catalog (films.amc). Le modèle utilisé est Tian, le titre de la page sera “Mes films” et les images auront une hauteur de 160 pixels.

gcstar -x -i “Ant Movie Catalog” -e HTML --exportprefs “template=>Tian,title=>Mes films,imgHeight=>160” -o films.html films.amc

Rechercher tous les jeux vidéos en rapport avec “The legend of Zelda” sur le site GameSpot. La sortie sera dans le format utilisé par Tellico. Ceci peut être utilisé comme source de données externe pour importer des données dans Tellico.

gcstar -x -w GameSpot -c GCgames -e Tellico --download “The legend of Zelda”

Exporter une collection de films au format CSV. La liste des champs à utiliser est dans un fichier appelé champs.

gcstar -x -e CSV -o films.csv -f champs films.gcs

 
fr/execution.txt · Dernière modification: 08/03/2008 02:48 par Dagg



Si avez rencontré un problème avec GCstar, vous pouvez ouvrir un rapport de bug ou demander de l'aide sur les forums GCstar.