tesorotools-python 0.1.8__tar.gz → 0.1.10__tar.gz

{tesorotools_python-0.1.8 → tesorotools_python-0.1.10}/.gitignore

@@ -32,8 +32,9 @@ test/
 # ruff
 .ruff_cache/
 
-# uv cache (CI restores it into the repo root)
+# uv cache and verified-tree marks (CI restores them into the repo root)
 .uv-cache/
+.ci-verified/
 
 demo_compacto/
 demo/

{tesorotools_python-0.1.8 → tesorotools_python-0.1.10}/PKG-INFO

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

{tesorotools_python-0.1.8 → tesorotools_python-0.1.10}/src/tesorotools/artists/_common.py

@@ -403,9 +403,18 @@ class Legend:
     values work in compact and in full-size charts, so a
     compact chart in a Word table can carry its labels under
     the plot when the text above it already reads as a title.
+    ``font_pt`` fixes the size of the legend text (a slide wants it
+    as big as the ticks) and ``min_entries=2`` drops the legend of a
+    chart with a single series.
     """
 
-    def __init__(self, ncol: int | None = None, position: str = "auto") -> None:
+    def __init__(
+        self,
+        ncol: int | None = None,
+        position: str = "auto",
+        font_pt: float | None = None,
+        min_entries: int = 1,
+    ) -> None:
         if position not in LEGEND_POSITIONS:
             raise ValueError(
                 f"legend position must be one of {LEGEND_POSITIONS}: "
@@ -413,6 +422,12 @@ class Legend:
             )
         self.ncol = ncol
         self.position = position
+        #: Size of the legend text (points); ``None`` keeps the house
+        #: size (``compact.legend_font_pt``, never above the ticks).
+        self.font_pt = font_pt
+        #: Fewer entries than this draw no legend: ``2`` leaves a chart
+        #: of a single series without one.
+        self.min_entries = min_entries
 
     @classmethod
     def from_yaml(cls, loader: TemplateLoader, node: MappingNode) -> Self:
@@ -1562,6 +1577,8 @@ def place_legend(
     ncol: int | None = None,
     position: str = "auto",
     entries: tuple[list[Any], list[str]] | None = None,
+    font_pt: float | None = None,
+    min_entries: int = 1,
 ) -> MplLegend | None:
     """Place the figure legend, compact-aware, from the labelled artists.
 
@@ -1575,17 +1592,21 @@ def place_legend(
     ``entries`` passes precomputed ``(handles, labels)`` instead of reading
     them off *ax* -- for charts whose series span several axes (a
     ``twinx`` secondary y-axis), in the order the legend should list them.
-    Returns ``None`` (drawing nothing) when there are no labels.
+    ``font_pt`` sets the size of the legend text.  Returns ``None``
+    (drawing nothing) when there are no labels, or fewer than
+    ``min_entries``.
     """
     handles, labels = (
         entries if entries is not None else ax.get_legend_handles_labels()
     )
-    if not labels:
+    if not labels or len(labels) < min_entries:
         return None
     side = resolve_legend_position(position, compact=compact)
     fig_w_px: float = fig.get_size_inches()[0] * fig.dpi
     if compact:
         legend_kw = compact_legend_kwargs(ax)
+        if font_pt is not None:
+            legend_kw["fontsize"] = font_pt
         if ncol is None:
             ncol = auto_ncol(
                 ax, labels, available_width_px=fig_w_px, **legend_kw
@@ -1603,8 +1624,12 @@ def place_legend(
             **legend_kw,
         )
     if ncol is None:
-        ncol = auto_ncol(ax, labels, available_width_px=fig_w_px)
-    return legend_band(ax, handles, labels, ncol=ncol, position=side)
+        ncol = auto_ncol(
+            ax, labels, available_width_px=fig_w_px, fontsize=font_pt
+        )
+    return legend_band(
+        ax, handles, labels, ncol=ncol, position=side, fontsize=font_pt
+    )
 
 
 def legend_layout(legend: Legend | None) -> dict[str, Any]:
@@ -1620,9 +1645,13 @@ def legend_layout(legend: Legend | None) -> dict[str, Any]:
             fig, ax, compact=self.compact, **legend_layout(self.legend)
         )
     """
+    if legend is None:
+        return {"ncol": None, "position": "auto"}
     return {
-        "ncol": legend.ncol if legend is not None else None,
-        "position": legend.position if legend is not None else "auto",
+        "ncol": legend.ncol,
+        "position": legend.position,
+        "font_pt": legend.font_pt,
+        "min_entries": legend.min_entries,
     }
 
 

{tesorotools_python-0.1.8 → tesorotools_python-0.1.10}/src/tesorotools/artists/box_plot.py

@@ -500,6 +500,8 @@ class BoxPlot(FigureLifecycle):
         )
         if self.compact:
             kw = compact_legend_kwargs(ax)
+            if self.legend.font_pt is not None:
+                kw["fontsize"] = self.legend.font_pt
             ncol = self.legend.ncol or auto_ncol(
                 ax, labels, available_width_px=fig_w_px, **kw
             )

{tesorotools_python-0.1.8 → tesorotools_python-0.1.10}/src/tesorotools/note/lint.py

@@ -17,7 +17,7 @@ from __future__ import annotations
 
 import re
 import unicodedata
-from collections.abc import Callable, Iterator, Sequence
+from collections.abc import Callable, Collection, Iterable, Iterator, Sequence
 from dataclasses import dataclass
 from pathlib import Path
 
@@ -357,9 +357,9 @@ _RULES: tuple[_Rule, ...] = (
         "las siglas no llevan plural gráfico (las IIC, no las IICs)",
     ),
     _r(
-        r"\b(?:ECB|IMF|BIS|FSB|OECD|ESRB|EIB)\b",
+        r"\b(?:ECB|IMF|BIS|FSB|OECD|ESRB|EIB|GDP|CPI)\b",
         "siglas",
-        "usa la sigla española (BCE, FMI, BPI, CEF, OCDE, JERS, BEI)",
+        "usa la sigla española (BCE, FMI, BPI, CEF, OCDE, JERS, BEI, PIB, IPC)",
         _outside_title,
         "todo",
     ),
@@ -560,10 +560,18 @@ def _scope_texts(text: str, scope: str) -> Iterator[_Rule]:
 _CROSS_REF = re.compile(r"\[@[^\]]*\]")
 
 
-def _text_issues(line: int, text: str, scope: str) -> Iterator[Issue]:
-    """The text rules of *scope* (``todo``, ``texto`` or ``prosa``)."""
+def _text_issues(
+    line: int, text: str, scope: str, only: Collection[str] | None = None
+) -> Iterator[Issue]:
+    """The text rules of *scope* (``todo``, ``texto`` or ``prosa``).
+
+    *only* keeps the rules with those names (the presentations take a
+    part of them).
+    """
     text = _CROSS_REF.sub(" ", _URL.sub(" ", text))
     for rule in _scope_texts(text, scope):
