Macro Build Utility/fr

Description
Cette macro est destinée à des projets volumineux, impliquant des centaines d'objets. Son utilisation sur un petit projet avec un fichier unique serait inutile. Toutefois, dans le cas d’un projet volumineux comportant de nombreux objets et de nombreux fichiers à fusionner, cela fera gagner du temps, et évitera à l’utilisateur d’être impliqué dans des actions répétitives et supprimera les erreurs humaines.

Installation
Tout le code pour buildUtility.FCMacro est dans une macro. L'installation consiste donc à copier le code dans le répertoire Macro approprié et à appeler l'utilitaire de génération à partir du menu Macro, de la console Python ou d'un bouton de la barre d'outils (méthode recommandée).
 * voir Comment installer des macros pour des informations sur la façon d'installer ce code de macro
 * voir Personnaliser les barres d'outils pour plus d'informations sur l'installation en tant que bouton dans une barre d'outils

Usage
L'utilitaire de construction fonctionne sur les mêmes principes que les fichiers de construction utilisés pour assembler des systèmes logiciels volumineux (comme FreeCAD). Un éditeur de texte est utilisé pour créer un fichier texte qui respecte les formats requis par l'utilitaire de génération. L'utilitaire de construction lit ensuite chaque ligne du fichier texte et exécute les actions spécifiées par ce fichier texte.

La macro demande à l'utilisateur un "fichier de construction". Il analyse ensuite le fichier de construction, il existe 3 types de lignes:  Remarque : le caractère "@" est destiné à une amélioration future lorsque les fichiers de construction inférieurs seront gérés.
 * lignes commençant par le caractère de commentaire "#", qui sont ignorées en tant que commentaires ou remarques
 * lignes commençant par le caractère de sous-fichier "@" qui sont ignorées
 * toutes les autres lignes pouvant être un fichier de projet ou un sous-répertoire

L'extension de fichier pour le fichier Build Utility est ".FCBld". Ceci afin que les fichiers ne soient pas mélangés avec d'autres utilisations et applications.

Tout fichier spécifié dans le fichier de construction est supposé avoir l'extension ".FCStd" Si la ligne commence par un répertoire, le fichier de projet est lu à partir de ce sous-dossier. Sinon, on suppose que la ligne spécifie un fichier de projet. Les répertoires au sein des répertoires sont pris en charge, ce qui permet d'imbriquer des profondeurs arbitraires. Le format de spécification de fichier est le style "Unix" avec différents niveaux séparés par la barre oblique "/".

Tout fichier manquant est imprimé sur la vue Rapport. Tout répertoire manquant est imprimé sur la vue Rapport.

Un nouveau document est créé et chaque projet est un "Projet fusionné" dans ce nouveau document vide. Une fois terminé le document n'est pas enregistré, libre à l'utilisateur de le sauvegarder s'il le souhaite. Si le fichier n'existe pas, le nom du fichier est Imprimé dans la vue Rapport.

Interface utilisateur
Il n'y a pas vraiment d'interface graphique pour cette macro. La macro lit un fichier texte qui a été préparé avec un éditeur de texte et génère un modèle dans un document de sortie. En dehors du fait de cliquer sur le bouton de la barre d’outils pour lancer le processus, il n’y a pas d’interaction de la part de l’utilisateur.

Options
Il n'y a pas d'interface graphique, donc il n'y a pas d'options. Les seules alternatives qui existent consistent à utiliser les 3 types de lignes du fichier texte, comme décrit ci-dessus.

Remarques
Pour réitérer ce qui a été dit au début, cette macro n’est pas utile sur un fichier unique. Mais pour les personnes qui modélisent un avion, une locomotive, un navire, un bâtiment, une installation physique ou un circuit complexe, il existe un avantage et un avantage définitifs. En choisissant l'extension de fichier ".FCBld", on espère pouvoir définir une norme de tri pour les fichiers de construction dans FreeCAD. En réservant le caractère de préfixe "@" dans la définition du fichier de commande, on espère pouvoir en tenir compte pour une utilisation future et (si nécessaire) pour la croissance.

Liens
none (so far)

Script
Macro_Build_Utility.FCMacro

Exemple
Vous travaillez avec d'autres services de votre entreprise pour utiliser FreeCAD afin de générer un grand modèle de CAO pour un client externe. Pour préparer la présentation à venir, vous devez intégrer les modèles représentés dans les sous-systèmes "noir" et "bleu". Le service d'ingénierie est responsable des sous-systèmes "vert" et "gris" et vous disposez vous-même du sous-système "métal" sur votre ordinateur. Le client utilise également FreeCAD et votre conception doit intégrer leurs sous-systèmes "rouge" et "jaune". Le client externe vous a dit que l’empileur n’est pas prêt à être utilisé. Vous devez donc le commenter dans votre fichier de construction.

Il y a beaucoup de chemins de dossiers à taper afin que vous puissiez entrer les commandes dans le fichier texte de Build Utility, ce qui signifie que vous pouvez l'exécuter en un simple clic sur un bouton de la barre d'outils.



Le contenu du fichier de construction "buildFile.FCBld" présenté ci-dessous montre la structure de fichier du projet décrit ci-dessus.

Un résumé du fichier et de la façon dont il est traité est:
 * les deux premières lignes sont traitées comme des commentaires et tout ce qui suit le caractère initial du signe dièse est ignoré


 * la troisième ligne est également ignorée car son premier caractère est le caractère esperluette qui est réservé pour une utilisation future, où les fichiers de commande peuvent appeler d'autres fichiers de recommandation.


 * la cinquième ligne est la première spécification de fichier, le fichier est dans le même répertoire que le fichier de construction, pas dans un sous-répertoire


 * les septième et huitième lignes sont les deux spécifications de fichier où le fichier est dans un sous-répertoire, notez que le sous-répertoire est de la forme "./black/" où "noir" est le nom du répertoire, donc un fichier appelé "sheetFold.FCstd" dans le répertoire "outsourcing" apparaîtrait "./outsourcing/sheetFold"


 * la dix-neuvième ligne montre une spécification de fichier qui existe mais qui n'est pas incluse dans cette opération de construction


 * les deux dernières lignes montrent les spécifications du fichier où le fichier est dans plus d'un niveau de sous-répertoire