awcs-scripts 1.0.1__tar.gz

awcs_scripts-1.0.1/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+.pytest_cache/
+*.egg-info/
+.cache/

awcs_scripts-1.0.1/.gitlab-ci.yml

@@ -0,0 +1,46 @@
+stages:
+  - test
+  - build
+  - publish
+
+default:
+  image: python:3.12-slim
+  tags:
+    - docker
+  before_script:
+    - apt-get update -qq && apt-get install -y -qq curl ca-certificates >/dev/null
+    - curl -LsSf https://astral.sh/uv/install.sh | sh
+    - export PATH="$HOME/.local/bin:$PATH"
+    - uv --version
+
+variables:
+  UV_CACHE_DIR: "$CI_PROJECT_DIR/.cache/uv"
+  UV_LINK_MODE: copy
+
+test:
+  stage: test
+  script:
+    - uv sync --frozen --group dev
+    - uv run pytest
+    - uv run awcs help
+
+build:
+  stage: build
+  script:
+    - uv build
+  artifacts:
+    paths:
+      - dist/
+    expire_in: 1 week
+  rules:
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+
+publish:
+  stage: publish
+  rules:
+    - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/
+  script:
+    - uv version "${CI_COMMIT_TAG#v}"
+    - uv build
+    - uv publish

awcs_scripts-1.0.1/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright 2026 AWCS
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

