Le manifeste du paquet

Présentation

Chaque paquet doit avoir un fichier manifeste contenant des spécifications qui seront résumées dans la base de données lorsque le paquet sera envoyé sur le serveur. Le manifeste doit être écrit en YAML, en suivant la structure de l’exemple ci-dessous.

Le fichier manifeste doit être nommé manifest.yml et doit se trouver à la racine du paquet (Ne vous inquiétez pas, la commande build de l’outil Yak CLI se charge de cela pour vous !).

L’objectif du manifeste est de favoriser la rationalisation (et potentiellement l’automatisation) du processus de publication des paquets, en évitant de devoir avoir recours à des formulaires Web pour publier des paquets.

Attributs requis

Attributs recommandés

Exemple

Voici un exemple de module de Grasshopper.

name: plankton
version: 0.3.4
authors:
  - Daniel Piker
  - Will Pearson
description: >
  Plankton is a flexible and efficient library for handling n-gonal meshes.
  Plankton is written in C# and implements the halfedge data structure. The
  structure of the library is loosely based on Rhinocommon's mesh classes and
  was originally created for use within C#/VB scripting components in
  Grasshopper.  
url: "https://github.com/meshmash/Plankton"

Attributs requis

Name

Il s’agit d’un nom court décrivant le paquet. Choisissez de préférence un seul mot ; mais il est aussi possible d’avoir plusieurs mots séparés par des tirets bas ou des tirets intermédiaires.

_Remarque 1 : le nom du paquet ne peut contenir que des lettres, des chiffres, des tirets intermédiaires et des tirets bas.

_Remarque 2 : les noms des paquets prennent la casse utilisée dans la toute première version qui a été téléchargée. Les téléchargements suivants ne tiennent pas compte de la casse du nom du paquet et les requêtes ne tiennent pas compte de la casse.

name: plankton

Version

Depuis la version 0.8 les numéros de version à quatre chiffres sont autorisés. Depuis la version 0.9 vous pouvez utiliser le caractère générique $version.

C’est le numéro de version attribué au paquet.

Les numéros de version des paquets doivent soit suivre la gestion sémantique de version 2.0.0 (par exemple 1.1.0-beta) ou Système.Version, que l’on appelle aussi norme à quatre chiffres de Microsoft (par exemple 1.2.3.4). Il est recommandé d’utiliser la gestion sémantique de version car cette approche permet aux auteurs de paquets de spécifier des versions préliminaires. C’est pratique pour des essais limités, puisque la dernière version stable est installée par défaut.

Pour faciliter le processus de création, il est possible de remplacer le numéro de version par $version. Le numéro de version sera alors déduit du contenu du paquet et substitué lors du processus de yak build.

version: 0.3.4

Authors

Liste des auteurs du paquet.

authors:
  - Daniel Piker
  # indiquez les autres auteurs du paquet en dessous
  - Will Pearson

Description

Cette section sert à décrire le paquet. À vous de voir si vous souhaitez entrer dans les détails ou être succinct.

description: This is an awesome package.

Si vous souhaitez en écrire davantage, vous pouvez utiliser la structure YAML.

description: >
  This is such an awesome package
  that I'm going to write a whole
  bunch of text describing it!

  This sentence will be on a new line.  

URL

Site Web pour le paquet. Il peut s’agir de n’importe quelle URL, par exemple les coordonnées de l’auteur, des forums, des tutoriels ou toute autre information sur le module.

url: "https://github.com/meshmash/Plankton"

Keywords

Liste de mots clés qui aideront les utilisateurs à trouver le paquet.

keywords:
- one
- two

Icon

Fichier d’icône dans le paquet. Il doit être de petite taille (par exemple 64x64) et doit être au format PNG ou JPEG.

icon: icon.png

Attributs obsolètes

Icon URL

Avertissement
⚠️ Remplacé par l’attribut icon.

Lien direct vers une icône qui sera utilisée par le gestionnaire de paquets dans Rhino. Elle doit être de petite taille (32x32 dans l’idéal) et être au format PNG ou JPEG.

icon_url: "https://example.com/path/to/icon.png"

Voir aussi