plotnine 0.15.2__tar.gz → 0.16.0a1__tar.gz

{plotnine-0.15.2 → plotnine-0.16.0a1}/.github/workflows/documentation.yml

@@ -16,7 +16,7 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
@@ -33,8 +33,8 @@ jobs:
 
       - name: See outputs
         run: |
-          echo 'deploy_to=${{ steps.variables.outputs.deploy_to }}'
-          echo 'commit_title=${{ steps.variables.outputs.commit_title }}'
+          echo deploy_to="${{ steps.variables.outputs.deploy_to }}"
+          echo commit_title="${{ steps.variables.outputs.commit_title }}"
 
   build-documentation:
     runs-on: ubuntu-latest
@@ -42,14 +42,14 @@ jobs:
 
     strategy:
       matrix:
-        python-version: [3.13]
+        python-version: [3.14]
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Install uv and set python version
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           python-version: ${{ matrix.python-version }}
 

{plotnine-0.15.2 → plotnine-0.16.0a1}/.github/workflows/release.yml

@@ -21,14 +21,14 @@ jobs:
 
     strategy:
       matrix:
-        python-version: ["3.13"]
+        python-version: ["3.14"]
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -63,15 +63,17 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           python-version: ${{ matrix.python-version }}
 
       - name: Install Packages
-        run: uv run uv pip install build
+        run: |
+          uv sync
+          uv pip install build
 
       - name: Build a wheel and a source tarball
         run: make dist

{plotnine-0.15.2 → plotnine-0.16.0a1}/.github/workflows/testing.yml

@@ -26,14 +26,14 @@ jobs:
         include:
           - python-version: "3.10"
             resolution: "lowest-direct"
-          - python-version: 3.13
+          - python-version: 3.14
             resolution: "highest"
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -41,7 +41,8 @@ jobs:
         run: |
           # Install as an editable so that the coverage path
           # is predicable
-          uv run uv pip install --resolution=${{ matrix.resolution }} -e ".[extra,test]"
+          uv sync
+          uv pip install --resolution=${{ matrix.resolution }} -e ".[extra,test]"
 
       - name: Environment Information
         run: uv pip list
@@ -70,65 +71,69 @@ jobs:
           token: ${{ secrets.CODECOV_TOKEN }}
           fail_ci_if_error: true
 
-  # lint-and-format:
-  #   runs-on: ubuntu-latest
-  #
-  #   # We want to run on external PRs, but not on our own internal PRs as they'll be run
-  #   # by the push to the branch.
-  #   if: github.event_name == 'push' || github.event.pull_request.head.repo.full_name != github.repository
-  #
-  #   strategy:
-  #     matrix:
-  #       python-version: [3.13]
-  #   steps:
-  #     - name: Checkout Code
-  #       uses: actions/checkout@v4
-  #
-  #     - name: Install a specific version of uv
-  #       uses: astral-sh/setup-uv@v6
-  #       with:
-  #         python-version: ${{ matrix.python-version }}
-  #
-  #     - name: Install Packages
-  #       run: uv run uv pip install ruff
-  #
-  #     - name: Environment Information
-  #       run: uv pip list
-  #
-  #     - name: Check lint with Ruff
-  #       run: make lint
-  #
-  #     - name: Check format with Ruff
-  #       run: make format
-
-  # typecheck:
-  #   runs-on: ubuntu-latest
-  #
-  #   # We want to run on external PRs, but not on our own internal PRs as they'll be run
-  #   # by the push to the branch.
-  #   if: github.event_name == 'push' || github.event.pull_request.head.repo.full_name != github.repository
-  #
-  #   strategy:
-  #     matrix:
-  #       python-version: [3.13]
-  #
-  #   steps:
-  #     - name: Checkout Code
-  #       uses: actions/checkout@v4
-  #
-  #     - name: Install a specific version of uv
-  #       uses: astral-sh/setup-uv@v6
-  #       with:
-  #         python-version: ${{ matrix.python-version }}
-  #
-  #     - name: Install Packages
-  #       run: uv run uv pip install ".[extra, typing]"
-  #
-  #     - name: Environment Information
-  #       run: uv pip list
-  #
-  #     - name: Run Tests
-  #       run: make typecheck
+  lint-and-format:
+    runs-on: ubuntu-latest
+
+    # We want to run on external PRs, but not on our own internal PRs as they'll be run
+    # by the push to the branch.
+    if: github.event_name == 'push' || github.event.pull_request.head.repo.full_name != github.repository
+
+    strategy:
+      matrix:
+        python-version: [3.14]
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v6
+
+      - name: Install a specific version of uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install Packages
+        run: |
+          uv sync
+          uv pip install ruff
+
+      - name: Environment Information
+        run: uv pip list
+
+      - name: Check lint with Ruff
+        run: make lint
+
+      - name: Check format with Ruff
+        run: make format
+
+  typecheck:
+    runs-on: ubuntu-latest
+
+    # We want to run on external PRs, but not on our own internal PRs as they'll be run
+    # by the push to the branch.
+    if: github.event_name == 'push' || github.event.pull_request.head.repo.full_name != github.repository
+
+    strategy:
+      matrix:
+        python-version: [3.14]
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v6
+
+      - name: Install a specific version of uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install Packages
+        run: |
+          uv sync
+          uv pip install ".[extra, typing]"
+
+      - name: Environment Information
+        run: uv pip list
+
+      - name: Run Tests
+        run: make typecheck
 
   call-build-documentation:
     if: |
