karcytics-sdk 3.2.0__tar.gz → 3.3.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (137) hide show
  1. {karcytics_sdk-3.2.0/src/karcytics_sdk.egg-info → karcytics_sdk-3.3.1}/PKG-INFO +1 -1
  2. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/pyproject.toml +1 -1
  3. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/contrib/image_utils.py +3 -3
  4. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/__init__.py +41 -0
  5. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/analysis.py +20 -1
  6. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/components.py +21 -5
  7. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/dialogs.py +54 -4
  8. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/image_view.py +1 -1
  9. karcytics_sdk-3.3.1/src/karcytics_sdk/plugin/params.py +58 -0
  10. karcytics_sdk-3.3.1/src/karcytics_sdk/plugin/params_form.py +319 -0
  11. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/rendering/mpl_canvas.py +8 -3
  12. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/runtime_services.py +22 -10
  13. karcytics_sdk-3.3.1/src/karcytics_sdk/plugin/stage_rail.py +139 -0
  14. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/tasks.py +1 -1
  15. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/theme_overlay.py +8 -5
  16. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/ui_daemon_runtime.py +36 -4
  17. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/version.py +1 -1
  18. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/testing/ui_daemon.py +10 -1
  19. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1/src/karcytics_sdk.egg-info}/PKG-INFO +1 -1
  20. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk.egg-info/SOURCES.txt +3 -0
  21. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/tests/test_plugin_ui.py +85 -0
  22. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/LICENSE +0 -0
  23. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/README.md +0 -0
  24. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/setup.cfg +0 -0
  25. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/__init__.py +0 -0
  26. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/cli/__init__.py +0 -0
  27. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/cli/commands/__init__.py +0 -0
  28. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/cli/commands/compliance.py +0 -0
  29. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/cli/commands/diagnostics.py +0 -0
  30. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/cli/commands/migrate.py +0 -0
  31. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/cli/commands/scaffold.py +0 -0
  32. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/cli/commands/security.py +0 -0
  33. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/cli/main.py +0 -0
  34. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/contrib/__init__.py +0 -0
  35. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/contrib/imaging.py +0 -0
  36. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/evaluator/__init__.py +0 -0
  37. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/evaluator/baseline.py +0 -0
  38. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/evaluator/catalog.py +0 -0
  39. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/evaluator/design_rules.py +0 -0
  40. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/evaluator/functional_rules.py +0 -0
  41. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/evaluator/model.py +0 -0
  42. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/evaluator/org_rules.py +0 -0
  43. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/evaluator/registry.py +0 -0
  44. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/evaluator/repo.py +0 -0
  45. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/evaluator/report.py +0 -0
  46. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/evaluator/runner.py +0 -0
  47. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/evaluator/source.py +0 -0
  48. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/evaluator/test_rules.py +0 -0
  49. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/host/__init__.py +0 -0
  50. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/host/ai.py +0 -0
  51. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/host/core_services.py +0 -0
  52. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/host/docs.py +0 -0
  53. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/host/marketplace_cache.py +0 -0
  54. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/host/module_status_widget.py +0 -0
  55. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/host/qt_bridge.py +0 -0
  56. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/host/sign_plugin.py +0 -0
  57. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/host/trust_manager.py +0 -0
  58. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/host/trust_overrides.py +0 -0
  59. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/host/trust_path.py +0 -0
  60. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/host/trust_storage.py +0 -0
  61. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/interfaces/__init__.py +0 -0
  62. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/interfaces/i_crash_reporter.py +0 -0
  63. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/interfaces/i_event_bus.py +0 -0
  64. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/interfaces/i_logger.py +0 -0
  65. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/interfaces/i_task_scheduler.py +0 -0
  66. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/academy.py +0 -0
  67. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/academy_driver.py +0 -0
  68. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/academy_lock_card.py +0 -0
  69. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/academy_window.py +0 -0
  70. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/autosave.py +0 -0
  71. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/base.py +0 -0
  72. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/citation_widgets.py +0 -0
  73. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/citations.py +0 -0
  74. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/context.py +0 -0
  75. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/course_complete_overlay.py +0 -0
  76. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/cyto_character.py +0 -0
  77. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/cyto_costumes.py +0 -0
  78. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/daemon.py +0 -0
  79. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/draggable.py +0 -0
  80. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/effects.py +0 -0
  81. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/events.py +0 -0
  82. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/galactic_loader.py +0 -0
  83. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/galactic_loader.qml +0 -0
  84. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/history.py +0 -0
  85. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/interfaces.py +0 -0
  86. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/io.py +0 -0
  87. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/logging.py +0 -0
  88. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/managed_task.py +0 -0
  89. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/manifest.py +0 -0
  90. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/manifest_parser.py +0 -0
  91. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/menu_builder.py +0 -0
  92. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/preferences.py +0 -0
  93. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/question_panel.py +0 -0
  94. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/rendering/__init__.py +0 -0
  95. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/rendering/axes.py +0 -0
  96. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/rendering/graphics_scene.py +0 -0
  97. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/rendering/lock.py +0 -0
  98. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/rendering/pipeline.py +0 -0
  99. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/ribbon.py +0 -0
  100. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/security_parser.py +0 -0
  101. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/signals.py +0 -0
  102. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/state.py +0 -0
  103. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/theme_fallback.py +0 -0
  104. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/timing.py +0 -0
  105. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/toast.py +0 -0
  106. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/tutorial_highlight.py +0 -0
  107. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/tutorial_models.py +0 -0
  108. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/tutorial_overlay.py +0 -0
  109. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/ui_preferences.py +0 -0
  110. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/update_check.py +0 -0
  111. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/validation.py +0 -0
  112. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/wizard.py +0 -0
  113. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/worker_thread.py +0 -0
  114. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/workflow.py +0 -0
  115. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/plugin/zoom_controls.py +0 -0
  116. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/py.typed +0 -0
  117. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/sdk_cli.py +0 -0
  118. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/testing/__init__.py +0 -0
  119. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk/testing/contract.py +0 -0
  120. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk.egg-info/dependency_links.txt +0 -0
  121. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk.egg-info/entry_points.txt +0 -0
  122. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk.egg-info/requires.txt +0 -0
  123. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/src/karcytics_sdk.egg-info/top_level.txt +0 -0
  124. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/tests/test_host_ai.py +0 -0
  125. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/tests/test_host_security.py +0 -0
  126. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/tests/test_marketplace_cache.py +0 -0
  127. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/tests/test_namespaces.py +0 -0
  128. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/tests/test_plugin_architecture.py +0 -0
  129. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/tests/test_plugin_ribbon.py +0 -0
  130. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/tests/test_plugin_state.py +0 -0
  131. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/tests/test_sdk_cli.py +0 -0
  132. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/tests/test_sign_plugin.py +0 -0
  133. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/tests/test_testing_contract.py +0 -0
  134. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/tests/test_theme_fallback.py +0 -0
  135. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/tests/test_ui_daemon_runtime.py +0 -0
  136. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/tests/test_workflow_context.py +0 -0
  137. {karcytics_sdk-3.2.0 → karcytics_sdk-3.3.1}/tests/test_workflow_dialogs.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: karcytics-sdk
