interactive-pipe 0.8.7__tar.gz → 0.8.8__tar.gz

interactive_pipe-0.8.8/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Balthazar Neveu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{interactive_pipe-0.8.7/src/interactive_pipe.egg-info → interactive_pipe-0.8.8}/PKG-INFO

@@ -1,12 +1,12 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: interactive_pipe
-Version: 0.8.7
+Version: 0.8.8
 Summary: Library to create flexible interactive image processing pipelines and automatically add a graphical user interface without knowing anything about GUI coding!
 Author-email: Balthazar Neveu <balthazarneveu@gmail.com>
 Project-URL: Homepage, https://github.com/balthazarneveu/interactive_pipe
 Project-URL: Bug Tracker, https://github.com/balthazarneveu/interactive_pipe/issues
 Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: The Unlicense (Unlicense)
+Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.7
 Description-Content-Type: text/markdown
@@ -41,6 +41,7 @@ Requires-Dist: pytest>=6.2.5; extra == "full"
 Requires-Dist: ipywidgets>=7.7.1; extra == "full"
 Requires-Dist: pandas; extra == "full"
 Requires-Dist: gradio; extra == "full"
+Dynamic: license-file
 
 
 <center>
@@ -69,8 +70,8 @@ Requires-Dist: gradio; extra == "full"
 | Science notebook | Toddler DIY Jukebox on a raspberry Pi |
 |:-----: |:-----:|
 | ![science notebook](/doc/images/scientific_notebook.jpg) |  ![jukebox](/doc/images/jukebox.jpg)