+        if only is not None and rule.rule not in only:
+            continue
         for match in rule.pattern.finditer(text):
             if rule.keep is None or rule.keep(text, match):
                 yield Issue(
@@ -990,16 +998,26 @@ def _acronym_issues(
     title; well-known indices, benchmarks, currencies and sources need no
     expansion (*known* adds more).
     """
-    seen: set[str] = set()
+    texts: list[tuple[int, str]] = []
     appendix = False
     for block in source.blocks:
         if isinstance(block, Heading) and block.level == 1:
             appendix = is_appendix(block.text)
-        if appendix or not isinstance(
+        if not appendix and isinstance(
             block, (Paragraph, Bullet, Numbered, Heading)
         ):
-            continue
-        text = _AUTHOR_CITATION.sub(" ", _plain_text(block.text))
+            texts.append((block.line, block.text))
+    return _first_use_issues(texts, known)
+
+
+def _first_use_issues(
+    texts: Iterable[tuple[int, str]], known: Collection[str] = frozenset()
+) -> Iterator[Issue]:
+    """Acronyms of *texts* (``(line, text)`` in order) whose first
+    appearance is not «Full name (ACR)» nor explained right after it."""
+    seen: set[str] = set()
+    for line, raw in texts:
+        text = _AUTHOR_CITATION.sub(" ", _plain_text(raw))
         for match in _ACRONYM.finditer(text):
             acronym = match.group(0)
             if (
@@ -1017,7 +1035,7 @@ def _acronym_issues(
             ):
                 continue
             yield Issue(
-                block.line,
+                line,
                 "siglas",
                 f"«{acronym}»: en su primera aparición, escribe el nombre"
                 f" completo y la sigla entre paréntesis («... ({acronym})»),"

{tesorotools_python-0.1.8 → tesorotools_python-0.1.10}/src/tesorotools/palette.py

@@ -31,6 +31,8 @@ BLUE_PALE = "AEBAE7"
 BLUE_FAINT = "ECF0FD"
 #: Secondary text: captions, metadata, stale rows.
 GREY = "6D6D6D"
+#: Plot area of the slide charts, under white grid lines.
+GREY_PANEL = "EFEFEF"
 #: Tesoro yellow: highlights of the presentations (bands, frames, the
 #: section subtitles of the index) and its light shade for fills.
 YELLOW = "FFBD4C"

{tesorotools_python-0.1.8 → tesorotools_python-0.1.10}/src/tesorotools/presentation/__init__.py

@@ -23,35 +23,51 @@ from tesorotools.presentation.builder import (
     Chart,
     Figure,
     Figures,
+    Flow,
+    FlowStep,
     Matrix,
+    Milestone,
     Presentation,
     Scheme,
     Steps,
     Table,
+    Timeline,
     month_text,
 )
 from tesorotools.presentation.charts import (
     SLIDE_CHART_CM,
     SLIDE_FONT_PT,
+    SLIDE_STYLE,
     slide_chart_size,
+    slide_style,
 )
 from tesorotools.presentation.cli import skill_text
-from tesorotools.presentation.lint import check, style_issues
+from tesorotools.presentation.glossary import acronyms
+from tesorotools.presentation.lint import check, headline_issues, style_issues
 from tesorotools.presentation.markdown import (
+    DeckExtras,
     DeckSource,
     PresentationError,
+    RenderedChart,
     SlideRenderer,
     assemble,
     build,
     parse,
     read,
 )
+from tesorotools.presentation.native import (
+    NATIVE_KINDS,
+    add_native_chart,
+    data_notes,
+)
 from tesorotools.presentation.template import LAYOUTS, open_template
 
 __all__ = [
     "LAYOUTS",
+    "NATIVE_KINDS",
     "SLIDE_CHART_CM",
     "SLIDE_FONT_PT",
+    "SLIDE_STYLE",
     "Alternative",
     "Alternatives",
     "Assessment",
@@ -59,24 +75,35 @@ __all__ = [
     "Band",
     "Bands",
     "Chart",
+    "DeckExtras",
     "DeckSource",
     "Figure",
     "Figures",
+    "Flow",
+    "FlowStep",
     "Matrix",
+    "Milestone",
     "Presentation",
     "PresentationError",
+    "RenderedChart",
     "Scheme",
     "SlideRenderer",
     "Steps",
     "Table",
+    "Timeline",
+    "acronyms",
+    "add_native_chart",
     "assemble",
     "build",
     "check",
+    "data_notes",
     "month_text",
     "open_template",
     "parse",
     "read",
     "skill_text",
     "slide_chart_size",
+    "headline_issues",
+    "slide_style",
     "style_issues",
 ]