seaf-helper-tools 0.1.0__tar.gz

seaf_helper_tools-0.1.0/LICENSE

@@ -0,0 +1,15 @@
+seaf-helper-tools — CLI tools for working with SEAF assessment data
+Copyright (C) 2024  Alexandr Latushkin
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.

seaf_helper_tools-0.1.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: seaf-helper-tools
+Version: 0.1.0
+Summary: CLI tools for working with SEAF assessment data: YAML/XLS conversion, standards surveys, remote NSI sources.
+Author: Alexandr Latushkin
+License: seaf-helper-tools — CLI tools for working with SEAF assessment data
+        Copyright (C) 2024  Alexandr Latushkin
+        
+        This program is free software: you can redistribute it and/or modify
+        it under the terms of the GNU General Public License as published by
+        the Free Software Foundation, either version 3 of the License, or
+        (at your option) any later version.
+        
+        This program is distributed in the hope that it will be useful,
+        but WITHOUT ANY WARRANTY; without even the implied warranty of
+        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+        GNU General Public License for more details.
+        
+        You should have received a copy of the GNU General Public License
+        along with this program.  If not, see <https://www.gnu.org/licenses/>.
+        
+Project-URL: Repository, https://gitverse.ru/alex314/helper_commands
+Keywords: seaf,assessment,yaml,xls,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: ruamel.yaml>=0.18
+Requires-Dist: requests>=2.31
+Requires-Dist: urllib3>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# seaf-helper-tools
+
+CLI-инструменты для работы с данными SEAF: конвертация анкет объектов оценки между форматами YAML и XLS, поддержка удалённых источников НСИ через JSONata API.
+
+## Установка
+
+```bash
+pip install seaf-helper-tools
+```
+
+## Команды
+
+| Команда | Описание |
+|---------|----------|
+| `survey-standards-yaml2xls` | Конвертировать YAML-анкету объекта оценки в XLS |
+| `survey-standards-xls2yaml` | Конвертировать XLS-анкету обратно в YAML |
+
+### Примеры
+
+```bash
+# Сгенерировать XLS из YAML
+seaf-helper-tools survey-standards-yaml2xls input.yaml output.xlsx --template template.xlsx
+
+# Конвертировать XLS обратно в YAML
+seaf-helper-tools survey-standards-xls2yaml input.xlsx output.yaml
+
+# С конфигурационным файлом (для подключения к API)
+seaf-helper-tools --config config.yaml survey-standards-yaml2xls input.yaml output.xlsx
+```
+
+## Конфигурация
+
+Для подключения к удалённому API NSI создайте `config.yaml` по образцу `config.example.yaml`:
+
+```yaml
+api:
+  url: https://your-seaf-instance/api
+  cert: /path/to/client.crt
+  key: /path/to/client.key
+```
+
+## Разработка
+
+```bash
+git clone https://gitverse.ru/alex314/helper_commands
+cd seaf-helper-tools
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+
+pytest -v
+ruff check .
+mypy src/
+```
+
+## Лицензия
+
+GPL-3.0 — см. [LICENSE](LICENSE).

seaf_helper_tools-0.1.0/README.md

