tesorotools-python 0.0.54__tar.gz → 0.0.56__tar.gz

{tesorotools_python-0.0.54 → tesorotools_python-0.0.56}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tesorotools-python
-Version: 0.0.54
+Version: 0.0.56
 Requires-Python: >=3.13
 Requires-Dist: babel>=2.17
 Requires-Dist: matplotlib>=3.10

{tesorotools_python-0.0.54 → tesorotools_python-0.0.56}/src/tesorotools/artists/line_plot.py

@@ -392,6 +392,14 @@ class LinePlot:
         y-grid, baseline, last-value labels).  Requires the optional
         ``interactive_plots`` extra (``plotly``); imported lazily so the
         static path never needs it.  Returns a ``plotly.graph_objects.Figure``.
+
+        Not every knob makes the trip, and the ones that do not are
+        accepted silently.  ``axis_decimals``, ``vlines``, ``ref_lines``
+        and ``show_means`` / ``means_window`` are simply not translated
+        yet; ``legend.ncol``, the ``date_*`` knobs and the physical-size
+        ones (``figsize``, ``plot_size``, ``compact``, ``font_pt``,
+        ``adapt_height``) have no stable equivalent on an interactive
+        figure.  ``docs/plotly-backend.md`` keeps the full table.
         """
         from tesorotools.artists.plotly_backend import line_plot_to_figure
 

{tesorotools_python-0.0.54 → tesorotools_python-0.0.56}/src/tesorotools/artists/plotly_backend.py

@@ -18,9 +18,9 @@ Requires the optional ``interactive_plots`` extra (``plotly``).  Imported
 lazily from each artist's ``to_plotly`` so the static matplotlib path
 never depends on plotly.
 
-Coverage: line, type curve, stacked area, stacked bar, shock, waterfall,
-horizontal bar, grouped bar and matrix.  ``VectorPlot`` (bespoke arrow
-geometry) is not ported yet.
+Coverage: every image artist except ``IntradayPlot`` -- line, type
+curve, stacked area, stacked bar, bar+line, box, shock, waterfall,
+horizontal bar, grouped bar, matrix and vector.
 
 Known mimicry caveats (the styling that does NOT transfer for free between
 backends, per the dual-backend research):
@@ -30,7 +30,14 @@ backends, per the dual-backend research):
   references the family by name -- it falls back unless the font is
   installed where the figure is viewed.
 * The "compact" two-per-row Word layout is matplotlib-only; this spike
-  renders the normal (wide) form.
+  renders the normal (wide) form, so the physical-size knobs
+  (``figsize``, ``plot_size``, ``compact``, ``font_pt``,
+  ``adapt_height``) do nothing here.
+* Beyond those, a few per-artist knobs have no stable Plotly equivalent
+  and a few others are simply not translated yet.  Both kinds are
+  accepted in silence, so which is which is written down parameter by
+  parameter in ``docs/plotly-backend.md`` (audited for ``LinePlot``).
+  Keep that table in sync when adding or translating a parameter.
 """
 
 from __future__ import annotations

{tesorotools_python-0.0.54 → tesorotools_python-0.0.56}/src/tesorotools/assets/plots.yaml

@@ -195,8 +195,65 @@ compact:
   barh_per_bar_cm: 0.55        # alto adicional por cada barra
 
 table:
-  style: Light Shading Accent 1
+  style: Tabla Tesoro
   autofit: False
   block_separator:
-    fill: "BFBFBF"      # hex color of the inter-block band
+    fill: "001E93"      # hex color of the inter-block band
     height_twips: 20    # half-band height; total band = 2 * height_twips
+
+  # Todo lo que la tabla pinta y no es dato. Vive aquí y no en el código
+  # porque el estilo de Word (`Tabla Tesoro`, dentro de template.docx) y el
+  # repintado de las cabeceras tienen que salir del mismo sitio: si cada uno
+  # llevara sus colores, una tabla horizontal y una vertical acabarían
+  # distintas.
+  chrome:
+    # Fila de nombres de columna. Sin relleno (`header_fill` vacío = sobre
+    # el papel): la jerarquía la sostienen las reglas y el cuerpo del texto.
+    # En redonda, porque en negrita competiría con los rótulos de fila, que
+    # sí necesitan destacar: son la entrada a cada línea.
+    header_fill:
+    header_text: "000000"
+    header_bold: False
+    header_pt: 9.5
+
+    # Fila de bloques, sólo en tablas horizontales. En negrita: es el piso
+    # de arriba de la cabecera y lo que agrupa las columnas, y con la fila
+    # de columnas en redonda es lo que hace legible la jerarquía sin color.
+    block_fill:
+    block_text: "000000"
+    block_bold: True
+    block_pt: 9.5
+
+    # Cuerpo. Las cifras van en monoespaciada para que las comas decimales
+    # caigan alineadas y la columna se pueda recorrer con la vista; los
+    # rótulos se quedan en la fuente del documento. `figure_font` vacío lo
+    # apaga. Consolas y no Courier New: Courier es de máquina de escribir y
+    # al lado de una grotesca deja la tabla desequilibrada.
+    body_pt: 9
+    figure_font: Consolas
+
+    # Reglas. `rule` cierra la cabecera; `gap` subraya cada rótulo de bloque
+    # para decir qué columnas cuelgan de él (vacío la omite);
+    # `block_rule_size` separa dos bloques en columnas y mide lo mismo que
+    # la banda de las tablas de bloques en filas (2 pt = 2 * height_twips):
+    # las dos formas de separar un bloque del siguiente pesan igual porque
+    # son la misma cosa vista en el otro eje.
+    rule: "001E93"
+    rule_size: 12
+    gap: "001E93"
+    gap_size: 8
+    block_rule_size: 16
+
+    # El rótulo, dentro de la tabla como su primera fila. Fuera es un
+    # párrafo suelto que un salto de página puede separar de su tabla, y en
+    # el correo de un móvil hay clientes que reescriben el tamaño de un
+    # `<h2>` con el suyo. `title_inside: False` recupera el `Heading 2`
+    # encima de la tabla.
+    #
+    # Va dentro también por el bandeado: el `firstRow` del estilo cae sobre
+    # esta fila, y por eso `Tabla Tesoro` lleva el relleno en `band2Horz`.
+    # Con el rótulo fuera, las filas alternas salen en fase invertida.
+    title_inside: True
+    title_color: "001E93"
+    title_pt: 10
+    title_rule_size: 8