awcs-scripts 1.0.1__tar.gz → 1.1.0__tar.gz

awcs_scripts-1.1.0/.vscode/tasks.json

@@ -0,0 +1,42 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "release",
+      "type": "shell",
+      "command": "python",
+      "args": ["scripts/release.py", "${input:releasePart}"],
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared"
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "release (dry-run)",
+      "type": "shell",
+      "command": "python",
+      "args": ["scripts/release.py", "--dry-run"],
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared"
+      },
+      "problemMatcher": []
+    }
+  ],
+  "inputs": [
+    {
+      "id": "releasePart",
+      "type": "pickString",
+      "description": "Which part to bump",
+      "options": ["patch", "minor", "major"],
+      "default": "patch"
+    }
+  ]
+}

{awcs_scripts-1.0.1 → awcs_scripts-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: awcs-scripts
-Version: 1.0.1
+Version: 1.1.0
 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
@@ -17,25 +17,9 @@ Description-Content-Type: text/markdown
 
 Скрипты для карт 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
@@ -53,57 +37,112 @@ uvx --from git+https://gitlab.sprydev.ru/automacon/agv/wcs/awcs_scripts.git awcs
 uv tool install .
 ```
 
-После этого команда `awcs` доступна в системе. Для разработки в том же клоне:
+После этого команда `awcs` доступна в системе.
+
+Разовый запуск после публикации:
 
 ```
-uv sync
-uv run awcs help
-uv build
+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`, поставленную через `uv tool install` из клона или с PyPI:
+#### Основное
 
 ```
-uv tool uninstall awcs-scripts
+awcs help
+awcs version
 ```
 
-Профиль с адресом и ключом эта команда не трогает. Его файл лежит по `AWCS_CONFIG`, иначе `%APPDATA%\awcs\config.ini` на Windows и `~/.config/awcs/config.ini` в остальных системах. Чтобы убрать и ключ, удалите этот файл.
+#### Карты
+
+```
+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 mrmap-to-raster` пишет PNG, GeoTIFF и JSON. `--resolution` задаёт метры на пиксель, по умолчанию берётся `resolution_2d` из карты. `awcs mrmap-to-bg` подставляет этот растр в `backgroundImage` одного layout. Без `--output` исходный `.lif` перезаписывается.
 
-## Команды
+#### API
 
 ```
-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 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 create --lif_json path/to/layout.lif -m MAIRUI -v 1.0.0 [--desc "line 1"] [--sync]
+awcs projects upload --lif_json path/to/layout.lif -m MAIRUI -v 1.0.0 [--desc "line 1"] [--sync]
+awcs projects download
+awcs projects download 12 -o path/to/layout.lif
 awcs projects activate 12
 ```
 
-Разовый запуск после публикации:
+`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`. `awcs projects upload` делает то же самое. `awcs projects download` без id забирает активный проект (`GET /projects/active`), с id — этот проект, и сохраняет исходный LIF. `-o` задаёт файл или существующую папку; без него файл пишется в текущий каталог под именем вложения. Путь печатается в stdout.
+
+### Удаление
+
+Снимает команду `awcs`, поставленную через `uv tool install` из клона или с PyPI:
 
 ```
-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
+uv tool uninstall awcs-scripts
 ```
 
-`awcs mrmap-to-raster` пишет PNG, GeoTIFF и JSON. `--resolution` задаёт метры на пиксель, по умолчанию берётся `resolution_2d` из карты. `awcs mrmap-to-bg` подставляет этот растр в `backgroundImage` одного layout. Без `--output` исходный `.lif` перезаписывается.
+Профиль с адресом и ключом эта команда не трогает. Его файл лежит по `AWCS_CONFIG`, иначе `%APPDATA%\awcs\config.ini` на Windows и `~/.config/awcs/config.ini` в остальных системах. Чтобы убрать и ключ, удалите этот файл.
 
-`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`.
+### Публикация в PyPI
 
-## Разработка
+Выкладка происходит только по тегу `vX.Y.Z`. Обычный push и merge request пакет не публикуют: CI прогоняет тесты и собирает wheel. Как сменить номер версии — в разделе ниже.
+
+Токен в репозиторий не входит. Его нужно завести один раз:
+
+1. На [pypi.org](https://pypi.org) создать API-токен с правом загрузки. Для первой выкладки имя `awcs-scripts` должно быть свободно: проект создаётся при первой успешной загрузке. До этого нужен токен уровня аккаунта, после первой публикации его можно ограничить этим проектом.
+2. В GitLab, в CI/CD-переменных этого репозитория, добавить `UV_PUBLISH_TOKEN` со значением токена и включить **Masked**. **Protected** включать только если теги `v*` тоже protected: иначе на теге переменная в джобу не попадёт и `uv publish` упадёт без токена.
+
+Репозиторий закрытый, а `uv publish` пишет на публичный PyPI. После зелёного пайплайна wheel доступен по имени пакета.
+
+### Обновление версии
+
+Выпуск — одна команда из корня репозитория. По умолчанию она поднимает patch:
+
+```
+python scripts/release.py
+```
+
+`minor` и `major` передаются аргументом: `python scripts/release.py minor`. Команда берёт последний тег `vX.Y.Z`, при другом номере в `pyproject.toml` сначала записывает туда версию тега, затем выполняет `uv version --bump`. Тот же номер попадает в `__version__` в `src/awcs_scripts/__init__.py` и, если uv его перепишет, в `uv.lock`. Дальше идут коммит `Release X.Y.Z.`, тег `vX.Y.Z`, `git push origin HEAD` и `git push origin vX.Y.Z`.
+
+Посмотреть следующий номер:
+
+```
+python scripts/release.py --dry-run
+```
+
+В Cursor это задачи `release` и `release (dry-run)`: Command Palette → Tasks: Run Task. Команда выпускает из чистого дерева на ветке. Тег должен совпадать с `^v\d+\.\d+\.\d+$`: по нему джоба `publish` подставляет номер командой `uv version` и собирает wheel. PyPI не принимает повторную загрузку той же версии.
+
+Уже установленную команду обновляют после зелёного пайплайна тега:
+
+```
+uv tool upgrade awcs-scripts
+```
+
+### В клоне
+
+Для разработки в том же клоне:
+
+```
+uv sync
+uv run awcs help
+uv build
+```
 
 Карта живёт в `src/awcs_scripts/mrmap/`. Имена файлов совпадают с подкомандами: `mrmap-to-raster.py` и `mrmap-to-bg.py`. Будущие shell-скрипты кладутся в `bash/` и тоже вызываются только через `awcs`.

{awcs_scripts-1.0.1 → awcs_scripts-1.1.0}/README.md

@@ -2,25 +2,9 @@
 
 Скрипты для карт 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
@@ -38,57 +22,112 @@ uvx --from git+https://gitlab.sprydev.ru/automacon/agv/wcs/awcs_scripts.git awcs
 uv tool install .
 ```
 
-После этого команда `awcs` доступна в системе. Для разработки в том же клоне:
+После этого команда `awcs` доступна в системе.
+
+Разовый запуск после публикации:
 
 ```
-uv sync
-uv run awcs help
-uv build
+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`, поставленную через `uv tool install` из клона или с PyPI:
+#### Основное
 
 ```
-uv tool uninstall awcs-scripts
+awcs help
+awcs version
 ```
 
-Профиль с адресом и ключом эта команда не трогает. Его файл лежит по `AWCS_CONFIG`, иначе `%APPDATA%\awcs\config.ini` на Windows и `~/.config/awcs/config.ini` в остальных системах. Чтобы убрать и ключ, удалите этот файл.
+#### Карты
+
+```
+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 mrmap-to-raster` пишет PNG, GeoTIFF и JSON. `--resolution` задаёт метры на пиксель, по умолчанию берётся `resolution_2d` из карты. `awcs mrmap-to-bg` подставляет этот растр в `backgroundImage` одного layout. Без `--output` исходный `.lif` перезаписывается.
 
-## Команды
+#### API
 
 ```
-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 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 create --lif_json path/to/layout.lif -m MAIRUI -v 1.0.0 [--desc "line 1"] [--sync]
+awcs projects upload --lif_json path/to/layout.lif -m MAIRUI -v 1.0.0 [--desc "line 1"] [--sync]
+awcs projects download
+awcs projects download 12 -o path/to/layout.lif
 awcs projects activate 12
 ```
 
-Разовый запуск после публикации:
+`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`. `awcs projects upload` делает то же самое. `awcs projects download` без id забирает активный проект (`GET /projects/active`), с id — этот проект, и сохраняет исходный LIF. `-o` задаёт файл или существующую папку; без него файл пишется в текущий каталог под именем вложения. Путь печатается в stdout.
+
+### Удаление
+
+Снимает команду `awcs`, поставленную через `uv tool install` из клона или с PyPI:
 
 ```
-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
+uv tool uninstall awcs-scripts
 ```
 
-`awcs mrmap-to-raster` пишет PNG, GeoTIFF и JSON. `--resolution` задаёт метры на пиксель, по умолчанию берётся `resolution_2d` из карты. `awcs mrmap-to-bg` подставляет этот растр в `backgroundImage` одного layout. Без `--output` исходный `.lif` перезаписывается.
+Профиль с адресом и ключом эта команда не трогает. Его файл лежит по `AWCS_CONFIG`, иначе `%APPDATA%\awcs\config.ini` на Windows и `~/.config/awcs/config.ini` в остальных системах. Чтобы убрать и ключ, удалите этот файл.
 
-`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`.
+### Публикация в PyPI
 
-## Разработка
+Выкладка происходит только по тегу `vX.Y.Z`. Обычный push и merge request пакет не публикуют: CI прогоняет тесты и собирает wheel. Как сменить номер версии — в разделе ниже.
+
+Токен в репозиторий не входит. Его нужно завести один раз:
+
+1. На [pypi.org](https://pypi.org) создать API-токен с правом загрузки. Для первой выкладки имя `awcs-scripts` должно быть свободно: проект создаётся при первой успешной загрузке. До этого нужен токен уровня аккаунта, после первой публикации его можно ограничить этим проектом.
+2. В GitLab, в CI/CD-переменных этого репозитория, добавить `UV_PUBLISH_TOKEN` со значением токена и включить **Masked**. **Protected** включать только если теги `v*` тоже protected: иначе на теге переменная в джобу не попадёт и `uv publish` упадёт без токена.
+
+Репозиторий закрытый, а `uv publish` пишет на публичный PyPI. После зелёного пайплайна wheel доступен по имени пакета.
+
+### Обновление версии
+
+Выпуск — одна команда из корня репозитория. По умолчанию она поднимает patch:
+
+```
+python scripts/release.py
+```
+
+`minor` и `major` передаются аргументом: `python scripts/release.py minor`. Команда берёт последний тег `vX.Y.Z`, при другом номере в `pyproject.toml` сначала записывает туда версию тега, затем выполняет `uv version --bump`. Тот же номер попадает в `__version__` в `src/awcs_scripts/__init__.py` и, если uv его перепишет, в `uv.lock`. Дальше идут коммит `Release X.Y.Z.`, тег `vX.Y.Z`, `git push origin HEAD` и `git push origin vX.Y.Z`.
+
+Посмотреть следующий номер:
+
+```
+python scripts/release.py --dry-run
+```
+
+В Cursor это задачи `release` и `release (dry-run)`: Command Palette → Tasks: Run Task. Команда выпускает из чистого дерева на ветке. Тег должен совпадать с `^v\d+\.\d+\.\d+$`: по нему джоба `publish` подставляет номер командой `uv version` и собирает wheel. PyPI не принимает повторную загрузку той же версии.
+
+Уже установленную команду обновляют после зелёного пайплайна тега:
+
+```
+uv tool upgrade awcs-scripts
+```
+
+### В клоне
+
+Для разработки в том же клоне:
+
+```
+uv sync
+uv run awcs help
+uv build
+```
 
 Карта живёт в `src/awcs_scripts/mrmap/`. Имена файлов совпадают с подкомандами: `mrmap-to-raster.py` и `mrmap-to-bg.py`. Будущие shell-скрипты кладутся в `bash/` и тоже вызываются только через `awcs`.

{awcs_scripts-1.0.1 → awcs_scripts-1.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "awcs-scripts"
-version = "1.0.1"
+version = "1.1.0"
 description = "Command line scripts for WCS maps and the ARMS API"
 readme = "README.md"
 requires-python = ">=3.10"

awcs_scripts-1.1.0/scripts/release.py

@@ -0,0 +1,141 @@
+"""Bump the package version, commit it, tag vX.Y.Z, and push the branch and tag."""
+
+from __future__ import annotations
+
+import argparse
+import re
+import subprocess
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+PYPROJECT = ROOT / "pyproject.toml"
+INIT = ROOT / "src" / "awcs_scripts" / "__init__.py"
+VERSION_FILES = (
+    "pyproject.toml",
+    "src/awcs_scripts/__init__.py",
+    "uv.lock",
+)
+TAG = re.compile(r"^v(\d+)\.(\d+)\.(\d+)$")
+PARTS = ("major", "minor", "patch")
+
+
+def _fail(message: str) -> None:
+    print(message, file=sys.stderr)
+    raise SystemExit(1)
+
+
+def _run(cmd: list[str]) -> subprocess.CompletedProcess[str]:
+    result = subprocess.run(cmd, cwd=ROOT, text=True, capture_output=True, check=False)
+    if result.returncode != 0:
+        detail = (result.stderr or result.stdout).strip()
+        _fail(detail or f"command failed: {' '.join(cmd)}")
+    return result
+
+
+def _git(*args: str) -> str:
+    return _run(["git", *args]).stdout.strip()
+
+
+def _pyproject_version() -> str:
+    text = PYPROJECT.read_text(encoding="utf-8")
+    match = re.search(r'(?m)^version = "(\d+\.\d+\.\d+)"\s*$', text)
+    if match is None:
+        _fail("version in pyproject.toml is not X.Y.Z")
+    return match.group(1)
+
+
+def _latest_tag_version() -> str | None:
+    for line in _git("tag", "-l", "--sort=-v:refname").splitlines():
+        if TAG.fullmatch(line.strip()):
+            return line.strip()[1:]
+    return None
+
+
+def _bump(version: str, part: str) -> str:
+    major, minor, patch = (int(piece) for piece in version.split("."))
+    if part == "major":
+        return f"{major + 1}.0.0"
+    if part == "minor":
+        return f"{major}.{minor + 1}.0"
+    return f"{major}.{minor}.{patch + 1}"
+
+
+def _status_paths() -> list[str]:
+    # Keep the leading space in porcelain lines. strip() would turn
+    # " M pyproject.toml" into "M pyproject.toml" and drop the first letter.
+    paths: list[str] = []
+    for line in _run(["git", "status", "--porcelain"]).stdout.splitlines():
+        path = line[3:]
+        if " -> " in path:
+            path = path.split(" -> ", 1)[1]
+        paths.append(path.strip().strip('"'))
+    return paths
+
+
+def _require_branch() -> None:
+    if _git("rev-parse", "--abbrev-ref", "HEAD") == "HEAD":
+        _fail("HEAD is detached; checkout a branch before releasing")
+
+
+def _require_clean() -> None:
+    if _status_paths():
+        _fail("working tree is not clean; commit other changes before releasing")
+
+
+def _write_version(version: str) -> None:
+    with INIT.open(encoding="utf-8", newline="") as handle:
+        text = handle.read()
+    updated, count = re.subn(
+        r'^__version__ = "[^"]*"',
+        f'__version__ = "{version}"',
+        text,
+        count=1,
+        flags=re.M,
+    )
+    if count != 1:
+        _fail("__version__ not found in src/awcs_scripts/__init__.py")
+    with INIT.open("w", encoding="utf-8", newline="") as handle:
+        handle.write(updated)
+
+
+def main(argv: list[str] | None = None) -> None:
+    parser = argparse.ArgumentParser(description="Bump, tag, and push a release.")
+    parser.add_argument("part", nargs="?", default="patch", choices=PARTS)
+    parser.add_argument("--dry-run", action="store_true", help="Print the next version and write nothing")
+    args = parser.parse_args(argv)
+
+    base = _latest_tag_version() or _pyproject_version()
+    version = _bump(base, args.part)
+    if args.dry_run:
+        print(version)
+        return
+
+    _require_branch()
+    _require_clean()
+    if _git("tag", "-l", f"v{version}"):
+        _fail(f"tag v{version} already exists")
+
+    if _pyproject_version() != base:
+        _run(["uv", "version", base, "--no-sync"])
+    bumped = _run(["uv", "version", "--bump", args.part, "--short", "--no-sync"]).stdout.strip()
+    if bumped != version:
+        _fail(f"uv version returned {bumped}, expected {version}")
+    _write_version(version)
+
+    unexpected = [path for path in _status_paths() if path not in VERSION_FILES]
+    if unexpected:
+        _fail("unexpected changes: " + ", ".join(unexpected))
+    if not _status_paths():
+        _fail("version did not change")
+
+    _run(["git", "add", "--", *VERSION_FILES])
+    _run(["git", "commit", "-m", f"Release {version}."])
+    _run(["git", "tag", f"v{version}"])
+    _run(["git", "push", "origin", "HEAD"])
+    _run(["git", "push", "origin", f"v{version}"])
+    print(f"v{version}")
+
+
+if __name__ == "__main__":
+    main()

{awcs_scripts-1.0.1 → awcs_scripts-1.1.0}/src/awcs_scripts/__init__.py

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

{awcs_scripts-1.0.1 → awcs_scripts-1.1.0}/src/awcs_scripts/api.py

@@ -24,6 +24,13 @@ def origin_of(url: str) -> str:
     return value
 
 
+def _strip_api_prefix(path: str) -> str:
+    """Drop a leading /api/v1 so the client base URL does not double it."""
+    if path.startswith(_API_PREFIX + "/"):
+        return path[len(_API_PREFIX) :]
+    return path
+
+
 class Client:
     def __init__(
         self,
@@ -64,3 +71,30 @@ class Client:
         if response.status_code >= 400:
             raise ApiError(response.status_code, response.text)
         return response
+
+    def get(self, url_or_path: str) -> httpx.Response:
+        """GET an API path or an absolute URL.
+
+        A leading /api/v1 is removed so the client base URL does not double it.
+        An absolute URL on this origin is sent with the API key. An absolute URL
+        on another host is fetched without the key.
+        """
+        if url_or_path.startswith(("http://", "https://")):
+            return self._get_absolute(url_or_path)
+        return self.request("GET", _strip_api_prefix(url_or_path))
+
+    def _get_absolute(self, url: str) -> httpx.Response:
+        target = httpx.URL(url)
+        origin = httpx.URL(self.origin)
+        same_origin = (
+            target.scheme == origin.scheme
+            and target.host == origin.host
+            and target.port == origin.port
+        )
+        if not same_origin:
+            response = httpx.get(url, timeout=self._client.timeout, follow_redirects=True)
+            if response.status_code >= 400:
+                raise ApiError(response.status_code, response.text)
+            return response
+        params = dict(target.params) or None
+        return self.request("GET", _strip_api_prefix(target.path), params=params)

{awcs_scripts-1.0.1 → awcs_scripts-1.1.0}/src/awcs_scripts/cli.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import argparse
+import importlib.metadata
 import importlib.util
 import json
 import sys
@@ -28,6 +29,10 @@ def _load_tool(filename: str):
     return module
 
 
+def _cmd_version(_args: argparse.Namespace) -> None:
+    print(importlib.metadata.version("awcs-scripts"))
+
+
 def _fail(message: str) -> None:
     print(message, file=sys.stderr)
     raise SystemExit(1)
@@ -153,6 +158,45 @@ def _cmd_projects_activate(args: argparse.Namespace) -> None:
         _emit(client.request("POST", f"/projects/{args.id}/activate"))
 
 
+def _download_name(source: dict[str, Any], project_id: object) -> str:
+    raw = str(source.get("filename") or "").replace("\\", "/")
+    name = Path(raw).name
+    if name and name not in {".", ".."}:
+        return name
+    return f"project-{project_id}.lif"
+
+
+def _download_destination(output: Path | None, filename: str) -> Path:
+    if output is None:
+        return Path(filename)
+    output = output.expanduser()
+    if output.is_dir():
+        return output / filename
+    return output
+
+
+def _cmd_projects_download(args: argparse.Namespace) -> None:
+    with _open_client() as client:
+        if args.id is None:
+            project = client.request("GET", "/projects/active").json()
+        else:
+            project = client.request("GET", f"/projects/{args.id}").json()
+        source = project.get("source") if isinstance(project, dict) else None
+        if not isinstance(source, dict):
+            source = {}
+        download_url = source.get("download_url")
+        if not download_url:
+            attachment_id = source.get("id")
+            if not attachment_id:
+                _fail("project has no map file")
+            download_url = f"/attachments/{attachment_id}/download"
+        response = client.get(str(download_url))
+    project_id = project.get("id", args.id) if isinstance(project, dict) else args.id
+    dest = _download_destination(args.output, _download_name(source, project_id))
+    dest.write_bytes(response.content)
+    print(dest)
+
+
 _TOOL_COMMANDS = {
     "mrmap-to-raster": "mrmap-to-raster.py",
     "mrmap-to-bg": "mrmap-to-bg.py",
@@ -172,6 +216,9 @@ def build_parser() -> argparse.ArgumentParser:
     help_parser = sub.add_parser("help", help="Show this help")
     help_parser.set_defaults(func=lambda _args: parser.print_help())
 
+    version_parser = sub.add_parser("version", help="Print the package version")
+    version_parser.set_defaults(func=_cmd_version)
+
     _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")
 
@@ -221,13 +268,24 @@ def build_parser() -> argparse.ArgumentParser:
     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 = projects_sub.add_parser(
+        "create",
+        aliases=["upload"],
+        help="POST /projects with a LIF file (alias: upload)",
+    )
     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_download = projects_sub.add_parser(
+        "download",
+        help="Save a project LIF file; the active project when id is omitted",
+    )
+    projects_download.add_argument("id", type=int, nargs="?", help="Project id; omit to download the active project")
+    projects_download.add_argument("--output", "-o", type=Path, help="Output file, or an existing directory")
+    projects_download.set_defaults(func=_cmd_projects_download)
     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)

{awcs_scripts-1.0.1 → awcs_scripts-1.1.0}/tests/test_api.py

@@ -7,6 +7,8 @@ from awcs_scripts.api import Client, origin_of
 from awcs_scripts.cli import main
 from awcs_scripts.config import load_profile
 
+_LIF = b'{"layouts":[]}'
+
 
 def test_origin_strips_api_prefix():
     assert origin_of("https://dev.wcs.automacon.ru/") == "https://dev.wcs.automacon.ru"
@@ -100,7 +102,8 @@ def test_template_execute_body(tmp_path, monkeypatch):
     assert seen["body"] == {"zone": "A"}
 
 
-def test_projects_create_and_activate(tmp_path, monkeypatch):
+@pytest.mark.parametrize("command", ["create", "upload"])
+def test_projects_create_and_activate(tmp_path, monkeypatch, command):
     _profile(tmp_path, monkeypatch)
     lif = tmp_path / "layout.lif"
     lif.write_text("{}", encoding="utf-8")
@@ -113,7 +116,7 @@ def test_projects_create_and_activate(tmp_path, monkeypatch):
     _install(monkeypatch, handler)
     main([
         "projects",
-        "create",
+        command,
         "--lif_json",
         str(lif),
         "-m",
@@ -143,6 +146,91 @@ def test_projects_create_and_activate(tmp_path, monkeypatch):
     assert seen[1].url.path == "/api/v1/projects/12/activate"
 
 
+def test_projects_download_active_uses_source_filename(tmp_path, monkeypatch, capsys):
+    _profile(tmp_path, monkeypatch)
+    monkeypatch.chdir(tmp_path)
+    seen = []
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        seen.append(request.url.path)
+        if request.url.path == "/api/v1/projects/active":
+            return httpx.Response(200, json={
+                "id": 4,
+                "source": {
+                    "id": 9,
+                    "filename": "nested/line.lif",
+                    "download_url": "/api/v1/attachments/9/download",
+                },
+            })
+        assert request.headers["x-api-key"] == "secret-key"
+        return httpx.Response(200, content=_LIF)
+
+    _install(monkeypatch, handler)
+    main(["projects", "download"])
+    assert seen == ["/api/v1/projects/active", "/api/v1/attachments/9/download"]
+    assert (tmp_path / "line.lif").read_bytes() == _LIF
+    assert capsys.readouterr().out.strip() == "line.lif"
+
+
+def test_projects_download_id_to_output(tmp_path, monkeypatch, capsys):
+    _profile(tmp_path, monkeypatch)
+    dest = tmp_path / "saved.lif"
+    folder = tmp_path / "maps"
+    folder.mkdir()
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        if request.url.path == "/api/v1/projects/12":
+            return httpx.Response(200, json={
+                "id": 12,
+                "source": {"id": 3, "filename": "layout.lif"},
+            })
+        assert request.url.path == "/api/v1/attachments/3/download"
+        return httpx.Response(200, content=_LIF)
+
+    _install(monkeypatch, handler)
+    main(["projects", "download", "12", "-o", str(dest)])
+    assert dest.read_bytes() == _LIF
+    assert capsys.readouterr().out.strip() == str(dest)
+
+    main(["projects", "download", "12", "-o", str(folder)])
+    assert (folder / "layout.lif").read_bytes() == _LIF
+
+
+def test_projects_download_without_source_fails(tmp_path, monkeypatch):
+    _profile(tmp_path, monkeypatch)
+    _install(monkeypatch, lambda request: httpx.Response(200, json={"id": 1, "source": None}))
+    with pytest.raises(SystemExit) as caught:
+        main(["projects", "download", "1"])
+    assert caught.value.code == 1
+
+
+def test_client_get_same_origin_keeps_query():
+    def handler(request: httpx.Request) -> httpx.Response:
+        assert request.url.path == "/api/v1/attachments/9/download"
+        assert request.url.params["x"] == "1"
+        assert request.headers["x-api-key"] == "secret-key"
+        return httpx.Response(200, content=_LIF)
+
+    with Client("https://dev.wcs.automacon.ru", "secret-key", transport=httpx.MockTransport(handler)) as client:
+        response = client.get("https://dev.wcs.automacon.ru/api/v1/attachments/9/download?x=1")
+    assert response.content == _LIF
+
+
+def test_client_get_external_omits_api_key(monkeypatch):
+    seen = {}
+
+    def fake_get(url, **kwargs):
+        seen["url"] = url
+        seen["headers"] = kwargs.get("headers")
+        return httpx.Response(200, content=_LIF)
+
+    monkeypatch.setattr("awcs_scripts.api.httpx.get", fake_get)
+    with Client("https://dev.wcs.automacon.ru", "secret-key") as client:
+        response = client.get("https://files.example/map.lif")
+    assert response.content == _LIF
+    assert seen == {"url": "https://files.example/map.lif", "headers": None}
+
+
 def _profile(tmp_path, monkeypatch):
     config = tmp_path / "config.ini"
     config.write_text("[default]\nurl = https://dev.wcs.automacon.ru\napikey = secret-key\n", encoding="utf-8")

{awcs_scripts-1.0.1 → awcs_scripts-1.1.0}/tests/test_cli.py

@@ -1,3 +1,5 @@
+import importlib.metadata
+
 import pytest
 
 from awcs_scripts.cli import main
@@ -10,6 +12,13 @@ def test_help_lists_commands(capsys):
     assert "mrmap-to-bg" in text
     assert "projects" in text
     assert "login" in text
+    assert "version" in text
+
+
+def test_version(capsys):
+    main(["version"])
+    text = capsys.readouterr().out.strip()
+    assert text == importlib.metadata.version("awcs-scripts")
 
 
 def test_help_command(capsys):
@@ -17,6 +26,7 @@ def test_help_command(capsys):
     text = capsys.readouterr().out
     assert "mission_templates" in text
     assert "users" in text
+    assert "version" in text
 
 
 def test_raster_help():

{awcs_scripts-1.0.1 → awcs_scripts-1.1.0}/uv.lock

@@ -23,7 +23,7 @@ wheels = [
 
 [[package]]
 name = "awcs-scripts"
-version = "1.0.1"
+version = "1.1.0"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },