Py osv newsletter-042018

1. PyOSV
Modélisation libre d'objets complexes
Newsletter #2
Avril 2018
Auteur(s) : Guillaume Florent (florentsailing-at-gmail.com)
Repositories : https://github.com/osv-team

2. Qualité du projet
Depuis la Newsletter #1, le projet PyOSV est plus robuste. En effet, les librairies ccad, party, reversy
et osvcad sont soumises à un processus d'intégration continue. A chaque commit l'ensemble des
tests est éxécuté à la fois pour Python 2.7 et pour Python 3.6. La plateforme choisie est Travis CI
(https://travis-ci.org/) qui offre gratuitement l'intégration continue aux projets Open Source.
Le code du projet est également soumis à une plateforme d'analyse de qualité du code: Codacy
(https://www.codacy.com/). Codacy ne fournit pas d'informations quant au bon fonctionnement
mais analyse des défauts de code passant facilement inaperçus: variables non utilisées, utilisation
d'asserts, problèmes potentiels de sécurité ... En plus de la liste des problèmes, Codacy note les
projets de A à E. Ccad et osvcad ont un A lors que party, qui utilise éxécute du code généré à la volée,
reçoit un B.
Certains projets/packages maitrisés par les membres de osv-team et utilisés par PyOSV ont
également été placé sous Travis CI et Codacy: corelib, aocutils, aocxchange
(https://github.com/guillaume-florent).
Une installation plus facile
ccad et party sont désormais installable via la commande conda (conda est un package manager lié
à Miniconda/Anaconda - https://anaconda.org/)
Pour une installation locale, PythonOCC (>= 0.18.2) doit préalablement être installé en compilant
les sources.
Puis l'installation des librairies du projet PyOSV peut se faire de la manière suivante:
> conda install -c gflorent ccad
> conda install -c gflorent party
Remarque : le nom du 'channel' conda (le paramètre de l'option -c) devrait évoluer de gflorent vers
osvteam dans les semaines à venir.
Toutefois, chaque projet dispose d'un duo de scripts: install_<nom du projet>.sh et start_<nom du
projet>.sh qui, exécutés dans cet ordre, amèneront à la ligne de commande d'un container Docker
où les exemples peuvent être éxécutés et d'autres exemples testés, PythonOCC étant préalablement
compilé dans l'image Docker qui sert de base à l'image Docker spécifique à chaque projet.
Syntaxe
La syntaxe des exemples d'osvcad (et donc du package osvcad/nodes.py) a été modifiée. Le but est
d'obtenir un code plus proche de la pensée du concepteur.
PartGeometryNode devient Part.
AssemblyGeometryNode devient Assembly.

3. La méthode add_edge() est remplacée par une méthode link().
Ceci permet de passer de :
part_1 = PartGeometryNode(...)
part_2 = PartGeometryNode(...)
a = AssemblyGeometryNode(root=part1)
a.add_edge(part_1, Part_2, ....)
à
part_1 = Part(...)
part_2 = Part(...)
a = Assembly(root=part1)
a.link(part_1, Part_2, ....)
Bref, rien de compliqué mais une syntaxe a priori plus claire et plus proche de la conception 3D
Le viewer 3D wx sous Linux
Bonne nouvelle : il fonctionne ! Les problèmes étaient dus, entre autres, à la manière de créer les
objets wx contenant le viewer (ils doivent être visibles sous Linux pour que l'Id du viewer puisse
être récupérée, ce qui n'est pas le cas sous Windows).
Le viewer est géré par la classe osvcad.view.OsvCadFrame

4. Le point sur la roadmap
Légende:
en cours
terminé
Communication / communauté
• Tutoriel détaillé pour la création des librairies de pièces
• Rédaction d'un lexique autour du projet
• Liste des tâches avec temps estimé et degré de difficulté (afin de faciliter l'intégration de
nouveaux contributeurs)
• Documentation !
Spécifications
• Cas d'utilisations (aka Use Cases)
Qualité du projet
• Redaction d'un guide de contribution, des normes et standards de développement
• Python 3.6 +
• Packages installables via conda
• Images Docker des environnements
• Intégration Continue (Travis)
• Intégration Continue (Appveyor)
• Qualité de code (Codacy)
Fonctionnalités
PyOSV
• 2eme vecteur pour les ancres
• Lien entre 'Constraints' et liaisons mécaniques possibles.
• Nouveaux types de noeuds du graphe de modélisation.
• 'IDE' de conception
• Procédure d'extraction du site 'concepteur' vers le site 'fabricant'.
• Intégration FreeCAD
Web
• Site 'concepteur' / pateforme collaborative
• Site 'fabricant' / instructions de fabrication
Si vous ne souhaitez plus recevoir cette newsletter, merci de le signaler à Guillaume Florent (florentsailing-at-
gmail.com).