envloop-cli 0.1.0__tar.gz

envloop_cli-0.1.0/.gitignore

@@ -0,0 +1,5 @@
+.venv/
+__pycache__/
+.pytest_cache/
+dist/
+/logs/

envloop_cli-0.1.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.5
+Name: envloop-cli
+Version: 0.1.0
+Summary: Standalone el command-line client for EnvLoop
+Project-URL: Repository, https://github.com/EnvLoop/envloop
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# envloop-cli
+
+Independent Python 3.11+ project providing the existing `el` CLI, version 0.1.0.
+It builds and installs without the envloop SDK checkout or any third-party runtime
+dependencies. The distribution is `envloop-cli`; its private implementation package
+is `el_cli`, so it does not overwrite the `envloop` SDK namespace.
+
+After publication:
+
+```bash
+pip install envloop-cli==0.1.0
+el --help
+el train --help
+el --api-url https://api.envloop.ai --workspace-id YOUR_WORKSPACE train job list
+```
+
+Set `ENVLOOP_API_KEY` privately in your environment. Existing command names,
+arguments, JSON output, error codes and `envloop/0.1` User-Agent are preserved.
+Local Task/Profile commands still require a separately installed compatible
+EnvPlatform, just as before; this package does not bundle an execution backend.
+No Tinker SDK, GPU, Docker or EnvHub dependencies are needed for remote queries.
+
+## Boundary and layout
+
+```text
+el-cli/
+  pyproject.toml
+  src/el_cli/
+    __init__.py
+    cli.py
+    client.py
+    http.py
+    train.py
+    utils/{__init__,logging}.py
+  tests/
+```
+
+The actual source has `envloop/cli.py` and `envloop/train.py`, rather than the
+`cli/commands/train.py` layout in the brief. `cli.py` imports Client and Train;
+Client uses the logging helper and lazily loads HttpService and Train. All use
+the standard library. Client also lazily imports EnvPlatform for local execution.
+Retaining Client preserves existing task/job/profile behavior rather than shipping
+a train-only CLI. These modules were extracted from the training-read CLI at
+`b546830`, based on main `11a5803`. Shared SDK/transport fixes should be applied
+to both packages while their copied implementations remain separate.
+
+The SDK keeps its Python APIs and legacy `python -m envloop.cli` interface, but
+no longer registers `el`; install this project for that executable.
+
+## Build, verify and publish
+
+From this directory:
+
+```bash
+uv sync --locked
+uv run --locked pytest -q --ignore=tests/test_jobs_http.py
+uv run --locked ruff check .
+uv build
+python -m venv /tmp/el-cli-clean
+/tmp/el-cli-clean/bin/python -m pip install dist/envloop_cli-0.1.0-py3-none-any.whl
+/tmp/el-cli-clean/bin/el --help
+/tmp/el-cli-clean/bin/el train --help
+```
+
+The real JobMaster integration cases in `tests/test_jobs_http.py` also require
+a separately installed EnvPlatform and its dependencies. Run the complete suite
+with that backend installed; the other cases need only the dev group.
+
+The workstation's Aliyun index is a download mirror, not an upload endpoint.
+No existing private upload repository or publishing credentials were found on
+2026-10-08. The intended public target is PyPI, upload endpoint
+`https://upload.pypi.org/legacy/`. Release remains unpublished until an authorized
+PyPI token (or configured Trusted Publisher) is available. Never put credentials
+in this project. With a token supplied privately as `UV_PUBLISH_TOKEN`:
+
+```bash
+uv publish --publish-url https://upload.pypi.org/legacy/ dist/*
+```
+
+Building a wheel does not establish that the PyPI name is reserved or that a
+release is available. Verify index installation after a successful upload.

envloop_cli-0.1.0/README.md

