cubevis 1.0.14__py3-none-any.whl → 1.0.21__py3-none-any.whl

cubevis/utils/_mutual_exclusion.py

@@ -0,0 +1,117 @@
+import threading
+from typing import Dict
+
+
+class MutualExclusionManager:
+    """
+    Generic manager for enforcing mutual exclusion between different execution paths.
+
+    Use this when you want to ensure only one of several mutually exclusive paths
+    can be taken within a given context (thread).
+
+    Example:
+        mode_manager = MutualExclusionManager(
+            name="display_mode",
+            valid_modes={
+                'notebook': "Cannot use Showable after displaying with bokeh.plotting.show().",
+                'separate_tab': "Cannot use bokeh.plotting.show() after displaying with Showable."
+            }
+        )
+
+        # In path A:
+        mode_manager.set_mode('notebook')
+
+        # In path B (will raise error if path A was already taken):
+        mode_manager.set_mode('separate_tab')
+    """
+
+    def __init__(self, name: str, valid_modes: Dict[str, str]):
+        """
+        Args:
+            name: Descriptive name for this manager (used in error messages)
+            valid_modes: Dictionary mapping mode names to error messages to display
+                        when that mode conflicts with an already-set mode.
+        """
+        self.name = name
+        self.valid_modes = valid_modes
+        self._local = threading.local()
+
+    def set_mode(self, mode: str):
+        """
+        Set the execution mode. Raises RuntimeError if a different mode was already set.
+
+        Args:
+            mode: The mode identifier to set
+
+        Raises:
+            ValueError: If mode is not in valid_modes
+            RuntimeError: If a different mode was already set in this context
+        """
+        if mode not in self.valid_modes:
+            raise ValueError(
+                f"Invalid mode '{mode}' for {self.name}. "
+                f"Valid modes: {set(self.valid_modes.keys())}"
+            )
+
+        current_mode = self.get_mode()
+        if current_mode is not None and current_mode != mode:
+            # Use the error message associated with the mode being set
+            error_message = self.valid_modes[mode]
+            raise RuntimeError(error_message)
+
+        self._local.mode = mode
+
+    def get_mode(self) -> str | None:
+        """
+        Get the current mode, or None if no mode has been set.
+
+        Returns:
+            The current mode string, or None
+        """
+        return getattr(self._local, 'mode', None)
+
+    def require_mode(self, mode: str):
+        """
+        Check that we're in the specified mode, set it if unset, error if different.
+
+        This is a convenience method that combines get_mode checking with set_mode.
+
+        Args:
+            mode: The required mode
+
+        Raises:
+            RuntimeError: If a different mode was already set
+        """
+        self.set_mode(mode)
+
+    def forbid_mode(self, mode: str, message: str | None = None):
+        """
+        Raise an error if the current mode matches the specified mode.
+
+        Args:
+            mode: The mode to forbid
+            message: Optional custom error message. If None, uses the message from valid_modes.
+
+        Raises:
+            RuntimeError: If current mode matches the forbidden mode
+        """
+        current_mode = self.get_mode()
+        if current_mode == mode:
+            if message is None:
+                message = self.valid_modes.get(
+                    mode,
+                    f"Cannot proceed: {self.name} is set to '{mode}', "
+                    f"which is not allowed in this context."
+                )
+            raise RuntimeError(message)
+
+    def reset(self):
+        """
+        Reset the mode for this context. Useful for testing or manual mode switching.
+        """
+        if hasattr(self._local, 'mode'):
+            del self._local.mode
+
+    def __repr__(self):
+        mode = self.get_mode()
+        return f"MutualExclusionManager(name='{self.name}', current_mode={mode!r})"

{cubevis-1.0.14.dist-info → cubevis-1.0.21.dist-info}/METADATA

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: cubevis
-Version: 1.0.14
+Version: 1.0.21
 Summary: visualization toolkit and apps for casa
 License: LGPL
 Author-email: Darrell Schiebel <darrell@schiebel.us>,Pam Harris <pharris@nrao.edu>
 Requires-Python: >=3.11
 Requires-Dist: astropy>=5.1
