Cette page de référence présente les meilleures pratiques décrites dans la section Stratégies de script, avec plus de détails sur les bibliothèques de codes, l'étiquetage et le style. Vous allez utiliser Python pour illustrer les concepts ci-dessous. Les mêmes principes s'appliquent à Python et C# (Zerotouch), mais la syntaxe est différente.
Les bibliothèques standard sont externes à Dynamo et sont présentes dans les langages de programmation Python et C# (Zerotouch). Dynamo possède également son propre ensemble de bibliothèques qui correspondent directement à sa hiérarchie de nœuds, permettant à l'utilisateur de coder tout ce qui peut être fait avec des nœuds et des fils. Voici un guide qui présente le contenu auquel chaque bibliothèque Dynamo permet d’accéder et qui explique quand utiliser une bibliothèque standard.
Bibliothèques standard et bibliothèques Dynamo
Les bibliothèques standard de Python et C# peuvent être utilisées pour créer des données avancées et des structures de flux dans l’environnement Dynamo.
Les bibliothèques Dynamo correspondent directement à la hiérarchie des nœuds pour la création de géométries et d’autres objets Dynamo.
Bibliothèques Dynamo
ProtoGeometry*
Fonctionnalités : Arc, Zone de contour, Cercle, Cône, Système de coordonnées, Cuboïde, Courbe, Cylindre, Arête, Ellipse, Arc d’ellipse, Face, Géométrie, Hélice, Groupe d’index, Ligne, Maillage, Courbe NURBS, Surface NURBS, Plan, Point, Polygone, Rectangle, Solide, Sphère, Surface, Topologie, T-Spline, UV, Vecteur, Sommet.
Comment importer : import Autodesk.DesignScript.Geometry
``
DSCoreNodes
Fonctionnalités : Couleur, Intervalle de couleurs 2D, Date et heure, Durée, E/S, Formule, Logique, Liste, Math, Arbre quadratique, Chaîne, Thread.
Comment importer : import DSCore
Tessellation
Fonctionnalités : Coque convexe, Delaunay, Voronoi.
Comment importer : import Tessellation
DSOffice
Fonctionnalité : Excel.
Comment importer : import DSOffice
*Remarque : lorsque vous utilisez ProtoGeometry via Python ou C#, vous créez des objets non gérés dont la mémoire doit être gérée manuellement. Pour plus d’informations, reportez-vous à la section Objets non gérés.
Lors de la création du script, vous utilisez en permanence des identificateurs pour indiquer des éléments tels que des variables, des types, des fonctions et d'autres entités. Grâce à ce système de notation symbolique, et à la création d'algorithmes, vous pouvez facilement vous référer à des informations par le biais de libellés, généralement composés d'une séquence de caractères. Le fait de nommer les choses correctement joue un rôle important dans l'écriture de code pour que ce dernier soit facilement lu et compris par d'autres personnes, ainsi que par vous-même dans le futur ! Voici quelques conseils à retenir lorsque vous nommez des éléments dans votre script :
Il est correct d’utiliser des abréviations, mais il convient d’expliquer l’abréviation par un commentaire :
Évitez les libellés redondants :
Utilisez une logique positive pour les noms de variables au lieu d’une logique négative :
Préférez la « notation inverse » :
Il est plus logique d’utiliser des termes structurels.
Les alias doivent être utilisés pour raccourcir les chaînes trop longues et souvent répétées :
L’utilisation d’alias peut rapidement conduire à des programmes déroutants et non standard.
Utilisez uniquement les mots nécessaires :
« Rendez les choses aussi simples que possible, mais pas plus simples. » – Albert Einstein
En règle générale, il existe plusieurs méthodes pour programmer à peu près tout ce que l'on veut. Votre "style personnel" de script est donc le résultat des innombrables petites décisions que vous choisissez de prendre (ou de ne pas prendre). Cela dit, la lisibilité et la pérennité de votre code sont le résultat direct de sa cohérence interne et de sa conformité aux conventions stylistiques générales. En règle générale, des lignes de code qui se ressemblent à deux emplacements différents doivent également fonctionner de la même manière. Voici quelques conseils pour écrire du code clair et cohérent.
Conventions d’appellation : (choisissez l’une des conventions ci-dessous pour chaque type d’entité de votre code et associez-la à votre système.)
Variables, fonctions, méthodes, packages, modules :
lower_case_with_underscores
Classes et exceptions :
CapWords
Méthodes protégées et fonctions internes :
_single_leading_underscore(self, ...)
Méthodes privées :
__double_leading_underscore(self, ...)
Des constantes :
ALL_CAPS_WITH_UNDERSCORES
Conseil : évitez les variables d’une lettre (p. ex. l, O, I) sauf dans des blocs très courts, quand la signification est clairement visible dans le contexte immédiat.
Utilisation de lignes vierges :
Entourez les définitions de classe et de fonction de niveau supérieur de deux lignes vierges.
Les définitions de méthode à l'intérieur d'une classe sont entourées d'une seule ligne vierge.
Des lignes vierges supplémentaires peuvent être utilisées (occasionnellement) pour séparer des groupes de fonctions associées.
Évitez les espaces superflus :
Immédiatement entre des parenthèses, des crochets ou des accolades :
Immédiatement avant une virgule, un point-virgule ou un signe deux-points :
Immédiatement avant la parenthèse ouvrante qui lance la liste d'arguments d'un appel de fonction :
Immédiatement avant la parenthèse ouverte qui démarre l'indexation ou l'extraction :
Entourez toujours ces opérateurs binaires d’un seul espace de part et d’autre :
Faites attention à la longueur des lignes :
Ne dépassez pas les 79 caractères.
Limiter la largeur de la fenêtre de l'éditeur requise permet d'ouvrir plusieurs fichiers côte à côte et facilite l'utilisation d'outils de révision de code qui présentent les deux versions dans des colonnes adjacentes.
Vous pouvez couper les longues lignes sur plusieurs lignes en mettant les expressions entre parenthèses :
Évitez les commentaires évidents et redondants :
Parfois, réduire le nombre de commentaires permet de rendre le code plus lisible, notamment si cela vous oblige à utiliser des noms de symboles significatifs à la place.
L'adoption de bonnes habitudes de codage réduit la dépendance aux commentaires :
Conseil : les commentaires vous expliquent pourquoi, le code vous explique comment.
Examinez attentivement le code source ouvert :
Les projets Open Source reposent sur les efforts de collaboration de nombreux développeurs. Ces projets doivent garantir un niveau élevé de lisibilité du code afin que l'équipe puisse travailler ensemble le plus efficacement possible. Par conséquent, il est recommandé de parcourir le code source de ces projets pour observer ce que font ces développeurs.
Améliorez vos conventions :
Demandez-vous si chaque convention fonctionne ou non pour les besoins définis.
Les fonctionnalités et l'efficacité sont-elles compromises ?
Consultez ces pages wiki pour obtenir des conseils sur l’écriture de C# pour Zerotouch et la participation à Dynamo :
Cette page wiki traite de certaines normes générales de codage pour la documentation et le test de votre code : https://github.com/DynamoDS/Dynamo/wiki/Coding-Standards
Cette page wiki traite spécifiquement des normes d’attribution de noms pour les bibliothèques, les catégories, les noms de nœuds, les noms de ports et les abréviations : https://github.com/DynamoDS/Dynamo/wiki/Coding-Standards
Objets non gérés :
Lorsque vous utilisez la bibliothèque de géométrie de Dynamo (ProtoGeometry) à partir de Python ou de C#, les objets de géométrie créés ne sont pas gérés par la machine virtuelle, et la mémoire d’un grand nombre de ces objets doit être nettoyée manuellement. Pour nettoyer des objets natifs ou non gérés, vous pouvez utiliser la méthode Dispose ou le mot-clé using. Consultez cette entrée Wiki pour obtenir un aperçu : https://github.com/DynamoDS/Dynamo/wiki/Zero-Touch-Plugin-Development#dispose—using-statement.
Il vous suffit de supprimer les ressources non gérées que vous ne renvoyez pas dans le graphique ou pour lesquelles vous n’enregistrez pas de référence. Le reste de cette section fait référence à ces objets comme étant une géométrie intermédiaire. Vous pouvez voir un exemple de cette classe d’objets dans l’exemple de code ci-dessous. La fonction C# Zero Touch singleCube renvoie un seul cube, mais permet de créer 10000 cubes supplémentaires au cours de son exécution. Il est possible que cette autre géométrie ait été utilisée comme géométrie de construction intermédiaire.
Cette fonction Zero Touch risque de bloquer Dynamo , étant donné que vous avez créé 10000 solides, mais n’avez enregistré qu’un seul d’entre eux et n’avez renvoyé que celui-ci. Vous devez plutôt éliminer tous les cubes intermédiaires, sauf celui renvoyé. Il est préférable de ne pas supprimer les objets renvoyés, car ces derniers sont propagés dans le graphique et utilisés par d'autres nœuds.
Le code réparé doit ressembler à ceci :
En général, il suffit de supprimer la géométrie comme Surfaces, Curves et Solids. Pour plus de sécurité, vous pouvez supprimer tous les types de géométrie (Vectors, Points, CoordinateSystems).