icplot 0.3.5__tar.gz → 0.4.0__tar.gz

{icplot-0.3.5/src/icplot.egg-info → icplot-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: icplot
-Version: 0.3.5
+Version: 0.4.0
 Summary: Utilities for generating plots and graphics for technical reports.
 Author-email: "James Grogan, Irish Centre for High End Computing" <james.grogan@ichec.ie>
 Project-URL: Repository, https://git.ichec.ie/performance/toolshed/icplot
@@ -14,11 +14,6 @@ Classifier: Topic :: System :: Distributed Computing
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: wand
-Requires-Dist: matplotlib
-Requires-Dist: vtk
-Requires-Dist: moviepy
-Requires-Dist: scipy
 Requires-Dist: iccore==0.2.3
 Requires-Dist: graphviz
 Requires-Dist: Jinja2
@@ -33,8 +28,27 @@ Requires-Dist: flake8; extra == "test"
 Requires-Dist: pylint; extra == "test"
 Requires-Dist: types-PyYAML; extra == "test"
 Provides-Extra: cairo
-Requires-Dist: pycairo; extra == "cairo"
 Requires-Dist: CairoSVG; extra == "cairo"
+Provides-Extra: scene
+Requires-Dist: pycairo; extra == "scene"
+Provides-Extra: imagemagick
+Requires-Dist: wand; extra == "imagemagick"
+Provides-Extra: plot
+Requires-Dist: matplotlib; extra == "plot"
+Provides-Extra: vtk
+Requires-Dist: vtk; extra == "vtk"
+Provides-Extra: geometry
+Requires-Dist: scipy; extra == "geometry"
+Provides-Extra: video
+Requires-Dist: moviepy; extra == "video"
+Provides-Extra: all
+Requires-Dist: CairoSVG; extra == "all"
+Requires-Dist: pycairo; extra == "all"
+Requires-Dist: wand; extra == "all"
+Requires-Dist: matplotlib; extra == "all"
+Requires-Dist: vtk; extra == "all"
+Requires-Dist: scipy; extra == "all"
+Requires-Dist: moviepy; extra == "all"
 Dynamic: license-file
 
 # icplot
@@ -122,13 +136,30 @@ The library supports themeing with an Angular Material 3 motivated design system
   
 # Installation #
 
-The package is available on PyPI. For a minimal installation you can do:
+The package is available on PyPI. The core install is deliberately light — it
+does not pull the heavy rendering backends, so consumers that only need part of
+the library (e.g. a docs build that just converts svg to png) stay small:
 
 ``` shell
 pip install icplot
 ```
 
-For full functionality, particularly conversion of image formats, `imagemagick` and `cairo` are required. On Mac you can install them with:
+Backends are opt-in via extras:
+
+| Extra | Pulls | Enables |
+|---|---|---|
+| `cairo` | CairoSVG | svg → png / pdf conversion |
+| `scene` | pycairo | vector scene drawing (`renderer.scene.cairo`) |
+| `imagemagick` | wand | pdf → png conversion (falls back to the `magick` CLI) |
+| `plot` | matplotlib | 2D plotting (`renderer.graph`, `charts`) |
+| `vtk` | vtk | 3D / mesh rendering (`geometry.mesh`) |
+| `geometry` | scipy | geometry transforms (`geometry.operations`) |
+| `video` | moviepy | video assembly (`renderer.video`) |
+| `all` | all of the above | everything (previous default behaviour) |
+
+For example, `pip install icplot[cairo]` for svg conversion, or
+`pip install icplot[all]` for the full toolkit. The native `cairo` and
+`imagemagick` system libraries are also required for those backends; on Mac:
 
 ``` shell
 brew install imagemagick cairo

{icplot-0.3.5 → icplot-0.4.0}/README.md

@@ -83,13 +83,30 @@ The library supports themeing with an Angular Material 3 motivated design system
   
 # Installation #
 
-The package is available on PyPI. For a minimal installation you can do:
+The package is available on PyPI. The core install is deliberately light — it
+does not pull the heavy rendering backends, so consumers that only need part of
+the library (e.g. a docs build that just converts svg to png) stay small:
 
 ``` shell
 pip install icplot
 ```
 
-For full functionality, particularly conversion of image formats, `imagemagick` and `cairo` are required. On Mac you can install them with:
+Backends are opt-in via extras:
+
+| Extra | Pulls | Enables |
+|---|---|---|
+| `cairo` | CairoSVG | svg → png / pdf conversion |
+| `scene` | pycairo | vector scene drawing (`renderer.scene.cairo`) |
+| `imagemagick` | wand | pdf → png conversion (falls back to the `magick` CLI) |
+| `plot` | matplotlib | 2D plotting (`renderer.graph`, `charts`) |
+| `vtk` | vtk | 3D / mesh rendering (`geometry.mesh`) |
+| `geometry` | scipy | geometry transforms (`geometry.operations`) |
+| `video` | moviepy | video assembly (`renderer.video`) |
+| `all` | all of the above | everything (previous default behaviour) |
+
+For example, `pip install icplot[cairo]` for svg conversion, or
+`pip install icplot[all]` for the full toolkit. The native `cairo` and
+`imagemagick` system libraries are also required for those backends; on Mac:
 
 ``` shell
 brew install imagemagick cairo

{icplot-0.3.5 → icplot-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "icplot"
-version = "0.3.5"
+version = "0.4.0"
 authors = [
   { name="James Grogan, Irish Centre for High End Computing", email="james.grogan@ichec.ie" },
 ]
@@ -16,14 +16,14 @@ classifiers = [
 ]
 keywords = ["Publishing", "Technical Reports", "Graphics"]
 
-dependencies = ["wand",
-	       "matplotlib",
-               "vtk",
-               "moviepy",
-               "scipy",
-	       "iccore==0.2.3",
-               "graphviz",
-               "Jinja2"]
+# Core is deliberately light: only what every import path needs. The heavy
+# rendering backends (matplotlib/vtk/scipy/moviepy/wand) are optional extras
+# so consumers that only use the converter or diagram renderer (e.g. the
+# handbook build) can install a small footprint. Use icplot[all] for the
+# previous behaviour of pulling every backend.
+dependencies = ["iccore==0.2.3",
+                "graphviz",
+                "Jinja2"]
 
 [project.urls]
 Repository = "https://git.ichec.ie/performance/toolshed/icplot"
@@ -42,11 +42,43 @@ test = [
     "types-PyYAML"
 ]
 
+# svg/pdf conversion (converter.svg_to_png / svg_to_pdf). CairoSVG pulls
+# cairocffi, which dlopens libcairo at runtime (no C build step needed).
 cairo = [
-   "pycairo",
    "CairoSVG"
 ]
 
+# vector scene drawing (renderer.scene.cairo). pycairo (module `cairo`)
+# builds against libcairo — needs the cairo headers + a C toolchain at install.
+scene = ["pycairo"]
+
+# raster conversion via ImageMagick bindings (converter.pdf_to_png);
+# falls back to the `magick` CLI if wand is absent
+imagemagick = ["wand"]
+
+# 2D plotting backend (icplot.renderer.graph / icplot.charts)
+plot = ["matplotlib"]
+
+# 3D / mesh backend (icplot.geometry.mesh, vtk graph backend)
+vtk = ["vtk"]
+
+# geometry transforms (icplot.geometry.operations)
+geometry = ["scipy"]
+
+# video assembly (icplot.renderer.video)
+video = ["moviepy"]
+
+# convenience aggregate — every backend (pre-split behaviour)
+all = [
+   "CairoSVG",
+   "pycairo",
+   "wand",
+   "matplotlib",
+   "vtk",
+   "scipy",
+   "moviepy"
+]
+
 [build-system]
 requires = ["setuptools", "wheel"]
 build-backend = "setuptools.build_meta"
@@ -119,7 +151,8 @@ skip_missing_interpreters = true
 
 [tool.tox.env_run_base]
 description = "Run Unit and Integration Tests"
-deps = [".[test, cairo]"]
+# `all` so the full suite (matplotlib/vtk/scipy/moviepy backends) still runs
+deps = [".[test, all]"]
 commands = [["pytest", "test"]]
 
 [tool.tox.env.format_apply]

{icplot-0.3.5 → icplot-0.4.0/src/icplot.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: icplot
-Version: 0.3.5
+Version: 0.4.0
 Summary: Utilities for generating plots and graphics for technical reports.
 Author-email: "James Grogan, Irish Centre for High End Computing" <james.grogan@ichec.ie>
 Project-URL: Repository, https://git.ichec.ie/performance/toolshed/icplot
@@ -14,11 +14,6 @@ Classifier: Topic :: System :: Distributed Computing
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: wand
-Requires-Dist: matplotlib
-Requires-Dist: vtk
-Requires-Dist: moviepy
-Requires-Dist: scipy
 Requires-Dist: iccore==0.2.3
 Requires-Dist: graphviz
 Requires-Dist: Jinja2
@@ -33,8 +28,27 @@ Requires-Dist: flake8; extra == "test"
 Requires-Dist: pylint; extra == "test"
 Requires-Dist: types-PyYAML; extra == "test"
 Provides-Extra: cairo
-Requires-Dist: pycairo; extra == "cairo"
 Requires-Dist: CairoSVG; extra == "cairo"
+Provides-Extra: scene
+Requires-Dist: pycairo; extra == "scene"
+Provides-Extra: imagemagick
+Requires-Dist: wand; extra == "imagemagick"
+Provides-Extra: plot
+Requires-Dist: matplotlib; extra == "plot"
+Provides-Extra: vtk
+Requires-Dist: vtk; extra == "vtk"
+Provides-Extra: geometry
+Requires-Dist: scipy; extra == "geometry"
+Provides-Extra: video
+Requires-Dist: moviepy; extra == "video"
+Provides-Extra: all
+Requires-Dist: CairoSVG; extra == "all"
+Requires-Dist: pycairo; extra == "all"
+Requires-Dist: wand; extra == "all"
+Requires-Dist: matplotlib; extra == "all"
+Requires-Dist: vtk; extra == "all"
+Requires-Dist: scipy; extra == "all"
+Requires-Dist: moviepy; extra == "all"
 Dynamic: license-file
 
 # icplot
@@ -122,13 +136,30 @@ The library supports themeing with an Angular Material 3 motivated design system
   
 # Installation #
 
-The package is available on PyPI. For a minimal installation you can do:
+The package is available on PyPI. The core install is deliberately light — it
+does not pull the heavy rendering backends, so consumers that only need part of
+the library (e.g. a docs build that just converts svg to png) stay small:
 
 ``` shell
 pip install icplot
 ```
 
-For full functionality, particularly conversion of image formats, `imagemagick` and `cairo` are required. On Mac you can install them with:
+Backends are opt-in via extras:
+
+| Extra | Pulls | Enables |
+|---|---|---|
+| `cairo` | CairoSVG | svg → png / pdf conversion |
+| `scene` | pycairo | vector scene drawing (`renderer.scene.cairo`) |
+| `imagemagick` | wand | pdf → png conversion (falls back to the `magick` CLI) |
+| `plot` | matplotlib | 2D plotting (`renderer.graph`, `charts`) |
+| `vtk` | vtk | 3D / mesh rendering (`geometry.mesh`) |
+| `geometry` | scipy | geometry transforms (`geometry.operations`) |
+| `video` | moviepy | video assembly (`renderer.video`) |
+| `all` | all of the above | everything (previous default behaviour) |
+
+For example, `pip install icplot[cairo]` for svg conversion, or
+`pip install icplot[all]` for the full toolkit. The native `cairo` and
+`imagemagick` system libraries are also required for those backends; on Mac:
 
 ``` shell
 brew install imagemagick cairo

{icplot-0.3.5 → icplot-0.4.0}/src/icplot.egg-info/requires.txt

@@ -1,16 +1,31 @@
+iccore==0.2.3
+graphviz
+Jinja2
+
+[all]
+CairoSVG
+pycairo
 wand
 matplotlib
 vtk
-moviepy
 scipy
-iccore==0.2.3
-graphviz
-Jinja2
+moviepy
 
 [cairo]
-pycairo
 CairoSVG
 
+[geometry]
+scipy
+
+[imagemagick]
+wand
+
+[plot]
+matplotlib
+
+[scene]
+pycairo
+
 [test]
 pytest
 pytest-cov
@@ -21,3 +36,9 @@ mypy
 flake8
 pylint
 types-PyYAML
+
+[video]
+moviepy
+
+[vtk]
+vtk