-Requires-Dist: bokeh<3.9,>=3.8
+Requires-Dist: bokeh<3.9,>=3.6
 Requires-Dist: certifi
 Requires-Dist: matplotlib
 Requires-Dist: regions>=0.8

{cubevis-1.0.14.dist-info → cubevis-1.0.21.dist-info}/RECORD

@@ -30,9 +30,9 @@ cubevis/__icons__/trash_full_raw.png,sha256=8ChZlNOqnDqmNhNYoqyLiGluYwJSYeQ2UvNL
 cubevis/__icons__/zoom-to-fit.png,sha256=aozGbrkoBX1q9kV0p272bg0YKGje1gIfVBkFZRlLAXs,9592
 cubevis/__icons__/zoom-to-fit.svg,sha256=NtYorWvH4s68iAMriqCPGuTBX5SsgVN310UXGKDM7i8,1802
 cubevis/__init__.py,sha256=c_7j2VgZ9yeRJOoFlzzQt-bQ_awlBMaaPJPSB0MNfcg,3233
-cubevis/__js__/bokeh-3.6/cubevisjs.min.js,sha256=F7HjEMjJpJOCCPIuydjOnv4oU1LNjHUJdsho8ZXbTnE,32149
-cubevis/__js__/bokeh-3.7/cubevisjs.min.js,sha256=pZ6xsZwdiVQ_oQiFN7N9sJDUCwHQy4KekPE5ycuFgn4,31088
-cubevis/__js__/bokeh-3.8/cubevisjs.min.js,sha256=KYALPxQSmcSUSbzlQwd7-2FE2TYbKbPY-mp2GgmFPac,35629
+cubevis/__js__/bokeh-3.6/cubevisjs.min.js,sha256=bZ8IjciHZwcUMrrc_6a3n965WlPCMeQedZjb4-0Ln34,42526
+cubevis/__js__/bokeh-3.7/cubevisjs.min.js,sha256=bZ8IjciHZwcUMrrc_6a3n965WlPCMeQedZjb4-0Ln34,42526
+cubevis/__js__/bokeh-3.8/cubevisjs.min.js,sha256=bZ8IjciHZwcUMrrc_6a3n965WlPCMeQedZjb4-0Ln34,42526
 cubevis/__js__/casalib.min.js,sha256=J9Uvlat_Vf6cjcvftOG5COk3YH6A371MJ7s5u_ZS2_4,91133
 cubevis/bokeh/__init__.py,sha256=b2Vgszi7sQPFyu2b4fnQzVXk5uX4B9vb59CilQpP31I,1835
 cubevis/bokeh/annotations/__init__.py,sha256=tjDIPKbg-rh7Iu3coFWvmX-j2yNj9KuKmRp1aTo71ww,50
@@ -42,11 +42,11 @@ cubevis/bokeh/format/__init__.py,sha256=umNotXSRR23675c44x3h5h2ILbZX8xrDFCztvriY
 cubevis/bokeh/format/_time_ticks.py,sha256=j-DcPh7RfGE8iX2bPjLQDQPIbiAbmjiEWQnKmdMWA3I,1773
 cubevis/bokeh/format/_wcs_ticks.py,sha256=RtonOEc-QXzUNmwg3Ec9ONM5u1Sq8_x5CmRdUwQi5HA,2079
 cubevis/bokeh/models/__init__.py,sha256=3ICcAlkQXMvuAblh8wfcAA5aJFT2z_QN249pEITMR40,247
