torchmonarch-nightly 2025.7.28__cp312-cp312-manylinux2014_x86_64.whl → 2025.7.30__cp312-cp312-manylinux2014_x86_64.whl

monarch/tools/components/hyperactor.py

@@ -22,7 +22,7 @@ DEFAULT_NAME: str = f"monarch-{_USER}"
 __version__ = "latest"  # TODO get version from monarch.__version_
 
 
-def proc_mesh(
+def host_mesh(
     image: str = f"ghcr.io/pytorch-labs/monarch:{__version__}",  # TODO docker needs to be built and pushed to ghcr
     meshes: list[str] = _DEFAULT_MESHES,
     env: Optional[dict[str, str]] = None,

monarch/tools/config/__init__.py

@@ -34,4 +34,4 @@ class Config:
     scheduler_args: dict[str, Any] = field(default_factory=dict)
     workspace: Optional[str] = None
     dryrun: bool = False
-    appdef: UnnamedAppDef = UnnamedAppDef()
+    appdef: UnnamedAppDef = field(default_factory=UnnamedAppDef)

monarch/tools/config/defaults.py

@@ -25,7 +25,7 @@ from torchx.schedulers import (
 
 def component_fn(scheduler: str) -> Callable[..., UnnamedAppDef]:
     """The default TorchX component function for the scheduler"""
-    return hyperactor.proc_mesh
+    return hyperactor.host_mesh
 
 
 def scheduler_factories() -> dict[str, SchedulerFactory]:

monarch/tools/utils.py

@@ -6,9 +6,36 @@
 
 # pyre-strict
 import os
+import pathlib
 from typing import Optional
 
 
+def MONARCH_HOME(*subdir_paths: str) -> pathlib.Path:
+    """
+    Path to the "dot-directory" for monarch.
+    Defaults to `~/.monarch` and is overridable via the `MONARCH_HOME` environment variable.
+
+    Usage:
+
+    .. doc-test::
+
+        from pathlib import Path
+        from monarch.tools.utils import MONARCH_HOME
+
+        assert MONARCH_HOME() == Path.home() / ".monarch"
+        assert MONARCH_HOME("conda-pack-out") ==  Path.home() / ".monarch" / "conda-pack-out"
+    ```
+    """
+
+    default_dir = str(pathlib.Path.home() / ".monarch")
+    monarch_home = pathlib.Path(os.getenv("MONARCH_HOME", default_dir))
+
+    monarch_home_subdir = monarch_home / os.path.sep.join(subdir_paths)
+    monarch_home_subdir.mkdir(parents=True, exist_ok=True)
+
+    return monarch_home_subdir
+
+
 class conda:
     """Conda related util functions."""
 

tests/test_actor_error.py

@@ -598,8 +598,7 @@ async def test_supervision_with_proc_mesh_stopped(mesh):
 # TODO - re-enable after resolving T232206970
 @pytest.mark.oss_skip
 async def test_supervision_with_sending_error():
-    os.environ["HYPERACTOR_CODEC_MAX_FRAME_LENGTH"] = "9999999999"
-    os.environ["HYPERACTOR_MESSAGE_DELIVERY_TIMEOUT_SECS"] = "1"
+    os.environ["HYPERACTOR_CODEC_MAX_FRAME_LENGTH"] = "50000000"
 
     proc = await proc_mesh(gpus=1)
     actor_mesh = await proc.spawn("healthy", HealthyActor)
@@ -611,9 +610,9 @@ async def test_supervision_with_sending_error():
 
     # send a large payload to trigger send timeout error
     with pytest.raises(
-        SupervisionError, match="supervision error:.*message not delivered:"
+        SupervisionError, match="supervision error:.*actor mesh is stopped"
     ):
-        await actor_mesh.check_with_payload.call(payload="a" * 5000000000)
+        await actor_mesh.check_with_payload.call(payload="a" * 55000000)
 
     # new call should fail with check of health state of actor mesh
     with pytest.raises(SupervisionError, match="actor mesh is not in a healthy state"):

tests/test_actor_shape.py

@@ -0,0 +1,114 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree.
+
+# pyre-strict
+
+from unittest import TestCase
+
+from monarch._rust_bindings.monarch_hyperactor.shape import Shape, Slice
+from monarch._src.actor.shape import ShapeExt
+
+
+class TestShapeSlicing(TestCase):
+    def test_shape_at_removes_dimension(self) -> None:
+        """Test that at() removes dimensions and updates offset
+        correctly."""
+
+        slice_obj = Slice(offset=0, sizes=[2, 3, 4], strides=[12, 4, 1])
+        shape = Shape(["batch", "height", "width"], slice_obj)
+
+        # Test removing first dimension
+        result = shape.at("batch", 1)
+        self.assertEqual(result.labels, ["height", "width"])
+        self.assertEqual(result.ndslice.sizes, [3, 4])
+        self.assertEqual(result.ndslice.strides, [4, 1])
+        self.assertEqual(result.ndslice.offset, 12)  # 1 * 12
+
+        # Test removing middle dimension
+        result = shape.at("height", 2)
+        self.assertEqual(result.labels, ["batch", "width"])
+        self.assertEqual(result.ndslice.sizes, [2, 4])
+        self.assertEqual(result.ndslice.strides, [12, 1])
+        self.assertEqual(result.ndslice.offset, 8)  # 2 * 4
+
+        # Test removing last dimension
+        result = shape.at("width", 3)
+        self.assertEqual(result.labels, ["batch", "height"])
+        self.assertEqual(result.ndslice.sizes, [2, 3])
+        self.assertEqual(result.ndslice.strides, [12, 4])
+        self.assertEqual(result.ndslice.offset, 3)  # 3  * 1
+
+    def test_shape_select_keeps_dimension(self) -> None:
+        """Test that select() keeps dimensions but changes sizes."""
+
+        slice_obj = Slice.new_row_major([4, 6])
+        shape = Shape(["rows", "cols"], slice_obj)
+
+        # Test range selection
+        result = shape.select("rows", slice(1, 3))
+        self.assertEqual(result.labels, ["rows", "cols"])
+        self.assertEqual(result.ndslice.sizes, [2, 6])  # 3-1=2 rows
+        self.assertEqual(result.ndslice.offset, 6)  # 1 * 6
+
+        # Test step selection
+        result = shape.select("cols", slice(0, 6, 2))
+        self.assertEqual(result.labels, ["rows", "cols"])
+        self.assertEqual(result.ndslice.sizes, [4, 3])  # every 2nd col = 3 cols
+        self.assertEqual(result.ndslice.strides, [6, 2])  # stride becomes 2
+
+    def test_shape_slice_mixed_operations(self) -> None:
+        """Test mixing at() and select() operations."""
+
+        slice_obj = Slice.new_row_major([2, 3, 4])
+        shape = Shape(["batch", "height", "width"], slice_obj)
+
+        # Chain operations: select then at
+        result = shape.select("width", slice(1, 4)).at("batch", 0)
+        self.assertEqual(result.labels, ["height", "width"])
+        self.assertEqual(result.ndslice.sizes, [3, 3])
+
+        # Chain operations: at then select
+        result = shape.at("height", 1).select("width", slice(2, 4))
+        self.assertEqual(result.labels, ["batch", "width"])
+        self.assertEqual(result.ndslice.sizes, [2, 2])
+
+    def test_shape_slice_errors(self) -> None:
+        """Test error conditions."""
+        slice_obj = Slice.new_row_major([2, 3])
+        shape = Shape(["rows", "cols"], slice_obj)
+
+        # Test invalid label
+        with self.assertRaises(ValueError):
+            shape.at("nonexistent", 0)
+
+        # Test index out of range
+        with self.assertRaises(ValueError):
+            shape.at("rows", 5)
+
+        # Test negative index (Python-Rust boundary issue)
+        with self.assertRaises(OverflowError):  # Changed from ValueError
+            shape.at("rows", -1)
+
+    def test_shape_slice_comprehensive(self) -> None:
+        """Comprehensive test of slice() method."""
+
+        slice_obj = Slice.new_row_major([4, 5, 6])
+        shape = Shape(["a", "b", "c"], slice_obj)
+
+        # Test integer selection (removes dimensions)
+        result = ShapeExt.slice(shape, a=1, c=2)
+        self.assertEqual(result.labels, ["b"])
+        self.assertEqual(result.ndslice.sizes, [5])
+
+        # Test slice selection (keeps dimensions)
+        result = ShapeExt.slice(shape, b=slice(1, 4), c=slice(0, 6, 2))
+        self.assertEqual(result.labels, ["a", "b", "c"])
+        self.assertEqual(result.ndslice.sizes, [4, 3, 3])
+
+        # Test mixed selection
+        result = ShapeExt.slice(shape, a=2, b=slice(1, 3))
+        self.assertEqual(result.labels, ["b", "c"])
+        self.assertEqual(result.ndslice.sizes, [2, 6])