nextmv 0.33.0.dev0__py3-none-any.whl → 0.34.0.dev0__py3-none-any.whl

nextmv/local/local.py

@@ -36,7 +36,7 @@ LOGS_KEY = "logs"
 """
 Logs key constant used for identifying logs in the run output.
 """
-LOGS_FILE = "stderr.log"
+LOGS_FILE = "logs.log"
 """
 Constant used for identifying the file used for logging.
 """

nextmv/manifest.py

@@ -49,7 +49,7 @@ from enum import Enum
 from typing import Any, Optional, Union
 
 import yaml
-from pydantic import AliasChoices, Field
+from pydantic import AliasChoices, Field, field_validator
 
 from nextmv.base_model import BaseModel
 from nextmv.input import InputFormat
@@ -166,6 +166,43 @@ class ManifestRuntime(str, Enum):
     Based on the python runtime, it provisions (pre-installs) the Hexaly solver
     to run Python applications.
     """
+    CUOPT = "ghcr.io/nextmv-io/runtime/cuopt:latest"
+    """
+    A runtime providing the NVIDIA cuOpt solver.
+    """
+
+
+class ManifestPythonArch(str, Enum):
+    """
+    Target architecture for bundling Python apps.
+
+    You can import the `ManifestPythonArch` class directly from `nextmv`:
+
+    ```python
+    from nextmv import ManifestPythonArch
+    ```
+
+    Attributes
+    ----------
+    ARM64 : str
+        ARM 64-bit architecture.
+    AMD64 : str
+        AMD 64-bit architecture.
+
+    Examples
+    --------
+    >>> from nextmv import ManifestPythonArch
+    >>> arch = ManifestPythonArch.ARM64
+    >>> arch
+    <ManifestPythonArch.ARM64: 'arm64'>
+    >>> str(arch)
+    'arm64'
+    """
+
+    ARM64 = "arm64"
+    """ARM 64-bit architecture."""
+    AMD64 = "amd64"
+    """AMD 64-bit architecture."""
 
 
 class ManifestBuild(BaseModel):
@@ -325,6 +362,12 @@ class ManifestPython(BaseModel):
     Contains (additional) Python dependencies that will be bundled with the
     app.
     """
+    arch: Optional[ManifestPythonArch] = None
+    """The architecture this model is meant to run on. One of "arm64" or "amd64". Uses
+    "arm64" if not specified."""
+    version: Optional[Union[str, float]] = None
+    """The Python version this model is meant to run with. Uses "3.11" if not specified.
+    """
     model: Optional[ManifestPythonModel] = None
     """Information about an encoded decision model.
 
@@ -332,6 +375,17 @@ class ManifestPython(BaseModel):
     from the app bundle.
     """
 
+    @field_validator("version", mode="before")
+    @classmethod
+    def validate_version(cls, v: Optional[Union[str, float]]) -> Optional[str]:
+        # We allow the version to be a float in the manifest for convenience, but we want
+        # to store it as a string internally.
+        if v is None:
+            return None
+        if isinstance(v, float):
+            return str(v)
+        return v
+
 
 class ManifestOptionUI(BaseModel):
     """
@@ -1025,7 +1079,12 @@ class Manifest(BaseModel):
 
     def model_post_init(self, __context) -> None:
         if self.entrypoint is None:
-            if self.runtime in (ManifestRuntime.PYTHON, ManifestRuntime.HEXALY, ManifestRuntime.PYOMO):
+            if self.runtime in (
+                ManifestRuntime.PYTHON,
+                ManifestRuntime.HEXALY,
+                ManifestRuntime.PYOMO,
+                ManifestRuntime.CUOPT,
+            ):
                 self.entrypoint = "./main.py"
             elif self.runtime == ManifestRuntime.DEFAULT:
                 self.entrypoint = "./main"

nextmv/run.py

@@ -52,7 +52,7 @@ from pydantic import AliasChoices, Field, field_validator
 from nextmv._serialization import serialize_json
 from nextmv.base_model import BaseModel
 from nextmv.input import Input, InputFormat
-from nextmv.output import Output, OutputFormat
+from nextmv.output import Asset, Output, OutputFormat, Statistics
 from nextmv.status import Status, StatusV2
 
 
@@ -687,6 +687,56 @@ class Metadata(BaseModel):
     """Deprecated: use status_v2."""
 
 
+class SyncedRun(BaseModel):
+    """
+    Information about a run that has been synced to a remote application.
+
+    You can import the `SyncedRun` class directly from `nextmv`:
+
+    ```python
+    from nextmv import SyncedRun
+    ```
+
+    Parameters
+    ----------
+    run_id : str
+        ID of the synced remote run. When the `Application.sync` method is
+        used, this field marks the association between the local run (`id`) and
+        the remote run (`synced_run.id`).
+    synced_at : datetime
+        Timestamp when the run was synced with the remote run.
+    app_id : str
+        The ID of the remote application that the local run was synced to.
+    instance_id : Optional[str], optional
+        The instance of the remote application that the local run was synced
+        to. This field is optional and may be None. If it is not specified, it
+        indicates that the run was synced against the default instance of the
+        app. Defaults to None.
+    """
+
+    run_id: str
+    """
+    ID of the synced remote run. When the `Application.sync` method is used,
+    this field marks the association between the local run (`id`) and the
+    remote run (`synced_run.id`)
+    """
+    synced_at: datetime
+    """
+    Timestamp when the run was synced with the remote run.
+    """
+    app_id: str
+    """
+    The ID of the remote application that the local run was synced to.
+    """
+
+    instance_id: Optional[str] = None
+    """
+    The instance of the remote application that the local run was synced to.
+    This field is optional and may be None. If it is not specified, it
+    indicates that the run was synced against the default instance of the app.
+    """
+
+
 class RunInformation(BaseModel):
     """
     Information of a run.
