tesorotools-python 0.0.41__tar.gz → 0.0.43__tar.gz

{tesorotools_python-0.0.41 → tesorotools_python-0.0.43}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tesorotools-python
-Version: 0.0.41
+Version: 0.0.43
 Requires-Python: >=3.13
 Requires-Dist: babel>=2.17
 Requires-Dist: matplotlib>=3.10
@@ -16,3 +16,5 @@ Provides-Extra: bde
 Requires-Dist: requests>=2.31; extra == 'bde'
 Provides-Extra: ecb
 Requires-Dist: requests>=2.31; extra == 'ecb'
+Provides-Extra: lseg
+Requires-Dist: lseg-data>=2.1; extra == 'lseg'

{tesorotools_python-0.0.41 → tesorotools_python-0.0.43}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "tesorotools-python"
 requires-python = ">=3.13"
-version = "0.0.41"
+version = "0.0.43"
 dependencies = [
     # database and ORM
     "psycopg[binary]>=3.1",
@@ -27,6 +27,7 @@ dependencies = [
 [project.optional-dependencies]
 bde = ["requests>=2.31"]
 ecb = ["requests>=2.31"]
+lseg = ["lseg-data>=2.1"]
 
 [dependency-groups]
 dev = [

{tesorotools_python-0.0.41 → tesorotools_python-0.0.43}/src/tesorotools/__init__.py

@@ -1,148 +1,157 @@
-"""tesorotools public API.
-
-Importing ``tesorotools`` eagerly loads artist and render
-classes (their modules run matplotlib/locale setup as side
-effects) and registers their YAML tags via
-``_register_builtins``.
-
-Provider subclasses gated by optional extras
-(``BdeProvider`` requires ``[bde]``, ``EcbProvider``
-requires ``[ecb]``) are exposed lazily through
-``__getattr__``; importing this module does not require the
-extras to be installed.
-
-Third parties extend the package via ``register_artist``,
-``register_tag``, and ``register_provider`` (and their
-plural variants).  See ``docs/extending.md`` for the
-recommended idioms.
-"""
-
-from typing import TYPE_CHECKING, Any
-
-if TYPE_CHECKING:
-    from tesorotools.providers.bde import BdeProvider
-    from tesorotools.providers.ecb import EcbProvider
-
-from tesorotools._build_context import BuildContext
-from tesorotools._registry import (
-    Artist,
-    YamlConstructor,
-    all_artists,
-    all_providers,
-    all_tags,
-    get_artist,
-    get_provider,
-    iter_artists,
-    iter_providers,
-    iter_tags,
-    register_artist,
-    register_artists,
-    register_provider,
-    register_providers,
-    register_tag,
-    register_tags,
-)
-from tesorotools.artists import (
-    Format,
-    HorizontalBarChart,
-    Legend,
-    LinePlot,
-    StackedAreaPlot,
-    StackedBarPlot,
-    TypeCurve,
-)
-from tesorotools.orchestration import CompositeRegistry, iter_contexts
-from tesorotools.providers.base import (
-    DataProvider,
-    RegistryProtocol,
-    bootstrap_providers,
-)
-from tesorotools.render import (
-    Content,
-    Image,
-    Images,
-    Report,
-    Section,
-    Subtitle,
-    Table,
-    Text,
-    Title,
-)
-
-
-def _register_builtins() -> None:
-    register_artist("line_plot", LinePlot)
-    register_artist("stacked_area", StackedAreaPlot)
-    register_artist("stacked_bar", StackedBarPlot)
-    register_artist("barh", HorizontalBarChart)
-    register_artist("type_curve", TypeCurve)
-
-    register_tag("format", Format)
-    register_tag("legend", Legend)
-    register_tag("report", Report)
-    register_tag("section", Section)
-    register_tag("image", Image)
-    register_tag("images", Images)
-    register_tag("table", Table)
-    register_tag("text", Text)
-    register_tag("title", Title)
-    register_tag("subtitle", Subtitle)
-
-
-_register_builtins()
-
-
-__all__ = [
-    "Artist",
-    "BdeProvider",
-    "BuildContext",
-    "CompositeRegistry",
-    "Content",
-    "DataProvider",
-    "EcbProvider",
-    "Format",
-    "HorizontalBarChart",
-    "Image",
-    "Images",
-    "Legend",
-    "LinePlot",
-    "RegistryProtocol",
-    "Report",
-    "Section",
-    "StackedAreaPlot",
-    "StackedBarPlot",
-    "Subtitle",
-    "Table",
-    "Text",
-    "Title",
-    "TypeCurve",
-    "YamlConstructor",
-    "all_artists",
-    "all_providers",
-    "all_tags",
-    "bootstrap_providers",
-    "get_artist",
-    "get_provider",
-    "iter_artists",
-    "iter_contexts",
-    "iter_providers",
-    "iter_tags",
-    "register_artist",
-    "register_artists",
-    "register_provider",
-    "register_providers",
-    "register_tag",
-    "register_tags",
-]
-
-
-def __getattr__(name: str) -> Any:
-    if name == "BdeProvider":
-        from tesorotools.providers.bde import BdeProvider
-
-        return BdeProvider
-    if name == "EcbProvider":
-        from tesorotools.providers.ecb import EcbProvider
-
-        return EcbProvider
-    raise AttributeError(f"module 'tesorotools' has no attribute {name!r}")
+"""tesorotools public API.
+
+Importing ``tesorotools`` eagerly loads artist and render
+classes (their modules run matplotlib/locale setup as side
+effects) and registers their YAML tags via
+``_register_builtins``.
+
+Provider subclasses gated by optional extras
+(``BdeProvider`` requires ``[bde]``, ``EcbProvider``
+requires ``[ecb]``, ``LSEGProvider`` requires ``[lseg]``)
+are exposed lazily through ``__getattr__``; importing this
+module does not require the extras to be installed.
+
+Third parties extend the package via ``register_artist``,
+``register_tag``, and ``register_provider`` (and their
+plural variants).  See ``docs/extending.md`` for the
+recommended idioms.
+"""
+
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from tesorotools.providers.bde import BdeProvider
+    from tesorotools.providers.ecb import EcbProvider
+    from tesorotools.providers.lseg import LSEGProvider
+
+from tesorotools._build_context import BuildContext
+from tesorotools._registry import (
+    Artist,
+    YamlConstructor,
+    all_artists,
+    all_providers,
+    all_tags,
+    get_artist,
+    get_provider,
+    iter_artists,
+    iter_providers,
+    iter_tags,
+    register_artist,
+    register_artists,
+    register_provider,
+    register_providers,
+    register_tag,
+    register_tags,
+)
+from tesorotools.artists import (
+    Format,
+    GroupedBarChart,
+    HorizontalBarChart,
+    Legend,
+    LinePlot,
+    StackedAreaPlot,
+    StackedBarPlot,
+    TypeCurve,
+)
+from tesorotools.orchestration import CompositeRegistry, iter_contexts
+from tesorotools.providers.base import (
+    DataProvider,
+    RegistryProtocol,
+    bootstrap_providers,
+)
+from tesorotools.render import (
+    Content,
+    Image,
+    Images,
+    Report,
+    Section,
+    Subtitle,
+    Table,
+    Text,
+    Title,
+)
+
+
+def _register_builtins() -> None:
+    register_artist("line_plot", LinePlot)
+    register_artist("stacked_area", StackedAreaPlot)
+    register_artist("stacked_bar", StackedBarPlot)
+    register_artist("barh", HorizontalBarChart)
+    register_artist("grouped_barh", GroupedBarChart)
+    register_artist("type_curve", TypeCurve)
+
+    register_tag("format", Format)
+    register_tag("legend", Legend)
+    register_tag("report", Report)
+    register_tag("section", Section)
+    register_tag("image", Image)
+    register_tag("images", Images)
+    register_tag("table", Table)
+    register_tag("text", Text)
+    register_tag("title", Title)
+    register_tag("subtitle", Subtitle)
+
+
+_register_builtins()
+
+
+__all__ = [
+    "Artist",
+    "BdeProvider",
+    "BuildContext",
+    "CompositeRegistry",
+    "Content",
+    "DataProvider",
+    "EcbProvider",
+    "Format",
+    "GroupedBarChart",
+    "HorizontalBarChart",
+    "Image",
+    "Images",
+    "Legend",
+    "LinePlot",
+    "LSEGProvider",
+    "RegistryProtocol",
+    "Report",
+    "Section",
+    "StackedAreaPlot",
+    "StackedBarPlot",
+    "Subtitle",
+    "Table",
+    "Text",
+    "Title",
+    "TypeCurve",
+    "YamlConstructor",
+    "all_artists",
+    "all_providers",
+    "all_tags",
+    "bootstrap_providers",
+    "get_artist",
+    "get_provider",
+    "iter_artists",
+    "iter_contexts",
+    "iter_providers",
+    "iter_tags",
+    "register_artist",
+    "register_artists",
+    "register_provider",
+    "register_providers",
+    "register_tag",
+    "register_tags",
+]
+
+
+def __getattr__(name: str) -> Any:
+    if name == "BdeProvider":
+        from tesorotools.providers.bde import BdeProvider
+
+        return BdeProvider
+    if name == "EcbProvider":
+        from tesorotools.providers.ecb import EcbProvider
+
+        return EcbProvider
+    if name == "LSEGProvider":
+        from tesorotools.providers.lseg import LSEGProvider
+
+        return LSEGProvider
+    raise AttributeError(f"module 'tesorotools' has no attribute {name!r}")

{tesorotools_python-0.0.41 → tesorotools_python-0.0.43}/src/tesorotools/artists/__init__.py

@@ -1,47 +1,48 @@
-"""Image artists.
-
-Five chart classes, one shared helpers module, one
-matplotlib stylesheet side effect on import.
-
-Each class follows the same shape:
-
-* ``__init__(out_path, *, data | data_path, series, ...)``
-  -- kw-only configuration; ``out_path`` must be ``.png``.
-  Pass either ``data`` (DataFrame in memory) or
-  ``data_path`` (``.feather`` on disk), never both.
-* ``from_yaml(loader, node)`` -- builds the same instance
-  from a ``!{name}`` YAML tag.
-* ``plot()`` -- renders the chart and writes the PNG; some
-  classes also expose ``build()`` / ``save()`` for
-  fine-grained control.
-
-Shared layout, annotation and styling helpers (plus the
-``Format`` and ``Legend`` config holders) live in
-:mod:`tesorotools.artists._common`.
-
-Document-element artists (Word tables, sections, titles)
-live under :mod:`tesorotools.render`; this package is
-strictly image output.
-"""
-
-import matplotlib.style
-
-from tesorotools.artists._common import Artist, Format, Legend
-from tesorotools.artists.barh_plot import HorizontalBarChart
-from tesorotools.artists.line_plot import LinePlot
-from tesorotools.artists.stacked import StackedAreaPlot, StackedBarPlot
-from tesorotools.artists.type_curve import TypeCurve
-from tesorotools.utils.globals import STYLE_SHEET
-
-matplotlib.style.use(STYLE_SHEET)
-
-__all__ = [
-    "Artist",
-    "Format",
-    "HorizontalBarChart",
-    "Legend",
-    "LinePlot",
-    "StackedAreaPlot",
-    "StackedBarPlot",
-    "TypeCurve",
-]
+"""Image artists.
+
+Five chart classes, one shared helpers module, one
+matplotlib stylesheet side effect on import.
+
+Each class follows the same shape:
+
+* ``__init__(out_path, *, data | data_path, series, ...)``
+  -- kw-only configuration; ``out_path`` must be ``.png``.
+  Pass either ``data`` (DataFrame in memory) or
+  ``data_path`` (``.feather`` on disk), never both.
+* ``from_yaml(loader, node)`` -- builds the same instance
+  from a ``!{name}`` YAML tag.
+* ``plot()`` -- renders the chart and writes the PNG; some
+  classes also expose ``build()`` / ``save()`` for
+  fine-grained control.
+
+Shared layout, annotation and styling helpers (plus the
+``Format`` and ``Legend`` config holders) live in
+:mod:`tesorotools.artists._common`.
+
+Document-element artists (Word tables, sections, titles)
+live under :mod:`tesorotools.render`; this package is
+strictly image output.
+"""
+
+import matplotlib.style
+
+from tesorotools.artists._common import Artist, Format, Legend
+from tesorotools.artists.barh_plot import GroupedBarChart, HorizontalBarChart
+from tesorotools.artists.line_plot import LinePlot
+from tesorotools.artists.stacked import StackedAreaPlot, StackedBarPlot
+from tesorotools.artists.type_curve import TypeCurve
+from tesorotools.utils.globals import STYLE_SHEET
+
+matplotlib.style.use(STYLE_SHEET)
+
+__all__ = [
+    "Artist",
+    "Format",
+    "GroupedBarChart",
+    "HorizontalBarChart",
+    "Legend",
+    "LinePlot",
+    "StackedAreaPlot",
+    "StackedBarPlot",
+    "TypeCurve",
+]