-cubevis/bokeh/models/_bokeh_app_context.py,sha256=ScF1mSkTnxOJj2NwWWHO_UtDZMx4CH2pF1vm64oYUWI,2209
+cubevis/bokeh/models/_bokeh_app_context.py,sha256=iHCFAJzFinX8I6ty3Vdw6w0Za-5qpoPpSNvbIbc3Q7M,4142
 cubevis/bokeh/models/_edit_span.py,sha256=7o59ZS0bF_Q_WtstvViWXP-2PiY_F7_zCecTqKcmz0E,196
 cubevis/bokeh/models/_ev_text_input.py,sha256=SGtefXkWK6jHEk4EneZ_hEUGwoIWwVGjwqLjGsAXMpY,158
 cubevis/bokeh/models/_shared_dict.py,sha256=AWjLMOKVAXWHSF4gcK2RbxF442QlzQ7hMR0oaODCqB0,901
-cubevis/bokeh/models/_showable.py,sha256=7_2qO2EGRk6iEy44AJv_KL5ff0UvDzOahgM6K8q0Nrs,14368
+cubevis/bokeh/models/_showable.py,sha256=-X63iKaQgAI37cTB_23dvBgVPUrAq9KfLiKcxB-KCXo,15723
 cubevis/bokeh/models/_tip.py,sha256=yNoUWods0xxva1WOfh5It_Y8hbpVy8RVXUmm8p7a58M,1431
 cubevis/bokeh/models/_tip_button.py,sha256=mwk1C7BMVlZrAAyQLn45S4Q9GEQfU_wU2MWpO0Gwzj4,1610
 cubevis/bokeh/sources/__init__.py,sha256=4FsudFuVU4o7VG5OG3K1tiMoxIXcJWNz_K9yzMDE8ls,1581
@@ -81,15 +81,15 @@ cubevis/exe/__init__.py,sha256=kH6dvUS_gjzlPxT1V-PU8ZCKvUTwIqJ-Es5UMfH9D9A,108
 cubevis/exe/_context.py,sha256=hcfn1YYXeIo8Jl_2HV0m2D2Qpo9z4qOunMJovThNctE,5676
 cubevis/exe/_mode.py,sha256=s7i19DY_BWESgqKdRQRnQaR5EK52rym4yu2eSylOHgA,139
 cubevis/exe/_setting.py,sha256=pND6qyQV69N5Y5pW7E8phesEAaGjDE45ASvUtlHPPUE,92
-cubevis/exe/_task.py,sha256=eslV_iUsDLaDqSkNLNEtzQg73FC9NJJLsPBss5TqFvA,10912
+cubevis/exe/_task.py,sha256=L5w3wjOJmjrlzYtmNmX__uRugXgVb49CeeALwCEuzrU,11664
 cubevis/private/_gclean.py,sha256=ExdR6cRxSa6Xne2veGNKhbTtx-tXUIWr2htzEmEZ9Z4,41107
 cubevis/private/apps/__init__.py,sha256=eQg28HPmEskRVJDQviUyuXroBKpUxocaj0Snk-VBaW4,2927
-cubevis/private/apps/_createmask.py,sha256=kLwb138M3CyZWG2MIv0-1jdpxjpelmroY_85KlSJptA,23592
-cubevis/private/apps/_createregion.py,sha256=OHZzTUaQ8Ofl5xt2mCrhXEDkfED-B3TxL-TCi7EXVeo,26724
-cubevis/private/apps/_interactiveclean.mustache,sha256=fM6-8p1DrWcxNHx9YY1zQUn9trfvKqKekJAOHlLZ96o,3776
-cubevis/private/apps/_interactiveclean.py,sha256=QRPqR7uDQhrMz1FZ1E_OvWB6w1p9U0c4s33VMGCgff8,139277
-cubevis/private/apps/_interactivecleannotebook.mustache,sha256=TqWMC2rFHIhwsoz--d0RFaKAfPPbvU7wjlwuWHgRhpM,4494
-cubevis/private/apps/_interactivecleannotebook.py,sha256=0N65GJG4D9vKWnl1lMNpNuKotQpy8NePkB97cdc-uI8,139995
+cubevis/private/apps/_createmask.py,sha256=MTsN47vuOu2iYjjQGHprnHWdJWTQea7clrTSG8TYtzY,23240
+cubevis/private/apps/_createregion.py,sha256=Q5YmYOeh46WPN7xMite4OAUFpHSZtAFTvJD4R6bsjpY,27020
+cubevis/private/apps/_interactiveclean.mustache,sha256=G8itL37DlLZU4Vxe24Sh6DM4aUFmoQSylALC1ktAiSg,3825
+cubevis/private/apps/_interactiveclean.py,sha256=2N-FV8CcDyqVKpbktaaxIfP5RK2Dv71DWsDRxuUIan8,139326
+cubevis/private/apps/_interactivecleannotebook.mustache,sha256=haJG7huuBCq8h9EwKaWQNsPEdOjTd5yLw9GUJxPr_jM,5251
+cubevis/private/apps/_interactivecleannotebook.py,sha256=LJS9wRggRt2swJqWhDK3XRuS0ACGPGho5c5tjcm9-TI,140752
 cubevis/private/apps/_plotants.py,sha256=top6VWVd_sE48IVPH_sIg3_sQeDl5tadi5DL7r5tUEI,10823
 cubevis/private/apps/_plotbandpass.py,sha256=NwOgKSRnpLw9Pt3KIdBpoV78q1OnjCvj6lWFqeyICt8,185
 cubevis/private/casashell/createmask.py,sha256=C1eSUUsttSGghjZ5aDUVhRxnjir5MlYXVyxzEYLcI3k,14457
