tgblocks 0.2.2__tar.gz → 0.2.4__tar.gz

{tgblocks-0.2.2 → tgblocks-0.2.4}/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.2.4
+
+Typography. Long dashes are replaced with a plain hyphen everywhere the project writes
+text: the documentation, the editor hints and the warnings. Only the punctuation changed;
+no behaviour, no generated code.
+
+## 0.2.3
+
+Documentation only. The package is installed from PyPI with one command, and the README
+no longer suggests otherwise: the repository install is now described as "the newest
+commit instead of the release".
+
+## 0.2.2
+
+Metadata only: the PyPI summary and the GitHub description became the same sentence,
+"Visual editor for building Telegram bots on aiogram 3". The code is unchanged.
+
 ## 0.2.1
 
 Metadata, tests and documentation. The generated aiogram code is unchanged.
@@ -44,7 +61,7 @@ The release that made the three editors agree with each other.
   `send_dice`.
 - **Editing and answering**: `edit_text`, `answer_callback [alert]`.
 - **Chat actions**: `pin [silent]`, `unpin`.
-- **Moderation**: `ban_user`, `unban_user`, `mute_user` — without an ID they act on the
+- **Moderation**: `ban_user`, `unban_user`, `mute_user` - without an ID they act on the
   sender of the message.
 - **Dialogues (FSM)**: `state order`, `set_state`, `clear_state`, `on state order:`.
   The generated bot gets `StatesGroup` and a `MemoryStorage` dispatcher.
@@ -108,8 +125,8 @@ The release that made the three editors agree with each other.
 
 - **Settings in every view**: ⚙ in the header switches the theme (dark/light) and the
   interface language (English by default, Russian optional). The choice is remembered and
-  can be shared as `?theme=light&lang=ru`; the whole catalogue — block names, field
-  captions, hints, drop-down values, status lines — is translated.
+  can be shared as `?theme=light&lang=ru`; the whole catalogue - block names, field
+  captions, hints, drop-down values, status lines - is translated.
 - **Typing is one-line everywhere again**, and every field has a caption, so a drop-down
   says what it is.
 - **Two event filters are hidden** from the panel: "only these texts" and "matches a

{tgblocks-0.2.2 → tgblocks-0.2.4}/GITHUB.md

@@ -1,21 +1,21 @@
 # Публикация tgblocks на GitHub и в PyPI
 
 Полная инструкция с нуля: от пустого аккаунта до `pip install tgblocks` у любого
-человека. Всё, что нужно сделать тебе, — один раз выполнить команды из разделов 1–4,
-а потом (по желанию) разделы 5–6.
+человека. Всё, что нужно сделать тебе, - один раз выполнить команды из разделов 1-4,
+а потом (по желанию) разделы 5-6.
 
 ---
 
 ## 0. Что понадобится
 
-**Аккаунт GitHub** — хранить код: <https://github.com/signup>
+**Аккаунт GitHub** - хранить код: <https://github.com/signup>
 
-**git** — отправлять код: <https://git-scm.com/download/win>
+**git** - отправлять код: <https://git-scm.com/download/win>
 (при установке оставь галочки по умолчанию)
 
-**Python 3.10 или новее** — собирать пакет: <https://www.python.org/downloads/>
+**Python 3.10 или новее** - собирать пакет: <https://www.python.org/downloads/>
 
-**Аккаунт PyPI** — чтобы работал `pip install`: <https://pypi.org/account/register/>
+**Аккаунт PyPI** - чтобы работал `pip install`: <https://pypi.org/account/register/>
 
 Проверка, что всё стоит:
 
@@ -33,7 +33,7 @@ git config --global user.name "Твоё Имя"
 git config --global user.email "твоя_почта@example.com"
 ```
 
-Почта должна совпадать с той, на которую зарегистрирован GitHub — иначе коммиты не
+Почта должна совпадать с той, на которую зарегистрирован GitHub - иначе коммиты не
 будут связаны с профилем.
 
 ---
@@ -43,7 +43,7 @@ git config --global user.email "твоя_почта@example.com"
 1. Открой <https://github.com/new>.
 2. **Repository name**: `tgblocks`.
 3. **Public** (для приватного всё то же, но `pip install` с GitHub не сработает).
-4. **НЕ** ставь галочки «Add a README», «Add .gitignore», «Choose a license» — они уже
+4. **НЕ** ставь галочки «Add a README», «Add .gitignore», «Choose a license» - они уже
    есть в проекте, иначе будет конфликт при первом `push`.
 5. **Create repository**.
 
@@ -69,14 +69,14 @@ git push -u origin main
 git remote set-url origin https://github.com/Pupka228228/tgblocks.git
 ```
 
