proximl 0.5.17__tar.gz → 1.0.1__tar.gz

{proximl-0.5.17/proximl.egg-info → proximl-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: proximl
-Version: 0.5.17
+Version: 1.0.1
 Summary: proxiML client SDK and command line utilities
 Home-page: https://github.com/proxiML/python-sdk
 Author: proxiML
@@ -177,7 +177,7 @@ Description: <div align="center">
         proximl dataset list
         ```
         
-        To connect to a job that requires the [connection capability](https://docs.proximl.ai/reference/connection-capability):
+        To connect to a job that uses the "local" file transfer method:
         
         ```
         proximl job connect <job ID or name>

{proximl-0.5.17 → proximl-1.0.1}/README.md

@@ -169,7 +169,7 @@ To list all datasets:
 proximl dataset list
 ```
 
-To connect to a job that requires the [connection capability](https://docs.proximl.ai/reference/connection-capability):
+To connect to a job that uses the "local" file transfer method:
 
 ```
 proximl job connect <job ID or name>

{proximl-0.5.17 → proximl-1.0.1}/examples/local_storage.py

@@ -19,7 +19,6 @@ async def create_dataset():
     attach_task = asyncio.create_task(dataset.attach())
     connect_task = asyncio.create_task(dataset.connect())
     await asyncio.gather(attach_task, connect_task)
-    await dataset.disconnect()
     return dataset
 
 
@@ -55,7 +54,6 @@ async def run_job(dataset):
     await asyncio.gather(attach_task, connect_task)
 
     # Cleanup job
-    await job.disconnect()
     await job.remove()
 
 

{proximl-0.5.17 → proximl-1.0.1}/proximl/__init__.py

@@ -13,5 +13,5 @@ logging.basicConfig(
 logger = logging.getLogger(__name__)
 
 
-__version__ = "0.5.17"
+__version__ = "1.0.1"
 __all__ = "ProxiML"

{proximl-0.5.17 → proximl-1.0.1}/proximl/checkpoints.py

@@ -10,7 +10,7 @@ from .exceptions import (
     SpecificationError,
     ProxiMLException,
 )
-from .connections import Connection
+from proximl.utils.transfer import upload, download
 
 
 class Checkpoints(object):
@@ -23,7 +23,9 @@ class Checkpoints(object):
 
     async def list(self, **kwargs):
         resp = await self.proximl._query(f"/checkpoint", "GET", kwargs)
-        checkpoints = [Checkpoint(self.proximl, **checkpoint) for checkpoint in resp]
+        checkpoints = [
+            Checkpoint(self.proximl, **checkpoint) for checkpoint in resp
+        ]
         return checkpoints
 
     async def list_public(self, **kwargs):
@@ -68,13 +70,17 @@ class Checkpoint:
     def __init__(self, proximl, **kwargs):
         self.proximl = proximl
         self._checkpoint = kwargs
-        self._id = self._checkpoint.get("id", self._checkpoint.get("checkpoint_uuid"))
+        self._id = self._checkpoint.get(
+            "id", self._checkpoint.get("checkpoint_uuid")
+        )
         self._status = self._checkpoint.get("status")
         self._name = self._checkpoint.get("name")
-        self._size = self._checkpoint.get("size") or self._checkpoint.get("used_size")
-        self._billed_size = self._checkpoint.get("billed_size") or self._checkpoint.get(
-            "size"
+        self._size = self._checkpoint.get("size") or self._checkpoint.get(
+            "used_size"
         )
+        self._billed_size = self._checkpoint.get(
+            "billed_size"
+        ) or self._checkpoint.get("size")
         self._project_uuid = self._checkpoint.get("project_uuid")
 
     @property
@@ -122,56 +128,45 @@ class Checkpoint:
         )
         return resp
 
-    async def get_connection_utility_url(self):
-        resp = await self.proximl._query(
-            f"/checkpoint/{self._id}/download",
-            "GET",
-            dict(project_uuid=self._project_uuid),
-        )
-        return resp
-
-    def get_connection_details(self):
-        if self._checkpoint.get("vpn"):
-            details = dict(
-                entity_type="checkpoint",
-                project_uuid=self._checkpoint.get("project_uuid"),
-                cidr=self._checkpoint.get("vpn").get("cidr"),
-                ssh_port=self._checkpoint.get("vpn").get("client").get("ssh_port"),
-                input_path=(
-                    self._checkpoint.get("source_uri")
-                    if self.status in ["new", "downloading"]
-                    else None
-                ),
-                output_path=(
-                    self._checkpoint.get("output_uri")
-                    if self.status == "exporting"
-                    else None
-                ),
-            )
-        else:
-            details = dict()
-        return details
-
     async def connect(self):
-        if self.status in ["ready", "failed"]:
-            raise SpecificationError(
-                "status",
-                f"You can only connect to downloading or exporting checkpoints.",
-            )
-        if self.status == "new":
-            await self.wait_for("downloading")
-        connection = Connection(
-            self.proximl, entity_type="checkpoint", id=self.id, entity=self
-        )
-        await connection.start()
-        return connection.status
+        if self.status not in ["downloading", "exporting"]:
+            if self.status == "new":
+                await self.wait_for("downloading")
+            else:
+                raise SpecificationError(
+                    "status",
+                    f"You can only connect to downloading or exporting checkpoints.",
+                )
 
-    async def disconnect(self):
-        connection = Connection(
-            self.proximl, entity_type="checkpoint", id=self.id, entity=self
-        )
-        await connection.stop()
-        return connection.status
+        # Refresh to get latest entity data
+        await self.refresh()
+
+        if self.status == "downloading":
+            # Upload task - get auth_token, hostname, and source_uri from checkpoint
+            auth_token = self._checkpoint.get("auth_token")
+            hostname = self._checkpoint.get("hostname")
+            source_uri = self._checkpoint.get("source_uri")
+
+            if not auth_token or not hostname or not source_uri:
+                raise SpecificationError(
+                    "status",
+                    f"Checkpoint in downloading status missing required connection properties (auth_token, hostname, source_uri).",
+                )
+
+            await upload(hostname, auth_token, source_uri)
+        elif self.status == "exporting":
+            # Download task - get auth_token, hostname, and output_uri from checkpoint
+            auth_token = self._checkpoint.get("auth_token")
+            hostname = self._checkpoint.get("hostname")
+            output_uri = self._checkpoint.get("output_uri")
+
+            if not auth_token or not hostname or not output_uri:
+                raise SpecificationError(
+                    "status",
+                    f"Checkpoint in exporting status missing required connection properties (auth_token, hostname, output_uri).",
+                )
+
+            await download(hostname, auth_token, output_uri)
 
     async def remove(self, force=False):
         await self.proximl._query(
@@ -210,7 +205,9 @@ class Checkpoint:
                 if msg_handler:
                     msg_handler(data)
                 else:
-                    timestamp = datetime.fromtimestamp(int(data.get("time")) / 1000)
+                    timestamp = datetime.fromtimestamp(
+                        int(data.get("time")) / 1000
+                    )
                     print(
                         f"{timestamp.strftime('%m/%d/%Y, %H:%M:%S')}: {data.get('msg').rstrip()}"
                     )
@@ -239,7 +236,7 @@ class Checkpoint:
     async def wait_for(self, status, timeout=300):
         if self.status == status:
             return
-        valid_statuses = ["downloading", "ready", "archived"]
+        valid_statuses = ["downloading", "ready", "exporting", "archived"]
         if not status in valid_statuses:
             raise SpecificationError(
                 "status",
@@ -254,7 +251,9 @@ class Checkpoint:
             )
         POLL_INTERVAL_MIN = 5
         POLL_INTERVAL_MAX = 60
-        POLL_INTERVAL = max(min(timeout / 60, POLL_INTERVAL_MAX), POLL_INTERVAL_MIN)
+        POLL_INTERVAL = max(
+            min(timeout / 60, POLL_INTERVAL_MAX), POLL_INTERVAL_MIN
+        )
         retry_count = math.ceil(timeout / POLL_INTERVAL)
         count = 0
         while count < retry_count:

{proximl-0.5.17 → proximl-1.0.1}/proximl/cli/__init__.py

@@ -142,7 +142,9 @@ def configure(config):
         project for project in projects if project.id == active_project_id
     ]
 
-    active_project_name = active_project[0].name if len(active_project) else "UNSET"
+    active_project_name = (
+        active_project[0].name if len(active_project) else "UNSET"
+    )
 
     click.echo(f"Current Active Project: {active_project_name}")
 
@@ -152,11 +154,12 @@ def configure(config):
         show_choices=True,
         default=active_project_name,
     )
-    selected_project = [project for project in projects if project.name == name]
+    selected_project = [
+        project for project in projects if project.name == name
+    ]
     config.proximl.client.set_active_project(selected_project[0].id)
 
 
-from proximl.cli.connection import connection
 from proximl.cli.dataset import dataset
 from proximl.cli.model import model
 from proximl.cli.checkpoint import checkpoint

{proximl-0.5.17 → proximl-1.0.1}/proximl/cli/checkpoint.py

@@ -35,15 +35,7 @@ def attach(config, checkpoint):
     if None is found:
         raise click.UsageError("Cannot find specified checkpoint.")
 
-    try:
-        config.proximl.run(found.attach())
-        return config.proximl.run(found.disconnect())
-    except:
-        try:
-            config.proximl.run(found.disconnect())
-        except:
-            pass
-        raise
+    config.proximl.run(found.attach())
 
 
 @checkpoint.command()
@@ -67,18 +59,10 @@ def connect(config, checkpoint, attach):
     if None is found:
         raise click.UsageError("Cannot find specified checkpoint.")
 
-    try:
-        if attach:
-            config.proximl.run(found.connect(), found.attach())
-            return config.proximl.run(found.disconnect())
-        else:
-            return config.proximl.run(found.connect())
-    except:
-        try:
-            config.proximl.run(found.disconnect())
-        except:
-            pass
-        raise
+    if attach:
+        config.proximl.run(found.connect(), found.attach())
+    else:
+        config.proximl.run(found.connect())
 
 
 @checkpoint.command()
@@ -123,41 +107,15 @@ def create(config, attach, connect, source, name, path):
             )
         )
 
