1C HBK BSL

Инструменты для разработки на платформе «1С:Предприятие» / BSL: расширение для VS Code и Cursor, CLI-линтер, форматтер, а также LSP- и MCP-серверы для локальных интеграций.

CI Security Documentation GitHub Release PyPI VS Marketplace Python License: MIT

Что это

onec-hbk-bsl помогает держать BSL-код в порядке:

  • показывает диагностики в редакторе и CLI;
  • включает 180 публичных диагностических правил;
  • форматирует .bsl / .os;
  • даёт навигацию, hover, completion, rename и inlay hints через LSP;
  • умеет отдавать SARIF/JSON для CI;
  • предоставляет MCP-инструменты для локальных AI-ассистентов.

Проект не запускает Java-анализатор в рантайме. В репозитории выпускаются два связанных продукта: Toolkit (CLI, LSP, MCP и Python API) и расширение VS Code / Cursor со встроенным сервером.

При установке из PyPI требуется Python 3.12 или новее. Платформенные VSIX содержат готовый бинарный файл и не требуют системного Python. Актуальное состояние подтверждают CI, проверка безопасности и артефакты конкретного релиза.

Быстрый старт

VS Code / Cursor

  1. Установите расширение mussolene.1c-hbk-bsl.
  2. Откройте каталог с исходниками 1С.
  3. Дождитесь запуска сервера: диагностики появятся в Problems, а форматирование и навигация заработают через LSP.

Поддерживаются VS Code / Cursor с API VS Code 1.85+ и платформенные сборки для macOS Apple Silicon, macOS Intel, Linux x64 и Windows x64.

Настройки редактора, команды и порядок поиска сервера описаны в руководстве по расширению.

CLI

uv tool install onec-hbk-bsl

onec-hbk-bsl check .
onec-hbk-bsl format . --check
onec-hbk-bsl check . --format sarif > bsl-results.sarif

Установка через pip:

pip install onec-hbk-bsl

Конфигурация

Основной файл проекта: onec-hbk-bsl.toml.

ignore = ["BSL012"]
exclude = ["vendor", "build", "*.gen.bsl"]
format = "text"
jobs = 0
insert-spaces = false
indent-size = 4
index-mode = "full"      # off | symbols | full
index-max-bytes = 0      # 0 = unlimited

[per-file-ignores]
"legacy/*.bsl" = ["BSL002", "BSL011"]

Также поддерживается секция [tool."onec-hbk-bsl"] в pyproject.toml. Основные правила разрешения настроек:

  • явный параметр → переменная окружения → конфигурация проекта → встроенное значение по умолчанию;
  • jobs = 0 включает адаптивное выполнение, а jobs = 1 — последовательное;
  • index-exclude управляет областью навигации и по умолчанию наследует exclude;
  • после изменения области индекса выполните onec-hbk-bsl index . --force.

Полное руководство по конфигурации и публичным интерфейсам: Toolkit.

Диагностики и подавления

BSL### — стабильный код правила для вывода, --select, --ignore, onec-hbk-bsl.toml и подавляющих комментариев noqa. Совместимые имена из существующих BSL-проектов, например LineLength, также принимаются, но в результатах всегда выводится код BSL###.

Все семейства подавляющих комментариев работают для одной строки и диапазона: маркер после кода действует на текущую строку, а маркер на отдельной строке открывает диапазон до noqa-enable, bsl-enable или совместимого BSLLS:…-on.

Пароль = "dev_only";  // noqa: BSL012

// bsl-disable: BSL002
// код без BSL002
// bsl-enable: BSL002

Полный перечень с RU/EN-описаниями, примерами и исключениями: опубликованный справочник диагностических правил.

Основные команды

Задача Команда
Проверить проект onec-hbk-bsl check .
Получить SARIF для CI onec-hbk-bsl check . --format sarif > bsl-results.sarif
Создать или применить baseline-файл onec-hbk-bsl check . --update-baseline bsl-baseline.json / --baseline bsl-baseline.json
Проверить форматирование onec-hbk-bsl format . --check
Запустить LSP onec-hbk-bsl lsp
Запустить локальный MCP onec-hbk-bsl mcp --stdio --workspace /path/to/project
Проверить состояние индекса onec-hbk-bsl index . --status
Пересобрать индекс onec-hbk-bsl index . --force

Режимы индекса: off, symbols и full. Перед --clean остановите LSP и MCP.

Python и пакеты

from onec_hbk_bsl import check_files

diagnostics = check_files(["src/Модуль.bsl"], jobs=1)
for diagnostic in diagnostics:
    print(diagnostic.code, diagnostic.file, diagnostic.line)

