From 816dabbc38d3cd7623ec82810538372136e63af7 Mon Sep 17 00:00:00 2001 From: Matthew Feickert Date: Tue, 14 Jul 2026 10:07:14 -0500 Subject: [PATCH 1/2] Provide source --- .../5_02_pixi_build/compiled/.gitattributes | 2 + examples/5_02_pixi_build/compiled/.gitignore | 224 ++++++++++++++++++ .../5_02_pixi_build/compiled/CMakeLists.txt | 7 + examples/5_02_pixi_build/compiled/collatz.cpp | 17 ++ .../compiled/original_pyproject.toml | 7 + 5 files changed, 257 insertions(+) create mode 100644 examples/5_02_pixi_build/compiled/.gitattributes create mode 100644 examples/5_02_pixi_build/compiled/.gitignore create mode 100644 examples/5_02_pixi_build/compiled/CMakeLists.txt create mode 100644 examples/5_02_pixi_build/compiled/collatz.cpp create mode 100644 examples/5_02_pixi_build/compiled/original_pyproject.toml diff --git a/examples/5_02_pixi_build/compiled/.gitattributes b/examples/5_02_pixi_build/compiled/.gitattributes new file mode 100644 index 0000000..997504b --- /dev/null +++ b/examples/5_02_pixi_build/compiled/.gitattributes @@ -0,0 +1,2 @@ +# SCM syntax highlighting & preventing 3-way merges +pixi.lock merge=binary linguist-language=YAML linguist-generated=true -diff diff --git a/examples/5_02_pixi_build/compiled/.gitignore b/examples/5_02_pixi_build/compiled/.gitignore new file mode 100644 index 0000000..06fa083 --- /dev/null +++ b/examples/5_02_pixi_build/compiled/.gitignore @@ -0,0 +1,224 @@ +# Byte-compiled / optimized / DLL files +__pycache__/ +*.py[codz] +*$py.class + +# C extensions +*.so + +# Distribution / packaging +.Python +build/ +develop-eggs/ +dist/ +downloads/ +eggs/ +.eggs/ +lib/ +lib64/ +parts/ +sdist/ +var/ +wheels/ +share/python-wheels/ +*.egg-info/ +.installed.cfg +*.egg +MANIFEST + +# PyInstaller +# Usually these files are written by a python script from a template +# before PyInstaller builds the exe, so as to inject date/other infos into it. +*.manifest +*.spec + +# Installer logs +pip-log.txt +pip-delete-this-directory.txt + +# Unit test / coverage reports +htmlcov/ +.tox/ +.nox/ +.coverage +.coverage.* +.cache +nosetests.xml +coverage.xml +*.cover +*.py.cover +*.lcov +.hypothesis/ +.pytest_cache/ +cover/ + +# Translations +*.mo +*.pot + +# Django stuff: +*.log +local_settings.py +db.sqlite3 +db.sqlite3-journal + +# Flask stuff: +instance/ +.webassets-cache + +# Scrapy stuff: +.scrapy + +# Sphinx documentation +docs/_build/ + +# PyBuilder +.pybuilder/ +target/ + +# Jupyter Notebook +.ipynb_checkpoints + +# IPython +profile_default/ +ipython_config.py + +# pyenv +# For a library or package, you might want to ignore these files since the code is +# intended to run in multiple environments; otherwise, check them in: +# .python-version + +# pipenv +# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control. +# However, in case of collaboration, if having platform-specific dependencies or dependencies +# having no cross-platform support, pipenv may install dependencies that don't work, or not +# install all needed dependencies. +# Pipfile.lock + +# UV +# Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control. +# This is especially recommended for binary packages to ensure reproducibility, and is more +# commonly ignored for libraries. +# uv.lock + +# poetry +# Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control. +# This is especially recommended for binary packages to ensure reproducibility, and is more +# commonly ignored for libraries. +# https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control +# poetry.lock +# poetry.toml + +# pdm +# Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control. +# pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python. +# https://pdm-project.org/en/latest/usage/project/#working-with-version-control +# pdm.lock +# pdm.toml +.pdm-python +.pdm-build/ + +# pixi +# Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control. +# pixi.lock +# Pixi creates a virtual environment in the .pixi directory, just like venv module creates one +# in the .venv directory. It is recommended not to include this directory in version control. +.pixi/* +!.pixi/config.toml + +# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm +__pypackages__/ + +# Celery stuff +celerybeat-schedule* +celerybeat.pid + +# Redis +*.rdb +*.aof +*.pid + +# RabbitMQ +mnesia/ +rabbitmq/ +rabbitmq-data/ + +# ActiveMQ +activemq-data/ + +# SageMath parsed files +*.sage.py + +# Environments +.env +.envrc +.venv +env/ +venv/ +ENV/ +env.bak/ +venv.bak/ + +# Spyder project settings +.spyderproject +.spyproject + +# Rope project settings +.ropeproject + +# mkdocs documentation +/site + +# mypy +.mypy_cache/ +.dmypy.json +dmypy.json + +# Pyre type checker +.pyre/ + +# pytype static type analyzer +.pytype/ + +# Cython debug symbols +cython_debug/ + +# PyCharm +# JetBrains specific template is maintained in a separate JetBrains.gitignore that can +# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore +# and can be added to the global gitignore or merged into this file. For a more nuclear +# option (not recommended) you can uncomment the following to ignore the entire idea folder. +# .idea/ + +# Abstra +# Abstra is an AI-powered process automation framework. +# Ignore directories containing user credentials, local state, and settings. +# Learn more at https://abstra.io/docs +.abstra/ + +# Visual Studio Code +# Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore +# that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore +# and can be added to the global gitignore or merged into this file. However, if you prefer, +# you could uncomment the following to ignore the entire vscode folder +# .vscode/ +# Temporary file for partial code execution +tempCodeRunnerFile.py + +# Ruff stuff: +.ruff_cache/ + +# PyPI configuration file +.pypirc + +# Marimo +marimo/_static/ +marimo/_lsp/ +__marimo__/ + +# Streamlit +.streamlit/secrets.toml +# pixi environments +.pixi/* +!.pixi/config.toml +pixi.lock diff --git a/examples/5_02_pixi_build/compiled/CMakeLists.txt b/examples/5_02_pixi_build/compiled/CMakeLists.txt new file mode 100644 index 0000000..816e40c --- /dev/null +++ b/examples/5_02_pixi_build/compiled/CMakeLists.txt @@ -0,0 +1,7 @@ +cmake_minimum_required(VERSION 3.15...4.3) +project(collatz LANGUAGES CXX) + +find_package(pybind11 CONFIG REQUIRED) + +pybind11_add_module(collatz collatz.cpp) +install(TARGETS collatz DESTINATION .) diff --git a/examples/5_02_pixi_build/compiled/collatz.cpp b/examples/5_02_pixi_build/compiled/collatz.cpp new file mode 100644 index 0000000..ba29ca4 --- /dev/null +++ b/examples/5_02_pixi_build/compiled/collatz.cpp @@ -0,0 +1,17 @@ +#include +#include + +// Even -> n/2, odd -> 3n+1. Conjectured to always terminate. +int collatz_steps(long long n) { + if (n < 1) throw std::domain_error("n must be >= 1"); + int steps = 0; + while (n != 1) { + n = (n % 2 == 0) ? n / 2 : 3 * n + 1; + ++steps; + } + return steps; +} + +PYBIND11_MODULE(collatz, m) { + m.def("collatz_steps", &collatz_steps, "Steps to reach 1 in the Collatz sequence"); +} diff --git a/examples/5_02_pixi_build/compiled/original_pyproject.toml b/examples/5_02_pixi_build/compiled/original_pyproject.toml new file mode 100644 index 0000000..2bc3228 --- /dev/null +++ b/examples/5_02_pixi_build/compiled/original_pyproject.toml @@ -0,0 +1,7 @@ +[build-system] +requires = ["scikit-build-core", "pybind11"] +build-backend = "scikit_build_core.build" + +[project] +name = "collatz" +version = "0.1.0" From f859383fa40f8ee799f5b72cf34517a360c043fb Mon Sep 17 00:00:00 2001 From: Matthew Feickert Date: Tue, 14 Jul 2026 10:17:02 -0500 Subject: [PATCH 2/2] Add example --- content/other-tools/02_pixi_build.md | 35 ++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/content/other-tools/02_pixi_build.md b/content/other-tools/02_pixi_build.md index 04e51f9..4671f9d 100644 --- a/content/other-tools/02_pixi_build.md +++ b/content/other-tools/02_pixi_build.md @@ -384,6 +384,41 @@ rattler-build package inspect /tmp/local-channel/linux-64/collatz*.conda :::: +::::{exercise} Install collatz as a conda package from source +:label: conda-source-collatz + +A full example is available at . +Add `collatz` as a source dependency to a Pixi workspace and install it as a conda package. + +:::{solution} conda-source-collatz +:class: dropdown + +```bash +pixi init git-source-pixi-build && cd git-source-pixi-build +``` + +```toml +[workspace] +channels = ["conda-forge"] +name = "git-source-pixi-build" +platforms = ["linux-64"] +version = "0.1.0" +preview = ["pixi-build"] + +[tasks] + +[dependencies] + +[dependencies.collatz] +git = "https://github.com/scikit-build/SIMPLE-Py" +branch = "main" +subdirectory = "examples/5_02_pixi_build/compiled" +``` + +::: + +:::: + ::::{exercise} Install a conda package from a new channel :label: prefix-channel-collatz