@@ -727,19 +777,18 @@ class RunInformation(BaseModel):
     """
     URL to the run in the Nextmv console.
     """
-    synced_run_id: Optional[str] = None
-    """
-    ID of the synced remote run, if applicable. When the `Application.sync`
-    method is used, this field marks the association between the local run
-    (`id`) and the remote run (`synced_run_id`). This field is None if the run
-    was not created using `Application.sync` or if the run has not been synced
-    yet.
+    synced_runs: Optional[list[SyncedRun]] = None
     """
-    synced_at: Optional[datetime] = None
-    """
-    Timestamp when the run was synced with the remote run. This field is
-    None if the run was not created using `Application.sync` or if the run
-    has not been synced yet.
+    List of synced runs associated with this run, if applicable. When the
+    `Application.sync` method is used, this field contains the associations
+    between the local run (`id`) and the remote runs (`synced_run.id`). This
+    field is None if the run was not created using `Application.sync` or if the
+    run has not been synced yet. It is possible to sync a single local run to
+    multiple remote runs. A remote run is identified by its application ID and
+    instance (if applicable). A local run cannot be synced to a remote run if
+    it is already present, this is, if there exists a record in the list with
+    the same application ID and instance. If there is not a repeated remote
+    run, a new record is added to the list.
     """
 
     def to_run(self) -> Run:
@@ -817,6 +866,83 @@ class RunInformation(BaseModel):
             input_set_id=None,
         )
 