-        try:
-            if connect and attach:
-                config.proximl.run(checkpoint.attach(), checkpoint.connect())
-                return config.proximl.run(checkpoint.disconnect())
-            elif connect:
-                return config.proximl.run(checkpoint.connect())
-            else:
-                raise click.UsageError(
-                    "Abort!\n"
-                    "No logs to show for local sourced checkpoint without connect."
-                )
-        except:
-            try:
-                config.proximl.run(checkpoint.disconnect())
-            except:
-                pass
-            raise
-
-
-@checkpoint.command()
-@click.argument("checkpoint", type=click.STRING)
-@pass_config
-def disconnect(config, checkpoint):
-    """
-    Disconnect and clean-up checkpoint upload.
-
-    CHECKPOINT may be specified by name or ID, but ID is preferred.
-    """
-    checkpoints = config.proximl.run(config.proximl.client.checkpoints.list())
-
-    found = search_by_id_name(checkpoint, checkpoints)
-    if None is found:
-        raise click.UsageError("Cannot find specified checkpoint.")
-
-    return config.proximl.run(found.disconnect())
+        if connect and attach:
+            config.proximl.run(checkpoint.attach(), checkpoint.connect())
+        elif connect:
+            config.proximl.run(checkpoint.connect())
+        else:
+            raise click.UsageError(
+                "Abort!\n"
+                "No logs to show for local sourced checkpoint without connect."
+            )
 
 
 @checkpoint.command()