@@ -0,0 +1,57 @@
+# seaf-helper-tools
+
+CLI-инструменты для работы с данными SEAF: конвертация анкет объектов оценки между форматами YAML и XLS, поддержка удалённых источников НСИ через JSONata API.
+
+## Установка
+
+```bash
+pip install seaf-helper-tools
+```
+
+## Команды
+
+| Команда | Описание |
+|---------|----------|
+| `survey-standards-yaml2xls` | Конвертировать YAML-анкету объекта оценки в XLS |
+| `survey-standards-xls2yaml` | Конвертировать XLS-анкету обратно в YAML |
+
+### Примеры
+
+```bash
+# Сгенерировать XLS из YAML
+seaf-helper-tools survey-standards-yaml2xls input.yaml output.xlsx --template template.xlsx
+
+# Конвертировать XLS обратно в YAML
+seaf-helper-tools survey-standards-xls2yaml input.xlsx output.yaml
+
+# С конфигурационным файлом (для подключения к API)
+seaf-helper-tools --config config.yaml survey-standards-yaml2xls input.yaml output.xlsx
+```
+
+## Конфигурация
+
+Для подключения к удалённому API NSI создайте `config.yaml` по образцу `config.example.yaml`:
+
+```yaml
+api:
+  url: https://your-seaf-instance/api
+  cert: /path/to/client.crt
+  key: /path/to/client.key
+```
+
+## Разработка
+
+```bash
+git clone https://gitverse.ru/alex314/helper_commands
+cd seaf-helper-tools
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+
+pytest -v
+ruff check .
+mypy src/
+```
+
+## Лицензия
+
+GPL-3.0 — см. [LICENSE](LICENSE).

seaf_helper_tools-0.1.0/pyproject.toml

@@ -0,0 +1,77 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "seaf-helper-tools"
+version = "0.1.0"
+description = "CLI tools for working with SEAF assessment data: YAML/XLS conversion, standards surveys, remote NSI sources."
+readme = "README.md"
+requires-python = ">=3.11"
+license = {file = "LICENSE"}
+authors = [
+    {name = "Alexandr Latushkin"}
+]
+keywords = ["seaf", "assessment", "yaml", "xls", "cli"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+    "Environment :: Console",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "typer>=0.9.0",
+    "rich>=13.0",
+    "openpyxl>=3.1",
+    "ruamel.yaml>=0.18",
+    "requests>=2.31",
+    "urllib3>=2.0",
+]
+
+[project.urls]
+Repository = "https://gitverse.ru/alex314/helper_commands"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+    "pytest-asyncio>=0.23",
+    "ruff>=0.1.0",
+    "mypy>=1.0",
+    "build>=1.0",
+    "twine>=5.0",
+]
+
+[project.scripts]
+seaf-helper-tools = "helper_commands.cli:app"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "UP"]
+ignore = [
+    "B008",  # typer.Argument/Option in defaults is standard Typer pattern
+    "E501",  # line length — long Russian strings are unavoidable
+]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_return_any = true
+warn_unused_ignores = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-v --cov=src/helper_commands"
+asyncio_mode = "auto"

seaf_helper_tools-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

seaf_helper_tools-0.1.0/src/helper_commands/__init__.py

@@ -0,0 +1,3 @@
+"""seaf-helper-tools — CLI tools for working with SEAF assessment data."""
+
+__version__ = "0.1.0"

seaf_helper_tools-0.1.0/src/helper_commands/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for `python -m helper_commands`."""
+
+from helper_commands.cli import app
+
+if __name__ == "__main__":
+    app()

seaf_helper_tools-0.1.0/src/helper_commands/cli.py

@@ -0,0 +1,39 @@
+"""CLI entry point."""
+
+from pathlib import Path
+
+import typer
+from rich.console import Console
+
+from helper_commands.commands.assessment_xls2yaml import app as xls2yaml_app
+from helper_commands.commands.assessment_yaml2xls import app as yaml2xls_app
+
+app = typer.Typer(help="helper-commands — инструменты для работы с данными оценок")
+console = Console()
+
+
+@app.callback()
+def main(
+    config: Path | None = typer.Option(
+        None,
+        "--config",
+        "-c",
+        help="Путь к YAML-файлу конфигурации",
+        exists=True,
+        dir_okay=False,
+        resolve_path=True,
+    ),
+) -> None:
+    """helper-commands — инструменты для работы с данными оценок."""
+    if config is not None:
+        from helper_commands.core.config import load_config
+
+        load_config(config)
+        console.print(f"[dim]Конфигурация загружена: {config}[/dim]")
+
+
+app.add_typer(yaml2xls_app)
+app.add_typer(xls2yaml_app)
+
+if __name__ == "__main__":
+    app()