From 4750b4546a18881e9ea21ebba7c0030e1829779e Mon Sep 17 00:00:00 2001 From: Matthew Feickert Date: Tue, 14 Jul 2026 12:03:04 -0500 Subject: [PATCH] docs: Add note on conda requirements --- content/other-tools/02_pixi_build.md | 10 ++++++++++ slides/5_02_pixi_build.md | 15 +++++++++++++++ 2 files changed, 25 insertions(+) diff --git a/content/other-tools/02_pixi_build.md b/content/other-tools/02_pixi_build.md index 4922bba..29d72ba 100644 --- a/content/other-tools/02_pixi_build.md +++ b/content/other-tools/02_pixi_build.md @@ -9,6 +9,16 @@ To learn the sections and functionalities by example rather than by inspection o ## Basic Packaging +:::{note} Build, Host, and Run conda requirements + +When building conda packages, recipes have the concept of `build`, `host`, and `run` requirements. + +* `build`: Tools that are used to perform the actual build (e.g. `cmake`, `ninja`) +* `host`: Packages that supply development requirements for the package you're building, like headers or shared libraries that are linked against (e.g. `boost-devel`) +* `run`: The requirements of your package to actually run (e.g. your `pyproject.toml` `dependencies`) + +::: + ### Configuring the Pixi manifest Take the example Python package directory tree from [Making a basic package](https://scikit-build.org/SIMPLE-Py/package/) as a starting foundation. diff --git a/slides/5_02_pixi_build.md b/slides/5_02_pixi_build.md index 1423fe3..1df1a54 100644 --- a/slides/5_02_pixi_build.md +++ b/slides/5_02_pixi_build.md @@ -25,6 +25,21 @@ _class: lead --- +# Build, host, and run requirements + +When building conda packages, recipes have the concept of `build`, +`host`, and `run` requirements: + +- `build`: Tools that are used to perform the actual build + (e.g. `cmake`, `ninja`) +- `host`: Packages that supply development requirements for the + package you're building, like headers or shared libraries that are + linked against (e.g. `boost-devel`) +- `run`: The requirements of your package to actually run + (e.g. your `pyproject.toml` `dependencies`) + +--- + # Basic packaging: starting point Take the `rescale` package from _Making a basic package_ and create a