3
- Version: 3.2.0
3
+ Version: 3.3.1
4
4
  Summary: Software Development Kit and CLI for Karcytics.
5
5
  Author: Kalaimaran Balasothy
6
6
  License: # PolyForm Noncommercial License 1.0.0
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "karcytics-sdk"
7
- version = "3.2.0"
7
+ version = "3.3.1"
8
8
  description = "Software Development Kit and CLI for Karcytics."
9
9
  readme = "README.md"
10
10
  license = { file = "LICENSE" }
@@ -1,7 +1,7 @@
1
1
  """Image loading, format conversion, and preprocessing utilities (deprecated).
2
2
 
3
- Deprecated: this is western-blot band-image logic, which moved into that
4
- plugin. It will be removed in karcytics-sdk 4.0.
3
+ Deprecated: this is band-image logic from the Gel & Blot plugin (formerly western-blot),
4
+ which now owns it. It will be removed in karcytics-sdk 4.0.
5
5
 
6
6
  This module provides low-level image I/O and transformation functions
7
7
  used throughout the Karcytics analysis pipeline. All functions operate on
@@ -36,7 +36,7 @@ from skimage.util import img_as_float64
36
36
 
37
37
  warnings.warn(
38
38
  "karcytics_sdk.contrib.image_utils is deprecated and will be removed in karcytics-sdk 4.0: it is "
39
- "western-blot band-image logic, which now lives in that plugin. Copy what you need into your plugin.",
39
+ "band-image logic that now lives in the Gel & Blot plugin (formerly western-blot). Copy what you need into your plugin.",
40
40
  DeprecationWarning,
41
41
  stacklevel=2,
42
42
  )
@@ -19,12 +19,16 @@ if TYPE_CHECKING:
19
19
  BioCaptionLabel,
20
20
  BioComboBox,
21
21
  BioDoubleSpinBox,
22
+ BioFooter,
22
23
  BioHeaderLabel,
23
24
  BioHelpButton,
24
25
  BioLineEdit,
25
26
  BioListWidget,
27
+ BioMenu,
28
+ BioProgressDialog,
26
29
  BioRunButton,
27
30
  BioScrollArea,
31
+ BioSectionLabel,
28
32
  BioSpinBox,
29
33
  BioSplitter,
30
34
  BioStatusLabel,
@@ -36,6 +40,7 @@ if TYPE_CHECKING:
36
40
  PrimaryButton,
37
41
  SecondaryButton,
38
42
  SubtitleLabel,
43
+ WorkspaceSaveButton,
39
44
  apply_component_style,
40
45
  repopulate_combo,
41
46
  )
@@ -46,6 +51,7 @@ if TYPE_CHECKING:
46
51
  from .dialogs import (
47
52
  ask_ok_cancel,
48
53
  ask_yes_no,
54
+ bring_into_project,
49
55
  confirm_destructive,
50
56
  get_directory,
51
57
  get_double,
@@ -65,6 +71,8 @@ if TYPE_CHECKING:
65
71
  from .logging import get_logger
66
72
  from .managed_task import FunctionalTask
67
73
  from .manifest import PluginManifest
74
+ from .params import Param
75
+ from .params_form import ParamsForm
68
76
  from .preferences import PreferenceManagerProtocol
69
77
  from .rendering import (
70
78
  MPL_RASTER_LOCK,
@@ -91,6 +99,7 @@ if TYPE_CHECKING:
91
99
  tutorial_manager,
92
100
  )
93
101
  from .signals import PluginSignals, move_to_gui_thread, safe_disconnect
102
+ from .stage_rail import StageRail, StageStatus
94
103
  from .state import PluginState
95
104
  from .tasks import TaskHandle, submit_task
96
105
  from .timing import Debouncer
@@ -153,12 +162,16 @@ _EXPORTS: dict[str, tuple[str, ...]] = {
153
162
  "BioCaptionLabel",
154
163
  "BioComboBox",
155
164
  "BioDoubleSpinBox",
165
+ "BioFooter",
156
166
  "BioHeaderLabel",
157
167
  "BioHelpButton",
158
168
  "BioLineEdit",
159
169
  "BioListWidget",
170
+ "BioMenu",
171
+ "BioProgressDialog",
160
172
  "BioRunButton",
161
173
  "BioScrollArea",
174
+ "BioSectionLabel",
162
175
  "BioSpinBox",
163
176
  "BioSplitter",
164
177
  "BioStatusLabel",
@@ -170,6 +183,7 @@ _EXPORTS: dict[str, tuple[str, ...]] = {
170
183
  "PrimaryButton",
171
184
  "SecondaryButton",
172
185
  "SubtitleLabel",
186
+ "WorkspaceSaveButton",
173
187
  "apply_component_style",
174
188
  "repopulate_combo",
175
189
  ),
@@ -180,6 +194,7 @@ _EXPORTS: dict[str, tuple[str, ...]] = {
180
194
  ".dialogs": (
181
195
  "ask_ok_cancel",
182
196
  "ask_yes_no",
197
+ "bring_into_project",
183
198
  "confirm_destructive",
184
199
  "get_directory",
185
200
  "get_double",
@@ -199,6 +214,8 @@ _EXPORTS: dict[str, tuple[str, ...]] = {
199
214
  ".logging": ("get_logger",),
200
215
  ".managed_task": ("FunctionalTask",),
201
216
  ".manifest": ("PluginManifest",),
217
+ ".params": ("Param",),
218
+ ".params_form": ("ParamsForm",),
202
219
  ".preferences": ("PreferenceManagerProtocol",),
203
220
  ".rendering": (
204
221
  "MPL_RASTER_LOCK",
@@ -224,6 +241,7 @@ _EXPORTS: dict[str, tuple[str, ...]] = {
224
241
  "task_scheduler",
225
242
  "tutorial_manager",
226
243
  ),
244
+ ".stage_rail": ("StageRail", "StageStatus"),
227
245
  ".signals": ("PluginSignals", "move_to_gui_thread", "safe_disconnect"),
228
246
  ".state": ("PluginState",),
229
247
  ".tasks": ("TaskHandle", "submit_task"),
@@ -345,13 +363,17 @@ __all__ = [
345
363
  "AxesColors",
346
364
  "BioComboBox",
347
365
  "BioDoubleSpinBox",
366
+ "BioFooter",
348
367
  "BioHeaderLabel",
349
368
  "BioHelpButton",
350
369
  "BioLineEdit",
351
370
  "BioListWidget",
371
+ "BioMenu",
372
+ "BioProgressDialog",
352
373
  "BioRibbon",
353
374
  "BioRunButton",
354
375
  "BioScrollArea",
376
+ "BioSectionLabel",
355
377
  "BioSpinBox",
356
378
  "BioSplitter",
357
379
  "BioStatusLabel",
@@ -365,6 +387,7 @@ __all__ = [
365
387
  "StepIndicator",
366
388
  "SubtitleLabel",
367
389
  "WizardPanel",
390
+ "WorkspaceSaveButton",
368
391
  "WizardStep",
369
392
  "apply_component_style",
370
393
  # Dialogs
@@ -374,6 +397,7 @@ __all__ = [
374
397
  "repopulate_combo",
375
398
  "style_axes",
376
399
  "ZoomControls",
400
+ "bring_into_project",
377
401
  "get_directory",
378
402
  "get_double",
379
403
  "get_image_path",
@@ -408,6 +432,10 @@ __all__ = [
408
432
  "array_to_pixmap",
409
433
  "FunctionalTask",
410
434
  "TaskHandle",
435
+ "Param",
436
+ "ParamsForm",
437
+ "StageRail",
438
+ "StageStatus",
411
439
  ]
412
440
 
413
441
 
@@ -426,5 +454,18 @@ def __getattr__(name: str) -> object:
426
454
  return value
427
455
 
428
456
 
457
+ def _preload_exports() -> None:
458
+ """Import every eagerly-exported name now, as the old barrel did.
459
+
460
+ The UI daemon calls this before its stdin-reader thread starts: on
461
+ Windows, importing native-extension-heavy modules on the main thread
462
+ while that thread is blocked reading stdin can deadlock (see
463
+ ``ui_daemon_runtime.run``). ``LayeredMatplotlibCanvas`` stays lazy, as it
464
+ always was.
465
+ """
466
+ for name in (*(n for names in _EXPORTS.values() for n in names), *_ALIASES):
467
+ __getattr__(name)
468
+
469
+
429
470
  def __dir__() -> list[str]:
430
471
  return sorted(set(globals()) | set(_LOCATIONS))
@@ -7,6 +7,7 @@ the UI.
7
7
 
8
8
  import logging
9
9
  from abc import ABC, abstractmethod
10
+ from collections.abc import Callable
10
11
  from typing import Any
11
12
 
12
13
  from PySide6.QtCore import QObject, QRunnable, Signal
@@ -177,14 +178,17 @@ class AnalysisRunnable(QRunnable):
177
178
  standard QThreadPool management system.
178
179
  """