@@ -0,0 +1,81 @@
+# envloop-cli
+
+Independent Python 3.11+ project providing the existing `el` CLI, version 0.1.0.
+It builds and installs without the envloop SDK checkout or any third-party runtime
+dependencies. The distribution is `envloop-cli`; its private implementation package
+is `el_cli`, so it does not overwrite the `envloop` SDK namespace.
+
+After publication:
+
+```bash
+pip install envloop-cli==0.1.0
+el --help
+el train --help
+el --api-url https://api.envloop.ai --workspace-id YOUR_WORKSPACE train job list
+```
+
+Set `ENVLOOP_API_KEY` privately in your environment. Existing command names,
+arguments, JSON output, error codes and `envloop/0.1` User-Agent are preserved.
+Local Task/Profile commands still require a separately installed compatible
+EnvPlatform, just as before; this package does not bundle an execution backend.
+No Tinker SDK, GPU, Docker or EnvHub dependencies are needed for remote queries.
+
+## Boundary and layout
+
+```text
+el-cli/
+  pyproject.toml
+  src/el_cli/
+    __init__.py
+    cli.py
+    client.py
+    http.py
+    train.py
+    utils/{__init__,logging}.py
+  tests/
+```
+
+The actual source has `envloop/cli.py` and `envloop/train.py`, rather than the
+`cli/commands/train.py` layout in the brief. `cli.py` imports Client and Train;
+Client uses the logging helper and lazily loads HttpService and Train. All use
+the standard library. Client also lazily imports EnvPlatform for local execution.
+Retaining Client preserves existing task/job/profile behavior rather than shipping
+a train-only CLI. These modules were extracted from the training-read CLI at
+`b546830`, based on main `11a5803`. Shared SDK/transport fixes should be applied
+to both packages while their copied implementations remain separate.
+
+The SDK keeps its Python APIs and legacy `python -m envloop.cli` interface, but
+no longer registers `el`; install this project for that executable.
+
+## Build, verify and publish
+
+From this directory:
+
+```bash
+uv sync --locked
+uv run --locked pytest -q --ignore=tests/test_jobs_http.py
+uv run --locked ruff check .
+uv build
+python -m venv /tmp/el-cli-clean
+/tmp/el-cli-clean/bin/python -m pip install dist/envloop_cli-0.1.0-py3-none-any.whl
+/tmp/el-cli-clean/bin/el --help
+/tmp/el-cli-clean/bin/el train --help
+```
+
+The real JobMaster integration cases in `tests/test_jobs_http.py` also require
+a separately installed EnvPlatform and its dependencies. Run the complete suite
+with that backend installed; the other cases need only the dev group.
+
+The workstation's Aliyun index is a download mirror, not an upload endpoint.
+No existing private upload repository or publishing credentials were found on
+2026-10-08. The intended public target is PyPI, upload endpoint
+`https://upload.pypi.org/legacy/`. Release remains unpublished until an authorized
+PyPI token (or configured Trusted Publisher) is available. Never put credentials
+in this project. With a token supplied privately as `UV_PUBLISH_TOKEN`:
+
+```bash
+uv publish --publish-url https://upload.pypi.org/legacy/ dist/*
+```
+
+Building a wheel does not establish that the PyPI name is reserved or that a
+release is available. Verify index installation after a successful upload.