@@ -138,7 +143,7 @@ jobs:
 
   build-website:
     # Requires all the previous jobs to pass
-    needs: [unittests, call-build-documentation]
+    needs: [unittests, lint-and-format, typecheck, call-build-documentation]
     if: |
       github.event_name == 'push' &&
       github.ref == 'refs/heads/main'

{plotnine-0.15.2 → plotnine-0.16.0a1}/.github/workflows/weekly.yml

@@ -13,20 +13,21 @@ jobs:
 
     strategy:
       matrix:
-        python-version: [3.13]
+        python-version: [3.14]
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           python-version: ${{ matrix.python-version }}
 
       - name: Install Packages
         run: |
-          uv run uv pip install ".[extra,test]"
+          uv sync
+          uv pip install ".[extra,test]"
           uv pip install --upgrade git+https://github.com/matplotlib/matplotlib
 
       - name: Environment Information
@@ -47,21 +48,22 @@ jobs:
 
     strategy:
       matrix:
-        python-version: [3.13]
+        python-version: [3.14]
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           python-version: ${{ matrix.python-version }}
 
 
       - name: Install Packages
         run: |
-          uv run uv pip install ".[extra,test]"
+          uv sync
+          uv pip install ".[extra,test]"
           uv pip install --upgrade git+https://github.com/pandas-dev/pandas
 
       - name: Environment Information
@@ -83,7 +85,7 @@ jobs:
 
     strategy:
       matrix:
-        python-version: [3.13]
+        python-version: [3.14]
 
     steps:
       - name: Get latest release with tag from GitHub API
@@ -96,18 +98,19 @@ jobs:
           echo ${{ steps.latestrelease.outputs.latestrelease }}
 
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           ref: ${{ steps.latestrelease.outputs.latestrelease }}
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           python-version: ${{ matrix.python-version }}
 
       - name: Install Packages
         run: |
-          uv run uv pip install --upgrade git+https://github.com/matplotlib/matplotlib
+          uv sync
+          uv pip install --upgrade git+https://github.com/matplotlib/matplotlib
           uv pip install ".[extra,test]"
 
       - name: Environment Information
@@ -128,7 +131,7 @@ jobs:
 
     strategy:
       matrix:
-        python-version: [3.13]
+        python-version: [3.14]
 
     steps:
       - name: Get latest release with tag from GitHub API
@@ -141,18 +144,19 @@ jobs:
           echo ${{ steps.latestrelease.outputs.latestrelease }}
 
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           ref: ${{ steps.latestrelease.outputs.latestrelease }}
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           python-version: ${{ matrix.python-version }}
 
       - name: Install Packages
         run: |
-          uv run uv pip install --upgrade git+https://github.com/pandas-dev/pandas
+          uv sync
+          uv pip install --upgrade git+https://github.com/pandas-dev/pandas
           uv pip install ".[extra,test]"
 
       - name: Environment Information
@@ -176,11 +180,11 @@ jobs:
 
     strategy:
       matrix:
-        python-version: [3.13]
+        python-version: [3.14]
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Install a specific version of uv
         uses: astral-sh/setup-uv@v6
@@ -189,7 +193,8 @@ jobs:
 
       - name: Install Packages
         run: |
-          uv run uv pip install ".[extra,typing]"
+          uv sync
+          uv pip install ".[extra,typing]"
           uv pip install --upgrade git+https://github.com/matplotlib/matplotlib
 
       - name: Environment Information
@@ -205,11 +210,11 @@ jobs:
 
     strategy:
       matrix:
-        python-version: [3.13]
+        python-version: [3.14]
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Install a specific version of uv
         uses: astral-sh/setup-uv@v6
@@ -218,7 +223,8 @@ jobs:
 
       - name: Install Packages
         run: |
-          uv run uv pip install ".[extra,typing]"
+          uv sync
+          uv pip install ".[extra,typing]"
           uv pip install --upgrade git+https://github.com/pandas-dev/pandas
 
       - name: Environment Information

{plotnine-0.15.2 → plotnine-0.16.0a1}/Makefile

@@ -12,9 +12,9 @@ else
 endif
 
 ifeq ($(HAS_UV),true)
-  PYTHON ?= uv run --active python
+  PYTHON ?= uv run --no-sync --active python
   PIP ?= uv pip
-  UVRUN ?= uv run --active
+  UVRUN ?= uv run --no-sync --active
 else
   PYTHON ?= python
   PIP ?= pip
@@ -112,6 +112,9 @@ build: dist
 install: clean
 	$(PIP) install ".[extra]"
 
+sync:
+	uv sync --all-extras
+
 doc-dependencies:
 	$(PIP) install -e ".[doc]"
 	$(PIP) install -r requirements/doc.txt

{plotnine-0.15.2/plotnine.egg-info → plotnine-0.16.0a1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plotnine
-Version: 0.15.2
+Version: 0.16.0a1
 Summary: A Grammar of Graphics for Python
 Author-email: Hassan Kibirige <has2k1@gmail.com>
 License: The MIT License (MIT)
@@ -82,7 +82,7 @@ Requires-Dist: twine; extra == "dev"
 Requires-Dist: plotnine[typing]; extra == "dev"
 Requires-Dist: pre-commit; extra == "dev"
 Provides-Extra: typing
-Requires-Dist: pyright==1.1.404; extra == "typing"
+Requires-Dist: pyright==1.1.408; extra == "typing"
 Requires-Dist: ipython; extra == "typing"
 Requires-Dist: pandas-stubs; extra == "typing"
 Dynamic: license-file

{plotnine-0.15.2 → plotnine-0.16.0a1}/doc/_quartodoc.yml

@@ -540,7 +540,10 @@ quartodoc:
           include_attributes: false
         - Stack
         - Beside
+        - Wrap
+        - plot_annotation
         - plot_spacer
+        - plot_layout
 
     - title: Options
       desc: |

{plotnine-0.15.2 → plotnine-0.16.0a1}/doc/changelog.qmd

@@ -2,13 +2,37 @@
 title: Changelog
 ---
 
-## v0.15.1
+## v0.16.0
+(not-yet-released)
+
+### New
+
+- Added [](:class:`~plotnine.composition.plot_layout`) with which you can customise the
+  layout of plots in composition.
+
+- You can now pass a sequence of horizontal and vertical alignment (ha & va) values in
+  element_text for colorbars.
+
+- You can now use a sequence to set the position of each text on colorbar, or have the
+  positions alternate left and right or bottom and top.
+
+- Added [](:class:`~plotnine.composition.plot_annotation`), allowing you to add title,
+  subtitle or caption to a composition.
+
+### Bug Fixes
+
+- Fixed [](:class:`~plotnine.geom_smooth`) / [](:class:`~plotnine.stat_smooth`) when using a linear model via "lm" with weights for the model to do a weighted regression. This bug did not affect the formula API of the linear model. ({{< issue 1005 >}})
+
+## v0.15.2
 (2025-12-12)
 
 ### Bug Fixes
 
 - Fixed random failures for when using plotnine in quarto == 1.8.26. {{< issue 1017 >}}
 
+## v0.15.1
+(2025-09-30)
+
 ### New
 
 - Added [](:class:`~plotnine.scale_stroke_identity`) which was conspicuously missing!
@@ -39,7 +63,6 @@ title: Changelog
 
 - Fixed bug with plot compositions where if a `plot_spacer` is the last plot in the composition, one could not change the figure size or dpi of the composition. ({{< issue 960 >}})
 
-
 ## v0.15.0
 
 (2025-06-15)

{plotnine-0.15.2 → plotnine-0.16.0a1}/plotnine/_mpl/gridspec.py

@@ -11,15 +11,16 @@ except ImportError:
     from matplotlib.figure import SubplotParams
     from matplotlib.gridspec import GridSpecBase
 
+from matplotlib.gridspec import SubplotSpec
 from matplotlib.transforms import Bbox, BboxTransformTo, TransformedBbox
 
 if TYPE_CHECKING:
     from matplotlib.figure import Figure
-    from matplotlib.gridspec import SubplotSpec
     from matplotlib.patches import Rectangle
     from matplotlib.transforms import Transform
 
-    from plotnine._mpl.layout_manager._spaces import GridSpecParams
+    from plotnine._mpl.layout_manager._side_space import GridSpecParams
+    from plotnine.composition._plot_layout import plot_layout
 
 
 class p9GridSpec(GridSpecBase):
@@ -27,8 +28,7 @@ class p9GridSpec(GridSpecBase):
     Gridspec for plotnine plots
 
     This gridspec does not read any subplot parameter values from matplotlib's
-    rcparams and the default a grid that fills up all the available space;
-    there is no space along the edges and between the subplots.
+    rcparams. And there is no space along the edges and between the subplots.
 
     This gridspec can also be initialised while contained/nested in a given
     subplot.
@@ -61,10 +61,12 @@ class p9GridSpec(GridSpecBase):
         *,
         width_ratios=None,
         height_ratios=None,
+        byrow: bool = True,
         nest_into: SubplotSpec | None = None,
     ):
         self.figure = figure
         self._nested_gridspecs = []
