mistralai-workflows-cli 0.1.0__tar.gz

mistralai_workflows_cli-0.1.0/.gitignore

@@ -0,0 +1,201 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Ruff
+.ruff_cache/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# VSCode
+.vscode/
+!.vscode/extensions.json
+!.vscode/settings.json
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+.DS_Store
+pyrightconfig.json
+coverage
+i18n.cache
+
+## Local scripts
+
+integrations/scripts/local/
+scripts/run-dashboard/apps.local.yaml
+# Convenient to disable your local config without deleting it
+scripts/run-dashboard/_apps.local.yaml
+scripts/run-dashboard/plugins
+
+## Local data for notebooks
+.data/
+
+# Watchman - used by mobile (metro and jest)
+# Those files are written in a 60s interval, not ignoring them causes turbo to restart tasks
+.watchman-cookie-*
+
+# TS
+node_modules
+.turbo
+.yarn
+
+# Files generated by the jobs tests. TODO: see whether we can use a temp directory for this.
+jobs/run/checkpoints/test/consolidated/lora.safetensors
+jobs/run/checkpoints/test/consolidated/params.json
+
+# By default `claude --worktree` creates the worktree in this directory
+.claude/worktrees
+
+# Cursor plans folder
+.cursor/plans/
+tsconfig.tsbuildinfo

mistralai_workflows_cli-0.1.0/Makefile

@@ -0,0 +1,21 @@
+.PHONY: lint format typecheck test installdeps clean
+
+lint:
+	uv run ruff check .
+	uv run ruff format --check .
+
+format:
+	uv run ruff format .
+	uv run ruff check --fix .
+
+typecheck:
+	uv run mypy src/
+
+test:
+	uv run pytest
+
+installdeps:
+	uv sync
+
+clean:
+	rm -rf dist/ build/ *.egg-info

mistralai_workflows_cli-0.1.0/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: mistralai-workflows-cli
+Version: 0.1.0
+Summary: CLI to bootstrap Mistral Workflows projects
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: copier>=9.0
+Requires-Dist: rich>=13.0

mistralai_workflows_cli-0.1.0/README.md