envloop_cli-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[project]
+name = "envloop-cli"
+version = "0.1.0"
+description = "Standalone el command-line client for EnvLoop"
+requires-python = ">=3.11"
+readme = "README.md"
+dependencies = []
+
+[project.scripts]
+el = "el_cli.cli:main"
+
+[project.urls]
+Repository = "https://github.com/EnvLoop/envloop"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/el_cli"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src", "tests", "README.md", "pyproject.toml"]
+
+[dependency-groups]
+dev = ["pytest>=8", "ruff==0.16.10"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["I"]

envloop_cli-0.1.0/src/el_cli/__init__.py

@@ -0,0 +1 @@
+"""Standalone EnvLoop command-line client."""

envloop_cli-0.1.0/src/el_cli/cli.py

@@ -0,0 +1,257 @@
+"""el: local Profile and Task operations built entirely on the SDK."""
+
+import argparse
+import json
+import os
+import shlex
+import sys
+from pathlib import Path
+
+from . import train
+from .client import Client
+
+
+class HelpArgumentParser(argparse.ArgumentParser):
+    """Show full command help for syntax and usage errors."""
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.set_defaults(_help_parser=self)
+        self._help_parser = self
+
+    def parse_known_args(self, args=None, namespace=None):
+        self._help_parser = self
+        parsed, remaining = super().parse_known_args(args, namespace)
+        # Subparsers propagate their defaults; keep the deepest selected command
+        # for unknown arguments and usage checks performed after parsing.
+        self._help_parser = parsed._help_parser
+        return parsed, remaining
+
+    def error(self, message):
+        command = self._help_parser
+        command.print_help(sys.stderr)
+        command.exit(2, f"\n{command.prog}: error: {message}\n")
+
+
+def dataset_reference(value):
+    name, separator, version = value.rpartition("@")
+    if (not value.strip() or (separator and (not name.strip() or not version.strip()))):
+        raise argparse.ArgumentTypeError(
+            "expected name or name@version with a non-empty name and version "
+            "(e.g. org/dataset@1.0)"
+        )
+    return value
+
+
+def submit_arguments(submit):
+    submit.add_argument("source", type=Path)
+    submit.add_argument(
+        "--profile", help="name@version, or name with an explicit default; latest is literal",
+    )
+    submit.add_argument("--profile-sha256", help="Expected canonical ProfileSpec SHA-256")
+    submit.add_argument("--request-id")
+    submit.add_argument("--seed", type=int)
+    submit.add_argument("--timeout-sec", type=int)
+    submit.add_argument("--executor", choices=["local", "docker", "sandbox"])
+    submit.add_argument("--provider", choices=["e2b", "e2b-local"])
+    submit.add_argument("--wait", action="store_true")
+
+
+def parser():
+    cli = HelpArgumentParser(prog="el")
+    cli.add_argument("--repository-root", type=Path)
+    cli.add_argument("--repository-commit")
+    cli.add_argument("--work-dir", type=Path)
+    cli.add_argument("--api-url", default=os.environ.get("ENVLOOP_BASE_URL", os.environ.get("ENVPLATFORM_API_URL")), help="HTTPS apiserver or loopback URL; defaults to ENVLOOP_BASE_URL; Bearer key from ENVLOOP_API_KEY")
+    cli.add_argument("--workspace-id", default=os.environ.get("ENVLOOP_WORKSPACE_ID"), help="Optional workspace override; defaults to the user's authorized workspace")
+    groups = cli.add_subparsers(dest="group", required=True)
+    train.register(groups)
+    profiles = groups.add_parser("profile").add_subparsers(dest="action", required=True)
+    profiles.add_parser("init")
+    put = profiles.add_parser("put")
+    put.add_argument("name")
+    put.add_argument("version")
+    put.add_argument("--file", type=Path, required=True, help="ProfileSpec JSON file")
+    get = profiles.add_parser("get")
+    get.add_argument("name")
+    get.add_argument("--version")
+    listing = profiles.add_parser("list")
+    listing.add_argument("--name")
+    listing.add_argument("--include-archived", action="store_true")
+    listing.add_argument("--limit", type=int, default=50)
+    listing.add_argument("--cursor")
+    default = profiles.add_parser("set-default")
+    default.add_argument("name")
+    default.add_argument("version")
+    default.add_argument("--expected-version", help="Omit only when no default exists")
+    for command in ("archive", "export"):
+        item = profiles.add_parser(command)
+        item.add_argument("name")
+        item.add_argument("version")
+    tasks = groups.add_parser("task").add_subparsers(dest="action", required=True)
+    submit = tasks.add_parser("submit")
+    submit_arguments(submit)
+    submissions = groups.add_parser("submit").add_subparsers(dest="action", required=True)
+    submit_arguments(submissions.add_parser("task"))
+    snapshot = tasks.add_parser("snapshot")
+    snapshot.add_argument("trial_id")
+    for action in ("status", "stop", "result"):
+        tasks.add_parser(action).add_argument("trial_id")
+    jobs = groups.add_parser("job").add_subparsers(dest="action", required=True)
+    job_submit = jobs.add_parser("submit")
+    job_submit.add_argument(
+        "dataset", nargs="?", type=dataset_reference, metavar="NAME[@VERSION]",
+        help="dataset name; optional author version (legacy positional form)",
+    )
+    job_submit.add_argument("--dataset", dest="dataset_option", type=dataset_reference, metavar="NAME[@VERSION]",
+                            help="dataset name; default selection uses the platform's pinned snapshot")
+    job_submit.add_argument("--namespace", help="explicit namespace for a short dataset name")
+    job_submit.add_argument("--config", help="dataset subset; uses its declared default when omitted")
+    job_submit.add_argument("--split", help="one complete split name; omitted selects all splits")
+    job_submit.add_argument("--revision", help="Git branch/tag/commit; must match the platform's pinned snapshot")
+    job_submit.add_argument("--attempts", type=int, default=1)
+    job_submit.add_argument("--request-id")
+    job_submit.add_argument("--profile")
+    job_submit.add_argument("--seed", type=int)
+    job_submit.add_argument("--timeout-sec", type=int)
+    job_submit.add_argument("--executor", choices=["local", "docker", "sandbox"])
+    job_submit.add_argument("--provider", choices=["e2b", "e2b-local"])
+    job_submit.add_argument("--wait", action="store_true")
+    for action in ("status", "stop", "result"):
+        jobs.add_parser(action).add_argument("job_id")
+    listing = jobs.add_parser("list")
+    listing.add_argument("--cursor")
+    listing.add_argument("--limit", type=int, default=25)
+    return cli
+
+
+def submission_options(args):
+    options = {}
+    if args.profile:
+        if "@" not in args.profile:
+            name, version = args.profile, None
+        elif args.group == "job":
+            name, version = args.profile.rsplit("@", 1)
+        else:
+            name, version = args.profile.split("@", 1)
+        options["profile_name"] = name
+        if version is not None:
+            options["profile_version"] = version
+    if args.seed is not None:
+        options["seed"] = args.seed
+    execution = {key: value for key, value in {"timeout_sec": args.timeout_sec, "executor": args.executor, "provider": args.provider}.items() if value is not None}
+    if execution:
+        options["execution"] = execution
+    return options
+
+
+def local_api_url():
+    """Read only the CLI connection setting; never import task secrets."""
+    path = Path.cwd() / ".env.local"
+    if not path.is_file():
+        return None
+    values = {}
+    for line in path.read_text(encoding="utf-8").splitlines():
+        key, separator, raw = line.strip().removeprefix("export ").partition("=")
+        if separator and key.strip() in {"ENVLOOP_BASE_URL", "ENVPLATFORM_API_URL"}:
+            values[key.strip()] = raw
+    raw = values.get("ENVLOOP_BASE_URL", values.get("ENVPLATFORM_API_URL"))
+    if raw is None:
+        return None
+    parts = shlex.split(raw, comments=True)
+    if len(parts) > 1:
+        raise ValueError("invalid API URL configuration")
+    return parts[0] if parts else ""
+
+
+def main(argv=None):
+    cli = parser()
+    args = cli.parse_args(argv)
+    if args.group == "job" and args.action == "submit":
+        if (args.dataset is None) == (args.dataset_option is None):
+            cli.error("provide exactly one positional dataset or --dataset")
+        args.dataset = args.dataset if args.dataset is not None else args.dataset_option
+    if args.api_url is not None and (args.repository_root or args.repository_commit or args.work_dir or args.group == "profile"):
+        cli.error("--api-url cannot be combined with local repository/profile options")
+    try:
+        if args.api_url is None and not (
+            args.repository_root or args.repository_commit or args.work_dir
+            or args.group == "profile"
+        ):
+            args.api_url = local_api_url()
+        if args.group == "profile" and args.action == "init":
+            if args.repository_root is None:
+                cli.error("--repository-root is required")
+            Client.init_repository(args.repository_root)
+            print(json.dumps({"initialized": True}))
+            return 0
+        if args.group == "train" and args.api_url is None:
+            cli.error("train requires --api-url or ENVLOOP_BASE_URL")
+        connection = Client.remote(args.api_url, workspace_id=args.workspace_id) if args.api_url is not None else Client.local(
+            repository_root=args.repository_root,
+            repository_commit=args.repository_commit,
+            work_dir=args.work_dir,
+        )
+        with connection as client:
+            if args.group == "train":
+                result = train.execute(client.train, args)
+            elif args.group == "profile":
+                if args.action == "put":
+                    result = client.profiles.import_spec(
+                        args.file.read_bytes(), name=args.name, version=args.version
+                    )
+                elif args.action == "get":
+                    result = client.profiles.get(args.name, args.version)
+                elif args.action == "list":
+                    result = client.profiles.list(
+                        name=args.name,
+                        include_archived=args.include_archived,
+                        limit=args.limit,
+                        cursor=args.cursor,
+                    )
+                elif args.action == "set-default":
+                    result = client.profiles.set_default(
+                        args.name, args.version, expected_version=args.expected_version
+                    )
+                elif args.action == "archive":
+                    result = client.profiles.archive(args.name, args.version)
+                else:
+                    sys.stdout.buffer.write(
+                        client.profiles.export(args.name, args.version) + b"\n"
+                    )
+                    return 0
+            elif args.group == "job":
+                if args.action == "submit":
+                    result = client.jobs.submit(args.dataset, attempts=args.attempts, request_id=args.request_id,
+                                                namespace=args.namespace, config=args.config, split=args.split,
+                                                revision=args.revision, **submission_options(args))
+                    if not args.api_url or args.wait:
+                        result = client.jobs.wait(result["job_id"])
+                elif args.action == "list":
+                    result = client.jobs.list(cursor=args.cursor, limit=args.limit)
+                else:
+                    result = getattr(client.jobs, args.action)(args.job_id)
+            elif args.action in {"snapshot", "status", "stop", "result"}:
+                result = getattr(client.tasks, args.action)(args.trial_id)
+            else:
+                trial = client.tasks.submit(
+                    args.source,
+                    request_id=args.request_id,
+                    profile_sha256=args.profile_sha256,
+                    **submission_options(args),
+                )
+                if not args.api_url or args.wait:
+                    client.tasks.wait(trial["trial_id"], timeout=600)
+                    result = client.tasks.result(trial["trial_id"])
+                else:
+                    result = trial
+            print(json.dumps(result, ensure_ascii=False))
+            return 1 if result.get("status") == "failed" else 0
+    except Exception as exc:
+        # Do not emit arbitrary exception messages, file content or credentials.
+        print(getattr(exc, "code", None) or type(exc).__name__, file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())