awcs_scripts-1.0.1/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.5
+Name: awcs-scripts
+Version: 1.0.1
+Summary: Command line scripts for WCS maps and the ARMS API
+Project-URL: Repository, https://gitlab.sprydev.ru/automacon/agv/wcs/awcs_scripts
+Author: AWCS
+License: Apache-2.0
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: httpx
+Requires-Dist: numpy
+Requires-Dist: pillow
+Requires-Dist: tifffile
+Description-Content-Type: text/markdown
+
+# awcs-scripts
+
+Скрипты для карт WCS и части ARMS API. Пакет называется `awcs-scripts`, команда после установки — `awcs`.
+
+## Публикация в PyPI
+
+Выкладка происходит только по тегу `vX.Y.Z`. Обычный push и merge request пакет не публикуют: CI прогоняет тесты и собирает wheel. Версию берёт джоба `publish` из тега (`v0.1.0` → `0.1.0`), поле `version` в `pyproject.toml` на публикацию не влияет.
+
+Токен в репозиторий не входит. Его нужно завести один раз:
+
+1. На [pypi.org](https://pypi.org) создать API-токен с правом загрузки. Для первой выкладки имя `awcs-scripts` должно быть свободно: проект создаётся при первой успешной загрузке. До этого нужен токен уровня аккаунта, после первой публикации его можно ограничить этим проектом.
+2. В GitLab, в CI/CD-переменных этого репозитория, добавить `UV_PUBLISH_TOKEN` со значением токена и включить **Masked**. **Protected** включать только если теги `v*` тоже protected: иначе на теге переменная в джобу не попадёт и `uv publish` упадёт без токена.
+
+Тег и отправка:
+
+```
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+Репозиторий закрытый, а `uv publish` пишет на публичный PyPI. После зелёного пайплайна wheel доступен по имени пакета.
+
+## Установка
+
+```
+uv tool install awcs-scripts
+```
+
+До первого тега те же подкоманды запускаются из git. Репозиторий закрытый, доступ к GitLab уже должен быть настроен, токен в команду не подставляется:
+
+```
+uvx --from git+https://gitlab.sprydev.ru/automacon/agv/wcs/awcs_scripts.git awcs help
+```
+
+Из клона репозитория, без публикации:
+
+```
+uv tool install .
+```
+
+После этого команда `awcs` доступна в системе. Для разработки в том же клоне:
+
+```
+uv sync
+uv run awcs help
+uv build
+```
+
+## Удаление
+
+Снимает команду `awcs`, поставленную через `uv tool install` из клона или с PyPI:
+
+```
+uv tool uninstall awcs-scripts
+```
+
+Профиль с адресом и ключом эта команда не трогает. Его файл лежит по `AWCS_CONFIG`, иначе `%APPDATA%\awcs\config.ini` на Windows и `~/.config/awcs/config.ini` в остальных системах. Чтобы убрать и ключ, удалите этот файл.
+
+## Команды
+
+```
+awcs help
+awcs mrmap-to-raster path/to/map.mrmap --out-dir path/to/out
+awcs mrmap-to-bg path/to/map.mrmap path/to/layout.lif --layout_id layoutId --resolution 0.05 --output path/to/layout.out.lif
+awcs login --url https://dev.wcs.automacon.ru --apikey <apikey>
+awcs users list
+awcs users me
+awcs mission_templates list
+awcs robots list
+awcs missions list
+awcs missions create --template_code PickPallet --params "{\"zone\":\"A\"}"
+awcs mission_templates execute PickPallet --params "{\"zone\":\"A\"}"
+awcs projects list
+awcs projects create --lif_json path/to/layout.lif -m MAIRUI -v 1.0.0 --desc "line 1" --sync
+awcs projects activate 12
+```
+
+Разовый запуск после публикации:
+
+```
+uvx --from awcs-scripts awcs help
+uvx --from awcs-scripts awcs mrmap-to-raster path/to/map.mrmap --resolution 0.05 --out-dir path/to/out
+uvx --from awcs-scripts awcs users me
+```
+
+`awcs mrmap-to-raster` пишет PNG, GeoTIFF и JSON. `--resolution` задаёт метры на пиксель, по умолчанию берётся `resolution_2d` из карты. `awcs mrmap-to-bg` подставляет этот растр в `backgroundImage` одного layout. Без `--output` исходный `.lif` перезаписывается.
+
+`awcs login` проверяет ключ через `GET /users/me` и только после ответа 200 сохраняет origin и ключ. Профиль лежит вне репозитория: путь из `AWCS_CONFIG`, иначе `%APPDATA%\awcs\config.ini` на Windows и `~/.config/awcs/config.ini` в остальных системах. Ключ в вывод не печатается. Клиент сам дописывает `/api/v1` и шлёт заголовок `X-Api-Key`.
+
+У списков есть `--page`, `--per_page`, `--filter`, `--sort_by`. `awcs missions create` принимает `--template_id` или `--template_code` и необязательный `--params`. `awcs mission_templates execute` отправляет `--params` плоским JSON-объектом. `awcs projects create` загружает LIF как `multipart/form-data`: `-m` это `--manufacturer`, `-v` и `--version` это `--project_version`, `--desc` это `--description`, `--sync` это `--synchronous`.
+
+## Разработка
+
+Карта живёт в `src/awcs_scripts/mrmap/`. Имена файлов совпадают с подкомандами: `mrmap-to-raster.py` и `mrmap-to-bg.py`. Будущие shell-скрипты кладутся в `bash/` и тоже вызываются только через `awcs`.

awcs_scripts-1.0.1/README.md

@@ -0,0 +1,94 @@
+# awcs-scripts
+
+Скрипты для карт WCS и части ARMS API. Пакет называется `awcs-scripts`, команда после установки — `awcs`.
+
+## Публикация в PyPI
+
+Выкладка происходит только по тегу `vX.Y.Z`. Обычный push и merge request пакет не публикуют: CI прогоняет тесты и собирает wheel. Версию берёт джоба `publish` из тега (`v0.1.0` → `0.1.0`), поле `version` в `pyproject.toml` на публикацию не влияет.
+
+Токен в репозиторий не входит. Его нужно завести один раз:
+
+1. На [pypi.org](https://pypi.org) создать API-токен с правом загрузки. Для первой выкладки имя `awcs-scripts` должно быть свободно: проект создаётся при первой успешной загрузке. До этого нужен токен уровня аккаунта, после первой публикации его можно ограничить этим проектом.
+2. В GitLab, в CI/CD-переменных этого репозитория, добавить `UV_PUBLISH_TOKEN` со значением токена и включить **Masked**. **Protected** включать только если теги `v*` тоже protected: иначе на теге переменная в джобу не попадёт и `uv publish` упадёт без токена.
+
+Тег и отправка:
+
+```
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+Репозиторий закрытый, а `uv publish` пишет на публичный PyPI. После зелёного пайплайна wheel доступен по имени пакета.
+
+## Установка
+
+```
+uv tool install awcs-scripts
+```
+
+До первого тега те же подкоманды запускаются из git. Репозиторий закрытый, доступ к GitLab уже должен быть настроен, токен в команду не подставляется:
+
+```
+uvx --from git+https://gitlab.sprydev.ru/automacon/agv/wcs/awcs_scripts.git awcs help
+```
+
+Из клона репозитория, без публикации:
+
+```
+uv tool install .
+```
+
+После этого команда `awcs` доступна в системе. Для разработки в том же клоне:
+
+```
+uv sync
+uv run awcs help
+uv build
+```
+
+## Удаление
+
+Снимает команду `awcs`, поставленную через `uv tool install` из клона или с PyPI:
+
+```
+uv tool uninstall awcs-scripts
+```
+
+Профиль с адресом и ключом эта команда не трогает. Его файл лежит по `AWCS_CONFIG`, иначе `%APPDATA%\awcs\config.ini` на Windows и `~/.config/awcs/config.ini` в остальных системах. Чтобы убрать и ключ, удалите этот файл.
+
+## Команды
+
+```
+awcs help
+awcs mrmap-to-raster path/to/map.mrmap --out-dir path/to/out
+awcs mrmap-to-bg path/to/map.mrmap path/to/layout.lif --layout_id layoutId --resolution 0.05 --output path/to/layout.out.lif
+awcs login --url https://dev.wcs.automacon.ru --apikey <apikey>
+awcs users list
+awcs users me
+awcs mission_templates list
+awcs robots list
+awcs missions list
+awcs missions create --template_code PickPallet --params "{\"zone\":\"A\"}"
+awcs mission_templates execute PickPallet --params "{\"zone\":\"A\"}"
+awcs projects list
+awcs projects create --lif_json path/to/layout.lif -m MAIRUI -v 1.0.0 --desc "line 1" --sync
+awcs projects activate 12
+```
+
+Разовый запуск после публикации:
+
+```
+uvx --from awcs-scripts awcs help
+uvx --from awcs-scripts awcs mrmap-to-raster path/to/map.mrmap --resolution 0.05 --out-dir path/to/out
+uvx --from awcs-scripts awcs users me
+```
+
+`awcs mrmap-to-raster` пишет PNG, GeoTIFF и JSON. `--resolution` задаёт метры на пиксель, по умолчанию берётся `resolution_2d` из карты. `awcs mrmap-to-bg` подставляет этот растр в `backgroundImage` одного layout. Без `--output` исходный `.lif` перезаписывается.
+
+`awcs login` проверяет ключ через `GET /users/me` и только после ответа 200 сохраняет origin и ключ. Профиль лежит вне репозитория: путь из `AWCS_CONFIG`, иначе `%APPDATA%\awcs\config.ini` на Windows и `~/.config/awcs/config.ini` в остальных системах. Ключ в вывод не печатается. Клиент сам дописывает `/api/v1` и шлёт заголовок `X-Api-Key`.
+
+У списков есть `--page`, `--per_page`, `--filter`, `--sort_by`. `awcs missions create` принимает `--template_id` или `--template_code` и необязательный `--params`. `awcs mission_templates execute` отправляет `--params` плоским JSON-объектом. `awcs projects create` загружает LIF как `multipart/form-data`: `-m` это `--manufacturer`, `-v` и `--version` это `--project_version`, `--desc` это `--description`, `--sync` это `--synchronous`.
+
+## Разработка
+
+Карта живёт в `src/awcs_scripts/mrmap/`. Имена файлов совпадают с подкомандами: `mrmap-to-raster.py` и `mrmap-to-bg.py`. Будущие shell-скрипты кладутся в `bash/` и тоже вызываются только через `awcs`.

awcs_scripts-1.0.1/bash/README.md

@@ -0,0 +1,3 @@
+# Bash-скрипты
+
+Сюда кладутся будущие shell-скрипты. Каждый вызывается только как подкоманда `awcs`, отдельная console-script для него не заводится.

awcs_scripts-1.0.1/pyproject.toml

@@ -0,0 +1,34 @@
+[project]
+name = "awcs-scripts"
+version = "1.0.1"
+description = "Command line scripts for WCS maps and the ARMS API"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "Apache-2.0" }
+authors = [{ name = "AWCS" }]
+dependencies = [
+  "httpx",
+  "numpy",
+  "pillow",
+  "tifffile",
+]
+
+[project.urls]
+Repository = "https://gitlab.sprydev.ru/automacon/agv/wcs/awcs_scripts"
+
+[project.scripts]
+awcs = "awcs_scripts.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = ["pytest"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/awcs_scripts"]
+
+[tool.hatch.build.targets.wheel.force-include]
+"src/awcs_scripts/mrmap/mrmap-to-raster.py" = "awcs_scripts/mrmap/mrmap-to-raster.py"
+"src/awcs_scripts/mrmap/mrmap-to-bg.py" = "awcs_scripts/mrmap/mrmap-to-bg.py"