179
180
 
180
- def __init__(self, worker: AnalysisWorker):
181
+ def __init__(self, worker: AnalysisWorker, on_done: Callable[[], None] | None = None):
181
182
  """Initialize the runnable wrapper with a target worker.
182
183
 
183
184
  Args:
184
185
  worker: The background AnalysisWorker controller containing the job.
186
+ on_done: Called on the pool thread once this runnable has let go of
187
+ the worker, so its owner can release it on its own thread.
185
188
  """
186
189
  super().__init__()
187
190
  self.worker: AnalysisWorker | None = worker
191
+ self._on_done = on_done
188
192
  # QThreadPool will take ownership and delete this runnable after run()
189
193
  self.setAutoDelete(True)
190
194
 
@@ -204,4 +208,19 @@ class AnalysisRunnable(QRunnable):
204
208
  # Fallback for truly catastrophic failures inside the worker itself
205
209
  logger.exception(f"Critical failure in background runnable: {e}")
206
210
  finally:
211
+ # Let go first: whoever releases the worker after on_done then
212
+ # holds the last reference, so it is never destroyed here, on the
213
+ # pool thread, while the GUI thread may still be delivering its
214
+ # signals.
207
215
  self.worker = None
216
+ if self._on_done is not None:
217
+ try:
218
+ self._on_done()
219
+ except RuntimeError as e:
220
+ # The owner (e.g. a LocalTaskScheduler) was destroyed
221
+ # while this task was still in flight — nothing is left
222
+ # to release.
223
+ if "deleted" in str(e):
224
+ logger.debug("Background runnable: owner deleted before on_done.")
225
+ else:
226
+ raise
@@ -540,6 +540,17 @@ class BioCaptionLabel(QLabel):
540
540
  self.setStyleSheet(f"font-size: {size}px; color: {Colors.FG_SECONDARY};")
