plotnine 0.16.0a13__tar.gz → 0.16.0a15__tar.gz

{plotnine-0.16.0a13 → plotnine-0.16.0a15}/.github/workflows/documentation.yml

@@ -16,7 +16,7 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v6
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           fetch-depth: 0
 
@@ -46,15 +46,15 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v6
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
       - name: Install uv and set python version
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           python-version: ${{ matrix.python-version }}
 
       - name: Install Quarto
-        uses: quarto-dev/quarto-actions/setup@v2
+        uses: quarto-dev/quarto-actions/setup@8a96df13519ee81fd526f2dfca5962811136661b # v2.2.0
         with:
           version: pre-release
 
@@ -79,7 +79,7 @@ jobs:
           cat doc/_variables.yml
 
       - name: Deploy to Documentation to a Branch
-        uses: JamesIves/github-pages-deploy-action@v4
+        uses: JamesIves/github-pages-deploy-action@fa24774553152dd7873cd16ebd8d959b010c5445 # v4.9.0
         if:  ${{ needs.parse_commit_info.outputs.deploy_to != '' }}
         with:
           folder: doc/_site

{plotnine-0.16.0a13 → plotnine-0.16.0a15}/.github/workflows/release.yml

@@ -25,10 +25,10 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v6
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -63,10 +63,10 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v6
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -93,7 +93,7 @@ jobs:
 
       - name: Build Website (Dev)
         if: ${{ needs.check-semver-tag.outputs.publish_on == 'testpypi' }}
-        uses: peter-evans/repository-dispatch@v3
+        uses: peter-evans/repository-dispatch@28959ce8df70de7be546dd1250a005dd32156697 # v4.0.1
         with:
           token: ${{ secrets.PLOTNINE_WEBSITE }}
           repository: has2k1/plotnine.org
@@ -101,7 +101,7 @@ jobs:
 
       - name: Build Website
         if: ${{ needs.check-semver-tag.outputs.publish_on == 'pypi' }}
-        uses: peter-evans/repository-dispatch@v3
+        uses: peter-evans/repository-dispatch@28959ce8df70de7be546dd1250a005dd32156697 # v4.0.1
         with:
           token: ${{ secrets.PLOTNINE_WEBSITE }}
           repository: has2k1/plotnine.org

{plotnine-0.16.0a13 → plotnine-0.16.0a15}/.github/workflows/testing.yml

@@ -30,10 +30,10 @@ jobs:
             resolution: "highest"
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v6
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -53,7 +53,7 @@ jobs:
       - name: List Directory
         run: ls -la
 
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         if: failure()
         with:
           name: result-images
@@ -65,7 +65,7 @@ jobs:
       # https://github.com/has2k1/plotnine/settings/secrets/actions
       - name: Upload coverage to Codecov
         if: ${{ !inputs.skip_codecov }}
-        uses: codecov/codecov-action@v4
+        uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
         with:
           name: "py${{ matrix.python-version }}"
           token: ${{ secrets.CODECOV_TOKEN }}
@@ -83,10 +83,10 @@ jobs:
         python-version: [3.14]
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v6
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -117,10 +117,10 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v6
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -150,7 +150,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Build Website (Dev)
-        uses: peter-evans/repository-dispatch@v3
+        uses: peter-evans/repository-dispatch@28959ce8df70de7be546dd1250a005dd32156697 # v4.0.1
         with:
           token: ${{ secrets.PLOTNINE_WEBSITE }}
           repository: has2k1/plotnine.org

{plotnine-0.16.0a13 → plotnine-0.16.0a15}/.github/workflows/weekly.yml

@@ -17,10 +17,10 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v6
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -36,7 +36,7 @@ jobs:
       - name: Run Tests
         run: make test
 
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         if: failure()
         with:
           name: result-images
@@ -52,10 +52,10 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v6
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -73,7 +73,7 @@ jobs:
       - name: Run Tests
         run: make test
 
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         if: failure()
         with:
           name: result-images
@@ -98,12 +98,12 @@ jobs:
           echo ${{ steps.latestrelease.outputs.latestrelease }}
 
       - name: Checkout Code
-        uses: actions/checkout@v6
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           ref: ${{ steps.latestrelease.outputs.latestrelease }}
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -119,7 +119,7 @@ jobs:
       - name: Run Tests
         run: make test
 
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         if: failure()
         with:
           name: result-images
@@ -144,12 +144,12 @@ jobs:
           echo ${{ steps.latestrelease.outputs.latestrelease }}
 
       - name: Checkout Code
-        uses: actions/checkout@v6
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           ref: ${{ steps.latestrelease.outputs.latestrelease }}
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -166,7 +166,7 @@ jobs:
       - name: Run Tests
         run: make test
 
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         if: failure()
         with:
           name: result-images
@@ -184,10 +184,10 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v6
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -214,10 +214,10 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v6
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
       - name: Install a specific version of uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -234,7 +234,7 @@ jobs:
       - name: Run Tests
         run: make typecheck
 
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         if: failure()
         with:
           name: result-images

{plotnine-0.16.0a13 → plotnine-0.16.0a15}/.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.12.3
+    rev: v0.16.8
     hooks:
       # Run the linter.
       - id: ruff

{plotnine-0.16.0a13 → plotnine-0.16.0a15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plotnine
-Version: 0.16.0a13
+Version: 0.16.0a15
 Summary: A Grammar of Graphics for Python
 Author-email: Hassan Kibirige <has2k1@gmail.com>
 License: The MIT License (MIT)
@@ -44,9 +44,10 @@ Classifier: Topic :: Scientific/Engineering :: Visualization
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: contourpy>=1.2.0
 Requires-Dist: matplotlib>=3.10.0
 Requires-Dist: pandas>=2.2.0
-Requires-Dist: mizani~=0.14.0
+Requires-Dist: mizani~=0.14.5
 Requires-Dist: numpy>=1.25.0
 Requires-Dist: scipy>=1.15.0
 Requires-Dist: statsmodels>=0.14.6
@@ -86,7 +87,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.411; extra == "typing"
+Requires-Dist: pyright==1.1.414; extra == "typing"
 Requires-Dist: ipython; extra == "typing"
 Requires-Dist: pandas-stubs; extra == "typing"
 Dynamic: license-file

{plotnine-0.16.0a13 → plotnine-0.16.0a15}/doc/Makefile

@@ -5,7 +5,7 @@
 # make target
 
 # Use uv (if it is installed) to run all python related commands,
-# and prefere the active environment over .venv in a parent folder
+# and prefer the active environment over .venv in a parent folder
 ifeq ($(OS),Windows_NT)
   HAS_UV := $(if $(shell where uv 2>NUL),true,false)
 else

{plotnine-0.16.0a13 → plotnine-0.16.0a15}/doc/_quartodoc.yml

@@ -17,7 +17,7 @@ quartodoc:
       desc: ""
       contents:
         - name: ggplot
-          members: [__add__, __iadd__, show, draw, save, save_helper]
+          members: [__add__, __iadd__, show, draw, build, save, save_helper]
         - qplot
         - watermark
         - name: layer
@@ -37,6 +37,7 @@ quartodoc:
         - after_stat
         - after_scale
         - stage
+        - I
 
     - subtitle: Functions in the Aesthetic Evaluation Environment
       desc: |
@@ -66,14 +67,18 @@ quartodoc:
         - geom_abline
         - geom_area
         - geom_bar
+        - geom_beeswarm
         - geom_bin_2d
         - geom_blank
         - geom_boxplot
         - geom_col
+        - geom_contour
+        - geom_contour_filled
         - geom_count
         - geom_crossbar
         - geom_density
         - geom_density_2d
+        - geom_density_2d_filled
         - geom_dotplot
         - geom_errorbar
         - geom_errorbarh
@@ -138,13 +143,17 @@ quartodoc:
 
     - options: *no-members
       contents:
+        - stat_beeswarm
         - stat_bin
         - stat_bin_2d
         - stat_bindot
         - stat_boxplot
+        - stat_contour
+        - stat_contour_filled
         - stat_count
         - stat_density
         - stat_density_2d
+        - stat_density_2d_filled
         - stat_ecdf
         - stat_ellipse
         - stat_function
@@ -476,7 +485,9 @@ quartodoc:
         - axis_title_y_left
         - axis_title_y_right
         - dpi
+        - figure_format
         - figure_size
+        - legend_axis_line
         - legend_background
         - legend_box
         - legend_box_background

{plotnine-0.16.0a13 → plotnine-0.16.0a15}/doc/changelog.qmd

@@ -7,6 +7,23 @@ title: Changelog
 
 ### New
 
+- Added binned scales for position, alpha, linetype, shape, size, colour,
+  and fill. Use `scale_x_binned`, `scale_y_binned`, or the corresponding
+  `scale_*_binned` aesthetic scale to divide continuous data into numeric
+  bins before mapping it. Colour and fill scales also provide the
+  `scale_*_steps`, `scale_*_steps2`, `scale_*_stepsn`, and
+  `scale_*_fermenter` families. `guide_colorsteps` draws one colour segment
+  per bin, while `guide_bins` draws adjacent geom keys. Both guides label bin
+  boundaries. `guide_bins` positions boundary labels with
+  `legend_text_position`, uses the key-facing `legend_text` margin, and styles
+  its ticks and axis line with `legend_ticks`, `legend_ticks_length`, and
+  `legend_axis_line`. ({{< issue 680 >}})
+
+- Set a plot's preferred notebook and save format with
+  `theme(figure_format="svg")`. An explicit save format takes priority,
+  followed by the filename extension. For a composition, set the preference
+  with `plot_annotation(theme=theme(figure_format="svg"))`.
+
 - You can now add a secondary axis to a plot, either as a one-to-one
   transformation of the primary axis with [](:class:`~plotnine.sec_axis`), or as a
   mirror of the primary axis with [](:func:`~plotnine.dup_axis`).
@@ -89,6 +106,40 @@ title: Changelog
   which you can place the strip on any side of the panel; `"top"` (default),
   `"bottom"`, `"left"` or `"right"`.
 
+- Added [](:class:`~plotnine.geom_contour`) and
+  [](:class:`~plotnine.geom_contour_filled`) to represent a gridded surface
+  with contour lines and filled bands.
+  ({{< issue 1084 >}})
+
+- Added [](:class:`~plotnine.geom_density_2d_filled`), the filled
+  counterpart of [](:class:`~plotnine.geom_density_2d`).
+
+- [](:class:`~plotnine.geom_polygon`) can now draw polygons with holes.
+  Use the new `subgroup` aesthetic to identify each ring within a polygon.
+
+- Plot components that take a `random_state` now also accept a
+  [](`numpy.random.Generator`), in addition to an integer seed or a
+  [](`~numpy.random.RandomState`).
+
+- Added [](:func:`~plotnine.I`), with which you can mark a value as literal.
+  A literal value takes no scale, so it is not trained, not mapped, and gets
+  no legend. One layer can draw literal colours while another maps the same
+  aesthetic through a scale. ({{< issue 1008 >}})
+
+- You can now place an annotation relative to the panel by wrapping a position
+  in [](:func:`~plotnine.I`). `x=I(0.5)` is the centre of the panel and
+  `x=I(0.9)` is 90% across, whatever the data, the limits or the expansion.
+  ({{< issue 939 >}})
+
+- Added [](:class:`~plotnine.geom_beeswarm`) and
+  [](:class:`~plotnine.stat_beeswarm`), which arrange points along one variable
+  and spread nearby values sideways into a swarm. Use the `spread` parameter to
+  select `"quasirandom"` (the default), `"pseudorandom"`, `"smiley"`, or
+  `"frowney"` placement.
+
+- Added [](:meth:`~plotnine.ggplot.build`) to compute a plot's layers, scales
+  and layout without drawing it.
+
 ### API Changes
 
 - Removed `geom.to_layer()`, `stat.to_layer()`, `annotate.to_layer()`,
@@ -126,8 +177,21 @@ title: Changelog
 - `statsmodels>=0.14.6` is now required on every platform. This replaces the
   separate `statsmodels<=0.14.4` requirement for Pyodide.
 
+- `contourpy>=1.2.0` is now required. It computes the contours of a surface.
+
+- [](:class:`~plotnine.stat_density_2d`) gained `contour_var`, `bins`,
+  `binwidth` and `breaks`. Every panel now uses the same contour heights.
+  The stat divides density into ten bands by default instead of five, so
+  [](:class:`~plotnine.geom_density_2d`) draws more contour lines for the
+  same data. The `levels` parameter is deprecated; use `bins` or `breaks`
+  instead.
+
 ### Bug Fixes
 
+- SVG colourbars now use overlapping rectangles to prevent misplaced
+  gradients in some SVG viewers. This applies to compositions and insets
+  without changing the colourbar mode used for other output formats.
+
 - [](:class:`~plotnine.scale_size_datetime`) now honours its `range`
   argument. Previously it was ignored and mapping data raised an error.
 
@@ -144,6 +208,17 @@ title: Changelog
   rectangle is now drawn as its own polygon instead of merging a bar's
   segments into a single path.
 
+- Under a non-linear coordinate system such as
+  [](:class:`~plotnine.coord_trans`), a [](:class:`~plotnine.geom_polygon`)
+  with several groups no longer draws an edge from one polygon to the next.
+
+- Under a non-linear coordinate system, separate
+  [](:class:`~plotnine.geom_path`) groups no longer connect when an aesthetic
+  such as `color` varies along the path. The fix also applies to
+  [](:class:`~plotnine.geom_line`), [](:class:`~plotnine.geom_step`),
+  [](:class:`~plotnine.geom_density`) and the line drawn by
+  [](:class:`~plotnine.geom_smooth`).
+
 - In a non-linear coordinate system (e.g. [](:class:`~plotnine.coord_trans`)),
   both edges of a [](:class:`~plotnine.geom_ribbon`) or
   [](:class:`~plotnine.geom_area`) now curve. Previously each edge held the
@@ -190,6 +265,36 @@ title: Changelog
   prevented layout from reserving their space, so the labels could render
   outside the figure.
 
+- Saving a composition now honours the `dpi` argument. For example,
+  `(p1 | p2).save("composition.png", dpi=200)` saves the image at 200 DPI
+  instead of the default resolution.
+
+- Plots containing an unseeded [](:class:`~plotnine.geom_sina`) can now be
+  copied, including when the geom has been added to every plot in a
+  composition. Copying previously raised
+  `TypeError: cannot pickle 'module' object`.
+  ({{< issue 1115 >}})
+
+- [](:class:`~plotnine.position_jitter`) and
+  [](:class:`~plotnine.position_jitterdodge`) now make independent random
+  draws for the horizontal and vertical axes when given a seed. Both axes
+  previously received identical offsets, placing points along a diagonal.
+
+- [](:class:`~plotnine.position_jitter`),
+  [](:class:`~plotnine.position_jitterdodge`),
+  [](:class:`~plotnine.stat_summary`), and
+  [](:class:`~plotnine.stat_summary_bin`) now treat `0` as a valid
+  `random_state` seed. They previously selected NumPy's global random state,
+  so results depended on other random draws.
+
+- Broadcasting a layer to every plot in a composition with `&` or `*` now
+  gives each target plot an independent copy. Changes made while drawing one
+  plot no longer affect the layer in another plot.
+
+- Calling [](:meth:`~plotnine.ggplot.draw`) more than once on the same plot no
+  longer duplicates artists or leaves ticks and labels partially hidden.
+  ({{< issue 1009 >}})
+
 ### Enhancements
 
 - The `factor` function available when evaluating expressions in