+    def add_synced_run(self, synced_run: SyncedRun) -> bool:
+        """
+        Add a synced run to the RunInformation.
+
+        This method adds a `SyncedRun` instance to the list of synced runs
+        associated with this `RunInformation`. If the list is None, it
+        initializes it first. If the run has already been synced, then it is
+        not added to the list. A run is already synced if there exists a record
+        in the list with the same application ID. This method returns True if
+        the synced run was added, and False otherwise.
+
+        Parameters
+        ----------
+        synced_run : SyncedRun
+            The SyncedRun instance to add.
+
+        Returns
+        -------
+        bool
+            True if the synced run was added, False if it was already present.
+        """
+
+        if self.synced_runs is None:
+            self.synced_runs = [synced_run]
+
+            return True
+
+        if synced_run.instance_id is None:
+            for existing_run in self.synced_runs:
+                if existing_run.app_id == synced_run.app_id:
+                    return False
+        else:
+            for existing_run in self.synced_runs:
+                if existing_run.app_id == synced_run.app_id and existing_run.instance_id == synced_run.instance_id:
+                    return False
+
+        self.synced_runs.append(synced_run)
+
+        return True
+
+    def is_synced(self, app_id: str, instance_id: Optional[str] = None) -> tuple[SyncedRun, bool]:
+        """
+        Check if the run has been synced to a specific application and instance.
+
+        This method checks if there exists a `SyncedRun` in the list of synced
+        runs that matches the given application ID and optional instance ID.
+
+        Parameters
+        ----------
+        app_id : str
+            The application ID to check.
+        instance_id : Optional[str], optional
+            The instance ID to check. If None, only the application ID is
+            considered. Defaults to None.
+
+        Returns
+        -------
+        tuple[SyncedRun, bool]
+            A tuple containing the SyncedRun instance if found, and a boolean
+            indicating whether the run has been synced to the specified
+            application and instance.
+        """
+
+        if self.synced_runs is None:
+            return None, False
+
+        if instance_id is None:
+            for existing_run in self.synced_runs:
+                if existing_run.app_id == app_id:
+                    return existing_run, True
+        else:
+            for existing_run in self.synced_runs:
+                if existing_run.app_id == app_id and existing_run.instance_id == instance_id:
+                    return existing_run, True
+
+        return None, False
+
 
 class ErrorLog(BaseModel):
     """
@@ -1154,6 +1280,16 @@ class ExternalRunResult(BaseModel):
     """Error message of the run."""
     execution_duration: Optional[int] = None
     """Duration of the run, in milliseconds."""
+    statistics_upload_id: Optional[str] = None
+    """
+    ID of the statistics upload. Use this field when working with `CSV_ARCHIVE`
+    or `MULTI_FILE` output formats.
+    """
+    assets_upload_id: Optional[str] = None
+    """
+    ID of the assets upload. Use this field when working with `CSV_ARCHIVE`
+    or `MULTI_FILE` output formats.
+    """
 
     def __post_init_post_parse__(self):
         """
@@ -1265,6 +1401,18 @@ class TrackedRun:
         when working with `CSV_ARCHIVE` or `MULTI_FILE`. If both `output` and
         `output_dir_path` are specified, the `output` is ignored, and the files
         are saved in the directory instead. Defaults to None.
+    statistics : Statistics or dict[str, Any], optional
+        Statistics of the run being tracked. Only use this field if you want to
+        track statistics for `CSV_ARCHIVE` or `MULTI_FILE` output formats. If you
+        are working with `JSON` or `TEXT` output formats, this field will be
+        ignored, as the statistics are extracted directly from the `output`.
+        This field is optional. Defaults to None.
+    assets : list[Asset or dict[str, Any]], optional
+        Assets associated with the run being tracked. Only use this field if you
+        want to track assets for `CSV_ARCHIVE` or `MULTI_FILE` output formats.
+        If you are working with `JSON` or `TEXT` output formats, this field will
+        be ignored, as the assets are extracted directly from the `output`.
+        This field is optional. Defaults to None.
 
     Examples
     --------
@@ -1365,6 +1513,20 @@ class TrackedRun:
     `output_dir_path` are specified, the `output` is ignored, and the files
     are saved in the directory instead.
     """
+    statistics: Optional[Union[Statistics, dict[str, Any]]] = None
+    """
+    Statistics of the run being tracked. Only use this field if you want to
+    track statistics for `CSV_ARCHIVE` or `MULTI_FILE` output formats. If you
+    are working with `JSON` or `TEXT` output formats, this field will be
+    ignored, as the statistics are extracted directly from the `output`.
+    """
+    assets: Optional[list[Union[Asset, dict[str, Any]]]] = None
+    """
+    Assets associated with the run being tracked. Only use this field if you
+    want to track assets for `CSV_ARCHIVE` or `MULTI_FILE` output formats.
+    If you are working with `JSON` or `TEXT` output formats, this field will
+    be ignored, as the assets are extracted directly from the `output`.
+    """
 
     def __post_init__(self):  # noqa: C901
         """