@@ -236,7 +194,10 @@ def remove(config, checkpoint, force):
     found = search_by_id_name(checkpoint, checkpoints)
     if None is found:
         if force:
-            config.proximl.run(found.client.checkpoints.remove(checkpoint))
+            config.proximl.run(
+                config.proximl.client.checkpoints.remove(checkpoint)
+            )
+            return
         else:
             raise click.UsageError("Cannot find specified checkpoint.")
 

{proximl-0.5.17 → proximl-1.0.1}/proximl/cli/dataset.py

@@ -35,15 +35,7 @@ def attach(config, dataset):
     if None is found:
         raise click.UsageError("Cannot find specified dataset.")
 
-    try:
-        config.proximl.run(found.attach())
-        return config.proximl.run(found.disconnect())
-    except:
-        try:
-            config.proximl.run(found.disconnect())
-        except:
-            pass
-        raise
+    config.proximl.run(found.attach())
 
 
 @dataset.command()
@@ -67,18 +59,10 @@ def connect(config, dataset, attach):
     if None is found:
         raise click.UsageError("Cannot find specified dataset.")
 
-    try:
-        if attach:
-            config.proximl.run(found.connect(), found.attach())
-            return config.proximl.run(found.disconnect())
-        else:
-            return config.proximl.run(found.connect())
-    except:
-        try:
-            config.proximl.run(found.disconnect())
-        except:
-            pass
-        raise
+    if attach:
+        config.proximl.run(found.connect(), found.attach())
+    else:
+        config.proximl.run(found.connect())
 
 
 @dataset.command()