@@ -104,15 +104,15 @@ cubevis/remote/__init__.py,sha256=0LgSfWUw8cYnVrOYGq3o15tWJPkgcvTyYIrvRSAW6N8,12
 cubevis/remote/_gclean.py,sha256=TpmCmCUtMjqOFnA2wtYdp4EJo-59DyI00aaTWQbMQU4,1930
 cubevis/remote/_local.py,sha256=PcPCFcwttTFZd3O33-5pqDuGKQKK6CA0gz1MTIkTiNI,10326
 cubevis/remote/_remote_kernel.py,sha256=wfu7ZzKn-oCxZxzDIkC5puBvGf8WbCLYL3CzM56_FNc,2652
-cubevis/toolbox/__init__.py,sha256=xzqwAG9863d7UKBVBRw7FrRUQbvCdFcLBq4vTpg63DU,1487
+cubevis/toolbox/__init__.py,sha256=sEN80BX91q_Z2zImDlT8oZ-0o8sE-iH7n3i4S1lmRLo,1450
 cubevis/toolbox/_app_context.py,sha256=rkjddiE4Ynf2HeyI0Hf8DOUt89bF67-2IlgD1uKSdOI,2908
-cubevis/toolbox/_cube.py,sha256=o-FSoq5giXbCVXdjDWWfEUGyvqV0Fw_QjP4EzHCmUZ8,306242
-cubevis/toolbox/_interactive_clean_ui.mustache,sha256=jDhATZohY14ntaG3N30E_gnf7uHkr4JwxXQmEYPwD4g,111937
-cubevis/toolbox/_interactive_clean_ui.py,sha256=N_TYgp8U-M6-A_5aNZaieIhwT-qhbkbPhc2ULaDuTDc,111848
+cubevis/toolbox/_cube.py,sha256=yNVeRFU3ZIM3FeOG4gsy2l6u7gnyqnFlQ6GzQ1fqIg4,308223
+cubevis/toolbox/_interactive_clean_ui.mustache,sha256=IVTcqkxIyw7SzfU92_70dG7bF9UapromDdmeukQ90cg,114113
+cubevis/toolbox/_interactive_clean_ui.py,sha256=98KnLZnDXqO5xl7Ie7WpirogtKL0a5myHejsC89CVSU,114024
 cubevis/toolbox/_interactiveclean_wrappers.py,sha256=XqyCGz33CMDhszTxnwZ_3-64GszUK1XYnGKUOxl9sas,5071
 cubevis/toolbox/_region_list.py,sha256=_1RvnXwqMoaAq8CPy-6IyhabLi_snXqO566onehI2y0,8957
 cubevis/utils/_ResourceManager.py,sha256=SaaR29etabRiKxmUK-aWvAm4v_OPFJH8CX7bNFm0Lgo,3410
