pipefunc 0.91.0__tar.gz → 0.92.0__tar.gz

{pipefunc-0.91.0 → pipefunc-0.92.0}/.devcontainer/Dockerfile

@@ -1,4 +1,4 @@
-ARG UV_VERSION=0.10.8
+ARG UV_VERSION=0.11.19
 ARG DEBIAN_VERSION=bookworm
 
 FROM ghcr.io/astral-sh/uv:$UV_VERSION AS uv

{pipefunc-0.91.0 → pipefunc-0.92.0}/.github/workflows/codspeed.yml

@@ -27,7 +27,7 @@ jobs:
           cat environment.yml
 
       - name: Install Conda environment with micromamba
-        uses: mamba-org/setup-micromamba@v2
+        uses: mamba-org/setup-micromamba@v3
         with:
           environment-file: environment.yml
           cache-environment: true

{pipefunc-0.91.0 → pipefunc-0.92.0}/.github/workflows/doc-string-check.yml

@@ -17,12 +17,12 @@ jobs:
         uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@v8.2.0
 
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: "3.14.3"
+          python-version: "3.14.5"
 
       - name: Install pipefunc
         shell: bash -l {0}

{pipefunc-0.91.0 → pipefunc-0.92.0}/.github/workflows/pr-title-checker.yml

@@ -22,7 +22,7 @@ jobs:
           configuration_path: .github/pr-title-checker-config.json
 
       - name: Add comment to fix PR title
-        uses: marocchino/sticky-pull-request-comment@v2
+        uses: marocchino/sticky-pull-request-comment@v3.0.4
         if: ${{ steps.check.outputs.success == 'false'}}
         with:
           header: 'PR Title Check'
@@ -44,7 +44,7 @@ jobs:
 
       - name: Add comment that PR title is fixed
         if: ${{ steps.check.outputs.success == 'true'}}
-        uses: marocchino/sticky-pull-request-comment@v2
+        uses: marocchino/sticky-pull-request-comment@v3.0.4
         with:
           header: 'PR Title Check'
           recreate: true

{pipefunc-0.91.0 → pipefunc-0.92.0}/.github/workflows/pytest-micromamba.yml

@@ -25,7 +25,7 @@ jobs:
           cat environment.yml
 
       - name: Install Conda environment with micromamba
-        uses: mamba-org/setup-micromamba@v2
+        uses: mamba-org/setup-micromamba@v3
         with:
           environment-file: environment.yml
           cache-environment: true
@@ -43,6 +43,6 @@ jobs:
 
       - name: Upload coverage to Codecov
         if: matrix.python-version == '3.14'
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v7
         env:
           CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

{pipefunc-0.91.0 → pipefunc-0.92.0}/.github/workflows/pytest-uv.yml

@@ -18,7 +18,7 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@v8.2.0
       - name: Run pytest (minimal)
         run: uvx nox -e pytest_min_deps-${{ matrix.python-version }} -v
       - name: Run pytest (all dependencies)

{pipefunc-0.91.0 → pipefunc-0.92.0}/.github/workflows/pythonpublish.yml

@@ -17,7 +17,7 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@v8.2.0
       - name: Build
         run: uv build
       - name: Publish package distributions to PyPI

{pipefunc-0.91.0 → pipefunc-0.92.0}/.github/workflows/release-drafter.yaml

@@ -11,6 +11,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: 🚀 Run Release Drafter
-        uses: release-drafter/release-drafter@v6.3.0
+        uses: release-drafter/release-drafter@v7.3.1
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

{pipefunc-0.91.0 → pipefunc-0.92.0}/.github/workflows/update-environment.yaml

@@ -19,7 +19,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: '3.14.3'
+          python-version: '3.14.5'
 
       - name: Run update-environment
         run: python .github/update-environment.py

{pipefunc-0.91.0 → pipefunc-0.92.0}/CHANGELOG.md

@@ -5,6 +5,285 @@ If it is out of date, please run
 
 GITHUB_TOKEN=$(gh auth token) uv run .github/generate-release-notes.py
 