@@ -123,41 +107,15 @@ def create(config, attach, connect, source, name, path):
             )
         )
 
-        try:
-            if connect and attach:
-                config.proximl.run(dataset.attach(), dataset.connect())
-                return config.proximl.run(dataset.disconnect())
-            elif connect:
-                return config.proximl.run(dataset.connect())
-            else:
-                raise click.UsageError(
-                    "Abort!\n"
-                    "No logs to show for local sourced dataset without connect."
-                )
-        except:
-            try:
-                config.proximl.run(dataset.disconnect())
-            except:
-                pass
-            raise
-
-
-@dataset.command()
-@click.argument("dataset", type=click.STRING)
-@pass_config
-def disconnect(config, dataset):
-    """
-    Disconnect and clean-up dataset upload.
-
-    DATASET may be specified by name or ID, but ID is preferred.
-    """
-    datasets = config.proximl.run(config.proximl.client.datasets.list())
-
-    found = search_by_id_name(dataset, datasets)
-    if None is found:
-        raise click.UsageError("Cannot find specified dataset.")
-
-    return config.proximl.run(found.disconnect())
+        if connect and attach:
+            config.proximl.run(dataset.attach(), dataset.connect())
+        elif connect:
+            config.proximl.run(dataset.connect())
+        else:
+            raise click.UsageError(
+                "Abort!\n"
+                "No logs to show for local sourced dataset without connect."
+            )
 
 
 @dataset.command()
@@ -252,7 +210,9 @@ def rename(config, dataset, name):
     DATASET may be specified by name or ID, but ID is preferred.
     """
     try:
-        dataset = config.proximl.run(config.proximl.client.datasets.get(dataset))
+        dataset = config.proximl.run(
+            config.proximl.client.datasets.get(dataset)
+        )
         if dataset is None:
             raise click.UsageError("Cannot find specified dataset.")
     except:

{proximl-0.5.17 → proximl-1.0.1}/proximl/cli/job/__init__.py

@@ -1,3 +1,4 @@
+import asyncio
 import click
 from webbrowser import open as browse
 from proximl.cli import cli, pass_config, search_by_id_name
@@ -25,90 +26,111 @@ def attach(config, job):
     if None is found:
         raise click.UsageError("Cannot find specified job.")
 
-    try:
-        config.proximl.run(found.attach())
-        return config.proximl.run(found.disconnect())
-    except:
-        try:
-            config.proximl.run(found.disconnect())
-        except:
-            pass
-        raise
+    config.proximl.run(found.attach())
 
 
-@job.command()
-@click.option(
-    "--attach/--no-attach",
-    default=True,
-    show_default=True,
-    help="Auto attach to job.",
-)
-@click.argument("job", type=click.STRING)
-@pass_config
-def connect(config, job, attach):
+async def _connect_job(job, attach, config):
     """