Публикуются два PyPI-дистрибутива:

Пакет Назначение
onec-hbk-bsl-core CLI, форматтер, диагностики, Python API и LSP без MCP-зависимостей
onec-hbk-bsl Полный совместимый пакет поверх onec-hbk-bsl-core[mcp] той же версии

Место в экосистеме

onec-hbk-bsl отвечает за анализ и безопасное изменение кода в текущей рабочей области. Централизованную справку предоставляет onec-context-mcp, контекстные пакеты конкретной версии проекта собирает onec-context-toolkit, а воспроизводимой средой выполнения управляет 1c-develop.

Эти проекты дополняют друг друга, но не требуются для установки Toolkit или расширения.

Документация

Полная документация публикуется на mussolene.github.io/1c_hbk_bsl. Она поддерживает русский и английский языки, системную светлую/тёмную тему, полнотекстовый поиск и прямые страницы всех 180 правил.

RU/EN-описания диагностик адаптированы из документационного корпуса BSL Language Server и распространяются с сохранением указанной в сторонних уведомлениях лицензии.

Разработка

git clone https://github.com/mussolene/1c_hbk_bsl
cd 1c_hbk_bsl
make install
make lint
make test

Для локальной сборки VSIX используйте make vsix.

Лицензия

MIT © 2024 1C HBK BSL Contributors

Project links

Data verified by PyPI on Aug 19, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.8.50)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for mussolene from gravatar.com mussolene

GitHub Statistics

Data verified by PyPI on Aug 19, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.12

Provides Extra

mcp all dev build

Tags

1c bsl linter formatter lsp mcp vscode

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

onec_hbk_bsl_core-0.8.49.tar.gz (489.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

onec_hbk_bsl_core-0.8.49-py3-none-any.whl (533.4 kB view details)

Uploaded Python 3

File details

Details for the file onec_hbk_bsl_core-0.8.49.tar.gz.

File metadata

  • Download URL: onec_hbk_bsl_core-0.8.49.tar.gz
  • Upload date:
  • Size: 489.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for onec_hbk_bsl_core-0.8.49.tar.gz
Algorithm Hash digest
SHA256 f0446e8b71de2574cfd577e571de9d51583ec8e2dbb99c2662050a8bb6d26b06
MD5 5622f840a6e83f3db82de1e47fb17ae5
BLAKE2b-256 e0693de6a9922e9ad692012a172366bb967c968856ce137b41220653b7f50998

See more details on using hashes here.

Provenance

The following attestation bundles were made for onec_hbk_bsl_core-0.8.49.tar.gz:

Publisher: release.yml on mussolene/1c_hbk_bsl

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file onec_hbk_bsl_core-0.8.49-py3-none-any.whl.

File metadata

File hashes

Hashes for onec_hbk_bsl_core-0.8.49-py3-none-any.whl
Algorithm Hash digest
SHA256 04db3467959ec4a6ee628b3713754bd45d4f0caa29523c48a096c484ef80ff52
MD5 bd7f68b4133313aecf510d4ea6fdba85
BLAKE2b-256 6d465317e3dbdc5b4c3a15324873fa0a7c0dd01f964b2db7aedf52efe4b60e62

See more details on using hashes here.

Provenance

The following attestation bundles were made for onec_hbk_bsl_core-0.8.49-py3-none-any.whl:

Publisher: release.yml on mussolene/1c_hbk_bsl

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.8.50

2 files

This release

0.8.49 This release

2 files

0.8.48

2 files

0.8.47

2 files

0.8.46

2 files

0.8.45

2 files

0.8.44

2 files

0.8.43

2 files

0.8.42

2 files

0.8.41

2 files

0.8.40

2 files

0.8.39

2 files

0.8.38

2 files

0.8.37

2 files

0.8.36

2 files

0.8.34

2 files

0.8.33

2 files

0.8.32

2 files

0.8.31

2 files

0.8.30

2 files

0.8.29

2 files

0.8.28

2 files

0.8.27

2 files

0.8.26

2 files

0.8.25

2 files

0.8.24

2 files

0.8.23

2 files

0.8.22

2 files

0.8.21

2 files

0.8.20

2 files

0.8.19

2 files

0.8.18

2 files

0.8.17

2 files

0.8.16

2 files

0.8.15

2 files

0.8.14

2 files

0.8.13

2 files

0.8.12

2 files

0.8.11

2 files

0.8.9

2 files

0.8.8

2 files

0.8.7

2 files

0.8.6

2 files

0.8.5

2 files

0.8.4

2 files

0.8.3

2 files

0.8.2

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page