+        self.byrow = byrow
 
         super().__init__(
             nrows,
@@ -92,6 +94,34 @@ class p9GridSpec(GridSpecBase):
             hspace=0,
         )
 
+    @staticmethod
+    def from_layout(
+        layout: plot_layout,
+        figure: Figure,
+        *,
+        nest_into: SubplotSpec | None = None,
+    ) -> p9GridSpec:
+        """
+        Create gridspec from a plot_layout instance
+        """
+        return p9GridSpec(
+            layout.nrow,
+            layout.ncol,
+            figure,
+            byrow=True if layout.byrow is None else layout.byrow,
+            nest_into=nest_into,
+        )
+
+    def __iter__(self):
+        from itertools import product
+
+        if self.byrow:
+            for r, c in product(range(self.nrows), range(self.ncols)):
+                yield SubplotSpec(self, r * self.ncols + c)
+        else:
+            for c, r in product(range(self.ncols), range(self.nrows)):
+                yield SubplotSpec(self, r * self.ncols + c)
+
     @property
     def patch(self) -> Rectangle:
         """
@@ -170,9 +200,9 @@ class p9GridSpec(GridSpecBase):
         for gs in self._nested_gridspecs:
             gs._update_artists()
 
-    def layout(self, gsparams: GridSpecParams):
+    def update_params_and_artists(self, gsparams: GridSpecParams):
         """
-        Update the layout of the gridspec
+        Update gridpspec params and the artists
         """
         self.update(**asdict(gsparams))
         self._update_artists()
@@ -244,6 +274,20 @@ class p9GridSpec(GridSpecBase):
         """
         return TransformedBbox(self.bbox_relative, self.figure.transSubfigure)
 
+    @property
+    def width(self) -> float:
+        """
+        Width of bbox in figure space
+        """
+        return self.bbox_relative.width
+
+    @property
+    def height(self) -> float:
+        """
+        Height of bbox in figure space
+        """
+        return self.bbox_relative.height
+
     def to_transform(self) -> Transform:
         """
         Return transform of this gridspec

plotnine-0.16.0a1/plotnine/_mpl/layout_manager/__init__.py

@@ -0,0 +1,3 @@
+from ._engine import PlotnineLayoutEngine
+
+__all__ = ("PlotnineLayoutEngine",)