onec-interactive-runtime-core 0.1.22__tar.gz → 0.1.23__tar.gz

{onec_interactive_runtime_core-0.1.22 → onec_interactive_runtime_core-0.1.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: onec-interactive-runtime-core
-Version: 0.1.22
+Version: 0.1.23
 License-Expression: GPL-3.0-only AND MIT
 License-File: COPYRIGHT
 License-File: LICENSE

{onec_interactive_runtime_core-0.1.22 → onec_interactive_runtime_core-0.1.23}/README.md

@@ -8,14 +8,14 @@
 
 Нужны Windows, Python 3.12+, VS Code 1.136+, установленная платформа 1С, **отдельная копия ИБ** и локальная копия выгрузки исходников той же конфигурации. По умолчанию runtime устанавливает в ИБ служебное расширение. Демо проверены на платформе **8.5.1.1529**: ЗУП — с **ЗУП КОРП 3.1.38.92** и снимком данных от **01.08.2021**, УТ — с **УТ 11.6.1.61** (дата данных определяется из ИБ). Платформа, демобазы и выгрузки в пакет не входят.
 
-Скачайте **Source code (zip)** и `bsl-notebook-0.1.5.vsix` из [релиза v0.1.22](https://github.com/pulh1/bsl-jupyter-runtime/releases/tag/v0.1.22). В архиве исходников находятся `notebooks/demo`, а VSIX отвечает за подсказки BSL в редакторе. Python-пакеты версии 0.1.22 устанавливаются из PyPI.
+Скачайте **Source code (zip)** и `bsl-notebook-0.1.5.vsix` из [релиза v0.1.23](https://github.com/pulh1/bsl-jupyter-runtime/releases/tag/v0.1.23). В архиве исходников находятся `notebooks/demo`, а VSIX отвечает за подсказки BSL в редакторе. Python-пакеты версии 0.1.23 устанавливаются из PyPI.
 
 В PowerShell из папки распакованного проекта создайте окружение, установите пакет и зарегистрируйте kernel:
 
 ```powershell
 py -3.12 -m venv .venv
 $python = ".\.venv\Scripts\python.exe"
-& $python -m pip install "onec-interactive-jupyter==0.1.22" "ipykernel>=6.29,<7" "matplotlib>=3.11,<4"
+& $python -m pip install "onec-interactive-jupyter==0.1.23" "ipykernel>=6.29,<7" "matplotlib>=3.11,<4"
 & $python -m ipykernel install --user --name onec-bsl --display-name "1C BSL"
 ```
 
@@ -102,3 +102,7 @@ uv run python -m pytest tests/unit -q
 Проверки генератора парсера используют включённый в репозиторий [тестовый исходник](tests/fixtures/parsergen/README.md). Архитектура описана [отдельно](docs/architecture/2026-08-12-canonical-runtime-architecture.md).
 
 Собственный код распространяется по `GPL-3.0-only`; лицензии и уведомления сторонних компонентов находятся в [LICENSE](LICENSE) и [THIRD_PARTY_NOTICES.txt](THIRD_PARTY_NOTICES.txt).
+
+## Статья на ![лого Инфостарт](https://infostart.ru/bitrix/templates/sandbox_empty/assets/tpl/abo/img/logo.svg)
+
+[Открыть статью о проекте](https://infostart.ru/1c/tools/2789187/).

{onec_interactive_runtime_core-0.1.22 → onec_interactive_runtime_core-0.1.23}/notebooks/demo/README.md

@@ -1,10 +1,10 @@
 # Демо Jupyter для ЗУП КОРП и УТ
 
-[ZUP/01-overview.ipynb](ZUP/01-overview.ipynb) ведёт от `Привет, мир!` и состояния между BSL-ячейками к типовым данным ЗУП, pandas, материализации документа, hot reload и остановленному проведению `ПриемаНаРаботу`. В финале он проверяет значение оклада в регистре периодических показателей и показывает плановый ФОТ. [ZUP/03-capture.ipynb](ZUP/03-capture.ipynb) отдельно исследует временную таблицу и стек вызовов между двумя точками останова, затем меняет локальный запрос только в одном вызове. Каждый notebook запускается сверху вниз в отдельном kernel.
+[ZUP/01-overview.ipynb](ZUP/01-overview.ipynb) ведёт от `Привет, мир!` и состояния между BSL-ячейками к типовым данным ЗУП, pandas, hot reload и остановленному проведению `ПриемаНаРаботу`. В финале он проверяет значение оклада в регистре периодических показателей и показывает плановый ФОТ. [ZUP/03-capture.ipynb](ZUP/03-capture.ipynb) отдельно исследует временную таблицу и стек вызовов между двумя точками останова, затем меняет локальный запрос только в одном вызове. Каждый notebook запускается сверху вниз в отдельном kernel.
 
-[UT/05-ut-sales.ipynb](UT/05-ut-sales.ipynb) — отдельный сценарий для **УТ 11.6.1.61**: сравнение месячной выручки из регистра «Выручка и себестоимость продаж», диаграммы по подразделениям, останов внутри типовой функции `ПродажиСервер.ПроцентПрироста` и hot reload её локальной копии. Период определяется по последнему активному движению выручки в выбранной ИБ; дата её данных заранее не предполагается. Метаданные и оба запроса сверены через EDT. 14.09.2026 все ячейки выполнены на временной копии файловой ИБ, включая hot reload; обе диаграммы проверены.
+[UT/05-ut-sales.ipynb](UT/05-ut-sales.ipynb) — отдельный сценарий для **УТ 11.6.1.61**: сравнение месячной выручки из регистра «Выручка и себестоимость продаж», диаграммы по подразделениям, вызов типовой функции `ПродажиСервер.ПроцентПрироста` и hot reload её локальной копии. Период определяется по последнему активному движению выручки в выбранной ИБ; дата её данных заранее не предполагается.
 
-Сценарии ЗУП рассчитаны на выделенную демобазу **ЗУП КОРП 3.1.38.92**, платформу **8.5.1.1529** и выгрузку исходников этой же конфигурации. Дата данных в примерах — **01.08.2021**; это не номер релиза. 14.09.2026 все ячейки текущих `01-overview` и `03-capture` выполнены на независимых временных файловых копиях ИБ с пакетом 0.1.19 из PyPI, включая hot reload, остановы и повторное проведение документа в обзоре. Результаты выполнения остаются локальными и не входят в репозиторий.
+Сценарии ЗУП рассчитаны на выделенную демобазу **ЗУП КОРП 3.1.38.92**, платформу **8.5.1.1529** и выгрузку исходников этой же конфигурации. Дата данных в примерах — **01.08.2021**; это не номер релиза. `03-capture` проходил живой прогон 14.09.2026 на временной файловой ИБ с пакетом 0.1.19. Обновлённые `01-overview` и `05-ut-sales` после переноса из авторских ноутбуков проверены статически; живой прогон для них не выполнялся. Результаты выполнения остаются локальными и не входят в репозиторий.
 
 Для установки из PyPI и запуска в VS Code используйте [«Быстрый старт»](../../README.md). Для работы с исходниками проекта и JupyterLab из корня репозитория установите окружение и зарегистрируйте kernel:
 

{onec_interactive_runtime_core-0.1.22 → onec_interactive_runtime_core-0.1.23}/notebooks/demo/UT/05-ut-sales.ipynb

@@ -5,11 +5,13 @@
    "id": "05-ut-sales-00",
    "metadata": {},
    "source": [
-    "# Продажи УТ: выручка, capture и hot reload\n",
+    "# Продажи УТ: исследуем данные и типовую логику интерактивно\n",
     "\n",
-    "Найдём последний месяц с выручкой и предыдущий календарный месяц, сравним обороты по подразделениям, остановим расчёт прироста и изменим его через hot reload.\n",
+    "Этот notebook дополняет обзорный сценарий ЗУП и показывает, что подход не привязан к одной конфигурации или предметной области.\n",
     "\n",
-    "Метаданные сверены с УТ 11.6.1.61; дата данных ИБ не фиксируется. Используйте отдельную демо-копию и соответствующую ей выгрузку исходников. Подготовка окружения — в [README](../README.md). Сеанс закрывается последней ячейкой; при прерывании выполните `runtime.close()`."
+    "На УТ 11.6.1.61 мы найдём последний месяц с данными и предыдущий календарный, сравним выручку в pandas, вызовем типовую функцию расчёта прироста и проверим альтернативную трактовку через hot reload.\n",
+    "\n",
+    "Здесь меньше деталей API: цель — компактный независимый end-to-end пример на другой конфигурации."
    ]
   },
   {
@@ -19,7 +21,9 @@
    "source": [
     "## Подготовка\n",
     "\n",
-    "Укажите `PLATFORM_BIN`, `CONNECTION_STRING` и `SOURCE_ROOT` для отдельной копии УТ 11.6.1.61. В `SOURCE_ROOT` нужна выгрузка исходников этой же конфигурации. Если в ИБ есть пользователи, задайте `username` и `password` в `RuntimeConfig` локально."
+    "Укажите `PLATFORM_BIN`, `CONNECTION_STRING` и `SOURCE_ROOT` для отдельной копии УТ 11.6.1.61. В `SOURCE_ROOT` нужна выгрузка исходников этой же конфигурации.\n",
+    "\n",
+    "Как и в ЗУП-сценарии, одна стартовая ячейка открывает сеанс 1С, а дальнейшие BSL- и Python-ячейки работают с общим состоянием."
    ]
   },
   {
@@ -56,9 +60,9 @@
    "id": "05-ut-sales-03",
    "metadata": {},
    "source": [
-    "## От какого месяца считать\n",
+    "## Находим период для опыта\n",
     "\n",
-    "Берём последнюю дату активного движения с ненулевой выручкой. Сравниваем месяц этой даты с предыдущим календарным месяцем. Если движений нет, ячейка остановится с понятной ошибкой вместо пустой диаграммы."
+    "Чтобы notebook не зависел от конкретной даты демобазы, найдём последнее активное движение с ненулевой выручкой. Сравним месяц этой даты с предыдущим календарным месяцем."
    ]
   },
   {
@@ -95,9 +99,9 @@
    "id": "05-ut-sales-05",
    "metadata": {},
    "source": [
-    "## Обороты регистра\n",
+    "## Получаем обороты средствами УТ\n",
     "\n",
-    "Виртуальная таблица `Обороты` учитывает движения выручки, в том числе корректировки и возвраты. Группируем по месяцу и подразделению; `СуммаВыручки` — ресурс регистра с НДС. В этой выборке нет пересчёта сумм документов по валютам."
+    "Используем виртуальную таблицу `Обороты` регистра `ВыручкаИСебестоимостьПродаж`. Она учитывает движения выручки, включая корректировки и возвраты. Группируем данные по месяцу и подразделению."
    ]
   },
   {
@@ -131,19 +135,29 @@
    ]
   },
   {
-   "cell_type": "markdown",
+   "cell_type": "code",
+   "execution_count": null,
    "id": "05-ut-sales-07",
    "metadata": {},
+   "outputs": [],
+   "source": [
+    "ПродажиПоМесяцам[:2].to_df()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "05-ut-sales-08",
+   "metadata": {},
    "source": [
-    "## Таблица и диаграммы\n",
+    "## Из 1С в pandas\n",
     "\n",
-    "Переносим результат `%%bsl` в pandas. Подписи ссылок получаем через `refs=\"presentation\"`; они нужны только для показа, а не для сопоставления объектов. Месяц без движений показываем с нулевой выручкой."
+    "Переносим результат запроса в pandas и строим несколько простых представлений. Ссылки материализуем как читаемые представления: здесь они нужны для анализа человеком, а не как технические идентификаторы."
    ]
   },
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "05-ut-sales-08",
+   "id": "05-ut-sales-09",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -170,7 +184,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "05-ut-sales-09",
+   "id": "05-ut-sales-10",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -194,18 +208,20 @@
   },
   {
    "cell_type": "markdown",
-   "id": "05-ut-sales-10",
+   "id": "05-ut-sales-11",
    "metadata": {},
    "source": [
-    "## Типовая логика прироста\n",
+    "## Вызываем типовую бизнес-логику\n",
+    "\n",
+    "Теперь оставим агрегацию выручки в BSL и вызовем `ПродажиСервер.ПроцентПрироста`.\n",
     "\n",
-    "Сначала суммируем выручку в BSL и вызываем `ПродажиСервер.ПроцентПрироста`. В УТ 11.6.1.61 эта функция отдельно обрабатывает нулевую и отрицательную базу сравнения: результат для нулевой базы не равен обычному математическому проценту роста."
+    "Интересен не только результат для наших двух месяцев, но и контрольный вызов `(0, 100)`: в УТ 11.6.1.61 функция отдельно обрабатывает нулевую и отрицательную базу сравнения."
    ]
   },
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "05-ut-sales-11",
+   "id": "05-ut-sales-12",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -228,7 +244,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "05-ut-sales-12",
+   "id": "05-ut-sales-13",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -240,121 +256,22 @@
   },
   {
    "cell_type": "markdown",
-   "id": "05-ut-sales-13",
-   "metadata": {},
-   "source": [
-    "## Останов перед возвратом\n",
-    "\n",
-    "Поставим точку на строке 9311 метода `ПродажиСервер.ПроцентПрироста`, перед `Возврат Результат;`. Номер относится к выгрузке УТ 11.6.1.61."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
    "id": "05-ut-sales-14",
    "metadata": {},
-   "outputs": [],
-   "source": [
-    "runtime.add_capture_point(r'CommonModules\\ПродажиСервер\\Ext\\Module.bsl', 9311)"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "05-ut-sales-15",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "%%bsl\n",
-    "Результат = ПродажиСервер.ПроцентПрироста(\n",
-    "    ВыручкаПредыдущегоМесяца, ВыручкаПоследнегоМесяца);"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "05-ut-sales-16",
-   "metadata": {},
-   "outputs": [],
    "source": [
-    "status = runtime.status()\n",
-    "assert status.state.value == 'captured'\n",
-    "stack = runtime.runtime_api.capture_stack(cursor=0, limit=20)\n",
-    "display(pd.DataFrame(stack['frames'])[['level', 'module_type', 'line']])"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "05-ut-sales-17",
-   "metadata": {},
-   "source": [
-    "## Значения внутри вызова\n",
+    "## Hot reload: проверяем альтернативную трактовку\n",
     "\n",
-    "Пока вызов остановлен, `КонтекстОтладки` даёт аргументы и локальный результат. Скопируем только три числа в таблицу для просмотра в Python."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "05-ut-sales-18",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "%%bsl\n",
-    "СнимокПрироста = Новый ТаблицаЗначений;\n",
-    "СнимокПрироста.Колонки.Добавить(\"ВыручкаПредыдущегоМесяца\");\n",
-    "СнимокПрироста.Колонки.Добавить(\"ВыручкаПоследнегоМесяца\");\n",
-    "СнимокПрироста.Колонки.Добавить(\"ПриростПроцентов\");\n",
-    "СтрокаСнимка = СнимокПрироста.Добавить();\n",
-    "СтрокаСнимка.ВыручкаПредыдущегоМесяца = КонтекстОтладки.ПредыдущееЗначение;\n",
-    "СтрокаСнимка.ВыручкаПоследнегоМесяца = КонтекстОтладки.ТекущееЗначение;\n",
-    "СтрокаСнимка.ПриростПроцентов = КонтекстОтладки.Результат;"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "05-ut-sales-19",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "display(СнимокПрироста.to_df())"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "05-ut-sales-20",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "completed = runtime.resume_capture()\n",
-    "runtime.clear_capture_points()\n",
-    "assert completed.succeeded and completed.state.value == 'completed'\n",
-    "print('Результат после продолжения, %:', completed.result)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "05-ut-sales-21",
-   "metadata": {},
-   "source": [
-    "## Hot reload: нет базы для процента\n",
+    "Оригинальная функция возвращает 100% для пары `(0, 100)`. Проверим другую бизнес-гипотезу: если предыдущая выручка равна нулю, считать процент прироста неопределённым.\n",
     "\n",
-    "Типовая функция возвращает 100% для пары `(0, 100)`. Попробуем другую трактовку: при нулевой предыдущей и положительной текущей выручке процент не определён. В **локальной копии** выгрузки `SOURCE_ROOT` откройте `CommonModules/ПродажиСервер/Ext/Module.bsl`. В функции `ПроцентПрироста` найдите ветку `ИначеЕсли ПредыдущееЗначение = 0 Тогда` и замените в ней `Результат = 100;` на `Результат = Неопределено;`. После правки ветка должна выглядеть так:\n",
+    "Изменяем только локальную копию `CommonModules/ПродажиСервер/Ext/Module.bsl`, загружаем её в текущий экспериментальный сеанс и повторяем те же вызовы. Конфигурация ИБ при этом не обновляется.\n",
     "\n",
-    "```bsl\n",
-    "ИначеЕсли ПредыдущееЗначение = 0 Тогда\n",
-    "    Результат = Неопределено;\n",
-    "```\n",
-    "\n",
-    "Сохраните файл, оставив остальную функцию без изменений. Конфигурация ИБ не меняется: следующий шаг загрузит изменённый модуль в текущий runtime-сеанс. При переносе в Python значение `Неопределено` представлено как `ONEC_UNDEFINED`."
+    "Это лишь короткая демонстрация возможности; устройство hot reload и его ограничения разбираются в отдельном материале."
    ]
   },
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "05-ut-sales-22",
+   "id": "05-ut-sales-15",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -364,7 +281,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "05-ut-sales-23",
+   "id": "05-ut-sales-16",
    "metadata": {},
    "outputs": [],
    "source": [
@@ -377,33 +294,19 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "05-ut-sales-24",
+   "id": "05-ut-sales-17",
    "metadata": {},
    "outputs": [],
    "source": [
-    "from onec_runtime.value_materialization import ONEC_UNDEFINED\n",
-    "\n",
-    "growth_after = ПриростПослеПерезагрузки.materialize()\n",
-    "probe_after = КонтрольныйПриростПосле.materialize()\n",
-    "assert probe_before == 100 and probe_after is ONEC_UNDEFINED\n",
-    "print('Контрольный вызов (0, 100):', probe_before, '→ Неопределено')\n",
-    "print('Выручка ИБ:', growth_before, '→',\n",
-    "      'Неопределено' if growth_after is ONEC_UNDEFINED else growth_after)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "05-ut-sales-25",
-   "metadata": {},
-   "source": [
-    "## Что дальше\n",
-    "\n",
-    "Можно заменить два месяца другим интервалом, добавить отбор по организации или исследовать отдельное подразделение. Для сравнения с ЗУП откройте [01-overview.ipynb](../ZUP/01-overview.ipynb)."
+    "growth_before = ПриростВыручки.materialize()\n",
+    "probe_before = КонтрольныйПриростДо.materialize()\n",
+    "print('Прирост выручки, %:', growth_before)\n",
+    "print('Контрольный вызов (0, 100), %:', probe_before)"
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "05-ut-sales-26",
+   "id": "05-ut-sales-18",
    "metadata": {},
    "source": [
     "## Завершение"
@@ -412,7 +315,7 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "05-ut-sales-27",
+   "id": "05-ut-sales-19",
    "metadata": {},
    "outputs": [],
    "source": [