keboola-cli 0.100.2__tar.gz → 0.100.3__tar.gz

{keboola_cli-0.100.2 → keboola_cli-0.100.3}/CLAUDE.md

@@ -490,7 +490,7 @@ kbagent auth register-projects [--stack URL|alias] [--all] [--project-id ID ...]
 #   starts the server and blocks every destructive route (none of them under `/auth/*`).
 #   See docs/web-server.md.
 
-kbagent project create --url URL [--project ALIAS] [--name NAME] [--backend snowflake|bigquery] [--sync-backend-init]
+kbagent project create --url URL [--project|--alias ALIAS] [--name NAME] [--backend snowflake|bigquery] [--sync-backend-init]
 # project create (since 0.95.0, DMD-1940): the ONLY kbagent command that works from nothing --
 #   no account, no token, no `auth login`. POSTs the unauthenticated provisioning endpoint
 #   (`/manage/programmatic-projects`, gated by the `agent-provisioning` stack feature
@@ -515,13 +515,13 @@ kbagent project create --url URL [--project ALIAS] [--name NAME] [--backend snow
 #   delivered and may have succeeded (retryable:false, message says not to repeat -- check
 #   `auth status`, whose stored session + claim link is the evidence). `--sync-backend-init`
 #   raises that call's read timeout to 300s, which can outlast an agent's foreground shell.
-kbagent project add --project NAME --url URL [--token-stdin | --token-file PATH [--keep-token-file] | --token-env NAME | --token TOKEN]
+kbagent project add --project|--alias NAME --url URL [--token-stdin | --token-file PATH [--keep-token-file] | --token-env NAME | --token TOKEN]
 kbagent project list
 kbagent project remove --project NAME
 kbagent project edit --project NAME [--url URL] [--token-stdin | --token-file PATH [--keep-token-file] | --token-env NAME | --token TOKEN] [--new-alias NEW]
 kbagent project status [--project NAME | --all-projects]
 kbagent project refresh --project ALIAS [--dry-run] [--force] [--yes] [--token-description DESC] [--token-expires-in N]
-kbagent project refresh --all [--dry-run] [--force] [--yes] [--token-description DESC] [--token-expires-in N]
+kbagent project refresh --all|--all-projects [--dry-run] [--force] [--yes] [--token-description DESC] [--token-expires-in N]
 kbagent project description-get --project NAME
 kbagent project description-set --project NAME [--text STR | --file PATH | --stdin]
 kbagent project use ALIAS

{keboola_cli-0.100.2 → keboola_cli-0.100.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: keboola-cli
-Version: 0.100.2
+Version: 0.100.3
 Summary: AI-friendly CLI for managing Keboola projects
 Author-email: Keboola <dev@keboola.com>
 License-Expression: Apache-2.0

{keboola_cli-0.100.2 → keboola_cli-0.100.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "keboola-cli"
-version = "0.100.2"
+version = "0.100.3"
 description = "AI-friendly CLI for managing Keboola projects"
 readme = "README.md"
 requires-python = ">=3.12"

{keboola_cli-0.100.2 → keboola_cli-0.100.3}/src/keboola_agent_cli/changelog.py

@@ -26,6 +26,14 @@ from .constants import CHANGELOG_HEADLINE_MAX_CHARS
 
 # Ordered newest-first.  Each value is a list of brief one-line descriptions.
 CHANGELOG: dict[str, list[str]] = {
+    "0.100.3": [
+        "New (#911): `project add` and `project create` also take the alias of the new project "
+        "as `--alias`, and `project refresh` also takes `--all-projects`. These are the names of "
+        "kbagent 1.0.0, which removes `--project` from these two commands and `--all` from "
+        "`project refresh`. A script with the new names works on 0.100.3 and on 1.x. On 0.x, "
+        "`--project` and `--all` keep working.",
+        "Note (#912): housekeeping with no user-facing change. It updates the filelock package.",
+    ],
     "0.100.2": [
         "Fix (#898): `kbagent update --beta` now allows a pre-release of kbagent itself, not of "
         "the Python packages that kbagent uses. Before, it allowed pre-releases of every package, "

{keboola_cli-0.100.2 → keboola_cli-0.100.3}/src/keboola_agent_cli/commands/context.py

@@ -268,7 +268,7 @@ Use `kbagent <command> --help` for full flag details and examples.
 
 ### Project Management
 
-  kbagent project create --url URL [--project ALIAS] [--name NAME]
+  kbagent project create --url URL [--project|--alias ALIAS] [--name NAME]
                          [--backend snowflake|bigquery] [--sync-backend-init]
     Create a BRAND-NEW Keboola project from a machine with no Keboola
     identity -- no account, no token, no `auth login` first. The only command
@@ -300,7 +300,7 @@ Use `kbagent <command> --help` for full flag details and examples.
     the stack finish it in the background (the async default warns that the
     first Storage command may fail until it lands).
 
-  kbagent project add --project NAME --url URL [--token-stdin | --token-file PATH | --token-env NAME | --token TOKEN]
+  kbagent project add --project|--alias NAME --url URL [--token-stdin | --token-file PATH | --token-env NAME | --token TOKEN]
     Add a new project connection. Token verified against API.
     See "Getting a Storage token in" below before you pick a flag.
 
@@ -374,8 +374,8 @@ Use `kbagent <command> --help` for full flag details and examples.
     `project list`, including on an ERROR row.
 
   kbagent project refresh --project ALIAS [--dry-run] [--force] [--yes] [--token-description ...] [--token-expires-in N]
-  kbagent project refresh --all [--dry-run] [--force] [--yes] [--token-description ...] [--token-expires-in N]
-    Refresh project tokens via Manage API. --all refreshes all projects. --force replaces non-expiring tokens.
+  kbagent project refresh --all|--all-projects [--dry-run] [--force] [--yes] [--token-description ...] [--token-expires-in N]
+    Refresh project tokens via Manage API. --all (or --all-projects) refreshes all projects. --force replaces non-expiring tokens.
     Browser-login (session) projects are reported under "skipped" with the
     reason that there is no static token to replace -- their access token
     rotates on its own from auth.json. --force does NOT convert them either;

{keboola_cli-0.100.2 → keboola_cli-0.100.3}/src/keboola_agent_cli/commands/project.py

@@ -172,7 +172,9 @@ def _format_status_table(console: Console, statuses: list[dict[str, Any]]) -> No
 @project_app.command("add")
 def project_add(
     ctx: typer.Context,
-    alias: str = typer.Option(..., "--project", help="Human-friendly name for this project"),
+    alias: str = typer.Option(
+        ..., "--project", "--alias", help="Human-friendly name for this project"
+    ),
     url: str = typer.Option(
         DEFAULT_STACK_URL,
         help="Keboola stack URL",
@@ -244,7 +246,10 @@ def project_create(
         help="Keboola stack URL to create the project on (required -- never guessed)",
     ),
     alias: str | None = typer.Option(
-        None, "--project", help="Local alias for the new project (default: from its name)"
+        None,
+        "--project",
+        "--alias",
+        help="Local alias for the new project (default: from its name)",
     ),
     name: str | None = typer.Option(None, "--name", help="Name for the new Keboola project"),
     backend: ProjectBackend | None = typer.Option(
@@ -574,7 +579,7 @@ def project_refresh(
         None, "--project", "-p", help="Refresh token for a specific project"
     ),
     all_projects: bool = typer.Option(
-        False, "--all", help="Refresh all projects with invalid tokens"
+        False, "--all", "--all-projects", help="Refresh all projects with invalid tokens"
     ),
     dry_run: bool = typer.Option(
         False, "--dry-run", help="Preview what would be refreshed without making changes"

{keboola_cli-0.100.2 → keboola_cli-0.100.3}/tests/test_cli.py

@@ -10,6 +10,7 @@ from typing import Any
 from unittest.mock import MagicMock, patch
 
 import pytest
+import typer.main
 from typer.testing import CliRunner
 
 from helpers import make_mock_client
@@ -75,6 +76,48 @@ class TestProjectAdd:
         # Token should be masked
         assert "55555" not in output["data"]["token"]
 
+    def test_project_add_alias_option(self, tmp_path: Path) -> None:
+        """--alias is the 1.x name of --project here, so one command works on 0.x and 1.x."""
+        mock_client = make_mock_client(project_name="Prod Project", project_id=5678)
+        config_dir = tmp_path / "config"
+        config_dir.mkdir()
+
+        with (
+            patch("keboola_agent_cli.cli.ConfigStore") as MockStore,
+            patch("keboola_agent_cli.cli.ProjectService") as MockService,
+            patch.dict(os.environ, {"KBC_TOKEN": TEST_TOKEN}),
+        ):
+            store_instance = ConfigStore(config_dir=config_dir)
+            MockStore.return_value = store_instance
+            MockService.return_value = ProjectService(
+                config_store=store_instance,
+                client_factory=lambda url, token: mock_client,
+            )
+
+            result = runner.invoke(
+                app,
+                [
+                    "--json",
+                    "project",
+                    "add",
+                    "--alias",
+                    "prod",
+                    "--url",
+                    "https://connection.keboola.com",
+                ],
+            )
+
+        assert result.exit_code == 0, f"Exit code {result.exit_code}: {result.output}"
+        assert json.loads(result.output)["data"]["alias"] == "prod"
+        assert "prod" in store_instance.load().projects
+
+    def test_project_create_takes_alias_option(self) -> None:
+        """project create accepts --alias, the 1.x name of its --project."""
+        root: Any = typer.main.get_command(app)
+        create = root.commands["project"].commands["create"]
+        alias = next(p for p in create.params if p.name == "alias")
+        assert alias.opts == ["--project", "--alias"]
+
     def test_project_add_success_human(self, tmp_path: Path) -> None:
         """project add in human mode outputs success message."""
         mock_client = make_mock_client()
@@ -8520,6 +8563,27 @@ class TestProjectRefresh:
         assert output["status"] == "error"
         assert "not both" in output["error"]["message"]
 
+    def test_project_refresh_all_projects_is_the_all_option(self, tmp_path: Path) -> None:
+        """--all-projects is the 1.x name of --all: with --project it is the same usage error."""
+        config_dir = tmp_path / "config"
+        config_dir.mkdir()
+        store = ConfigStore(config_dir=config_dir)
+
+        with (
+            patch("keboola_agent_cli.cli.ConfigStore") as MockStore,
+            patch("keboola_agent_cli.cli.OrgService"),
+        ):
+            MockStore.return_value = store
+
+            result = runner.invoke(
+                app,
+                ["--json", "project", "refresh", "--project", "prod", "--all-projects", "--yes"],
+            )
+
+        assert result.exit_code == 2, f"Exit code {result.exit_code}: {result.output}"
+        output = json.loads(result.output)
+        assert "not both" in output["error"]["message"]
+
     def test_project_refresh_dry_run(self, tmp_path: Path) -> None:
         """project refresh --all --dry-run --json shows preview without changes."""
         config_dir = tmp_path / "config"