mgplot 0.2.21__tar.gz → 0.2.23__tar.gz

mgplot-0.2.23/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(uv run *)"
+    ]
+  }
+}

{mgplot-0.2.21 → mgplot-0.2.23}/CHANGELOG.md

@@ -1,3 +1,55 @@
+Version 0.2.23 - released 24-Apr-2026 (Canberra, Australia)
+
+* bug fix
+    - finalise_plot() now refreshes PeriodIndex x-axis ticks after applying
+      late-stage splat kwargs (axvspan, axvline). Previously, an axvspan or
+      axvline that extended the view beyond the plotted data (e.g. a
+      recession shade for dates before the series starts) would widen the
+      xlim but leave the tick labels frozen at the original data range
+    - a Period passed to axvspan/axvline now also widens the stashed period
+      range, so tick labels cover the span even when matplotlib's auto-scale
+      does not visibly extend the view
+
+* enhancement
+    - factored label regeneration out of set_labels() into the new
+      refresh_period_labels() helper in axis_utils
+    - added axes_only=True flag to finalise_plot() that suppresses all
+      figure-level side effects (fig.set_size_inches, fig.tight_layout,
+      fig.suptitle, header/footer fig.text, savefig, plt.show, plt.close).
+      Use when finalising individual axes inside a multi-panel figure
+      created with plt.subplots — the caller manages figure-level layout
+      and saving themselves
+    - added test_axvspan_period_widens_ticks and test_axes_only_preserves_figure
+      to test/test_splat_sequences.py
+    - added filename kwarg to finalise_plot() that overrides the title-derived
+      stem used in the saved file's name. The override is sanitized and still
+      composed with pre_tag/tag/file_type, so existing tagging behaviour is
+      preserved
+
+---
+
+Version 0.2.22 - released 22-Apr-2026 (Canberra, Australia)
+
+* bug fix
+    - finalise_plot() now converts pandas Period values passed to axvline
+      (x) and axvspan (xmin, xmax) into their integer ordinals, matching
+      the ordinal-mapped x-axis used for PeriodIndex plots
+
+* enhancement
+    - axis_utils now stashes (freq, min_ordinal, max_ordinal) on any Axes
+      that mgplot period-maps, via register_period_axes() / get_period_axes()
+    - set_labels() registers the PeriodIndex and uses the union of the
+      stashed ordinal range and the current xlim when building tick labels
+    - plotting a second PeriodIndex with a different freq onto the same
+      axes now raises ValueError (ordinals live in different spaces)
+    - finalise_plot() raises ValueError when a Period passed to
+      axvline/axvspan has a freq that does not match the axes' stashed freq;
+      axes without a stash (e.g. external matplotlib axes) retain the
+      trust-the-programmer behaviour and just use Period.ordinal
+    - added freq-mismatch tests to test/test_splat_sequences.py
+
+---
+
 Version 0.2.21 - released 17-Mar-2026 (Canberra, Australia)
 
 * enhancement

{mgplot-0.2.21 → mgplot-0.2.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mgplot
-Version: 0.2.21
+Version: 0.2.23
 Summary: mgplot is a time-series/PeriodIndex frontend for matplotlib
 Project-URL: Repository, https://github.com/bpalmer4/mgplot
 Project-URL: Homepage, https://github.com/bpalmer4/mgplot