-### Пароль не подойдёт — нужен токен
+### Пароль не подойдёт - нужен токен
 
 GitHub больше не принимает пароль аккаунта. Один раз:
 
 1. <https://github.com/settings/tokens> → **Generate new token (classic)**.
 2. Note: `tgblocks push`, Expiration: 90 days, галочка **`repo`**.
 3. **Generate token**, скопируй строку `ghp_...` (она показывается один раз).
-4. В окне `git push` на запрос пароля вставь этот токен, логин — обычный.
+4. В окне `git push` на запрос пароля вставь этот токен, логин - обычный.
 
 Сохранить токен в менеджере Windows, чтобы не вводить каждый раз:
 
@@ -84,7 +84,7 @@ GitHub больше не принимает пароль аккаунта. Од
 git config --global credential.helper manager
 ```
 
-Альтернатива — GitHub CLI:
+Альтернатива - GitHub CLI:
 
 ```powershell
 winget install --id GitHub.cli
@@ -103,7 +103,7 @@ git push
 
 ## 4. Проверить, что всё в порядке
 
-1. Открой страницу репозитория — файлы на месте, README и `docs/demo.gif` видны.
+1. Открой страницу репозитория - файлы на месте, README и `docs/demo.gif` видны.
 2. Вкладка **Actions**: workflow **CI** должен стать зелёным. Он прогоняет 261 тест на
    Windows и Linux (Python 3.10, 3.11, 3.13), проверяет JS редакторов, собирает пакет и
    ставит его в чистое окружение.