-cubevis/utils/__init__.py,sha256=-hSFUv8F4DgpbtZY3uznn65cuMoqsYxvb17U9iC_E9Y,27994
+cubevis/utils/__init__.py,sha256=6u9bbkK_KY98qa6VJOGzjz0mwtKblbK63pxZ34OJ4mg,28048
 cubevis/utils/_browser.py,sha256=rmJ8_wq6XqhXZmVdmWI4t736qB-zd7ZbzfjVdVz40eY,261
 cubevis/utils/_contextmgrchain.py,sha256=r5SrCBdgQIVH7zXKOmq5oWhDUSeHaZpgsIfWFHvb3cQ,2859
 cubevis/utils/_conversion.py,sha256=SziCU8sOGtG7djlY766-MeOvnQgvT9C737FEfJ4aYsE,3262
@@ -122,12 +122,13 @@ cubevis/utils/_git.py,sha256=fLrwN40zm6fv3SKz3MSwj-wtUa9AslpwPPIYJNLzXik,1120
 cubevis/utils/_import_protected_module.py,sha256=AIISHPdiSzwgVzLXqHSWSHT-L7lcMWbYrsMlGlTFafE,1482
 cubevis/utils/_jupyter.py,sha256=37aNCGO52sOyklBQAR5eaAHkv-5NpmzCXPuTT7Euk0o,4214
 cubevis/utils/_logging.py,sha256=HqyoTib7QSuAUbzicPVMdhFtxWKo-Dv4GgD0AYDDXIY,2348
+cubevis/utils/_mutual_exclusion.py,sha256=fkVsHPrFfeXdLSoZGw49ObxsTfwAeeJQTAcOCM2LvC8,3879
 cubevis/utils/_pkgs.py,sha256=mu2CCzndmJZYP81UkFhxveW_CisWLUvagJVolHOEVgM,2294
 cubevis/utils/_regions.py,sha256=TdAg4ZUUyhg3nFmX9_KLboqmc0LkyOdEW8M1WDR5Udk,1669
 cubevis/utils/_static.py,sha256=rN-sqXNqQ5R2M3wmPHU1GPP5OTyyWQlUPRuimCrht-g,2347
 cubevis/utils/_tiles.py,sha256=A9W1X61VOhBMTOKXVajzOIoiV2FBdO5N2SFB9SUpDOo,7336
-cubevis/__version__.py,sha256=3X90f6HGpDfnyIIIVOe0gXw8CJq4nN8scff1OJoFAmk,22
-cubevis-1.0.14.dist-info/WHEEL,sha256=B19PGBCYhWaz2p_UjAoRVh767nYQfk14Sn4TpIZ-nfU,87
-cubevis-1.0.14.dist-info/METADATA,sha256=Wu2Q1pdn4LY_7zwhqg8tbR7lVyTsJYOxKPvox9dIUQg,2632
-cubevis-1.0.14.dist-info/licenses/LICENSE,sha256=IMF9i4xIpgCADf0U-V1cuf9HBmqWQd3qtI3FSuyW4zE,26526
-cubevis-1.0.14.dist-info/RECORD,,
+cubevis/__version__.py,sha256=V8mcjgjAaALTQgu46QC6JsqtVhIuwUw8ouH3h3lkBi8,22
+cubevis-1.0.21.dist-info/WHEEL,sha256=B19PGBCYhWaz2p_UjAoRVh767nYQfk14Sn4TpIZ-nfU,87
+cubevis-1.0.21.dist-info/METADATA,sha256=CocE5gz6awIhYzmwtQys8x8sn1qM4Wg05D_fAuHELJQ,2632
+cubevis-1.0.21.dist-info/licenses/LICENSE,sha256=IMF9i4xIpgCADf0U-V1cuf9HBmqWQd3qtI3FSuyW4zE,26526
+cubevis-1.0.21.dist-info/RECORD,,