Structure interne
=================

Ce document est destine aux developpeurs. Il regroupe des conventions de structure
interne qui ne sont pas necessaires pour un lecteur utilisateur.

pyvertexvectors
---------------

Factories: convention d'implementation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Dans la famille de modules ``pyvertexvectors``, les routines de factory
(``_make_vector``, ``_make_zone``, ``_make_zones``, ``_make_properties``, etc.)
sont volontairement des **methodes d'instance**.

Raison principale:

- conserver le polymorphisme modele/GUI sans couplage fort
- permettre l'utilisation du contexte de l'objet courant (parent, options, hooks)
- faciliter les remplacements/mocks en tests unitaires

Regle de maintenance:

- utiliser systematiquement ``self._make_*`` dans le code interne lorsqu'un objet sibling est cree
- ne pas convertir ces factories en ``@classmethod`` sauf besoin explicite,
  stateless, documente et valide par revue

Notes de portage
~~~~~~~~~~~~~~~~

La convention ci-dessus est appliquee dans les classes GUI ``Zones``, ``zone``
et ``Triangulation``. L'objectif est d'eviter les regressions lors des refactors
(modele/GUI) et de conserver un point d'extension unique pour les creations d'objets.