awcs_scripts-1.0.1/src/awcs_scripts/__init__.py

@@ -0,0 +1,3 @@
+"""Scripts for WCS maps and the ARMS API."""
+
+__version__ = "0.1.0"

awcs_scripts-1.0.1/src/awcs_scripts/api.py

@@ -0,0 +1,66 @@
+"""ARMS HTTP client. The API key is sent as X-Api-Key."""
+
+from __future__ import annotations
+
+from typing import Any
+
+import httpx
+
+_API_PREFIX = "/api/v1"
+
+
+class ApiError(Exception):
+    def __init__(self, status_code: int, body: str) -> None:
+        self.status_code = status_code
+        self.body = body
+        super().__init__(f"HTTP {status_code}")
+
+
+def origin_of(url: str) -> str:
+    """Return the site origin. A trailing /api/v1 is stripped so it is not doubled."""
+    value = url.strip().rstrip("/")
+    if value.endswith(_API_PREFIX):
+        value = value[: -len(_API_PREFIX)].rstrip("/")
+    return value
+
+
+class Client:
+    def __init__(
+        self,
+        url: str,
+        apikey: str,
+        *,
+        transport: httpx.BaseTransport | None = None,
+        timeout: float = 120,
+    ) -> None:
+        self.origin = origin_of(url)
+        self._client = httpx.Client(
+            base_url=self.origin + _API_PREFIX,
+            headers={"X-Api-Key": apikey},
+            transport=transport,
+            timeout=timeout,
+        )
+
+    def close(self) -> None:
+        self._client.close()
+
+    def __enter__(self) -> Client:
+        return self
+
+    def __exit__(self, *args: object) -> None:
+        self.close()
+
+    def request(
+        self,
+        method: str,
+        path: str,
+        *,
+        params: dict[str, Any] | None = None,
+        json: Any = None,
+        data: dict[str, Any] | None = None,
+        files: dict[str, Any] | None = None,
+    ) -> httpx.Response:
+        response = self._client.request(method, path, params=params, json=json, data=data, files=files)
+        if response.status_code >= 400:
+            raise ApiError(response.status_code, response.text)
+        return response