@@ -113,7 +113,7 @@ git push
 [![CI](https://github.com/Pupka228228/tgblocks/actions/workflows/ci.yml/badge.svg)](https://github.com/Pupka228228/tgblocks/actions/workflows/ci.yml)
 ```
 
-Если Actions красный — открой лог: чаще всего это не установленные зависимости, а не
+Если Actions красный - открой лог: чаще всего это не установленные зависимости, а не
 код; локально повтори `python -m pytest -q`.
 
 ---
@@ -138,7 +138,7 @@ tgblocks
    Account settings → Two-factor authentication.
 3. Account settings → **API tokens** → **Add API token** → Name: `tgblocks`,
    Scope: **Entire account** (для первого раза) → **Add token**.
-4. Скопируй `pypi-AgEIcHlwaS5vcmc...` — это пароль для загрузки.
+4. Скопируй `pypi-AgEIcHlwaS5vcmc...` - это пароль для загрузки.
 
 ### 6.2 Собрать и проверить
 
@@ -185,7 +185,7 @@ tgblocks compile mybot.tg -o bot.py
 ```
 
 - без `[runtime]` ставится только компилятор и редакторы (генерация кода работает);
-- `tgblocks` появляется в PATH вместе с Python; в виртуальном окружении — после
+- `tgblocks` появляется в PATH вместе с Python; в виртуальном окружении - после
   активации. Если команда не находится: `python -m tgblocks` работает всегда.
 
 ---
@@ -218,36 +218,36 @@ git push --tags
 изменения → прикрепи файлы из `dist/` → **Publish release**.
 
 5. Загрузи в PyPI (`python -m twine upload dist/*`). Одно и то же имя версии дважды
-   загрузить нельзя — всегда поднимай номер.
+   загрузить нельзя - всегда поднимай номер.
 
 ---
 
 ## 9. Частые проблемы
 
-**`Authentication failed` при push** — введён пароль вместо токена.
+**`Authentication failed` при push** - введён пароль вместо токена.
 Смотри раздел 3, нужен токен с галочкой `repo`.
 
-**`remote origin already exists`** — remote уже привязан.
+**`remote origin already exists`** - remote уже привязан.
 Выполни `git remote set-url origin <адрес>`.
 
-**`Updates were rejected`** — на GitHub уже есть коммиты (например, создавал README
+**`Updates were rejected`** - на GitHub уже есть коммиты (например, создавал README
 через сайт). Сделай `git pull --rebase origin main`, потом `git push`.
 
-**`403` при `twine upload`** — токен без Scope «Entire account» или не включена 2FA.
+**`403` при `twine upload`** - токен без Scope «Entire account» или не включена 2FA.
 Создай токен заново.
 
-**`File already exists` на PyPI** — эта версия уже загружена.
+**`File already exists` на PyPI** - эта версия уже загружена.
 Подними `version` в `pyproject.toml`.
 
-**`tgblocks: command not found`** — папка скриптов Python не в PATH.
+**`tgblocks: command not found`** - папка скриптов Python не в PATH.
 Активируй venv или запускай `python -m tgblocks`.
 
-**`ModuleNotFoundError: aiogram`** при запуске бота — пакет поставлен без `[runtime]`.
+**`ModuleNotFoundError: aiogram`** при запуске бота - пакет поставлен без `[runtime]`.
 Нужен `pip install "tgblocks[runtime]"`.
 
-**README не показывает картинки** — файлы не попали в репозиторий.
+**README не показывает картинки** - файлы не попали в репозиторий.
 Проверь, что `docs/editor-nodes.png`, `docs/editor-blocks.png`, `docs/editor-text.png`
-и `docs/demo.gif` закоммичены, а ветка в ссылках — `main`.
+и `docs/demo.gif` закоммичены, а ветка в ссылках - `main`.
 
 ---
 

{tgblocks-0.2.2 → tgblocks-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tgblocks
-Version: 0.2.2
+Version: 0.2.4
 Summary: Visual editor for building Telegram bots on aiogram 3
 Project-URL: Homepage, https://github.com/Pupka228228/tgblocks
 Project-URL: Repository, https://github.com/Pupka228228/tgblocks
@@ -37,7 +37,7 @@ Description-Content-Type: text/markdown
 
 **A tiny text DSL and three visual editors for Telegram bots on aiogram 3.**
 
-Five lines of text — or five dragged blocks — and you get ordinary, editable aiogram
+Five lines of text - or five dragged blocks - and you get ordinary, editable aiogram
 code. No account, no cloud, no lock-in: the editor is a local server on
 127.0.0.1, and the result is a normal bot.py you can read, commit and deploy.
 
@@ -55,8 +55,8 @@ tgblocks                            # opens the editor at http://127.0.0.1:8765/
 ```
 
 Without the extra: `pip install tgblocks` installs the compiler and the editors only,
-which is enough to generate and read code. If the package is not on PyPI yet, the same
-two commands work straight from the repository:
+which is enough to generate and read code. To follow the newest commit instead of the
+release:
 
 ```bash
 pip install "tgblocks[runtime] @ git+https://github.com/Pupka228228/tgblocks.git"
@@ -74,7 +74,7 @@ Publishing a release is described in **[GITHUB.md](GITHUB.md)**.
 
 ## Three views, one compiler
 
-### `/nodes` — boxes and wires
+### `/nodes` - boxes and wires
 
 ![nodes](https://raw.githubusercontent.com/Pupka228228/tgblocks/main/docs/editor-nodes.png)
 
@@ -82,14 +82,14 @@ Blocks come from the palette on the left, and they do not connect by themselves:
 from a dot to the block you want, and `✕` in the middle of a wire removes it. Drag the
 background to pan, wheel to zoom, `Ctrl+Z` and `Ctrl+Y` undo and redo.
 
-### `/blocks` — Blockly
+### `/blocks` - Blockly
 
 ![blocks](https://raw.githubusercontent.com/Pupka228228/tgblocks/main/docs/editor-blocks.png)
 
 The same bot with blocks generated from the same catalogue. Blockly ships inside the
 package, so this view works without internet.
 
-### `/text` — the code, with help
+### `/text` - the code, with help
 
 ![text](https://raw.githubusercontent.com/Pupka228228/tgblocks/main/docs/editor-text.png)
 
@@ -98,14 +98,14 @@ compiler knows at the cursor.
 
 All three are one document. A change in any view shows up in the other two within a
 second, and clearing one clears the bot everywhere. The ⚙ panel in the header switches
-the theme and the interface language — English by default, Russian at one click, and the
+the theme and the interface language - English by default, Russian at one click, and the
 block names, field captions and hints change with it.
 
 ## Why
 
 Paid bot constructors keep your bot inside their panel: you rent the hosting, you cannot
 read the code, and leaving means starting again. Writing aiogram 3 by hand is the
-opposite — full control, but the first hour is dispatcher, routers, filters, keyboards,
+opposite - full control, but the first hour is dispatcher, routers, filters, keyboards,
 callbacks and an async entrypoint before anything answers.
 
 tgblocks is the middle: a language small enough to fit on a postcard, or an editor where
@@ -176,7 +176,7 @@ parameters, its labels, the aiogram method it lands on. The DSL parser, the text
 parser, the converters (text ⇄ node board ⇄ Blockly XML) and the code generator all
 read that one table, and `/api/schema` hands it to the three pages, so their palettes
 and property fields are generated too. Adding an aiogram method is a catalogue entry
-plus one emitter — not five copies that drift apart.
+plus one emitter - not five copies that drift apart.
 
 ## What a bot can do
 
@@ -240,7 +240,7 @@ bot.tg:7:5: error: expected a quoted text
 
 Two handlers that claim the same messages are refused at parse time: aiogram calls
 only the first one, so the second would silently never run. A button that calls a
-command nobody handles is a warning, not an error — the bot still builds.
+command nobody handles is a warning, not an error - the bot still builds.
 
 ## Telegram is blocked? Use a proxy
 
@@ -254,7 +254,7 @@ bot proxy "socks5://127.0.0.1:1080"
 fails, the generated bot prints a short explanation instead of a full aiohttp
 traceback.
 
-Paste only the URL into the bot's `proxy` field — not the whole record from a proxy
+Paste only the URL into the bot's `proxy` field - not the whole record from a proxy
 list. To check that a proxy actually reaches Telegram before running a bot:
 
 ```bash
@@ -272,7 +272,7 @@ as a potential attacker:
 - it answers only on `127.0.0.1`, and only to a `Host` header that is one of its own
   (a hostile domain pointing at 127.0.0.1 is refused);
 - cross-site requests are refused by `Origin` and `Sec-Fetch-Site` checks, and a POST
-  body must be `application/json` — the two ways a foreign page could otherwise drive
+  body must be `application/json` - the two ways a foreign page could otherwise drive
   it;
 - running a preview is a child process by design, so `--host` needs `--allow-remote`
   before that is exposed to the network.
@@ -282,10 +282,10 @@ Secrets stay out of artefacts: `compile` writes code without the token unless yo
 
 ## Python API
 
-- `from tgblocks import compile_source, compile_text` — DSL text or editor text to
+- `from tgblocks import compile_source, compile_text` - DSL text or editor text to
   aiogram code.
-- `from tgblocks import parse, generate` — AST in, code out.
-- `from tgblocks import run` — a DSL string inside a normal `.py` file.
+- `from tgblocks import parse, generate` - AST in, code out.
+- `from tgblocks import run` - a DSL string inside a normal `.py` file.
 - `tgblocks.dsl.parser.DSLParseError` carries `line`, `column`, `message` and `hint`.
 
 ## Project layout
@@ -318,14 +318,14 @@ python -m pytest -q          # 261 tests
 The suite runs the generated bots on a fake Telegram, so a broken `/start` fails a
 test instead of failing in production:
 
-- `tests/test_golden.py` — pins the generated code for a corpus of bots and imports
+- `tests/test_golden.py` - pins the generated code for a corpus of bots and imports
   every sample into the real aiogram package;
-- `tests/test_bots.py`, `tests/test_features.py`, `tests/test_examples.py` — feed real
+- `tests/test_bots.py`, `tests/test_features.py`, `tests/test_examples.py` - feed real
   updates through a real `Dispatcher` and assert the API calls a user would cause;
-- `tests/test_sync.py`, `tests/test_ui.py` — the editors: one document for three
+- `tests/test_sync.py`, `tests/test_ui.py` - the editors: one document for three
   views, the schema, and both "compile this canvas" paths;
-- `tests/test_security.py` — the CSRF, rebinding and wide-bind refusals;
-- `tests/test_scaffold.py` — `scaffold.py` cannot drift from the tree again.
+- `tests/test_security.py` - the CSRF, rebinding and wide-bind refusals;
+- `tests/test_scaffold.py` - `scaffold.py` cannot drift from the tree again.
 
 Beyond pytest:
 
@@ -346,12 +346,12 @@ python tools/qa_smoke.py                 # endpoints plus the editor-to-editor h
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+MIT - see [LICENSE](LICENSE).
 
 ## Русский
 
-`tgblocks` — маленький язык и три редактора для Telegram-ботов на aiogram 3. Написал
-пять строк (или собрал блоки мышкой) — получил обычный `bot.py`, который можно читать,
+`tgblocks` - маленький язык и три редактора для Telegram-ботов на aiogram 3. Написал
+пять строк (или собрал блоки мышкой) - получил обычный `bot.py`, который можно читать,
 править и выкладывать.
 
 ```bash
@@ -363,19 +363,22 @@ tgblocks compile examples/hello.tg -o mybot.py
 ```
 
 Всё работает на твоём компьютере: никаких аккаунтов, облака и подписок. Три вида
-(узлы, текст, блоки) — это один и тот же бот, поэтому правка в одном виде сразу видна
+(узлы, текст, блоки) - это один и тот же бот, поэтому правка в одном виде сразу видна
 в двух других. В шапке есть кнопка настроек: тёмная или светлая тема и русский или
 английский интерфейс. Токен в сгенерированный файл не пишется, если не попросить
 `--embed-token`.
 
-Установка без файлов, сразу с GitHub:
+Пакет уже лежит на PyPI, поэтому ставится одной строкой - файлы никто не скачивает:
 
 ```bash
-pip install "tgblocks[runtime] @ git+https://github.com/Pupka228228/tgblocks.git"
+pip install "tgblocks[runtime]"
 ```
 
-А когда пакет залит на PyPI, хватает одной строки `pip install tgblocks` — файлы
-никто не скачивает.
+Если нужен самый свежий коммит, а не релиз:
+
+```bash
+pip install "tgblocks[runtime] @ git+https://github.com/Pupka228228/tgblocks.git"
+```
 
 Подробно по шагам, с разбором ошибок: **[ИНСТРУКЦИЯ.md](ИНСТРУКЦИЯ.md)**.
 Как выложить проект на GitHub и в PyPI: **[GITHUB.md](GITHUB.md)**.

{tgblocks-0.2.2 → tgblocks-0.2.4}/README.md

@@ -2,7 +2,7 @@
 
 **A tiny text DSL and three visual editors for Telegram bots on aiogram 3.**
 
-Five lines of text — or five dragged blocks — and you get ordinary, editable aiogram
+Five lines of text - or five dragged blocks - and you get ordinary, editable aiogram
 code. No account, no cloud, no lock-in: the editor is a local server on
 127.0.0.1, and the result is a normal bot.py you can read, commit and deploy.
 
@@ -20,8 +20,8 @@ tgblocks                            # opens the editor at http://127.0.0.1:8765/
 ```
 
 Without the extra: `pip install tgblocks` installs the compiler and the editors only,
-which is enough to generate and read code. If the package is not on PyPI yet, the same
-two commands work straight from the repository:
+which is enough to generate and read code. To follow the newest commit instead of the
+release:
 
 ```bash
 pip install "tgblocks[runtime] @ git+https://github.com/Pupka228228/tgblocks.git"
@@ -39,7 +39,7 @@ Publishing a release is described in **[GITHUB.md](GITHUB.md)**.
 
 ## Three views, one compiler
 
-### `/nodes` — boxes and wires
+### `/nodes` - boxes and wires
 
 ![nodes](https://raw.githubusercontent.com/Pupka228228/tgblocks/main/docs/editor-nodes.png)
 
@@ -47,14 +47,14 @@ Blocks come from the palette on the left, and they do not connect by themselves:
 from a dot to the block you want, and `✕` in the middle of a wire removes it. Drag the
 background to pan, wheel to zoom, `Ctrl+Z` and `Ctrl+Y` undo and redo.
 
-### `/blocks` — Blockly
+### `/blocks` - Blockly
 
 ![blocks](https://raw.githubusercontent.com/Pupka228228/tgblocks/main/docs/editor-blocks.png)
 
 The same bot with blocks generated from the same catalogue. Blockly ships inside the
 package, so this view works without internet.
 
-### `/text` — the code, with help
+### `/text` - the code, with help
 
 ![text](https://raw.githubusercontent.com/Pupka228228/tgblocks/main/docs/editor-text.png)
 
@@ -63,14 +63,14 @@ compiler knows at the cursor.
 
 All three are one document. A change in any view shows up in the other two within a
 second, and clearing one clears the bot everywhere. The ⚙ panel in the header switches
-the theme and the interface language — English by default, Russian at one click, and the
+the theme and the interface language - English by default, Russian at one click, and the
 block names, field captions and hints change with it.
 
 ## Why
 
 Paid bot constructors keep your bot inside their panel: you rent the hosting, you cannot
 read the code, and leaving means starting again. Writing aiogram 3 by hand is the
-opposite — full control, but the first hour is dispatcher, routers, filters, keyboards,
+opposite - full control, but the first hour is dispatcher, routers, filters, keyboards,
 callbacks and an async entrypoint before anything answers.
 
 tgblocks is the middle: a language small enough to fit on a postcard, or an editor where
@@ -141,7 +141,7 @@ parameters, its labels, the aiogram method it lands on. The DSL parser, the text
 parser, the converters (text ⇄ node board ⇄ Blockly XML) and the code generator all
 read that one table, and `/api/schema` hands it to the three pages, so their palettes
 and property fields are generated too. Adding an aiogram method is a catalogue entry
-plus one emitter — not five copies that drift apart.
+plus one emitter - not five copies that drift apart.
 
 ## What a bot can do
 
@@ -205,7 +205,7 @@ bot.tg:7:5: error: expected a quoted text
 
 Two handlers that claim the same messages are refused at parse time: aiogram calls
 only the first one, so the second would silently never run. A button that calls a
-command nobody handles is a warning, not an error — the bot still builds.
+command nobody handles is a warning, not an error - the bot still builds.
 
 ## Telegram is blocked? Use a proxy
 
@@ -219,7 +219,7 @@ bot proxy "socks5://127.0.0.1:1080"
 fails, the generated bot prints a short explanation instead of a full aiohttp
 traceback.
 
-Paste only the URL into the bot's `proxy` field — not the whole record from a proxy
+Paste only the URL into the bot's `proxy` field - not the whole record from a proxy
 list. To check that a proxy actually reaches Telegram before running a bot:
 
 ```bash
@@ -237,7 +237,7 @@ as a potential attacker:
 - it answers only on `127.0.0.1`, and only to a `Host` header that is one of its own
   (a hostile domain pointing at 127.0.0.1 is refused);
 - cross-site requests are refused by `Origin` and `Sec-Fetch-Site` checks, and a POST
-  body must be `application/json` — the two ways a foreign page could otherwise drive
+  body must be `application/json` - the two ways a foreign page could otherwise drive
   it;
 - running a preview is a child process by design, so `--host` needs `--allow-remote`
   before that is exposed to the network.
@@ -247,10 +247,10 @@ Secrets stay out of artefacts: `compile` writes code without the token unless yo
 
 ## Python API
 
-- `from tgblocks import compile_source, compile_text` — DSL text or editor text to
+- `from tgblocks import compile_source, compile_text` - DSL text or editor text to
   aiogram code.
-- `from tgblocks import parse, generate` — AST in, code out.
-- `from tgblocks import run` — a DSL string inside a normal `.py` file.
+- `from tgblocks import parse, generate` - AST in, code out.
+- `from tgblocks import run` - a DSL string inside a normal `.py` file.
 - `tgblocks.dsl.parser.DSLParseError` carries `line`, `column`, `message` and `hint`.
 
 ## Project layout
@@ -283,14 +283,14 @@ python -m pytest -q          # 261 tests
 The suite runs the generated bots on a fake Telegram, so a broken `/start` fails a
 test instead of failing in production:
 
-- `tests/test_golden.py` — pins the generated code for a corpus of bots and imports
+- `tests/test_golden.py` - pins the generated code for a corpus of bots and imports
   every sample into the real aiogram package;
-- `tests/test_bots.py`, `tests/test_features.py`, `tests/test_examples.py` — feed real
+- `tests/test_bots.py`, `tests/test_features.py`, `tests/test_examples.py` - feed real
   updates through a real `Dispatcher` and assert the API calls a user would cause;
-- `tests/test_sync.py`, `tests/test_ui.py` — the editors: one document for three
+- `tests/test_sync.py`, `tests/test_ui.py` - the editors: one document for three
   views, the schema, and both "compile this canvas" paths;
-- `tests/test_security.py` — the CSRF, rebinding and wide-bind refusals;
-- `tests/test_scaffold.py` — `scaffold.py` cannot drift from the tree again.
+- `tests/test_security.py` - the CSRF, rebinding and wide-bind refusals;
+- `tests/test_scaffold.py` - `scaffold.py` cannot drift from the tree again.
 
 Beyond pytest:
 
@@ -311,12 +311,12 @@ python tools/qa_smoke.py                 # endpoints plus the editor-to-editor h
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+MIT - see [LICENSE](LICENSE).
 
 ## Русский
 
-`tgblocks` — маленький язык и три редактора для Telegram-ботов на aiogram 3. Написал
-пять строк (или собрал блоки мышкой) — получил обычный `bot.py`, который можно читать,
+`tgblocks` - маленький язык и три редактора для Telegram-ботов на aiogram 3. Написал
+пять строк (или собрал блоки мышкой) - получил обычный `bot.py`, который можно читать,
 править и выкладывать.
 
 ```bash
@@ -328,19 +328,22 @@ tgblocks compile examples/hello.tg -o mybot.py
 ```
 
 Всё работает на твоём компьютере: никаких аккаунтов, облака и подписок. Три вида
-(узлы, текст, блоки) — это один и тот же бот, поэтому правка в одном виде сразу видна
+(узлы, текст, блоки) - это один и тот же бот, поэтому правка в одном виде сразу видна
 в двух других. В шапке есть кнопка настроек: тёмная или светлая тема и русский или
 английский интерфейс. Токен в сгенерированный файл не пишется, если не попросить
 `--embed-token`.
 
-Установка без файлов, сразу с GitHub:
+Пакет уже лежит на PyPI, поэтому ставится одной строкой - файлы никто не скачивает:
 
 ```bash
-pip install "tgblocks[runtime] @ git+https://github.com/Pupka228228/tgblocks.git"
+pip install "tgblocks[runtime]"
 ```
 
-А когда пакет залит на PyPI, хватает одной строки `pip install tgblocks` — файлы
-никто не скачивает.
+Если нужен самый свежий коммит, а не релиз:
+
+```bash
+pip install "tgblocks[runtime] @ git+https://github.com/Pupka228228/tgblocks.git"
+```
 
 Подробно по шагам, с разбором ошибок: **[ИНСТРУКЦИЯ.md](ИНСТРУКЦИЯ.md)**.
 Как выложить проект на GitHub и в PyPI: **[GITHUB.md](GITHUB.md)**.

{tgblocks-0.2.2 → tgblocks-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tgblocks"
-version = "0.2.2"
+version = "0.2.4"
 description = "Visual editor for building Telegram bots on aiogram 3"
 readme = "README.md"
 requires-python = ">=3.10"

{tgblocks-0.2.2 → tgblocks-0.2.4}/src/tgblocks/convert.py

@@ -589,7 +589,7 @@ def _actions_of(children: List[dict], nodes: Dict[str, dict],
 
         if node_type == "otherwise":
             if warnings is not None:
-                warnings.append("«Иначе» без «Условия» перед ним — блок пропущен")
+                warnings.append("«Иначе» без «Условия» перед ним - блок пропущен")
             index += 1
             continue
 

{tgblocks-0.2.2 → tgblocks-0.2.4}/src/tgblocks/dsl/parser.py

@@ -770,7 +770,7 @@ class _Parser:
                 self._fail(
                     "для интерактивного эмодзи нужно число",
                     token,
-                    'кубик даёт 1–6, дартс — 1–6, слоты — 1–64: `when dice == 6:`',
+                    'кубик даёт 1-6, дартс - 1-6, слоты - 1-64: `when dice == 6:`',
                 )
             return Condition(op=op, value=raw, line=token.line, source="dice")
         # Several values mean "any of them": when text contains "a", "b":