-| Sliders are added automatically in your jupyter notebook. This works on Google Collab and the code takes about 40 lines of code. No Widgets, event handlers or matplotlib knowledge required.| Plays some music when you touch the icon. Images can be generated using the OpenAI [Dall-E API helpers](https://github.com/balthazarneveu/interactive_pipe/blob/master/src/interactive_pipe/thirdparty/images_openai_api.py) . Caption added through the title mechanism. Music samples generated by prompting [MusicGen](https://huggingface.co/spaces/facebook/MusicGen) |
-| [Demo notebook on collab](https://colab.research.google.com/drive/1AwHyjZH8MnzZqwsvbmxBoB15btuMIwtk?usp=sharing) | [jukebox.py demo code](/demo/jukebox.py)|
+| Sliders are added automatically in your jupyter notebook. This works on Google Collab and the code takes about 40 lines of code. No Widgets, event handlers or matplotlib knowledge required.| Plays some music when you touch the icon. Caption added through the title mechanism. Music samples generated by prompting [MusicGen](https://huggingface.co/spaces/facebook/MusicGen) |
+| [Demo notebook on collab](https://colab.research.google.com/drive/1AwHyjZH8MnzZqwsvbmxBoB15btuMIwtk?usp=sharing) | [jukebox_demo.py demo code](/demo/jukebox_demo.py)|
 
 
 ----------------------
@@ -107,19 +108,21 @@ pip install -e ".[full]"
 
 ## :scroll:  Features
 
-**Version 0.8.7**
+**Version 0.8.8**
 - Modular multi-image processing filters
 - Declarative: Easily make graphical user interface without having to learn anything about pyQt or matplotlib
 - Support in jupyter notebooks
 - Tuning sliders & check buttons  with a GUI
 - Cache intermediate results in RAM for much faster processing
 - `KeyboardControl` : no slider on UI but exactly the same internal mechanism, update on key press.
-- Support Curve plots (2D signalKeybos)
-- :new: gradio backend (+allows sharing with others). 
-- :new: Audio support in Gradio (live audio or display several players by returning 1D numpy arrays)
-- :new: Circular sliders for Qt Backend
-- :new: Text prompt (`free_text=("Hello world!", None),`)
-- :new: TimeControl (possibility to play/pause time using an incrementing timer)
+- Support Curve plots (2D signals)
+- Gradio backend (+allows sharing with others). 
+- Audio support in Gradio (live audio or display several players by returning 1D numpy arrays)
+- Circular sliders for Qt Backend
+- Text prompt (`free_text=("Hello world!", None),`)
+- TimeControl (possibility to play/pause time using an incrementing timer)
+- :new: **Context API**: Direct access to shared context across filters via `get_context()`, `context`, `layout`, `audio` 
+- :new: MIT License
 
 
 
@@ -327,21 +330,119 @@ if __name__ == '__main__':
 
 ----------
 
+### Release Notes
+
+#### Version 0.8.8 (January 2026)
+
+**New Features:**
+- **Clean Context API**: Access shared context directly without `global_params` pollution
+  - `get_context()` - Get the shared context dictionary
+  - `context` - Direct dict-like access to context
+  - `layout` - Access layout configuration directly
+  - `audio` - Access audio functionality directly
+
+**Code Quality Improvements:**
+- Replaced all assertions with proper exceptions (`ValueError`, `TypeError`, `RuntimeError`)
+- Fixed all mutable default arguments across the codebase (prevents shared state bugs)
+- Improved type hints with proper `Optional` and `Any` types
+- Better error messages for debugging
+
+**UX Improvements:**
+- Dropdown menus are now hidden when only a single choice is available
+- Helpful message displayed when Graphviz is not available (when pressing `G`)
+- Fixed warning in linestyle for curves
+
+**Bug Fixes:**
+- Fixed audio initialization order in Qt backend
+- Fixed pytest failures for optional dependencies in CI
+- Fixed various edge cases in error handling
+
+**Migration of old context or global_params:**  
+- Use `global_params=SharedContext.injected()` to let code interpreters know that there's no need to pass this parameter.
+
+```python
+# Before
+def apply_brightness(img:np.ndarray, brightness: float = 0.5, global_params:dict =None):
+    global_params["brightness"] = brightness
+    return img * brightness
+
+# Progressive migration
+def apply_brightness(img:np.ndarray, brightness: float = 0.5, global_params:dict ==SharedContext.injected()):
+    global_params["brightness"] = brightness
+    return img * brightness
+
+# Recommended version
+from interactive_pipe import context
+def apply_brightness(img:np.ndarray, brightness: float = 0.5):
+    context.shared_brightness = brightness # shared with all filters
+    return img * brightness
+```
+
+
+
+
+**License:**
+- Updated to MIT License
+
+---
+
 ### History
-- Interactive pipe was initially developped by [Balthazar Neveu](https://github.com/balthazarneveu) as part of the [irdrone project](https://github.com/wisescootering/infrareddrone/tree/master/interactive) based on matplotlib.
+- Interactive pipe was initially developed by [Balthazar Neveu](https://github.com/balthazarneveu) as part of the [irdrone project](https://github.com/wisescootering/infrareddrone/tree/master/interactive) based on matplotlib.
 - Later, more contributions were also made by [Giuseppe Moschetti](https://github.com/g-moschetti) and Sylvain Leroy.
 - August 2023: rewriting the whole core and supporting several graphical backends!
 - September 2024: Gradio backend
+- January 2026: Clean Context API and code quality improvements (v0.8.8)
 
 
 ### FAQ
-- :question: Is there a difference between `global_params` and `context` ?
-> No, `global_params`, `global_parameters`, `global_state`, `global_context`, `context`, `state` all mean the same thing and are all supported for legacy reasons. `context` is the preferred wording.
+- :question: What is the recommended way to access shared context?
+> **New in v0.8.8**: Use the clean context API for direct access:
+> ```python
+> from interactive_pipe import context, layout, audio, get_context
+> 
+> @interactive()
+> def my_filter(img):
+>     context["shared_key"] = "shared_value"  # Direct dict-like access
+>     context.brightness = 0.5
+>     layout.set_title("output_image", "My Image")  # Layout helpers
+>
+>     return img
+> ```
+
+- :question: How do I change the layout?  *Can I change the grid layout of images live? (like you compare 2 images side by side and you want to start comparing 4 images in a 2x2 fashion for debugging purpose)*. It is possible with Qt backend. 
+
+> Use the `layout` helper to control image arrangement and styling:
+> ```python
+> from interactive_pipe import layout
+> 
+> def change_layout(layout: str="side_by_side"):
+>     # Arrange outputs in a 2x2 grid
+>       if layout == "side_by_side":
+>            layout.grid([["input", "result"]])
+>       if layout == "grid2x2":
+>           layout.grid([["input", "processed"], ["histogram_graph", "result"]])
+>     # Style individual outputs
+>     layout.style("result", title="Final Result")
+>     # Note that the string "input", "processed", "histogram_graph", "result"
+>     # are the variables used in the pipeline (see below)!
+> 
+> def pipeline(input):
+>     processed = denoise(input)
+>     result = change_brightness(processed)
+>     histogram_graph = compute_histo(processed)
+>     change_layout()
+>     return result
+> ```
+
 - :question: Do I have to remove `KeyboardSlider` when using gradio or notebook backends?
 > No, don't worry, these will be mapped back to regular sliders!
 - :question: How do I play audio live?
-> :sound: Inside a processing block, write the audio file to disk 
-> and use `context["__set_audio"](audio_file)`
+> :sound: Inside a processing block, write the audio file to disk and use the audio helper:
+> ```python
+> from interactive_pipe import audio
+> audio.set_audio(audio_file)  # New clean API (v0.8.8)
+> # or legacy: context["__set_audio"](audio_file)
+> ```
 - :question: Do I have to decorate my processing block using the `@interactive` 
 > If you use the `@` decoration style, your function won't be useable in a regular manner (wich may be problematic in a serious development environment)
 ```python
@@ -374,7 +475,14 @@ def add_interactivity():
 # Don't do that!
 def bad_processing_block(inp):
     inp+=1
-``` 
+```
+
+- :question: Is there a difference between `global_params` and `context` ?
+> No, `global_params`, `global_parameters`, `global_state`, `global_context`, `context`, `state` all mean the same thing and are all supported for legacy reasons. `context` is the preferred wording. However, we now recommend using the clean context API (see above).
+> :warning: The old `global_params={}` / `context={}` keyword argument style still works for backwards compatibility but is deprecated.
+
+
+
 # Roadmap and todos
 :bug: Want to contribute or interested in adding new features? Enter a new [Github issue](https://github.com/balthazarneveu/interactive_pipe/issues)
 
@@ -402,12 +510,36 @@ def bad_processing_block(inp):
 
 ![Ultra simplistic ISP](/doc/images/isp_pipeline.png)
 
+----------------------
+
+### Development
+
+#### Code quality checks
+
+Before committing, ensure your code passes the linters and tests. The CI runs these checks automatically:
+
+**What CI does:**
+- **Black formatting check** (`.github/workflows/formatting.yaml`): Runs `black --check` to verify code formatting
+- **Flake8 linting** (`.github/workflows/flake8.yaml`): Runs `flake8` to check code quality
+- **Pytest tests** (`.github/workflows/pytest.yaml`): Runs `pytest` on Python 3.9, 3.10, and 3.11
 
+**Local commands (match CI):**
 
+```bash
+# Install linting tools and test dependencies
+pip install black flake8
+pip install -e ".[pytest]"
 
+# Check code formatting (Black) - matches CI
+black --check .
+
+# Auto-format code (Black) - run this if check fails
+black .
+
+# Run linting checks (flake8) - matches CI
+flake8 .
+
+# Run tests (pytest) - matches CI
+pytest
+```
 
-#### :test_tube: Experimental features
-- Custom events on specific key press
-- Display the execution graph of the pipeline `G` key
-- [thirdparty/music](/src/interactive_pipe/thirdparty/music.py) Play audio (Qt backend only). Play songs on spotify (linux only) when the spotify app is running.
-- [thirdparty/images_openai_api](/src/interactive_pipe/thirdparty/images_openai_api.py) Generate images from prompt using OpenAI API image generation DALL-E Model (:dollar:  paid service ~ 2cents/image) 

{interactive_pipe-0.8.7 → interactive_pipe-0.8.8}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "interactive_pipe"
-version = "0.8.7"
+version = "0.8.8"
 authors = [
   { name="Balthazar Neveu", email="balthazarneveu@gmail.com" },
 ]
@@ -28,7 +28,7 @@ readme = "readme.md"
 requires-python = ">=3.7"
 classifiers = [
     "Programming Language :: Python :: 3",
-    "License :: OSI Approved :: The Unlicense (Unlicense)",
+    "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
 ]
 

{interactive_pipe-0.8.7 → interactive_pipe-0.8.8}/readme.md

@@ -25,8 +25,8 @@
 | Science notebook | Toddler DIY Jukebox on a raspberry Pi |
 |:-----: |:-----:|
 | ![science notebook](/doc/images/scientific_notebook.jpg) |  ![jukebox](/doc/images/jukebox.jpg)
-| Sliders are added automatically in your jupyter notebook. This works on Google Collab and the code takes about 40 lines of code. No Widgets, event handlers or matplotlib knowledge required.| Plays some music when you touch the icon. Images can be generated using the OpenAI [Dall-E API helpers](https://github.com/balthazarneveu/interactive_pipe/blob/master/src/interactive_pipe/thirdparty/images_openai_api.py) . Caption added through the title mechanism. Music samples generated by prompting [MusicGen](https://huggingface.co/spaces/facebook/MusicGen) |
-| [Demo notebook on collab](https://colab.research.google.com/drive/1AwHyjZH8MnzZqwsvbmxBoB15btuMIwtk?usp=sharing) | [jukebox.py demo code](/demo/jukebox.py)|
+| Sliders are added automatically in your jupyter notebook. This works on Google Collab and the code takes about 40 lines of code. No Widgets, event handlers or matplotlib knowledge required.| Plays some music when you touch the icon. Caption added through the title mechanism. Music samples generated by prompting [MusicGen](https://huggingface.co/spaces/facebook/MusicGen) |
+| [Demo notebook on collab](https://colab.research.google.com/drive/1AwHyjZH8MnzZqwsvbmxBoB15btuMIwtk?usp=sharing) | [jukebox_demo.py demo code](/demo/jukebox_demo.py)|
 
 
 ----------------------
@@ -63,19 +63,21 @@ pip install -e ".[full]"
 
 ## :scroll:  Features
 
-**Version 0.8.7**
+**Version 0.8.8**
 - Modular multi-image processing filters
 - Declarative: Easily make graphical user interface without having to learn anything about pyQt or matplotlib
 - Support in jupyter notebooks
 - Tuning sliders & check buttons  with a GUI
 - Cache intermediate results in RAM for much faster processing
 - `KeyboardControl` : no slider on UI but exactly the same internal mechanism, update on key press.
-- Support Curve plots (2D signalKeybos)
-- :new: gradio backend (+allows sharing with others). 
-- :new: Audio support in Gradio (live audio or display several players by returning 1D numpy arrays)
-- :new: Circular sliders for Qt Backend
-- :new: Text prompt (`free_text=("Hello world!", None),`)
-- :new: TimeControl (possibility to play/pause time using an incrementing timer)
+- Support Curve plots (2D signals)
+- Gradio backend (+allows sharing with others). 
+- Audio support in Gradio (live audio or display several players by returning 1D numpy arrays)
+- Circular sliders for Qt Backend
+- Text prompt (`free_text=("Hello world!", None),`)
+- TimeControl (possibility to play/pause time using an incrementing timer)
+- :new: **Context API**: Direct access to shared context across filters via `get_context()`, `context`, `layout`, `audio` 
+- :new: MIT License
 
 
 
@@ -283,21 +285,119 @@ if __name__ == '__main__':
 
 ----------
 
+### Release Notes
+
+#### Version 0.8.8 (January 2026)
+
+**New Features:**
+- **Clean Context API**: Access shared context directly without `global_params` pollution
+  - `get_context()` - Get the shared context dictionary
+  - `context` - Direct dict-like access to context
+  - `layout` - Access layout configuration directly
+  - `audio` - Access audio functionality directly
+
+**Code Quality Improvements:**
+- Replaced all assertions with proper exceptions (`ValueError`, `TypeError`, `RuntimeError`)
+- Fixed all mutable default arguments across the codebase (prevents shared state bugs)
+- Improved type hints with proper `Optional` and `Any` types
+- Better error messages for debugging
+
+**UX Improvements:**
+- Dropdown menus are now hidden when only a single choice is available
+- Helpful message displayed when Graphviz is not available (when pressing `G`)
+- Fixed warning in linestyle for curves
+
+**Bug Fixes:**
+- Fixed audio initialization order in Qt backend
+- Fixed pytest failures for optional dependencies in CI
+- Fixed various edge cases in error handling
+
+**Migration of old context or global_params:**  
+- Use `global_params=SharedContext.injected()` to let code interpreters know that there's no need to pass this parameter.
+
+```python
+# Before
+def apply_brightness(img:np.ndarray, brightness: float = 0.5, global_params:dict =None):
+    global_params["brightness"] = brightness
+    return img * brightness
+
+# Progressive migration
+def apply_brightness(img:np.ndarray, brightness: float = 0.5, global_params:dict ==SharedContext.injected()):
+    global_params["brightness"] = brightness
+    return img * brightness
+
+# Recommended version
+from interactive_pipe import context
+def apply_brightness(img:np.ndarray, brightness: float = 0.5):
+    context.shared_brightness = brightness # shared with all filters
+    return img * brightness
+```
+
+
+
+
+**License:**
+- Updated to MIT License
+
+---
+
 ### History
-- Interactive pipe was initially developped by [Balthazar Neveu](https://github.com/balthazarneveu) as part of the [irdrone project](https://github.com/wisescootering/infrareddrone/tree/master/interactive) based on matplotlib.
+- Interactive pipe was initially developed by [Balthazar Neveu](https://github.com/balthazarneveu) as part of the [irdrone project](https://github.com/wisescootering/infrareddrone/tree/master/interactive) based on matplotlib.
 - Later, more contributions were also made by [Giuseppe Moschetti](https://github.com/g-moschetti) and Sylvain Leroy.
 - August 2023: rewriting the whole core and supporting several graphical backends!
 - September 2024: Gradio backend
+- January 2026: Clean Context API and code quality improvements (v0.8.8)
 
 
 ### FAQ
-- :question: Is there a difference between `global_params` and `context` ?
-> No, `global_params`, `global_parameters`, `global_state`, `global_context`, `context`, `state` all mean the same thing and are all supported for legacy reasons. `context` is the preferred wording.
+- :question: What is the recommended way to access shared context?
+> **New in v0.8.8**: Use the clean context API for direct access:
+> ```python
+> from interactive_pipe import context, layout, audio, get_context
+> 
+> @interactive()
+> def my_filter(img):
+>     context["shared_key"] = "shared_value"  # Direct dict-like access
+>     context.brightness = 0.5
+>     layout.set_title("output_image", "My Image")  # Layout helpers
+>
+>     return img
+> ```
+
+- :question: How do I change the layout?  *Can I change the grid layout of images live? (like you compare 2 images side by side and you want to start comparing 4 images in a 2x2 fashion for debugging purpose)*. It is possible with Qt backend. 
+
+> Use the `layout` helper to control image arrangement and styling:
+> ```python
+> from interactive_pipe import layout
+> 
+> def change_layout(layout: str="side_by_side"):
+>     # Arrange outputs in a 2x2 grid
+>       if layout == "side_by_side":
+>            layout.grid([["input", "result"]])
+>       if layout == "grid2x2":
+>           layout.grid([["input", "processed"], ["histogram_graph", "result"]])
+>     # Style individual outputs
+>     layout.style("result", title="Final Result")
+>     # Note that the string "input", "processed", "histogram_graph", "result"
+>     # are the variables used in the pipeline (see below)!
+> 
+> def pipeline(input):
+>     processed = denoise(input)
+>     result = change_brightness(processed)
+>     histogram_graph = compute_histo(processed)
+>     change_layout()
+>     return result
+> ```
+
 - :question: Do I have to remove `KeyboardSlider` when using gradio or notebook backends?
 > No, don't worry, these will be mapped back to regular sliders!
 - :question: How do I play audio live?
-> :sound: Inside a processing block, write the audio file to disk 
-> and use `context["__set_audio"](audio_file)`
+> :sound: Inside a processing block, write the audio file to disk and use the audio helper:
+> ```python
+> from interactive_pipe import audio
+> audio.set_audio(audio_file)  # New clean API (v0.8.8)
+> # or legacy: context["__set_audio"](audio_file)
+> ```
 - :question: Do I have to decorate my processing block using the `@interactive` 
 > If you use the `@` decoration style, your function won't be useable in a regular manner (wich may be problematic in a serious development environment)
 ```python
@@ -330,7 +430,14 @@ def add_interactivity():
 # Don't do that!
 def bad_processing_block(inp):
     inp+=1
-``` 
+```
+
+- :question: Is there a difference between `global_params` and `context` ?
+> No, `global_params`, `global_parameters`, `global_state`, `global_context`, `context`, `state` all mean the same thing and are all supported for legacy reasons. `context` is the preferred wording. However, we now recommend using the clean context API (see above).
+> :warning: The old `global_params={}` / `context={}` keyword argument style still works for backwards compatibility but is deprecated.
+
+
+
 # Roadmap and todos
 :bug: Want to contribute or interested in adding new features? Enter a new [Github issue](https://github.com/balthazarneveu/interactive_pipe/issues)
 
@@ -358,12 +465,36 @@ def bad_processing_block(inp):
 
 ![Ultra simplistic ISP](/doc/images/isp_pipeline.png)
 
+----------------------
+
+### Development
+
+#### Code quality checks
+
+Before committing, ensure your code passes the linters and tests. The CI runs these checks automatically:
+
+**What CI does:**
+- **Black formatting check** (`.github/workflows/formatting.yaml`): Runs `black --check` to verify code formatting
+- **Flake8 linting** (`.github/workflows/flake8.yaml`): Runs `flake8` to check code quality
+- **Pytest tests** (`.github/workflows/pytest.yaml`): Runs `pytest` on Python 3.9, 3.10, and 3.11
 
+**Local commands (match CI):**
 
+```bash
+# Install linting tools and test dependencies
+pip install black flake8
+pip install -e ".[pytest]"
 
+# Check code formatting (Black) - matches CI
+black --check .
+
+# Auto-format code (Black) - run this if check fails
+black .
+
+# Run linting checks (flake8) - matches CI
+flake8 .
+
+# Run tests (pytest) - matches CI
+pytest
+```
 
-#### :test_tube: Experimental features
-- Custom events on specific key press
-- Display the execution graph of the pipeline `G` key
-- [thirdparty/music](/src/interactive_pipe/thirdparty/music.py) Play audio (Qt backend only). Play songs on spotify (linux only) when the spotify app is running.
-- [thirdparty/images_openai_api](/src/interactive_pipe/thirdparty/images_openai_api.py) Generate images from prompt using OpenAI API image generation DALL-E Model (:dollar:  paid service ~ 2cents/image) 

{interactive_pipe-0.8.7 → interactive_pipe-0.8.8}/src/interactive_pipe/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.8.7"
+__version__ = "0.8.8"
 from interactive_pipe.helper.pipeline_decorator import pipeline, interactive_pipeline
 from interactive_pipe.headless.control import (
     Control,
@@ -11,6 +11,18 @@ from interactive_pipe.data_objects.image import Image
 from interactive_pipe.headless.keyboard import KeyboardControl
 from interactive_pipe.helper.filter_decorator import interactive, interact
 
+# Clean context API - no more global_params pollution!
+from interactive_pipe.core.context import (
+    get_context,
+    context,  # Direct dict-like access
+    layout,
+    audio,
+    SharedContext,  # For legacy code migration with explicit injection
+)
+
+# Clean exception handling
+from interactive_pipe.core.engine import FilterError
+
 # Allowing more straightforward naming convention
 block = interactive
 pipeline = interactive_pipeline

{interactive_pipe-0.8.7 → interactive_pipe-0.8.8}/src/interactive_pipe/core/cache.py

@@ -1,6 +1,6 @@
 import logging
 from copy import deepcopy
-from typing import Any
+from typing import Any, Optional
 
 
 class CachedResults:
@@ -26,7 +26,7 @@ class CachedResults:
     Underlying class used in the interactive pipe cache mechanism.
     """
 
-    def __init__(self, name: str = None, safe_buffer_deepcopy: bool = True):
+    def __init__(self, name: Optional[str] = None, safe_buffer_deepcopy: bool = True):
         self.name = name
         self.result = None
         self.state_change = StateChange(name=name)
@@ -68,7 +68,7 @@ class CachedResults:
         )
 
     def __repr__(self) -> str:
-        return self.name
+        return self.name if self.name is not None else "CachedResults"
 
 
 class StateChange:
@@ -78,7 +78,7 @@ class StateChange:
     Underlying class used in the interactive pipe cache mechanism.
     """
 
-    def __init__(self, name: str = None):
+    def __init__(self, name: Optional[str] = None):
         self.name = name
         self._stored_params = None
         self._update_needed = False
@@ -106,6 +106,7 @@ class StateChange:
         self._update_needed = value
 
     def __repr__(self) -> str:
-        return f"{self.name}: " + (
+        name_str = self.name if self.name is not None else "StateChange"
+        return f"{name_str}: " + (
             "needs update" if self.update_needed else "no update needed"
         )