-    Connect to job.
-
-    JOB may be specified by name or ID, but ID is preferred.
+    Async helper function to handle job connection with proper
+    handling of local input/output types and attach task management.
     """
-    jobs = config.proximl.run(config.proximl.client.jobs.list())
-
-    found = search_by_id_name(job, jobs)
-    if None is found:
-        raise click.UsageError("Cannot find specified job.")
-
-    if found.type != "notebook":
-        try:
-            if attach:
-                config.proximl.run(found.connect(), found.attach())
-                return config.proximl.run(found.disconnect())
-            else:
-                return config.proximl.run(found.connect())
-        except:
-            try:
-                config.proximl.run(found.disconnect())
-            except:
-                pass
-            raise
-    else:
-        if found.status in [
-            "new",
-            "waiting for data/model download",
-            "waiting for GPUs",
-        ]:
-            try:
-                if attach:
-                    config.proximl.run(found.connect(), found.attach())
-                    config.proximl.run(found.disconnect())
-                    click.echo("Launching...", file=config.stdout)
-                    browse(found.notebook_url)
-                else:
-                    return config.proximl.run(found.connect())
-            except:
-                try:
-                    config.proximl.run(found.disconnect())
-                except:
-                    pass
-                raise
-        elif found.status not in [
+    # Get job properties
+    model = job._job.get("model", {})
+    data = job._job.get("data", {})
+    model_local = model.get("source_type") == "local"
+    data_local = data.get("input_type") == "local"
+    output_local = data.get("output_type") == "local"
+    early_statuses = [
+        "new",
+        "waiting for data/model download",
+        "waiting for GPUs",
+        "waiting for resources",
+    ]
+
+    # Check if we need to wait for data/model download
+    # Only wait if status is early AND (data or model is local)
+    needs_upload_wait = job.status in early_statuses and (
+        model_local or data_local
+    )
+
+    if needs_upload_wait:
+        # Wait for job to reach data/model download status
+        await job.wait_for("waiting for data/model download", 3600)
+        await job.refresh()
+
+    # Start attach task early if requested
+    attach_task = None
+    if attach:
+        attach_task = asyncio.create_task(job.attach())
+
+    # Run first connect (upload if needed)
+    await job.connect()
+
+    # For notebook jobs, handle opening
+    if job.type == "notebook":
+        # Refresh to get latest status after connect
+        await job.refresh()
+
+        if job.status in early_statuses:
+            if attach_task:
+                await attach_task
+            click.echo("Launching...", file=config.stdout)
+            browse(job.notebook_url)
+            return
+        elif job.status not in [
             "starting",
             "running",
             "reinitializing",
             "copying",
         ]:
+            if attach_task:
+                attach_task.cancel()
             raise click.UsageError("Notebook job not running.")
         else:
-            config.proximl.run(found.wait_for("running"))
+            await job.wait_for("running")
+            if attach_task:
+                await attach_task
             click.echo("Launching...", file=config.stdout)
-            browse(found.notebook_url)
+            browse(job.notebook_url)
+            return
+
+    # For non-notebook jobs, check if we need second connect (download)
+    # Refresh to get latest status after first connect
+    await job.refresh()
+
+    # Run second connect if output_type is local
+    # (as per user's requirement: "if the output_type is 'local'")
+    if output_local:
+        # Always wait for running status before second connect
+        # (as shown in user's example)
+        await job.wait_for("running", 3600)
+        await job.refresh()
+
+        # Create second connect task (download)
+        connect_task = asyncio.create_task(job.connect())
+
+        # Gather both attach and second connect tasks
+        if attach_task:
+            await asyncio.gather(attach_task, connect_task)
+        else:
+            await connect_task
+    elif attach_task:
+        # Just wait for attach if no second connect needed
+        await attach_task
 
 
 @job.command()
+@click.option(
+    "--attach/--no-attach",
+    default=True,
+    show_default=True,
+    help="Auto attach to job.",
+)
 @click.argument("job", type=click.STRING)
 @pass_config
-def disconnect(config, job):
+def connect(config, job, attach):
     """
-    Disconnect and clean-up job.
+    Connect to job.
 
     JOB may be specified by name or ID, but ID is preferred.
     """
@@ -118,7 +140,7 @@ def disconnect(config, job):
     if None is found:
         raise click.UsageError("Cannot find specified job.")
 
-    return config.proximl.run(found.disconnect())
+    config.proximl.run(_connect_job(found, attach, config))
 
 
 @job.command()