Modulo 1: serializacion Hull / Project en formato .arsd (Task 11)

- hull.py: Hull.to_dict() serializa a dict JSON con formato hull_v1
  (arrays numpy -> listas Python); Hull.from_dict() deserializa con
  validacion de claves y forma de array.

- project.py: Project.hull (property lazy) deserializa el Hull desde
  ship_data; Project.set_hull() persiste el Hull y marca is_modified.

- main_window.py: _on_new_project guarda el Hull en el proyecto;
  _on_project_loaded restaura el Hull en todos los visores al abrir
  un archivo .arsd; _on_hull_changed_from_editor mantiene el proyecto
  sincronizado con ediciones en el editor de offsets.

- test_serialization.py: 26 tests (round-trip dict, round-trip ZIP,
  5 familias parametricas, escritura atomica, proyecto sin Hull).

Suite total: 112 tests -- 112 passed.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-05-27 08:33:34 -04:00
parent 2137b0a228
commit 3b0d5e9e50
4 changed files with 376 additions and 1 deletions
+39
View File
@@ -248,6 +248,45 @@ class Project:
"""Marca el proyecto como modificado."""
self._is_modified = True
# ──────────────────────────────────────────────
# HULL
# ──────────────────────────────────────────────
@property
def hull(self):
"""Hull activo del proyecto, o None si no hay geometría guardada.
El Hull se deserializa bajo demanda desde ship_data["hull"].
La primera llamada realiza la conversión; las siguientes también
(el objeto no se cachea para mantener la coherencia con ediciones
posteriores de ship_data).
Returns
-------
Hull | None
"""
hull_data = self.ship_data.get("hull")
if not hull_data or hull_data.get("format") not in ("hull_v1",):
return None
try:
from arshipdesign.core.hull import Hull
return Hull.from_dict(hull_data)
except Exception as exc:
logger.warning("No se pudo deserializar el Hull: %s", exc)
return None
def set_hull(self, hull) -> None:
"""Serializa el Hull en ship_data y marca el proyecto como modificado.
Parameters
----------
hull : Hull
El casco a guardar. Se serializa llamando a ``hull.to_dict()``.
"""
self.ship_data["hull"] = hull.to_dict()
self._is_modified = True
logger.debug("Hull '%s' guardado en proyecto '%s'", hull.name, self.name)
def __repr__(self) -> str:
return f"Project(name={self.name!r}, path={self.path})"