{nextmv-0.33.0.dev0.dist-info → nextmv-0.34.0.dev0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nextmv
-Version: 0.33.0.dev0
+Version: 0.34.0.dev0
 Summary: The all-purpose Python SDK for Nextmv
 Project-URL: Homepage, https://www.nextmv.io
 Project-URL: Documentation, https://nextmv-py.docs.nextmv.io/en/latest/nextmv/

{nextmv-0.33.0.dev0.dist-info → nextmv-0.34.0.dev0.dist-info}/RECORD

@@ -1,29 +1,29 @@
-nextmv/__about__.py,sha256=swx5y44doM60f9hpn91hbwEUw-qTWVfvgrZ4zO7sCP0,29
+nextmv/__about__.py,sha256=IEH4q3YZ3NJ8xLBOPvbdmzjvZQSBu6mlVa0ZYNf6FZ0,29
 nextmv/__entrypoint__.py,sha256=dA0iwwHtrq6Z9w9FxmxKLoBGLyhe7jWtUAU-Y3PEgHg,1094
-nextmv/__init__.py,sha256=pW2HMcJnNSFqF_tj77TtqpddEeCosTKS7NxGNPDp7mU,3620
+nextmv/__init__.py,sha256=GYzXp81KEteniXZkNZ9IgLYnJNOBOQckOeGpTkxjjD4,3723
 nextmv/_serialization.py,sha256=JlSl6BL0M2Esf7F89GsGIZ__Pp8RnFRNM0UxYhuuYU4,2853
 nextmv/base_model.py,sha256=qmJ4AsYr9Yv01HQX_BERrn3229gyoZrYyP9tcyqNfeU,2311
 nextmv/deprecated.py,sha256=kEVfyQ-nT0v2ePXTNldjQG9uH5IlfQVy3L4tztIxwmU,1638
 nextmv/input.py,sha256=m9sVfO9ZL3F5i1l8amEtlWlbkekyUP4C3y9DduHWGFs,40211
 nextmv/logger.py,sha256=kNIbu46MisrzYe4T0hNMpWfRTKKacDVvbtQcNys_c_E,2513
-nextmv/manifest.py,sha256=wzGDrGleIgYvRvKyy73acjd68cGdCLD_7x_Dy3UhCaI,44266
+nextmv/manifest.py,sha256=jCu5RUl6bip4kTDh4zaD4PTYNOIGHWKm34kfXD_rpzw,45898
 nextmv/model.py,sha256=vI3pSV3iTwjRPflar7nAg-6h98XRUyi9II5O2J06-Kc,15018
 nextmv/options.py,sha256=yPJu5lYMbV6YioMwAXv7ctpZUggLXKlZc9CqIbUFvE4,37895
 nextmv/output.py,sha256=HdvWYG3gIzwoXquulaEVI4LLchXJDjkbag0BkBPM0vQ,55128
 nextmv/polling.py,sha256=nfefvWI1smm-lIzaXE-4DMlojp6KXIvVi88XLJYUmo8,9724
-nextmv/run.py,sha256=lAWWkLml1C7wkXSvN8orBjudoz72Qv5ZCHCWY9e7xaY,45813
+nextmv/run.py,sha256=8B9hh-jWJpoMSJiDmgmXaqvmzTicWCn75UTJu7Nf7Cs,52401
 nextmv/safe.py,sha256=VAK4fGEurbLNji4Pg5Okga5XQSbI4aI9JJf95_68Z20,3867
 nextmv/status.py,sha256=SCDLhh2om3yeO5FxO0x-_RShQsZNXEpjHNdCGdb3VUI,2787
 nextmv/cloud/__init__.py,sha256=2wI72lhWq81BYv1OpS0OOTT5-3sivpX0H4z5ANPoLMc,5051
-nextmv/cloud/acceptance_test.py,sha256=ZvOaVzhy3sHb5Vi9uBGhZJPggLN0oEmEvLKyc830zQ8,27439
+nextmv/cloud/acceptance_test.py,sha256=ZEzCMrfJF-nUFr1nEr4IDgcoyavPhnanjFuPBJ79tAk,27731
 nextmv/cloud/account.py,sha256=jIdGNyI3l3dVh2PuriAwAOrEuWRM150WgzxcBMVBNRw,6058
-nextmv/cloud/application.py,sha256=wieXFWijmCsgEDpmefLWs010BkHMbAdLLV7Cwmncu5I,140555
+nextmv/cloud/application.py,sha256=oUpw6I1r4u9Cn0pnlylWlm23hPgZKsg_vnBXbqTtU-w,139693
 nextmv/cloud/batch_experiment.py,sha256=13ciRpgBabMMTyazfdfEAymD3rTPrTAAorECsANxxuA,10397
 nextmv/cloud/client.py,sha256=E0DiUb377jvEnpXlRnfT1PGCI0Jm0lTUoX5VqeU91lk,18165
 nextmv/cloud/ensemble.py,sha256=glrRgyRFcEH12fNUhEl1FOo6xOTDEaF478dxfX0wj2Y,8604
 nextmv/cloud/input_set.py,sha256=NkzA6_hwgD-YwoirzwvZrObIoBTfurry7Os3jo4DyXc,4236
 nextmv/cloud/instance.py,sha256=SS4tbp0LQMWDaeYpwcNxJei82oi_Hozv1t5i3QGjASY,4024
-nextmv/cloud/package.py,sha256=cG75DptN4sxXaT8ruDh2EY2duaK5Jwg16X2LV0BP8ts,13021
+nextmv/cloud/package.py,sha256=Xmt-daAeN9QJKpquV28IiZa2eYCX0P3wSS564JHvrtY,14495
 nextmv/cloud/scenario.py,sha256=JRFTDiFBcrgud6wE2qDHUu5oO-Ur3zbPYhhB6ONCxTo,14263
 nextmv/cloud/secrets.py,sha256=fA5cX0jfTsPVZWV7433wzETGlXpWRLHGswuObx9e6FQ,6820
 nextmv/cloud/url.py,sha256=Fz70ywkWdCLmP21ZBmJwZi5kDbjpmsX_VlwVF_xQeHg,1836
@@ -38,13 +38,13 @@ nextmv/default_app/src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3
 nextmv/default_app/src/main.py,sha256=WWeN_xl_mcPhICl3rSCvdEjRkFXGmAnej88FhS-fAmc,884
 nextmv/default_app/src/visuals.py,sha256=WYK_YBnLmYo3TpVev1CpoNCuW5R7hk9QIkeCmvMn1Fs,1014
 nextmv/local/__init__.py,sha256=6BsoqlK4dw6X11_uKzz9gBPfxKpdiol2FYO8R3X73SE,116
-nextmv/local/application.py,sha256=qq14ihKxymg5NHqhU56qTu6lVmMYWLGYUJC4MrhWB68,45815
-nextmv/local/executor.py,sha256=ohAUrIRohcH_qGglK1hSFR0W6bPBSuMAcMwVkW5G4vM,24338
+nextmv/local/application.py,sha256=dupLPPJ0JkMsTI-7-OoPz9JCRboJyxWy6iO3SPKdA1o,46514
+nextmv/local/executor.py,sha256=Num-VdI5rRecI1XDz__YtW7U2q02ulbwMfWxlhhzwU8,35202
 nextmv/local/geojson_handler.py,sha256=7FavJdkUonop-yskjis0x3qFGB8A5wZyoBUblw-bVhw,12540
-nextmv/local/local.py,sha256=wUHuoAXqJIZpTJBh056hmQuiPEjlZvLTR2BC6Ino-WI,2619
+nextmv/local/local.py,sha256=cp56UpI8h19Ob6Jvb_Ni0ceXH5Vv3ET_iPTDe6ftq3Y,2617
 nextmv/local/plotly_handler.py,sha256=bLb50e3AkVr_W-F6S7lXfeRdN60mG2jk3UElNmhoMWU,1930
 nextmv/local/runner.py,sha256=hwkITHrQG_J9TzxufnaP1mjLWG-iSsNQD66UFZY4pp4,8602
-nextmv-0.33.0.dev0.dist-info/METADATA,sha256=GU6x---pvDI4R1SBV9BW1J5fVLLPxllbrccj6kLyApA,16013
-nextmv-0.33.0.dev0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-nextmv-0.33.0.dev0.dist-info/licenses/LICENSE,sha256=ZIbK-sSWA-OZprjNbmJAglYRtl5_K4l9UwAV3PGJAPc,11349
-nextmv-0.33.0.dev0.dist-info/RECORD,,
+nextmv-0.34.0.dev0.dist-info/METADATA,sha256=lqIIWxNBN6AfvZ_Nw8hmkTyxM1lOhVQ2nvm--xoPML8,16013
+nextmv-0.34.0.dev0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+nextmv-0.34.0.dev0.dist-info/licenses/LICENSE,sha256=ZIbK-sSWA-OZprjNbmJAglYRtl5_K4l9UwAV3PGJAPc,11349
+nextmv-0.34.0.dev0.dist-info/RECORD,,