awcs_scripts-1.0.1/src/awcs_scripts/cli.py

@@ -0,0 +1,264 @@
+"""Single `awcs` command for map tools and a slice of the ARMS API."""
+
+from __future__ import annotations
+
+import argparse
+import importlib.util
+import json
+import sys
+from pathlib import Path
+from typing import Any
+from urllib.parse import quote
+
+import httpx
+
+from awcs_scripts.api import ApiError, Client, origin_of
+from awcs_scripts.config import ConfigError, load_profile, save_profile
+
+_TOOLS = Path(__file__).resolve().parent / "mrmap"
+
+
+def _load_tool(filename: str):
+    path = _TOOLS / filename
+    spec = importlib.util.spec_from_file_location(filename.removesuffix(".py").replace("-", "_"), path)
+    if spec is None or spec.loader is None:
+        raise ImportError(f"cannot load {path}")
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+    return module
+
+
+def _fail(message: str) -> None:
+    print(message, file=sys.stderr)
+    raise SystemExit(1)
+
+
+def _emit(response: httpx.Response) -> None:
+    if not response.content:
+        return
+    print(json.dumps(response.json(), ensure_ascii=False, indent=2))
+
+
+def _open_client() -> Client:
+    try:
+        url, apikey = load_profile()
+    except ConfigError as exc:
+        _fail(str(exc))
+    return Client(url, apikey)
+
+
+def _params_object(raw: str | None) -> dict[str, Any] | None:
+    if raw is None:
+        return None
+    payload = json.loads(raw)
+    if not isinstance(payload, dict):
+        _fail("--params must be a JSON object")
+    return payload
+
+
+def _list_params(args: argparse.Namespace) -> dict[str, Any]:
+    params: dict[str, Any] = {}
+    if args.page is not None:
+        params["page"] = args.page
+    if args.per_page is not None:
+        params["per_page"] = args.per_page
+    if args.filter is not None:
+        params["filter"] = args.filter
+    if args.sort_by is not None:
+        params["sort_by"] = args.sort_by
+    return params
+
+
+def _add_list_flags(parser: argparse.ArgumentParser) -> None:
+    parser.add_argument("--page", type=int)
+    parser.add_argument("--per_page", type=int)
+    parser.add_argument("--filter")
+    parser.add_argument("--sort_by")
+
+
+def _cmd_login(args: argparse.Namespace) -> None:
+    origin = origin_of(args.url)
+    with Client(origin, args.apikey) as client:
+        response = client.request("GET", "/users/me")
+    path = save_profile(origin, args.apikey)
+    _emit(response)
+    print(f"saved {path}", file=sys.stderr)
+
+
+def _cmd_users_list(args: argparse.Namespace) -> None:
+    with _open_client() as client:
+        _emit(client.request("GET", "/users", params=_list_params(args)))
+
+
+def _cmd_users_me(_args: argparse.Namespace) -> None:
+    with _open_client() as client:
+        _emit(client.request("GET", "/users/me"))
+
+
+def _cmd_templates_list(args: argparse.Namespace) -> None:
+    with _open_client() as client:
+        _emit(client.request("GET", "/mission_templates", params=_list_params(args)))
+
+
+def _cmd_templates_execute(args: argparse.Namespace) -> None:
+    body = _params_object(args.params)
+    if body is None:
+        body = {}
+    target = quote(args.id_or_code, safe="")
+    with _open_client() as client:
+        _emit(client.request("POST", f"/mission_templates/{target}/execute", json=body))
+
+
+def _cmd_robots_list(args: argparse.Namespace) -> None:
+    with _open_client() as client:
+        _emit(client.request("GET", "/robots", params=_list_params(args)))
+
+
+def _cmd_missions_list(args: argparse.Namespace) -> None:
+    with _open_client() as client:
+        _emit(client.request("GET", "/missions", params=_list_params(args)))
+
+
+def _cmd_missions_create(args: argparse.Namespace) -> None:
+    if args.template_id is not None:
+        body: dict[str, Any] = {"template_id": args.template_id}
+    else:
+        body = {"template_code": args.template_code}
+    params = _params_object(args.params)
+    if params is not None:
+        body["params"] = params
+    with _open_client() as client:
+        _emit(client.request("POST", "/missions", json=body))
+
+
+def _cmd_projects_list(args: argparse.Namespace) -> None:
+    with _open_client() as client:
+        _emit(client.request("GET", "/projects", params=_list_params(args)))
+
+
+def _cmd_projects_create(args: argparse.Namespace) -> None:
+    lif_path = args.lif_json.expanduser()
+    data = {"manufacturer": args.manufacturer, "project_version": args.project_version}
+    if args.description is not None:
+        data["description"] = args.description
+    params = {"synchronous": "true"} if args.synchronous else None
+    with _open_client() as client:
+        with lif_path.open("rb") as handle:
+            files = {"lif_json": (lif_path.name, handle, "application/json")}
+            _emit(client.request("POST", "/projects", params=params, data=data, files=files))
+
+
+def _cmd_projects_activate(args: argparse.Namespace) -> None:
+    with _open_client() as client:
+        _emit(client.request("POST", f"/projects/{args.id}/activate"))
+
+
+_TOOL_COMMANDS = {
+    "mrmap-to-raster": "mrmap-to-raster.py",
+    "mrmap-to-bg": "mrmap-to-bg.py",
+}
+
+
+def _add_tool(sub: argparse._SubParsersAction, name: str, help_text: str) -> None:
+    # The real argv is handled in main() before parse_args, so --help reaches the tool.
+    # The subparser exists so `awcs help` lists the command.
+    sub.add_parser(name, help=help_text)
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="awcs", description="AWCS API client")
+    sub = parser.add_subparsers(dest="command")
+
+    help_parser = sub.add_parser("help", help="Show this help")
+    help_parser.set_defaults(func=lambda _args: parser.print_help())
+
+    _add_tool(sub, "mrmap-to-raster", "Rasterize a .mrmap to PNG, GeoTIFF, and JSON")
+    _add_tool(sub, "mrmap-to-bg", "Set a .mrmap raster as a LIF layout background")
+
+    login = sub.add_parser("login", help="Check an API key and save the profile")
+    login.add_argument("--url", required=True, help="ARMS origin, for example https://dev.wcs.automacon.ru")
+    login.add_argument("--apikey", required=True)
+    login.set_defaults(func=_cmd_login)
+
+    users = sub.add_parser("users", help="Users")
+    users_sub = users.add_subparsers(dest="users_command", required=True)
+    users_list = users_sub.add_parser("list", help="GET /users")
+    _add_list_flags(users_list)
+    users_list.set_defaults(func=_cmd_users_list)
+    users_me = users_sub.add_parser("me", help="GET /users/me")
+    users_me.set_defaults(func=_cmd_users_me)
+
+    templates = sub.add_parser("mission_templates", help="Mission templates")
+    templates_sub = templates.add_subparsers(dest="mission_templates_command", required=True)
+    templates_list = templates_sub.add_parser("list", help="GET /mission_templates")
+    _add_list_flags(templates_list)
+    templates_list.set_defaults(func=_cmd_templates_list)
+    templates_execute = templates_sub.add_parser("execute", help="POST /mission_templates/{id}/execute")
+    templates_execute.add_argument("id_or_code", help="Numeric id or template code")
+    templates_execute.add_argument("--params", help="JSON object sent as the request body")
+    templates_execute.set_defaults(func=_cmd_templates_execute)
+
+    robots = sub.add_parser("robots", help="Robots")
+    robots_sub = robots.add_subparsers(dest="robots_command", required=True)
+    robots_list = robots_sub.add_parser("list", help="GET /robots")
+    _add_list_flags(robots_list)
+    robots_list.set_defaults(func=_cmd_robots_list)
+
+    missions = sub.add_parser("missions", help="Missions")
+    missions_sub = missions.add_subparsers(dest="missions_command", required=True)
+    missions_list = missions_sub.add_parser("list", help="GET /missions")
+    _add_list_flags(missions_list)
+    missions_list.set_defaults(func=_cmd_missions_list)
+    missions_create = missions_sub.add_parser("create", help="POST /missions")
+    template = missions_create.add_mutually_exclusive_group(required=True)
+    template.add_argument("--template_id", type=int)
+    template.add_argument("--template_code")
+    missions_create.add_argument("--params", help="JSON object stored in params")
+    missions_create.set_defaults(func=_cmd_missions_create)
+
+    projects = sub.add_parser("projects", help="Navigation projects")
+    projects_sub = projects.add_subparsers(dest="projects_command", required=True)
+    projects_list = projects_sub.add_parser("list", help="GET /projects")
+    _add_list_flags(projects_list)
+    projects_list.set_defaults(func=_cmd_projects_list)
+    projects_create = projects_sub.add_parser("create", help="POST /projects with a LIF file")
+    projects_create.add_argument("--lif_json", type=Path, required=True, help="Path to a .lif file")
+    projects_create.add_argument("--manufacturer", "-m", required=True)
+    projects_create.add_argument("--project_version", "--version", "-v", required=True, dest="project_version")
+    projects_create.add_argument("--description", "--desc", dest="description")
+    projects_create.add_argument("--synchronous", "--sync", action="store_true", dest="synchronous")
+    projects_create.set_defaults(func=_cmd_projects_create)
+    projects_activate = projects_sub.add_parser("activate", help="POST /projects/{id}/activate")
+    projects_activate.add_argument("id", type=int)
+    projects_activate.set_defaults(func=_cmd_projects_activate)
+
+    return parser
+
+
+def main(argv: list[str] | None = None) -> None:
+    args_list = list(sys.argv[1:] if argv is None else argv)
+    if args_list and args_list[0] in _TOOL_COMMANDS:
+        _load_tool(_TOOL_COMMANDS[args_list[0]]).main(args_list[1:])
+        return
+    parser = build_parser()
+    args = parser.parse_args(args_list)
+    func = getattr(args, "func", None)
+    if func is None:
+        parser.print_help()
+        return
+    try:
+        func(args)
+    except ApiError as exc:
+        _fail(exc.body or f"HTTP {exc.status_code}")
+    except ConfigError as exc:
+        _fail(str(exc))
+    except json.JSONDecodeError as exc:
+        _fail(f"invalid JSON: {exc}")
+    except httpx.HTTPError as exc:
+        _fail(str(exc))
+    except OSError as exc:
+        _fail(str(exc))
+
+
+if __name__ == "__main__":
+    main()