onescript-kernel-jupyter

KO | EN

gitlite — search

#javascript #hacktoberfest #react #ai #llm #android #linux #macos #windows #pytorch #openai #mcp #ios #open-source

onescript-kernel-jupyter

(★ 13)

Ядро onescript для jupyter notebook

onescript-kernel-jupyter Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# onescript-kernel-jupyter
Ядро onescript для jupyter notebook

Для создания ядра Jupyter Notebook, которое будет использовать язык программирования OneScript, необходимо выполнить несколько шагов. OneScript — это скриптовый язык, совместимый с 1С:Предприятие, и для его интеграции в Jupyter потребуется создать пользовательское ядро.

Ниже приведен пошаговый план и пример кода для реализации такого ядра.

## Upd 2025.08.21
- Добавлен синтаксис-контроль с помощью связки [BSL Language Server](https://1c-syntax.github.io/bsl-language-server/dev/) и [jupyter-lsp](https://jupyterlab-lsp.readthedocs.io/en/latest/index.html)
- Добавлен файл Example1C.ipynb с примерами использования движка OneScript

## Запуск в контейнере
Для запуска контейнера необходимо собрать его образ

### Сборка образа
1. **Скачайте проект с данного репозитория**

2. **Запустите команду сборки образа**
   ```bash
   docker build -t jupyter-onescript .   
   ```

### Запустите контейнер
Для запуска контейнера выполните команду
   ```bash
   docker run -e NOTEBOOK_ARGS="--NotebookApp.token='' --ip=0.0.0.0" -p 8888:8888 jupyter-onescript  
   ```

## Запуск без контейнера

### Шаг 1: Установка необходимых инструментов
1. **Установите Jupyter Notebook**:
   Если у вас еще не установлен Jupyter, выполните:
   ```bash
   pip install notebook
   ```

2. **Установите OneScript**:
   Скачайте и установите OneScript с официального сайта: [https://oscript.io/](https://oscript.io/) или из папки install.

3. **Установите `jupyter_kernel`**:
   Для создания пользовательского ядра используется пакет `jupyter_kernel`. Установите его:
   ```bash
   pip install jupyter_kernel
   ```

---

### Шаг 2: Создание ядра OneScript
Ядро Jupyter Notebook — это программа, которая взаимодействует с Jupyter через протокол ZeroMQ. Мы будем использовать Python для создания интерфейса между Jupyter и OneScript.

#### 1. Скопируйте каталог с ядром из репозитория в каталог ~/.local/share/jupyter/
Эти файлы содержат логику ядра для OneScript.
Должно получиться:

~/.local/share/jupyter/kernels/onescript/kernel.json

~/.local/share/jupyter/kernels/onescript/onescript_kernel.py

### Шаг 3: Запуск Jupyter Notebook
1. Запустите Jupyter Notebook:
   ```bash
   jupyter notebook
   ```

2. При создании новой записной книжки выберите ядро "OneScript" из списка доступных ядер.

---

### Пример использования
Теперь вы можете писать код на OneScript прямо в Jupyter Notebook. Например:
```onescript
// Простой пример
Перем a;
a = 5 + 3;
Сообщить(a);
```

Результат выполнения будет отображаться в ячейке вывода.

![result](https://github.com/user-attachments/assets/6e01e457-6cb6-491f-8c85-9cb84d8b14ba)

onescript-kernel-jupyter

onescript-kernel-jupyter Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

onescript-kernel-jupyter

onescript-kernel-jupyter Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README