+## v0.91.1 (2026-03-06)
+
+### 🧹 Maintenance
+
+- suppress google-crc32c pure-python fallback warning ([#942](https://github.com/pipefunc/pipefunc/pull/942))
+
+### 📊 Stats
+
+- `.md`: +0 lines, -3 lines
+- `.py`: +9 lines, -12 lines
+
+## v0.91.0 (2026-03-06)
+
+### ✨ Enhancements
+
+- harden persisted run status error handling ([#940](https://github.com/pipefunc/pipefunc/pull/940))
+- Add persisted run status CLI ([#938](https://github.com/pipefunc/pipefunc/pull/938))
+
+### 📦 Dependencies
+
+- ⬆️ Update ghcr.io/astral-sh/uv Docker tag to v0.10.8 ([#937](https://github.com/pipefunc/pipefunc/pull/937))
+- ⬆️ Update release-drafter/release-drafter action to v6.3.0 ([#939](https://github.com/pipefunc/pipefunc/pull/939))
+
+### 🧪 Testing
+
+- Add tests to reach 100% code coverage ([#936](https://github.com/pipefunc/pipefunc/pull/936))
+
+### 📊 Stats
+
+- `.yaml`: +1 lines, -1 lines
+- `.md`: +130 lines, -0 lines
+- `.py`: +1900 lines, -119 lines
+- `.toml`: +3 lines, -0 lines
+- `other`: +1 lines, -1 lines
+
+## v0.90.3 (2026-02-06)
+
+### 🐛 Bug Fixes
+
+- Fix Slurm executor validation in launch_maps ([#912](https://github.com/pipefunc/pipefunc/pull/912))
+
+### 📦 Dependencies
+
+- ⬆️ Update ghcr.io/astral-sh/uv Docker tag to v0.10.0 ([#931](https://github.com/pipefunc/pipefunc/pull/931))
+- ⬆️ Update release-drafter/release-drafter action to v6.2.0 ([#933](https://github.com/pipefunc/pipefunc/pull/933))
+- ⬆️ Update python to v3.14.3 ([#934](https://github.com/pipefunc/pipefunc/pull/934))
+- ⬆️ Update release-drafter/release-drafter action to v6.1.1 ([#932](https://github.com/pipefunc/pipefunc/pull/932))
+- ⬆️ Update ghcr.io/astral-sh/uv Docker tag to v0.9.24 ([#930](https://github.com/pipefunc/pipefunc/pull/930))
+
+### 🧪 Testing
+
+- Add regression test for SlurmExecutor reuse across pipeline generations ([#935](https://github.com/pipefunc/pipefunc/pull/935))
+
+### 📊 Stats
+
+- `.yml`: +1 lines, -1 lines
+- `.yaml`: +2 lines, -2 lines
+- `.py`: +106 lines, -12 lines
+- `other`: +1 lines, -1 lines
+
+## v0.90.2 (2026-01-05)
+
+### 📝 Other
+
+- Fix CI failure on Python 3.13/3.14 with numpy 2.4.0+ ([#929](https://github.com/pipefunc/pipefunc/pull/929))
+
+### 📦 Dependencies
+
+- ⬆️ Update ghcr.io/astral-sh/uv Docker tag to v0.9.21 ([#928](https://github.com/pipefunc/pipefunc/pull/928))
+
+### 📊 Stats
+
+- `.py`: +1 lines, -1 lines
+- `other`: +1 lines, -1 lines
+
+## v0.90.1 (2025-12-12)
+
+### 📝 Other
+
+- Add concise __repr__ methods to ErrorSnapshot and PropagatedErrorSnapshot ([#927](https://github.com/pipefunc/pipefunc/pull/927))
+
+### 📊 Stats
+
+- `.py`: +13 lines, -2 lines
+
+## v0.90.0 (2025-12-12)
+
+### ✨ Enhancements
+
+- `error_handling` options (`raise` and `continue`) ([#854](https://github.com/pipefunc/pipefunc/pull/854))
+
+### 📦 Dependencies
+
+- ⬆️ Update ghcr.io/astral-sh/uv Docker tag to v0.9.17 ([#922](https://github.com/pipefunc/pipefunc/pull/922))
+- ⬆️ Update python to v3.14.2 ([#926](https://github.com/pipefunc/pipefunc/pull/926))
+
+### 📊 Stats
+
+- `.yml`: +1 lines, -1 lines
+- `.yaml`: +1 lines, -1 lines
+- `.md`: +135 lines, -45 lines
+- `.py`: +4852 lines, -158 lines
+- `other`: +6 lines, -2 lines
+
+## v0.89.0 (2025-12-03)
+
+### Closed Issues
+
+- Results.to_dataframe() fails for scalar outputs with __getitem__ ([#924](https://github.com/pipefunc/pipefunc/issues/924))
+
+### 📦 Dependencies
+
+- ⬆️ Update actions/checkout action to v6 ([#923](https://github.com/pipefunc/pipefunc/pull/923))
+- ⬆️ Update ghcr.io/astral-sh/uv Docker tag to v0.9.7 ([#908](https://github.com/pipefunc/pipefunc/pull/908))
+
+### 🐛 Bug Fixes
+
+- Fix Results.to_dataframe() for scalar outputs with __getitem__ ([#925](https://github.com/pipefunc/pipefunc/pull/925))
+
+### 🧹 Maintenance
+
+- Deprecate `cleanup` parameter in favor of `resume` parameter  ([#921](https://github.com/pipefunc/pipefunc/pull/921))
+
+### ✨ Enhancements
+
+- Add `reuse_validation` parameter to `pipeline.map()` ([#920](https://github.com/pipefunc/pipefunc/pull/920))
+
+### 📚 Documentation
+
+- Fix 'Function Chaining Helper' docs typo ([#919](https://github.com/pipefunc/pipefunc/pull/919))
+
+### 📊 Stats
+
+- `.yml`: +6 lines, -6 lines
+- `.yaml`: +1 lines, -1 lines
+- `.md`: +5 lines, -5 lines
+- `.py`: +783 lines, -51 lines
+- `other`: +1 lines, -1 lines
+
+## v0.88.0 (2025-11-04)
+
+### 📚 Documentation
+
+- Add missing 'Function Chaining Helper' in index ([#918](https://github.com/pipefunc/pipefunc/pull/918))
+
+### ✨ Enhancements
+
+- Add `pipefunc.helpers.chain` for auto-renaming linear pipelines ([#909](https://github.com/pipefunc/pipefunc/pull/909))
+- Support and require Zarr v3 ([#523](https://github.com/pipefunc/pipefunc/pull/523))
+- Extend `AsyncMap.result()` for use in scripts ([#911](https://github.com/pipefunc/pipefunc/pull/911))
+
+### 🤖 CI
+
+- Add Python 3.14 variants to pytest uv workflow ([#913](https://github.com/pipefunc/pipefunc/pull/913))
+- Fix free-threaded dependencies ([#917](https://github.com/pipefunc/pipefunc/pull/917))
+
+### 🧪 Testing
+
+- Allow async map call order variance ([#916](https://github.com/pipefunc/pipefunc/pull/916))
+
+### 🧹 Maintenance
+
+- Drop Python 3.10 support ([#914](https://github.com/pipefunc/pipefunc/pull/914))
+
+### 📦 Dependencies
+
+- ⬆️ Update ghcr.io/astral-sh/uv Docker tag to v0.9.4 ([#904](https://github.com/pipefunc/pipefunc/pull/904))
+- ⬆️ Update ghcr.io/astral-sh/uv Docker tag to v0.9.1 ([#900](https://github.com/pipefunc/pipefunc/pull/900))
+
+### 📝 Other
+
+- Add ProcessPool error snapshot regression test ([#907](https://github.com/pipefunc/pipefunc/pull/907))
+- Skip SLURM tests when /bin/bash is missing ([#906](https://github.com/pipefunc/pipefunc/pull/906))
+
+### 📊 Stats
+
+- `.yml`: +9 lines, -9 lines
+- `.md`: +91 lines, -0 lines
+- `.py`: +1053 lines, -92 lines
+- `.toml`: +6 lines, -5 lines
+- `other`: +1 lines, -1 lines
+
+## v0.87.1 (2025-10-10)
+
+### 📚 Documentation
+
+- Add comparison section with Hamilton ([#502](https://github.com/pipefunc/pipefunc/pull/502))
+
+### 🐛 Bug Fixes
+
+- Fix 1D array single outputs stored as coordinates instead of data variables ([#899](https://github.com/pipefunc/pipefunc/pull/899))
+
+### 📊 Stats
+
+- `.md`: +27 lines, -0 lines
+- `.py`: +287 lines, -15 lines
+
+## v0.87.0 (2025-10-09)
+
+### 🐛 Bug Fixes
+
+- Fix path resolution and add legacy format support for RunInfo.load ([#898](https://github.com/pipefunc/pipefunc/pull/898))
+- Fix path resolution when loading from different working directory ([#893](https://github.com/pipefunc/pipefunc/pull/893))
+- Fix load_dataframe failing on list/tuple outputs not in mapspec ([#892](https://github.com/pipefunc/pipefunc/pull/892))
+
+### ✨ Enhancements
+
+- Add first-class Polars DataFrame support ([#882](https://github.com/pipefunc/pipefunc/pull/882))
+- Add rename_axes method to ArraySpec and MapSpec and add PipeFunc.update_mapspec_axes ([#889](https://github.com/pipefunc/pipefunc/pull/889))
+
+### 📝 Other
+
+- Revert "BUG: Fix path resolution when loading from different working directory (#893)" ([#897](https://github.com/pipefunc/pipefunc/pull/897))
+
+### 📚 Documentation
+
+- Add MCP Server Integration documentation ([#891](https://github.com/pipefunc/pipefunc/pull/891))
+
+### 🧹 Maintenance
+
+- Skip coverage on version branch (get to 100%) ([#894](https://github.com/pipefunc/pipefunc/pull/894))
+- Update fastmcp to >=2.12.0 and fix compatibility issues ([#890](https://github.com/pipefunc/pipefunc/pull/890))
+- Factor out `_get_item_sliced` from `DictArray.__getitem__` to simplify diff of #720 ([#884](https://github.com/pipefunc/pipefunc/pull/884))
+
+### 📦 Dependencies
+
+- ⬆️ Update ghcr.io/astral-sh/uv Docker tag to v0.9.0 ([#885](https://github.com/pipefunc/pipefunc/pull/885))
+- ⬆️ Update astral-sh/setup-uv action to v7 ([#888](https://github.com/pipefunc/pipefunc/pull/888))
+- ⬆️ Update github/codeql-action action to v4 ([#887](https://github.com/pipefunc/pipefunc/pull/887))
+- ⬆️ Update python to v3.14.0 ([#886](https://github.com/pipefunc/pipefunc/pull/886))
+- ⬆️ Update ghcr.io/astral-sh/uv Docker tag to v0.8.23 ([#753](https://github.com/pipefunc/pipefunc/pull/753))
+- ⬆️ Update actions/checkout action to v5 ([#870](https://github.com/pipefunc/pipefunc/pull/870))
+- ⬆️ Update CodSpeedHQ/action action to v4 ([#872](https://github.com/pipefunc/pipefunc/pull/872))
+- ⬆️ Update actions/setup-python action to v6 ([#873](https://github.com/pipefunc/pipefunc/pull/873))
+
+### 🧪 Testing
+
+- add regression coverage for regular arrays ([#883](https://github.com/pipefunc/pipefunc/pull/883))
+
+### 🤖 CI
+
+- Set `mode: instrumentation` in codspeed.yml ([#875](https://github.com/pipefunc/pipefunc/pull/875))
+
+### 📊 Stats
+
+- `.yml`: +20 lines, -21 lines
+- `.yaml`: +3 lines, -3 lines
+- `.md`: +238 lines, -0 lines
+- `.py`: +1013 lines, -115 lines
+- `.toml`: +5 lines, -3 lines
+- `other`: +3 lines, -1 lines
+
+## v0.86.0 (2025-09-10)
+
+### ✨ Enhancements
+
+- Extract type annotations from NamedTuple return types ([#874](https://github.com/pipefunc/pipefunc/pull/874))
+
+### 📦 Dependencies
+
+- ⬆️ Update python to v3.13.7 ([#869](https://github.com/pipefunc/pipefunc/pull/869))
+
+### 🔄 Pre-commit
+
+- [pre-commit.ci] pre-commit autoupdate ([#861](https://github.com/pipefunc/pipefunc/pull/861))
+
+### 📚 Documentation
+
+- Add `llms.txt` and `llms-full.txt` to the documentation ([#866](https://github.com/pipefunc/pipefunc/pull/866))
+- Update `CHANGELOG.md` until v0.85.2 ([#864](https://github.com/pipefunc/pipefunc/pull/864))
+
+### 📊 Stats
+
+- `.yml`: +3 lines, -1 lines
+- `.yaml`: +3 lines, -3 lines
+- `.md`: +115 lines, -1 lines
+- `.py`: +146 lines, -0 lines
+- `.toml`: +2 lines, -0 lines
+
 ## v0.85.2 (2025-07-15)
 
 ### ✨ Enhancements
@@ -26,6 +305,10 @@ GITHUB_TOKEN=$(gh auth token) uv run .github/generate-release-notes.py
 
 ## v0.85.1 (2025-07-10)
 
+### Closed Issues
+
+- BUG: `Pipeline.update_defaults` with inputs that do not support `__eq__` fails. ([#856](https://github.com/pipefunc/pipefunc/issues/856))
+
 ### 🐛 Bug Fixes
 
 - Cast to `bool` to prevent issues with custom equality methods ([#859](https://github.com/pipefunc/pipefunc/pull/859))
@@ -89,6 +372,10 @@ GITHUB_TOKEN=$(gh auth token) uv run .github/generate-release-notes.py
 
 ## v0.83.0 (2025-06-20)
 
+### Closed Issues
+
+- update_defaults does not allow for a scope-keyed nested dictionary ([#810](https://github.com/pipefunc/pipefunc/issues/810))
+
 ### 🧹 Maintenance
 
 - Add typed `handle_pipefunc_error` function ([#844](https://github.com/pipefunc/pipefunc/pull/844))
@@ -165,6 +452,10 @@ GITHUB_TOKEN=$(gh auth token) uv run .github/generate-release-notes.py
 
 ## v0.82.0 (2025-06-18)
 
+### Closed Issues
+
+- `Pipeline.subpipeline` handles optional inputs as required when validating new `root_args` ([#825](https://github.com/pipefunc/pipefunc/issues/825))
+
 ### ✨ Enhancements
 
 - Add support for suppressing runtime error logs in `PipeFunc` and `Pipeline` classes ([#827](https://github.com/pipefunc/pipefunc/pull/827))
@@ -400,6 +691,11 @@ GITHUB_TOKEN=$(gh auth token) uv run .github/generate-release-notes.py
 
 ## v0.74.0 (2025-05-12)
 
+### Closed Issues
+
+- Have visual indicator if `map_async`'s task fails ([#752](https://github.com/pipefunc/pipefunc/issues/752))
+- Enhancement: Allow `chunksizes={"": None, "outp": 10}` ([#751](https://github.com/pipefunc/pipefunc/issues/751))
+
 ### ✨ Enhancements
 
 - Set background colors per scope in `ProgressTracker` widget ([#772](https://github.com/pipefunc/pipefunc/pull/772))

{pipefunc-0.91.0 → pipefunc-0.92.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pipefunc
-Version: 0.91.0
+Version: 0.92.0
 Summary: A Python library for defining, managing, and executing function pipelines.
 Project-URL: homepage, https://pipefunc.readthedocs.io/
 Project-URL: documentation, https://pipefunc.readthedocs.io/
@@ -199,7 +199,7 @@ Requires-Dist: numcodecs; extra == 'zarr'
 Requires-Dist: zarr>=3; extra == 'zarr'
 Description-Content-Type: text/markdown
 
-# PipeFunc: Structure, Automate, and Simplify Your Computational Workflows 🕸
+# PipeFunc: Structure, Automate, and Simplify Your Computational Workflows
 
 > **_Stop_** micromanaging execution. Focus on the **science**. Capture your workflow's essence with **function pipelines**, represent **computations as DAGs**, and **automate parallel sweeps**.
 
@@ -219,22 +219,22 @@ Description-Content-Type: text/markdown
 
 <!-- toc-start -->
 
-## :books: Table of Contents
+## Table of Contents
 
 <!-- START doctoc generated TOC please keep comment here to allow auto update -->
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 
-- [:thinking: What is this?](#thinking-what-is-this)
-- [:rocket: Key Features](#rocket-key-features)
-- [:test_tube: How does it work?](#test_tube-how-does-it-work)
-- [:notebook: Jupyter Notebook Example](#notebook-jupyter-notebook-example)
-- [:computer: Installation](#computer-installation)
-- [:hammer_and_wrench: Development](#hammer_and_wrench-development)
+- [What is this?](#what-is-this)
+- [Key Features](#key-features)
+- [How does it work?](#how-does-it-work)
+- [Jupyter Notebook Example](#jupyter-notebook-example)
+- [Installation](#installation)
+- [Development](#development)
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 <!-- toc-end -->
 
-## :thinking: What is this?
+## What is this?
 
 [![asciicast](https://asciinema.org/a/q5S3ffIxrAGmoLMOc0hOb3aod.svg)](https://asciinema.org/a/q5S3ffIxrAGmoLMOc0hOb3aod)
 
@@ -248,7 +248,7 @@ Visualize the pipeline as a directed graph, execute the pipeline for all (or spe
 
 Whether you're working with data processing, scientific computations, machine learning (AI) workflows, or any other scenario involving interdependent functions, `pipefunc` helps you focus on the logic of your code while it handles the intricacies of function dependencies and execution order.
 
-## :rocket: Key Features
+## Key Features
 
 1. 🚀 **Function Composition and Pipelining**: Create pipelines by using the `@pipefunc` decorator; execution order is automatically handled.
 1. 📊 **Pipeline Visualization**: Generate visual graphs of your pipelines to better understand the flow of data.
@@ -256,14 +256,14 @@ Whether you're working with data processing, scientific computations, machine le
 1. 🔁 **Map-Reduce Support**: Perform "map" operations to apply functions over data and "reduce" operations to aggregate results, allowing n-dimensional mappings.
 1. 👮 **Type Annotations Validation**: Validates the type annotations between functions to ensure type consistency.
 1. 🎛️ **Resource Usage Profiling**: Get reports on CPU usage, memory consumption, and execution time to identify bottlenecks and optimize your code.
-1. 🔄 **Automatic parallelization**: Automatically runs pipelines in parallel (local or remote) with shared memory and disk caching options.
-1. ⚡ **Ultra-Fast Performance**: Minimal overhead of [about 15 µs](https://pipefunc.readthedocs.io/en/latest/faq/#what-is-the-overhead-efficiency-performance-of-pipefunc) per function in the graph, ensuring blazingly fast execution.
+1. 🔄 **Automatic Parallelization**: Automatically runs pipelines in parallel (local or remote) with shared memory and disk caching options.
+1. ⚡ **Fast Performance**: Minimal overhead of [about 15 µs](https://pipefunc.readthedocs.io/en/latest/faq/#what-is-the-overhead-efficiency-performance-of-pipefunc) per function in the graph.
 1. 🔍 **Parameter Sweep Utilities**: Generate parameter combinations for parameter sweeps and optimize the sweeps with result caching.
 1. 💡 **Flexible Function Arguments**: Call functions with different argument combinations, letting `pipefunc` determine which other functions to call based on the provided arguments.
 1. 🏗️ **Leverages giants**: Builds on top of [NetworkX](https://networkx.org/) for graph algorithms, [NumPy](https://numpy.org/) for multi-dimensional arrays, and optionally [Xarray](https://docs.xarray.dev/) for labeled multi-dimensional arrays, [Zarr](https://zarr.readthedocs.io/) to store results in memory/disk/cloud or any key-value store, and [Adaptive](https://adaptive.readthedocs.io/) for parallel sweeps.
 1. 🤓 **Nerd stats**: >1000 tests with 100% test coverage, fully typed, only 3 required dependencies, _all_ Ruff Rules, _all_ public API documented.
 
-## :test_tube: How does it work?
+## How does it work?
 
 pipefunc provides a Pipeline class that you use to define your function pipeline.
 You add functions to the pipeline using the `pipefunc` decorator, which also lets you specify the function's output name.
@@ -329,7 +329,7 @@ print(result)  # prints 7.0
 
 Here the `mapspec` argument is used to specify the mapping between the inputs and outputs of the `f` function, it creates the product of the `a` and `b` input lists and computes the sum of each pair. The `g` function then computes the mean of the resulting 2D array. The `map` method executes the pipeline for the `inputs`, and the `load_outputs` function is used to load the results of the `g` function from the specified run folder.
 
-## :notebook: Jupyter Notebook Example
+## Jupyter Notebook Example
 
 See the detailed usage example and more in our [example.ipynb](https://github.com/pipefunc/pipefunc/blob/main/example.ipynb).
 
@@ -337,7 +337,7 @@ See the detailed usage example and more in our [example.ipynb](https://github.co
 > Have [`uv` installed](https://docs.astral.sh/uv/)?
 > Run `uvx --with "pipefunc[docs]" -p 3.13 opennb pipefunc/pipefunc/example.ipynb` to open the example notebook in your browser without the need to setup anything!
 
-## :computer: Installation
+## Installation
 
 Install the **latest stable** version from conda (recommended):
 
@@ -365,7 +365,7 @@ cd pipefunc
 pip install -e ".[dev]"
 ```
 
-## :hammer_and_wrench: Development
+## Development
 
 We use [`pre-commit`](https://pre-commit.com/) to manage pre-commit hooks, which helps us ensure that our code is always clean and compliant with our coding standards.
 To set it up, install pre-commit with pip and then run the install command:

{pipefunc-0.91.0 → pipefunc-0.92.0}/README.md

@@ -1,4 +1,4 @@
-# PipeFunc: Structure, Automate, and Simplify Your Computational Workflows 🕸
+# PipeFunc: Structure, Automate, and Simplify Your Computational Workflows
 
 > **_Stop_** micromanaging execution. Focus on the **science**. Capture your workflow's essence with **function pipelines**, represent **computations as DAGs**, and **automate parallel sweeps**.
 
@@ -18,22 +18,22 @@
 
 <!-- toc-start -->
 
-## :books: Table of Contents
+## Table of Contents
 
 <!-- START doctoc generated TOC please keep comment here to allow auto update -->
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 
-- [:thinking: What is this?](#thinking-what-is-this)
-- [:rocket: Key Features](#rocket-key-features)
-- [:test_tube: How does it work?](#test_tube-how-does-it-work)
-- [:notebook: Jupyter Notebook Example](#notebook-jupyter-notebook-example)
-- [:computer: Installation](#computer-installation)
-- [:hammer_and_wrench: Development](#hammer_and_wrench-development)
+- [What is this?](#what-is-this)
+- [Key Features](#key-features)
+- [How does it work?](#how-does-it-work)
+- [Jupyter Notebook Example](#jupyter-notebook-example)
+- [Installation](#installation)
+- [Development](#development)
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 <!-- toc-end -->
 
-## :thinking: What is this?
+## What is this?
 
 [![asciicast](https://asciinema.org/a/q5S3ffIxrAGmoLMOc0hOb3aod.svg)](https://asciinema.org/a/q5S3ffIxrAGmoLMOc0hOb3aod)
 
@@ -47,7 +47,7 @@ Visualize the pipeline as a directed graph, execute the pipeline for all (or spe
 
 Whether you're working with data processing, scientific computations, machine learning (AI) workflows, or any other scenario involving interdependent functions, `pipefunc` helps you focus on the logic of your code while it handles the intricacies of function dependencies and execution order.
 
-## :rocket: Key Features
+## Key Features
 
 1. 🚀 **Function Composition and Pipelining**: Create pipelines by using the `@pipefunc` decorator; execution order is automatically handled.
 1. 📊 **Pipeline Visualization**: Generate visual graphs of your pipelines to better understand the flow of data.
@@ -55,14 +55,14 @@ Whether you're working with data processing, scientific computations, machine le
 1. 🔁 **Map-Reduce Support**: Perform "map" operations to apply functions over data and "reduce" operations to aggregate results, allowing n-dimensional mappings.
 1. 👮 **Type Annotations Validation**: Validates the type annotations between functions to ensure type consistency.
 1. 🎛️ **Resource Usage Profiling**: Get reports on CPU usage, memory consumption, and execution time to identify bottlenecks and optimize your code.
-1. 🔄 **Automatic parallelization**: Automatically runs pipelines in parallel (local or remote) with shared memory and disk caching options.
-1. ⚡ **Ultra-Fast Performance**: Minimal overhead of [about 15 µs](https://pipefunc.readthedocs.io/en/latest/faq/#what-is-the-overhead-efficiency-performance-of-pipefunc) per function in the graph, ensuring blazingly fast execution.
+1. 🔄 **Automatic Parallelization**: Automatically runs pipelines in parallel (local or remote) with shared memory and disk caching options.
+1. ⚡ **Fast Performance**: Minimal overhead of [about 15 µs](https://pipefunc.readthedocs.io/en/latest/faq/#what-is-the-overhead-efficiency-performance-of-pipefunc) per function in the graph.
 1. 🔍 **Parameter Sweep Utilities**: Generate parameter combinations for parameter sweeps and optimize the sweeps with result caching.
 1. 💡 **Flexible Function Arguments**: Call functions with different argument combinations, letting `pipefunc` determine which other functions to call based on the provided arguments.
 1. 🏗️ **Leverages giants**: Builds on top of [NetworkX](https://networkx.org/) for graph algorithms, [NumPy](https://numpy.org/) for multi-dimensional arrays, and optionally [Xarray](https://docs.xarray.dev/) for labeled multi-dimensional arrays, [Zarr](https://zarr.readthedocs.io/) to store results in memory/disk/cloud or any key-value store, and [Adaptive](https://adaptive.readthedocs.io/) for parallel sweeps.
 1. 🤓 **Nerd stats**: >1000 tests with 100% test coverage, fully typed, only 3 required dependencies, _all_ Ruff Rules, _all_ public API documented.
 
-## :test_tube: How does it work?
+## How does it work?
 
 pipefunc provides a Pipeline class that you use to define your function pipeline.
 You add functions to the pipeline using the `pipefunc` decorator, which also lets you specify the function's output name.
@@ -128,7 +128,7 @@ print(result)  # prints 7.0
 
 Here the `mapspec` argument is used to specify the mapping between the inputs and outputs of the `f` function, it creates the product of the `a` and `b` input lists and computes the sum of each pair. The `g` function then computes the mean of the resulting 2D array. The `map` method executes the pipeline for the `inputs`, and the `load_outputs` function is used to load the results of the `g` function from the specified run folder.
 
-## :notebook: Jupyter Notebook Example
+## Jupyter Notebook Example
 
 See the detailed usage example and more in our [example.ipynb](https://github.com/pipefunc/pipefunc/blob/main/example.ipynb).
 
@@ -136,7 +136,7 @@ See the detailed usage example and more in our [example.ipynb](https://github.co
 > Have [`uv` installed](https://docs.astral.sh/uv/)?
 > Run `uvx --with "pipefunc[docs]" -p 3.13 opennb pipefunc/pipefunc/example.ipynb` to open the example notebook in your browser without the need to setup anything!
 
-## :computer: Installation
+## Installation
 
 Install the **latest stable** version from conda (recommended):
 
@@ -164,7 +164,7 @@ cd pipefunc
 pip install -e ".[dev]"
 ```
 
-## :hammer_and_wrench: Development
+## Development
 
 We use [`pre-commit`](https://pre-commit.com/) to manage pre-commit hooks, which helps us ensure that our code is always clean and compliant with our coding standards.
 To set it up, install pre-commit with pip and then run the install command:

{pipefunc-0.91.0 → pipefunc-0.92.0}/docs/source/concepts/caching.md

@@ -181,6 +181,7 @@ pipeline.cache.clear()
 - When using `pipeline.map` with `parallel=True`, the cache itself will be serialized, so one must use a cache that supports shared memory, such as {class}`~pipefunc.cache.LRUCache` with `shared=True` or a disk cache like {class}`~pipefunc.cache.DiskCache`.
 - The {func}`pipefunc.cache.to_hashable` function is used to attempt to ensure that input values are hashable, which is a requirement for storing results in a cache.
 - This function works for many common types but is not guaranteed to work for all types.
+- Cached values are isolated from mutations: the in-memory caches store and return deep copies (shared caches achieve the same via (de)serialization), so mutating a returned result does not corrupt the cache entry. If your results are large and you never mutate them, you can opt out of the copy overhead with e.g. ``LRUCache(shared=False, copy=False)`` or ``SimpleCache(copy=False)``.
 
 By understanding and utilizing `pipefunc`'s caching mechanisms effectively, you can significantly improve the performance of your pipelines, especially when dealing with computationally expensive functions or large datasets.