BSL Jupyter Runtime: interactive 1C notebooks

Install

Manual install

py -3.12 -m venv .venv
.venv\Scripts\python.exe -m pip install "onec-interactive-jupyter==0.1.23" "ipykernel>=6.29,<7" "matplotlib>=3.11,<4"
.venv\Scripts\python.exe -m ipykernel install --user --name onec-bsl --display-name "1C BSL"

This is third-party code. Review the repository files before installing.

What it does

The package adds a kernel and a %%bsl magic command for VS Code Jupyter notebooks: BSL cells run in one 1C session and keep its state between calls, and results, such as value tables, arrive in Python as pandas.DataFrame for further analysis and charts. Execution can be paused inside a standard configuration method, its local data and call stack inspected via CAPTURE breakpoints, and for experiments a modified local copy of a method can be loaded without updating the infobase configuration, i.e. hot reload. The 1C service extension installs into the database automatically from the wheel package, or manually via the Configurator. A separate VSIX gives highlighting, autocomplete and go-to-definition for BSL cells right inside the notebook.

Who it is for. For 1C developers and analysts who want to interactively explore how standard configuration methods behave, with breakpoints and on-the-fly edits, and process results in Python.

Example request

Stop the payroll calculation method right before it returns and show the value table as a pandas.DataFrame

Limitations

Requires Windows, Python 3.12+, VS Code 1.136+ and an installed 1C platform; the platform, demo databases and exports are not included in the package. The README explicitly recommends using a separate infobase copy and a separate source export copy, not production ones. Editor BSL support via the VSIX is marked as a preview version. The project's own code is licensed GPL-3.0-only, which imposes copyleft obligations when distributing derivative works.

How to disable. Remove the VSIX extension from VS Code, uninstall the package with pip uninstall onec-interactive-jupyter, and disable the OnecInteractiveRuntime service extension in the infobase copy.

Security check

• Runs arbitrary BSL code in a live 1C session, including hot-reloading methods without a configuration update
• Installs a service extension into the infobase and requires disabling safe mode for manual installation

README in short

The README describes an interactive runtime with BSL cells in VS Code Jupyter notebooks, gives a step-by-step quick start installing the Python package, registering the kernel, installing VS Code extensions, and starting a session against platform, infobase and source copies. It shows demo notebooks for payroll and trade management configurations, explains the components (runtime core, 1C extension, Jupyter integration, a preview VS Code extension), automatic and manual service-extension install via ExtensionMode, development requirements via uv, and the GPL-3.0-only license with third-party notices.

Related