@@ -0,0 +1,39 @@
+# mistralai-workflows-cli
+
+CLI to bootstrap Mistral Workflows projects.
+
+## Usage
+
+```bash
+uvx mistralai-workflows-cli setup
+```
+
+Or with options:
+
+```bash
+uvx mistralai-workflows-cli setup --api-key sk-... --project-name my-project
+```
+
+The `setup` command will:
+
+1. Ask for a project name (or use `--project-name`)
+2. Ask for a Mistral API key (or use `--api-key` / `MISTRAL_API_KEY` env var)
+3. Scaffold a new project from the [workflows-starter-app](https://github.com/mistralai/workflows-starter-app) template
+4. Suggest running `vibe` to start coding
+
+## Development
+
+```bash
+cd tools/mistral-workflows
+uv sync
+uv run mistral-workflows --help
+```
+
+## Publishing
+
+Tag with `mistral-workflows-cli/v<version>` to trigger the PyPI publish workflow.
+
+```bash
+git tag mistral-workflows-cli/v0.1.0
+git push origin mistral-workflows-cli/v0.1.0
+```

mistralai_workflows_cli-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[project]
+name = "mistralai-workflows-cli"
+version = "0.1.0"
+description = "CLI to bootstrap Mistral Workflows projects"
+requires-python = ">=3.10"
+dependencies = [
+    "click>=8.0",
+    "copier>=9.0",
+    "rich>=13.0",
+]
+
+[project.scripts]
+mistral-workflows = "mistral_workflows_cli.main:cli"
+mistralai-workflows-cli = "mistral_workflows_cli.main:cli"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mistral_workflows_cli"]
+
+[tool.ruff]
+line-length = 120
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP"]
+
+[dependency-groups]
+dev = [
+    "ruff>=0.11",
+    "mypy>=1.15",
+    "pytest>=8.0",
+]

mistralai_workflows_cli-0.1.0/src/mistral_workflows_cli/main.py

@@ -0,0 +1,18 @@
+import click
+
+
+@click.group()
+@click.version_option()
+def cli() -> None:
+    """Mistral Workflows CLI — bootstrap and manage workflow projects."""
+
+
+@cli.command()
+@click.option("--api-key", default=None, help="Mistral API key.")
+@click.option("--output-dir", "-o", default=".", help="Parent directory for the new project.")
+@click.option("--project-name", "-n", default=None, help="Project name (also used as directory name).")
+def setup(api_key: str | None, output_dir: str, project_name: str | None) -> None:
+    """Bootstrap a new Mistral Workflows project."""
+    from mistral_workflows_cli.setup import run_setup
+
+    run_setup(api_key=api_key, output_dir=output_dir, project_name=project_name)

mistralai_workflows_cli-0.1.0/src/mistral_workflows_cli/setup.py

@@ -0,0 +1,61 @@
+from __future__ import annotations
+
+import socket
+from pathlib import Path
+
+from rich.console import Console
+from rich.prompt import Prompt
+
+TEMPLATE_URL = "gh:mistralai/workflows-starter-app"
+API_KEYS_URL = "https://console.mistral.ai/api-keys"
+
+
+def run_setup(
+    api_key: str | None,
+    output_dir: str,
+    project_name: str | None,
+) -> None:
+    console = Console()
+
+    console.print("\n[bold]Mistral Workflows — Project Setup[/bold]\n")
+
+    # 1. Project name
+    if not project_name:
+        project_name = Prompt.ask("Project name", default="my-workflow")
+
+    # 2. API key
+    if not api_key:
+        console.print(f"Create an API key at: [link={API_KEYS_URL}]{API_KEYS_URL}[/link]\n")
+        api_key = Prompt.ask("Paste your Mistral API key")
+
+    if not api_key:
+        console.print("[bold red]No API key provided. Aborting.[/bold red]")
+        raise SystemExit(1)
+
+    # 3. Clone template via copier
+    dest = Path(output_dir) / project_name
+
+    if dest.exists():
+        console.print(f"[bold red]Directory already exists: {dest}[/bold red]")
+        raise SystemExit(1)
+
+    console.print(f"\nScaffolding project into [bold]{dest}[/bold] ...\n")
+
+    try:
+        import copier
+    except ImportError:
+        console.print("[bold red]copier is not installed. Run: pip install copier[/bold red]")
+        raise SystemExit(1)
+
+    copier.run_copy(
+        TEMPLATE_URL,
+        str(dest),
+        data={"project_name": project_name, "mistral_api_key": api_key, "temporal_task_queue": socket.gethostname()},
+        unsafe=True,
+    )
+
+    # 4. Success
+    console.print(f"\n[bold green]Project created at {dest}[/bold green]\n")
+    console.print("Get started:\n")
+    console.print(f"  cd {project_name}")
+    console.print("  vibe\n")

mistralai_workflows_cli-0.1.0/tests/test_setup.py

@@ -0,0 +1,36 @@
+from __future__ import annotations
+
+from unittest.mock import patch
+
+import pytest
+from click.testing import CliRunner
+
+from mistral_workflows_cli.main import cli
+from mistral_workflows_cli.setup import run_setup
+
+
+@pytest.fixture
+def runner() -> CliRunner:
+    return CliRunner()
+
+
+def test_cli_has_setup_command(runner: CliRunner) -> None:
+    result = runner.invoke(cli, ["--help"])
+    assert result.exit_code == 0
+    assert "setup" in result.output
+
+
+def test_setup_fails_without_api_key(tmp_path: object) -> None:
+    with patch("mistral_workflows_cli.setup.Prompt.ask", return_value=""):
+        with pytest.raises(SystemExit) as exc_info:
+            run_setup(api_key=None, output_dir=str(tmp_path), project_name="test-proj")
+        assert exc_info.value.code == 1
+
+
+def test_setup_fails_if_dir_exists(tmp_path: object) -> None:
+    import pathlib
+
+    (pathlib.Path(str(tmp_path)) / "existing").mkdir()
+    with pytest.raises(SystemExit) as exc_info:
+        run_setup(api_key="sk-test", output_dir=str(tmp_path), project_name="existing")
+    assert exc_info.value.code == 1