541
541
 
542
542
 
543
+ class BioSectionLabel(QLabel):
544
+ """A small bold heading over a group of controls, e.g. in a tab's sidebar."""
545
+
546
+ def __init__(self, text: str, parent=None):
547
+ super().__init__(text, parent)
548
+ _connect_theme_signal(self._apply_theme_styles)
549
+
550
+ def _apply_theme_styles(self) -> None:
551
+ self.setStyleSheet(f"color: {Colors.FG_SECONDARY}; font-weight: bold; font-size: 11px;")
552
+
553
+
543
554
  class BioStatusLabel(QLabel):
544
555
  """Standardized italicized status text."""
545
556
 
@@ -637,11 +648,14 @@ class BioComboBox(QComboBox):
637
648
  """)
638
649
 
639
650
 
651
+ _KEEP_SELECTION = object()
652
+
653
+
640
654
  def repopulate_combo(
641
655
  combo: QComboBox,
642
656
  items: Sequence[tuple[str, Any]],
643
657
  *,
644
- restore_data: Any = None,
658
+ restore_data: Any = _KEEP_SELECTION,
645
659
  ) -> None:
646
660
  """Rebuild a combo box's items and restore a selection, without spurious signals.
647
661
 
@@ -658,8 +672,9 @@ def repopulate_combo(
658
672
  items: Ordered (label, data) pairs for every item to show.
659
673
  restore_data: The `data` value to reselect if still present in
660
674
  `items` after rebuilding — typically the combo's own
661
- `currentData()` captured before calling this. `None` leaves
662
- the current index wherever `clear()`/`addItem()` land it.
675
+ `currentData()` captured before calling this. `None` is a value
676
+ like any other (an "All events" item often carries it). Leave it
677
+ out to keep the index wherever `clear()`/`addItem()` land it.
663
678
 
664
679
  Returns:
665
680
  None.
@@ -667,7 +682,8 @@ def repopulate_combo(
667
682
  items = list(items)
668
683
  current = [(combo.itemText(i), combo.itemData(i)) for i in range(combo.count())]
669
684
  items_unchanged = current == items
670
- selection_already_right = restore_data is None or combo.currentData() == restore_data
685
+ keep = restore_data is _KEEP_SELECTION
686
+ selection_already_right = keep or combo.currentData() == restore_data
671
687
 
672
688
  if items_unchanged and selection_already_right:
673
689
  return
@@ -677,7 +693,7 @@ def repopulate_combo(
677
693
  combo.clear()
678
694
  for label, data in items:
679
695
  combo.addItem(label, data)
680
- if restore_data is not None:
696
+ if not keep:
681
697
  idx = combo.findData(restore_data)
682
698
  if idx >= 0:
683
699
  combo.setCurrentIndex(idx)
@@ -6,6 +6,7 @@ that work with the current theme.
6
6
 
7
7
  from collections.abc import Sequence
8
8
  from datetime import datetime
9
+ from pathlib import Path
9
10
 
10
11
  from PySide6.QtCore import Qt
11
12
  from PySide6.QtWidgets import (
@@ -25,19 +26,65 @@ from PySide6.QtWidgets import (
25
26
  # ──────────────────────────────────────────────────────────────────────────────
26
27
 
27
28
 
29
+ def project_assets_dir(widget=None) -> str:
30
+ """The open project's assets folder, as `widget`'s window knows it ("" with no project).
31
+
32
+ The Hub (and an isolated plugin's runtime) sets `project_manager` on the
33
+ plugin's window; its `assets_dir` is where a project's images live.
34
+ """
35
+ window = widget.window() if widget is not None else None
36
+ folder = getattr(getattr(window, "project_manager", None), "assets_dir", None)
37
+ return str(folder) if folder and Path(folder).is_dir() else ""
38
+
39
+
40
+ def bring_into_project(parent, path: str) -> str | None:
41
+ """`path`, registered with the open project after offering to copy it into its assets.
42
+
43
+ A file chosen from outside the project would be left behind when the
44
+ project moves to another computer, so the user is asked whether to copy
45
+ it into the project's 'assets' folder. It is registered with the
46
+ project either way (copied, or referenced where it is).
47
+
48
+ Returns the path to use (the copy's when it was copied), `path` itself
49
+ when no project is open, or None when the project couldn't take it (a
50
+ warning says why), so the caller can stop.
51
+ """
52
+ window = parent.window() if parent is not None else None
53
+ pm = getattr(window, "project_manager", None)
54
+ if pm is None:
55
+ return path
56
+ try:
57
+ inside = Path(pm.assets_dir).resolve() in Path(path).resolve().parents
58
+ copy = not inside and ask_yes_no(
59
+ parent,
60
+ "Copy to Workspace?",
61
+ f"The image '{Path(path).name}' is outside the project folder.\n\n"
62
+ "Would you like to copy it into the project's 'assets' folder for safe keeping "
63
+ "and portability?",
64
+ )
65
+ resolved = pm.get_asset_path(pm.add_image(Path(path), copy))
66
+ except Exception as exc: # the project manager reports any failure as an exception
67
+ show_warning(parent, "Asset Error", f"Failed to add asset to project:\n{exc}")
68
+ return None
69
+ return str(resolved) if resolved else path
70
+
71
+
28
72
  def get_image_path(parent=None, title: str = "Select Image", start_dir: str = "") -> str | None:
29
73
  """Show file dialog to select an image.
30
74
 
31
75
  Args:
32
76
  parent: Parent widget
33
77
  title: Dialog title
34
- start_dir: Initial directory
78
+ start_dir: Initial directory (default: the open project's assets folder)
35
79
 
36
80
  Returns:
37
81
  Selected file path or None if cancelled
38
82
  """
39
83
  file_path, _ = QFileDialog.getOpenFileName(
40
- parent, title, start_dir, "Images (*.png *.jpg *.jpeg *.tiff *.tif);;All Files (*)"
84
+ parent,
85
+ title,
86
+ start_dir or project_assets_dir(parent),
87
+ "Images (*.png *.jpg *.jpeg *.tiff *.tif);;All Files (*)",
41
88
  )
42
89
  return file_path if file_path else None
43
90
 
@@ -48,13 +95,16 @@ def get_image_paths(parent=None, title: str = "Select Images", start_dir: str =
48
95
  Args:
49
96
  parent: Parent widget
50
97
  title: Dialog title
51
- start_dir: Initial directory
98
+ start_dir: Initial directory (default: the open project's assets folder)
52
99
 
53
100
  Returns:
54
101
  List of selected file paths
55
102
  """
56
103
  file_paths, _ = QFileDialog.getOpenFileNames(
57
- parent, title, start_dir, "Images (*.png *.jpg *.jpeg *.tiff *.tif);;All Files (*)"
104
+ parent,
105
+ title,
106
+ start_dir or project_assets_dir(parent),
107
+ "Images (*.png *.jpg *.jpeg *.tiff *.tif);;All Files (*)",
58
108
  )
59
109
  return file_paths if file_paths else []
60
110
 
@@ -1,7 +1,7 @@
1
1
  """A zoomable, pannable image viewer for image-analysis plugins.
2
2
 
3
3
  `ImageView` is the part every image plugin's canvas had re-implemented
4
- (western-blot's `ImageCanvas`, cytometrics' `MultiChannelCanvas`): showing
4
+ (gel-blot's `ImageCanvas`, cytometrics' `MultiChannelCanvas`): showing
5
5
  an image, wheel zoom around the cursor with limits, panning, fit-to-view, an
6
6
  empty state with a load button and drag-and-drop, a calibration line, a
7
7
  scale bar, and named overlay layers. Plugins subclass it and add their own
@@ -0,0 +1,58 @@
1
+ """User-settable parameters, declared once and turned into controls by ``ParamsForm``.
2
+
3
+ An algorithm (a segmenter, a background method, a lane finder…) declares
4
+ what it can be told as a list of :class:`Param`. The form builds the
5
+ controls from that list, so adding a parameter never means editing UI code.
6
+ This module imports no Qt, so analysis code can declare parameters freely.
7
+ """
8
+
9
+ from __future__ import annotations
10
+
11
+ from dataclasses import dataclass
12
+ from typing import Any
13
+
14
+ #: The kinds a ``Param`` can be. ``options`` is a pick-list whose entries
15
+ #: arrive at runtime (channel names, image names…) through
16
+ #: ``ParamsForm.set_options(param.source, names)``.
17
+ KINDS = ("float", "int", "bool", "choice", "options")
18
+
19
+
20
+ @dataclass(frozen=True)
21
+ class Param:
22
+ """One parameter: enough to build its control, label it and explain it.
23
+
24
+ ``unit`` is shown after the value. A form can map a unit to another
25
+ display (µm instead of px, say) with ``ParamsForm.set_unit_display``;
26
+ the algorithm always receives the value in the unit it declared.
27
+ ``advanced`` parameters sit behind the form's "Advanced settings" toggle.
28
+ ``enabled_by`` names a ``bool`` parameter that switches this one on.
29
+ """
30
+
31
+ key: str
32
+ label: str
33
+ kind: str
34
+ default: Any = None
35
+ minimum: float | None = None
36
+ maximum: float | None = None
37
+ step: float | None = None
38
+ decimals: int = 1
39
+ unit: str = ""
40
+ choices: tuple[tuple[str, Any], ...] = ()
41
+ source: str = ""
42
+ advanced: bool = False
43
+ help: str = ""
44
+ special_value_text: str = ""
45
+ enabled_by: str = ""
46
+
47
+ def __post_init__(self) -> None:
48
+ if self.kind not in KINDS:
49
+ raise ValueError(f"Param {self.key!r}: kind must be one of {KINDS}, not {self.kind!r}")
50
+ if self.kind == "options" and not self.source:
51
+ raise ValueError(f"Param {self.key!r}: an 'options' parameter needs a source")
52
+ if self.kind == "choice" and not self.choices:
53
+ raise ValueError(f"Param {self.key!r}: a 'choice' parameter needs choices")
54
+
55
+
56
+ def defaults(params: list[Param]) -> dict[str, Any]:
57
+ """Every parameter's default, keyed like ``ParamsForm.values()``."""
58
+ return {p.key: p.default for p in params}